Files
STM32F4-Base/scripts/rename_maps/batch6-net-annotate.json
T
wandering1 fca414102e fix(编号): 批 6 追溯器分档 + 板级 NET 用例号标注归一
步骤 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 的代码里有载体、后被重构丢掉,最值得补
2026-10-21 13:53:06 +08:00

62 lines
2.4 KiB
JSON
Raw 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": "批 6(2026-10-21 板级 NET 用例号标注)",
"applied_by": "scripts/rename_ids.py",
"record": "docs/编号规范.md §8.3",
"note": "追溯器分档后暴露的真问题:板级 NET 用例的**实现体里标的是裸形**(TC204 / TC-201 / TC1501 / TC1502b…),文档侧写的是合规号 TC-NET-204 等 → 双向追溯对不上,看上去像「文档声明了没实现」,实际是**标注形态烂**。本批只补模块码、序号一位不改(§7.1),作用域限定 5 个真载体文件;改完 @build 验证(改到 test/board 与 Drivers/BSP/CH395F 注释)。刻意不含别的模块(host 侧 TC-00x 那批属另一个模块,另批处理)。",
"batches": [
{
"family": "TC",
"old": "\\bTC[- ]?(?P<n>20[1-4])\\b",
"new": "TC-NET-{n}",
"files": [
"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"
],
"note": "阶段 2 芯片层 TCP Client 用例 201~204 的裸形标注"
},
{
"family": "TC",
"old": "\\bTC[- ]?(?P<n>70[1-4])\\b",
"new": "TC-NET-{n}",
"files": [
"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"
],
"note": "阶段 7 NET 层 TCP Client 用例 701~704"
},
{
"family": "TC",
"old": "\\bTC[- ]?(?P<n>15\\d{2}b?)\\b",
"new": "TC-NET-{n}",
"files": [
"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"
],
"note": "阶段 15 自愈驱动原语 1501/1502/1502b/1503(含 b 子项后缀,序号原样保留)"
},
{
"family": "TC",
"old": "\\bTC[- ]?(?P<n>60[16]|80[12]|90[12]|1006|110[01])\\b",
"new": "TC-NET-{n}",
"files": [
"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"
],
"note": "阶段 6/8/9/11/12 的 601/606/801/802/901/902/1006/1100/1101 裸形(有则补,无则 0 命中)"
}
]
}