wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

fix(编号): 批 6 追溯器分档 + 板级 NET 用例号标注归一

Browse Source 
步骤 1：追溯器分两档（不改数据，改判据）
- BENCH：文档**定义行**（标题行或表格首格）带「（硬件层）」或其所属章节带的号 →
  人工台架用例，不期望有 C 代码载体；NOTIMPL：定义行标了未实现/待补/暂缓/已取消
- 两档**单列示数恒打印**、明细进 --verbose，不是静默豁免；也不等于"已验证"
- 两个实测坑写在脚本注释里：① 按"任意行出现即算"实现时 BENCH 收 14 个号却只消掉
  1 处差异（同一号被别处引用一次就复活）→ 改为只认定义行 + 从文档全集整体减档；
  ② 载体类型必须由定义处决定，引用行不影响判断
- 另把 has_intent() 收窄到同号所在行（原先整文件任意位置有人话就算过关）

步骤 2：板级 NET 用例标注归一（真债，改名 109 处 / 5 文件）
- 取证发现"文档声明却无载体"绝大多数是**标注形态烂**：实现体里写的是
  TC204 / TC-201 / TC 703 / TC1501 / TC1502b（三种畸形），文档写 TC-NET-204 等
- 序号一位不改、只补模块码（§7.1）；作用域限定 5 个真载体文件：
  test/board/ch395f_test_task.c(67) net_test_task.c(37) net_test_task.h(1)
  test/host/ch395f_socket_test.py(3) Drivers/BSP/CH395F/ch395f.c(1)
- 审计轨迹 scripts/rename_maps/batch6-net-annotate.json；别名自动登记（scoped）

实测
- DOC-ONLY 29 → 15：701~704 的 NET 层实现体一直存在（net_test_task.c），
  此前因裸形标注被误判成"未实现"；1501~1503 属硬件层人工 + 同样裸形
- 交集 260 不变、代码侧 578 不减（识别面没缩）；BENCH 14 个号 / NOTIMPL 1 个
- 台账 --prune-backlog 还清 6 条（只减不增）；@build 0 错误 0 警告
  （Program Size 与改前逐字节相同：Code=213356 RO=18580 RW=1184 ZI=131480
   → 证实只动了注释与日志串）；7 个改动文件 BOM/CR/U+FFFD 与 HEAD 逐项一致

剩余 15 处 DOC-ONLY 的组成（步骤 3 未完，下轮处理）
- 4 处文档侧无模块码形态（TC-1003/206/501/704）→ 属 ② 大批
- TC-NET-607 一条是历史指称（原文"原 607/608/609，现 701/702/703"）
- 真未实现 10 条：TC-NET-101/102/601/606/801/802/901/902/1006/1101
  ——其中 801/802/901/902 曾在 2026-08 的代码里有载体、后被重构丢掉，最值得补
This commit is contained in:
Wanderingss
2026-10-21 13:53:06 +08:00
parent 43fbfa140b
commit fca414102e
9 changed files with 478 additions and 146 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/id_aliases.json
+265 -1
View File
@@ -1,7 +1,7 @@
{
"schema": 1,
"generated_from": "docs/编号规范.md §7 迁移映射 + §4.3 冻结前缀；本表只登记**仓库里已实际出现**的旧字面量 → 现行字面量，不做尚未落地的批量改写（§7.2 阶段 1 一律保留存量）",
"note": "旧号引用不因本表而改写：本表只让门禁把「旧号引用」判成可解析（校验 3 悬空引用 / 校验 4 重复定义）。批量改写属 §9 阶段 1，须逐批 dry-run + 三重复核（§7.3）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。",
"note": "旧号引用不因本表而改写：本表只让门禁把「旧号引用」判成可解析（校验 3 悬空引用 / 校验 4 重复定义）。批量改写属 §9 阶段 1，须逐批 dry-run + 三重复核（§7.3）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。 带 scope 的条目只在所列文件内生效（同一裸形字面量可能属多族，全局别名会把真撞号洗成已解析）。",
"aliases": {
"N-31": {
"to": null,
@@ -2829,6 +2829,270 @@
"MDK-ARM/retracted_bench_20260922/README.txt",
"scripts/README.md"
]
},
"TC-201": {
"to": "TC-NET-201",
"status": "renamed",
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC-203": {
"to": "TC-NET-203",
"status": "renamed",
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC201": {
"to": "TC-NET-201",
"status": "renamed",
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC202": {
"to": "TC-NET-202",
"status": "renamed",
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC203": {
"to": "TC-NET-203",
"status": "renamed",
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC204": {
"to": "TC-NET-204",
"status": "renamed",
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC 701": {
"to": "TC-NET-701",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC 702": {
"to": "TC-NET-702",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC 703": {
"to": "TC-NET-703",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC 704": {
"to": "TC-NET-704",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC701": {
"to": "TC-NET-701",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC702": {
"to": "TC-NET-702",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC703": {
"to": "TC-NET-703",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC704": {
"to": "TC-NET-704",
"status": "renamed",
"note": "阶段 7 NET 层 TCP Client 用例 701~704（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC-1501": {
"to": "TC-NET-1501",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC-1502": {
"to": "TC-NET-1502",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC-1502b": {
"to": "TC-NET-1502b",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC-1503": {
"to": "TC-NET-1503",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC1501": {
"to": "TC-NET-1501",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC1502": {
"to": "TC-NET-1502",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC1502b": {
"to": "TC-NET-1502b",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
},
"TC1503": {
"to": "TC-NET-1503",
"status": "renamed",
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503（含 b 子项后缀，序号原样保留）（scripts/rename_ids.py 批：族 TC）｜旧号仅在本批 scope 内指向新号；scope 外同字面量属其它族，不受本条影响",
"scope": [
"test/board/ch395f_test_task.c",
"test/board/net_test_task.c",
"test/board/net_test_task.h",
"test/host/ch395f_socket_test.py",
"Drivers/BSP/CH395F/ch395f.c"
]
}
},
"id_aliases": {}