Files
STM32F4-Base/scripts/rename_maps/batch8-s-review-dead.json
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

199 lines
7.7 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": "批次四(2026-10-27 实测清点):复审残号 S-REVIEW + 两条无主死号的残留引用收口(删号留事实)",
"applied_by": "scripts/rename_ids.py --no-alias",
"record": "docs/编号规范.md §4.1.1(复审残号 S1~S14 / E-xx → 写条目本身)、§4.5、§7.3",
"note": "只清「号当标识用」的标注与待办用法;别名表**故意不写**:这些裸形(S1/S4/S5/S7/S9/S11)在 .c/.h 注释、.pre-commit-config.yaml 与在飞的 docs/测试说明/流程与规范/自动化测试流程.md 里还有活引用,写进别名表等于把那些残留一起洗成「已解析」(§4.1.1:部分死号故意不进别名表,好让门禁继续咬残留引用)。刻意不碰:① 属主登记处 docs/任务规划/测试与架构专项.md(§2.1 S12 定义行 + 首行指针;删行销项属 Ask-first);② 变更记录行与「原复审项 S4,已闭环」这类显式历史标注;③ 任何 .c/.h(改注释也要重跑 @build,本批零代码);④ 工作区里别人在飞的脏文件;⑤ 实机测试实施指南.md:5「(S7、A1~A4)」——A1~A4 与本文 A 表(前置检查 A2~A6)同形、语义待属主确认,按 §7.3 第 3 条不猜。",
"batches": [
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/链路延迟测试说明.md"
],
"old": "基线行为;可选优化 (?P<n>S7)(poll 前置 \\+ while 排空),低优先",
"new": "基线行为;可选优化(poll 前置 + while 排空),低优先",
"note": "§10.1 表行 D5:S7 是 uiTask 排空待办的死号"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/链路延迟测试说明.md"
],
"old": "其余待办 (?P<n>S9)(按键后立即取帧",
"new": "其余待办(按键后立即取帧",
"note": "§10.1 表行 D8:客户端待办死号"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/链路延迟测试说明.md"
],
"old": "^4\\. \\*\\*(?P<n>S1)\\*\\* 超时参数分档",
"new": "4. 超时参数分档",
"note": "§10.2 待办列表项 4"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/链路延迟测试说明.md"
],
"old": "^6\\. \\*\\*(?P<n>S4)\\*\\* 发送块配额与 MSS",
"new": "6. 发送块配额与 MSS",
"note": "§10.2 待办列表项 6"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/链路延迟测试说明.md"
],
"old": "^7\\. \\*\\*(?P<n>S5)\\*\\* 去掉一次 3200B 拷贝",
"new": "7. 去掉一次 3200B 拷贝",
"note": "§10.2 待办列表项 7"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/链路延迟测试说明.md"
],
"old": "^8\\. \\*\\*(?P<n>S7)\\*\\* uiTask:",
"new": "8. uiTask:",
"note": "§10.2 待办列表项 8"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/板级测试/实机测试实施指南.md"
],
"old": "堆低水位告警实测(P1-B / (?P<n>S11))",
"new": "堆低水位告警实测(P1-B)",
"note": "步骤表:保留 P1-B 档位词,去掉复审死号"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/板级测试/实机测试实施指南.md"
],
"old": "GD5F 错误通道回归(P2-A / (?P<n>S9))",
"new": "GD5F 错误通道回归(P2-A)",
"note": "步骤表:同上"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/板级测试/实机测试实施指南.md"
],
"old": "工程卫生(P3 / (?P<n>S5) \\+ S4 \\+ 待核实项)",
"new": "工程卫生(P3 + 待核实项)",
"note": "步骤表:S5+S4 两个死号同批去掉"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/板级测试/实机测试实施指南.md"
],
"old": "含新增 (?P<n>S5) `test-cppcheck`",
"new": "含新增 `test-cppcheck`",
"note": "步骤 7 出口判据里的钩子来源标注"
},
{
"family": "S-REVIEW",
"files": [
"docs/子系统设计/看门狗设计说明.md"
],
"old": "——原计划的 (?P<n>S1) 已降级",
"new": "——原计划的模拟器侧看门狗自检已降级",
"note": "§4.7:句子本身已写明是什么(模拟器不编译本模块)"
},
{
"family": "S-REVIEW",
"files": [
"docs/测试说明/专项验证/存储维护与容量恢复.md"
],
"old": "自检台账清零,重建 (?P<n>S7) 审计基线",
"new": "自检台账清零,重建联合判定审计基线",
"note": "§4.2 标题:S7 = 自检记录联合判定"
},
{
"family": "S-LDG",
"files": [
"docs/测试说明/测试数据/boot_log_data/README.md"
],
"old": "本流程立项:原 `../../任务规划/README\\.md` (?P<n>S-2)(2026-09-22 提出",
"new": "本流程立项:原 `../../任务规划/README.md` 的「启动日志固化流程」条目(2026-09-22 提出",
"note": "S-2 在别名表标 void(两义均死),短语取自别名 note"
},
{
"family": "E-AUD",
"files": [
"docs/测试说明/测试数据/m2_data/README.md"
],
"old": "(`--ftp-stress`,(?P<n>E-02) 复现)",
"new": "(`--ftp-stress` 复现)",
"note": "E-AUD 族无属主登记处(审计发现号)→ 删号留事实"
},
{
"family": "S-REVIEW",
"files": [
"scripts/check_test_traceability.py"
],
"old": "\"\"\"check_test_traceability\\.py - (?P<n>S4) 用例追溯校验",
"new": "\"\"\"check_test_traceability.py - 用例追溯校验",
"note": "脚本自述里的死号标注;下一行的「原复审项 S4,已闭环」是显式历史标注,保留"
},
{
"family": "S-REVIEW",
"files": [
".dsh/skills/serial-boot-test/scripts/verify_log.py"
],
"old": "自检记录联合判定((?P<n>S7),2026-10 实机窗口",
"new": "自检记录联合判定(2026-10 实机窗口",
"note": "skill 脚本文案"
},
{
"family": "S-REVIEW",
"files": [
".dsh/skills/serial-boot-test/scripts/run_boot_test.py"
],
"old": "自检台账联合判定((?P<n>S7)):默认",
"new": "自检台账联合判定:默认",
"note": "run_boot_test.py 流程注释"
},
{
"family": "S-REVIEW",
"files": [
".dsh/skills/serial-boot-test/scripts/run_boot_test.py"
],
"old": "干净台账,(?P<n>S7) 判 PASS",
"new": "干净台账 → 判定 PASS",
"note": "同上"
},
{
"family": "S-REVIEW",
"files": [
".dsh/skills/serial-boot-test/scripts/run_boot_test.py"
],
"old": "selftest\\.log \\((?P<n>S7)\\): missing/empty",
"new": "selftest.log: missing/empty",
"note": "argparse help 文案(纯 ASCII,无脚本按字面量读它)"
},
{
"family": "S-REVIEW",
"files": [
".dsh/skills/serial-boot-test/scripts/run_boot_test.py"
],
"old": "自检台账基线((?P<n>S7)「只看本次新增」)",
"new": "自检台账基线(只看本次新增)",
"note": "同上"
},
{
"family": "S-REVIEW",
"files": [
".dsh/skills/serial-boot-test/scripts/run_boot_test.py"
],
"old": "自检记录判定((?P<n>S7)):默认只判",
"new": "自检记录判定:默认只判",
"note": "同上"
}
]
}