Files
wandering1 f754d59218 docs(测试说明): 按用途分六个子目录并同步全库引用
分层:流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/,
顶层只留新增的目录导航 README.md(归层判据 + 硬约束 + 本次处置记录)。

- 搬迁 28 个路径:测试数据三个目录 58 个文件为纯改名(R100,内容逐字节不变)
- 全库引用同步 124 个文件:AGENTS / docs 索引 / skills / 门禁注释 / scripts
- 门禁面:scripts/check_test_traceability.py 的 glob 改 rglob
  (分层后不递归扫描=追溯门禁直接瞎掉)
- scripts/rename_ref.py:收尾的 ℹ 提示在 GBK 代码页抛 UnicodeEncodeError,
  让进程以退出码 1 收场而改写其实已落盘(RC 与真实结果相反);改为把
  stdout/stderr reconfigure 成 UTF-8,与 check_doc_links.py 等同法
- docs/文档规范.md §1.1 补「子目录文件过多时再分一层」;§3.6 补 rename_ref
  搬整目录的两个实测坑:① 会改写目录内部文件的内容 ② 内部文件的 ../ 出链
  不补层级(本次 23 个被误改的证据文件已按 HEAD 原始字节逐字节还原)
- docs/README.md §6 改为与六个子目录一一对应,并补登原先漏登记的
  「启动日志原子性复验流程」一行
- .cubemx_survival_baseline.json:App/util/task_watchdog.c 的注释路径也随分层更新,
  该文件是存活审计的 watchdog-module 漂移锚点,按脚本自己的提示跑 --write 重建基线
  (实测重建后仅 watchdog-module 一条哈希变化)
- 铁律 4 例外(本次在任务树里改了单写者文件):AGENTS.md 与
  .pre-commit-config.yaml 只被 rename_ref 改写路径字面量(后者全在注释行),
  任务表块与钩子声明一字未动

验证:check_doc_links.py --sections-strict 覆盖全部 88 个改动 .md 全绿;
check_test_traceability.py 输出与主树逐行一致;196 个文本文件无 BOM、无新增
CR、无 U+FFFD、无行尾空白;陈旧引用面由主树 25 处降到 6 处(无新增断链)。
2026-10-30 07:16:07 +08:00

54 lines
2.4 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"schema": 1,
"batch": "批 3-Trap(2026-10-21)",
"applied_by": "scripts/rename_ids.py",
"record": "docs/编号规范.md §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 这个活登记处,号本身不变"
}
]
}