STM32F4-Base

wandering1/STM32F4-Base

Fork 0

Commit Graph

Author	SHA1	Message	Date
wandering1	ad87f979b1	docs(规约): 删除编号规范.md，生效规则并入文档规范 §7.1 用户裁定：docs/编号规范.md 在项目里已无意义，删除。依据：该文 253 行里真正仍生效的只有两条规则（新条目一律不发编号、人读文档存量编号继续清退）和一张存量族表；其余内容早有归属——两道编号门禁的退役记录在 docs/门禁说明/id-check.md 与 id-check-new.md，手工普查与恢复机器面在 scripts/archive/id_gate/README.md。留着就是第二真相源，同一事实写在两处迟早漂移。处理： - docs/文档规范.md 新增 §7.1「条目与编号：一律不发」，承接规则、场景表、三条硬规矩、存量族表、已停发旧号族清单、不是编号的清单、清理动作与「没有机器门禁兜底」四段。 - 活跃引用 62 处逐条改指 §7.1 或归档 README：AGENTS.md 2 处、门禁说明三篇 18 处、其余文档 11 篇、代码与脚本 10 处、rename_maps 七个 record 字段、.dsh/skills 四个文件 8 处。 - 归档区 107 处去掉 docs/ 前缀当纯文本提及；编号治理历史.md 45 处改为「原编号规范 §N」，避免被 doc-links 当自引用解析。 - 顺带修正 scripts/archive/id_gate/README.md 里仍称旧文为现行规范的表述。门禁：check_doc_links --all --sections-strict 220 篇全通过、无法判定 0； pre-commit 全 Passed。	2026-11-06 18:32:04 +08:00
wandering1	301c3e5183	feat(门禁): 编号门禁 id-check 落地（36→37 钩子）+ 批 1 编号单词化改名新增门禁本体 - scripts/check_ids.py：实现 docs/编号规范.md §8 八项校验；默认 warn-only，唯一硬拦项是「可判定比例跌破基线」（防回退的本体） - scripts/id_registry.json：66 个前缀族，逐项来自 §4 总表 + 全库实测游标，偏差一律写进 cursor_note，不凭记忆编造 - scripts/id_aliases.json：旧号 → 新号 / 作废标记（照搬 section_aliases.json 范式） - 顺带收编 check_test_traceability.py：正则补齐大写后缀与无模块码形态，比对范围扩到 test/host 与 7 篇「单元测试说明.md」，另加 --board-only 回退旧口径批 1 改名（用户授权解禁「不改写存量号」） - 代码规范条款 S1~S19 → CODE-RULE-nn：78 处 / 2 文件 - UI 像素回归状态 S0~S7 → MENU-STATE-nn：61 处 / 3 文件（冻结在 07） - 两族属主登记处 = 脚本自身的规则表 / STATES 表，文档只作引用方 - 新增 scripts/rename_ids.py（§7.3 规划脚本）：映射表驱动、显式 scope、默认干跑、自动写 scoped 别名，跳过 [示例]/[计划] 行与变更记录表，按原字节读写保 BOM 行尾 - 已应用映射表存档 scripts/rename_maps/batch1.json 作审计轨迹有牙实测（证明门禁不是空转） - 注入 Z-99 / 裸形 / 悬空 / 越游标 / 未紧邻 / 跨文档重复定义六例，分别被校验 1/2/3/5/6/4 点名，--strict 退出码 1；临时档删除后工作树干净验证与同步 - 可判定比例基线 82.3% → 82.7%（已 --update-baseline 入档）；错误级 1312 → 1291 - ci_local.py 全绿（L0 + L0.5 共 1104 断言）；ui-golden Passed； check_doc_links.py --all 无法判定 0 - 未改任何 C/H 源文件，故本次不需 @build - 文档：AGENTS.md 与 pre-commit使用说明.md 计数 36→37 并新增 §2.25 详解；编号规范 §4.1 补两行、§8.1 落地记录、§8.2 规范与仓库偏差、§8.3 迁移批次记录	2026-10-21 09:33:54 +08:00

Author

SHA1

