Files

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

board

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

2026-10-21 13:53:06 +08:00

host

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

2026-10-21 13:53:06 +08:00

README.md

串口采集/测试去重：删 tools/serial_tool 与 test/host run_boot_test/verify_log 副本，引用改指 .dsh/skills 串口 skill

2026-10-10 15:13:23 +08:00

run_all_suites.py

chore(注释): 清掉源码里不可检索的过程编码

2026-10-21 11:39:53 +08:00

README.md

test/ — 测试代码与主机端脚本

测试分两部分，物理隔离在两个子目录：

board/ —— 板端测试套件（.c/.h，编入固件由 testTask 执行）

host/ —— 主机端脚本（.py，PC 侧驱动板子并判读结果）

目录结构

目录	内容	README
`board/`	板端测试套件（编入 Keil 工程，占 RAM）	`board/README.md`
`host/`	PC 端测试/判读脚本（Python）	`host/README.md`
`run_all_suites.py`	多套件回归编排（改宏 → 构建 → 烧录 → 采集，`try/finally` 保证还原开关）；`--check-build` = 只编译不烧录（纯离机）	本文 §多套件回归

运行方式

# @test 一键闭环（推荐）
& '.venv\Scripts\python.exe' .dsh/skills/serial-boot-test/scripts/run_boot_test.py

# 单独校验日志
& '.venv\Scripts\python.exe' .dsh/skills/serial-boot-test/scripts/verify_log.py <日志文件>

# 多套件回归编排（需真机；自动改开关 + 构建 + 烧录 + 采集，结束后还原）
& '.venv\Scripts\python.exe' test/run_all_suites.py
& '.venv\Scripts\python.exe' test/run_all_suites.py --suites STORAGE,GD5F
& '.venv\Scripts\python.exe' test/run_all_suites.py --dry-run      # 只看计划

# 只编译不烧录（S6；不需要 MCU / 串口 / ST-LINK，验证 4 套件可编译性）
& '.venv\Scripts\python.exe' test/run_all_suites.py --check-build

退出码约定：0=PASS / 1=FAIL / 2=采集或烧录错误 / 3=用法或预检错误。

多套件回归（`run_all_suites.py`）

套件互斥（编译期 #error）意味着跑 4 个套件要手工循环 4 轮。本脚本把它编排成一条命令，并且无条件还原 test_config.h——跑完忘还原 = 测试固件进库，这是它存在的核心理由（与提交期门禁 test-suite-switch 互为独立防线）。

⚠️ 每轮要真机烧录 + 采集，4 套件约数分钟起；破坏性套件还会改设备持久状态。 仅回归窗口用，绝不挂 pre-commit。

--check-build 则相反：只改宏 + @build，不烧录不采集，无需任何硬件，用于防止 "测试套件长期编不过而无人知"（2026-08~09 CH395F 套件实例）。改动 test/board/ 下测试代码后建议先跑它——实测 4 套件均 BUILD_OK: 0 errors, 0 warnings。

⚠️ 注意

本目录被 pre-commit 门禁排除（测试代码不受 C 规范约束）
board/ 套件占用 RAM，启用前先核算预算（见 docs/内存管理/）
Keil 工程已同步：board/ 下 7 个 .c 编入 MDK-ARM/STM32F4-Demo.uvprojx， IncludePath 含 ../test/board；移动文件须同步改工程文件
套件选择开关：board/test_config.h 的 TEST_SUITE_*（互斥，一次只启用一个）
测试缓冲用分 Phase 复用静态缓冲（避免 L6406E 溢出）

README.md Unescape Escape

test/ — 测试代码与主机端脚本

目录结构

运行方式

多套件回归（run_all_suites.py）

⚠️ 注意

相关文档

README.md

多套件回归（`run_all_suites.py`）