wandering1
ad87f979b1
用户裁定：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。
54 lines
2.4 KiB
JSON
54 lines
2.4 KiB
JSON
{
|
||
"schema": 1,
|
||
"batch": "批 3-Trap（2026-10-21）",
|
||
"applied_by": "scripts/rename_ids.py",
|
||
"record": "当时的编号规范 §8.3 / §7.1",
|
||
"note": "陷阱号统一为 TRAP-<模块码>-<nn>：数字不变、只补模块码（§7.1）。作用域按文件切分，因为同一空格形在不同文件里指向不同族的属主文档——GD5F 的属主是 GD5F2GQ5UE_Trap_Records.md，README.txt/scripts/README.md 里的 Trap 21/19 指向 CH395F_Trap_Records.md（NET 域），SD2506 的中文形按 §4.2 归 RTC 域。刻意不改：docs/环境与部署/并行任务工作树方案.md:39 的 wip/trap22-fix 是分支名不是编号；docs/UI设计/菜单页面设计.md:501 的「§8.2 陷阱 1」是本文小节内第 1 条（另走平实语言改写）；:896 是变更记录行（§8.1 冻结不改写）。",
|
||
"batches": [
|
||
{
|
||
"family": "TRAP",
|
||
"old": "\\bTrap (?P<n>\\d{2})\\b",
|
||
"new": "TRAP-GD5F-{n:02d}",
|
||
"files": [
|
||
"docs/问题记录/GD5F2GQ5UE_Trap_Records.md",
|
||
"docs/问题记录/项目审查与优化建议报告.md",
|
||
"docs/测试说明/板级测试/GD5F2GQ5UE_Test_Guide.md",
|
||
"Drivers/BSP/GD5F2GQ5UE/gd5f2gq5ue.c",
|
||
"Drivers/BSP/GD5F2GQ5UE/gd5f2gq5ue.h",
|
||
"Drivers/BSP/GD5F2GQ5UE/nand_ftl.c",
|
||
"test/board/gd5f_test_task.c",
|
||
"test/board/storage_test_task.c"
|
||
],
|
||
"note": "GD5F 存储域：Trap 01~07 → TRAP-GD5F-01~07（属主文档 7 个标题行为定义位，其余为引用）"
|
||
},
|
||
{
|
||
"family": "TRAP",
|
||
"old": "陷阱 (?P<n>\\d{2})\\b",
|
||
"new": "TRAP-GD5F-{n:02d}",
|
||
"files": [
|
||
"docs/测试说明/板级测试/GD5F2GQ5UE_Test_Guide.md"
|
||
],
|
||
"note": "同一属主的中文形「见陷阱 01」→ 与空格形合并成同一个号"
|
||
},
|
||
{
|
||
"family": "TRAP",
|
||
"old": "陷阱 (?P<n>\\d{1,2})\\b",
|
||
"new": "TRAP-RTC-{n:02d}",
|
||
"files": [
|
||
"docs/问题记录/SD2506_Trap_Records.md"
|
||
],
|
||
"note": "SD2506（RTC 芯片）域：陷阱 1 → TRAP-RTC-01（§4.2 该域按 RTC 编号）"
|
||
},
|
||
{
|
||
"family": "TRAP",
|
||
"old": "\\bTrap (?P<n>\\d{1,2})\\b",
|
||
"new": "TRAP-NET-{n:02d}",
|
||
"files": [
|
||
"MDK-ARM/retracted_bench_20260922/README.txt",
|
||
"scripts/README.md"
|
||
],
|
||
"note": "NET（CH395F）域：Trap 21 → TRAP-NET-21、Trap 19 → TRAP-NET-19；两处引用的都是 CH395F_Trap_Records.md 这个活登记处，号本身不变"
|
||
}
|
||
]
|
||
}
|