Message

Date

wandering1

ad87f979b1

docs(规约): 删除编号规范.md，生效规则并入文档规范 §7.1

用户裁定：docs/编号规范.md 在项目里已无意义，删除。

依据：该文 253 行里真正仍生效的只有两条规则（新条目一律不发编号、
人读文档存量编号继续清退）和一张存量族表；其余内容早有归属——两道
编号门禁的退役记录在 docs/门禁说明/id-check.md 与 id-check-new.md，
手工普查与恢复机器面在 scripts/archive/id_gate/README.md。留着就是
第二真相源，同一事实写在两处迟早漂移。

处理：
- docs/文档规范.md 新增 §7.1「条目与编号：一律不发」，承接规则、
  场景表、三条硬规矩、存量族表、已停发旧号族清单、不是编号的清单、
  清理动作与「没有机器门禁兜底」四段。
- 活跃引用 62 处逐条改指 §7.1 或归档 README：AGENTS.md 2 处、
  门禁说明三篇 18 处、其余文档 11 篇、代码与脚本 10 处、rename_maps
  七个 record 字段、.dsh/skills 四个文件 8 处。
- 归档区 107 处去掉 docs/ 前缀当纯文本提及；编号治理历史.md 45 处
  改为「原编号规范 §N」，避免被 doc-links 当自引用解析。
- 顺带修正 scripts/archive/id_gate/README.md 里仍称旧文为现行规范
  的表述。

门禁：check_doc_links --all --sections-strict 220 篇全通过、无法判定 0；
pre-commit 全 Passed。

2026-11-06 18:32:04 +08:00

wandering1

301c3e5183

feat(门禁): 编号门禁 id-check 落地（36→37 钩子）+ 批 1 编号单词化改名

新增门禁本体
- scripts/check_ids.py：实现 docs/编号规范.md §8 八项校验；默认 warn-only，
  唯一硬拦项是「可判定比例跌破基线」（防回退的本体）
- scripts/id_registry.json：66 个前缀族，逐项来自 §4 总表 + 全库实测游标，
  偏差一律写进 cursor_note，不凭记忆编造
- scripts/id_aliases.json：旧号 → 新号 / 作废标记（照搬 section_aliases.json 范式）
- 顺带收编 check_test_traceability.py：正则补齐大写后缀与无模块码形态，
  比对范围扩到 test/host 与 7 篇「单元测试说明.md」，另加 --board-only 回退旧口径

批 1 改名（用户授权解禁「不改写存量号」）
- 代码规范条款 S1~S19 → CODE-RULE-nn：78 处 / 2 文件
- UI 像素回归状态 S0~S7 → MENU-STATE-nn：61 处 / 3 文件（冻结在 07）
- 两族属主登记处 = 脚本自身的规则表 / STATES 表，文档只作引用方
- 新增 scripts/rename_ids.py（§7.3 规划脚本）：映射表驱动、显式 scope、默认干跑、
  自动写 scoped 别名，跳过 [示例]/[计划] 行与变更记录表，按原字节读写保 BOM 行尾
- 已应用映射表存档 scripts/rename_maps/batch1.json 作审计轨迹

有牙实测（证明门禁不是空转）
- 注入 Z-99 / 裸形 / 悬空 / 越游标 / 未紧邻 / 跨文档重复定义 六例，
  分别被校验 1/2/3/5/6/4 点名，--strict 退出码 1；临时档删除后工作树干净

验证与同步
- 可判定比例基线 82.3% → 82.7%（已 --update-baseline 入档）；错误级 1312 → 1291
- ci_local.py 全绿（L0 + L0.5 共 1104 断言）；ui-golden Passed；
  check_doc_links.py --all 无法判定 0
- 未改任何 C/H 源文件，故本次不需 @build
- 文档：AGENTS.md 与 pre-commit使用说明.md 计数 36→37 并新增 §2.25 详解；
  编号规范 §4.1 补两行、§8.1 落地记录、§8.2 规范与仓库偏差、§8.3 迁移批次记录

2026-10-21 09:33:54 +08:00

2 Commits