Files

T

wandering1 557f1d042a docs(计数): 录波落地后的全仓计数同步（套数/钩子/黄金/菜单/字库）

机器面先定真值，再逐处对齐文档；带日期戳的取数行只加「当时」不改数。

六个数（每条两个以上独立机器源互证）
- 主机单测套数 41 → 44（find test/host -name run_unit_test.py / 覆盖率总闸 --list /
  基线 modules 条目三源一致；目录数 46 = 44 + common + __pycache__，两个数分开写）
- 有专属钩子 22 根（YAML 解析 -unit-test 后缀）⇒ 无专属钩子 19 → 22 套，并把
  wave_ring / wave_store / wave_trig 逐名列进门禁台账 §6 第 4 条，18 / 19 / 22 三个数
  改标「裁定当时 / 2026-10-28 / 2026-10-29 现值」
- 内容页黄金参考 60 → 66 张（simulator/tests/ref/shot_*.bin 实数 / PAGES 条目 66，
  其中 2 个分页 → 页面 64）；钩子显示名与门禁索引表成对改
- 菜单 42 → 43 行（9 菜单 + 34 叶）、已绑 28 → 30、未绑 4（ui_menu_tab.h 宏 +
  g_menu_tab[] 末行 / ui_page_registry.h 的 UI_PAGE_MAP_COUNT + #page= 计数剔示例行）
- 中文字库 218 → 224 唯一字、313 → 319 字形（清单唯一码点 / .bitmap_index 条目数
  含 notdef；224 + 95 = 319 成立）
- 钩子口径 52 声明 / 49 提交期实跑：只核不改，核对 AGENTS 与 YAML 解析一致

Lead 追加四处（wave-algo 按「AGENTS 只核不改」的指令交回我裁的部分）
- AGENTS.md 提交门禁节：41 套 → 44 套（两处）、19 套 → 22 套（两处，并把「与录波
  三套」写进括注）、ui-golden 条目 60 张 → 66 张；52 / 49 的口径叙述与历史括号原样
- scripts/board_ui_nav.py 的自述 docstring：60 张 → 66 张
- test/host/sys_log_mcu/sys_log_mcu_test.c 注释：全量门禁 41 套 → 44 套（纯注释）
- 产品需求 FR-UI-2：需求原文「42 节点」保留不动，在实现行注「2026-10-29 实到 43
  节点，42 是 V0.1 立项数」——需求基线不由实现方回改

刻意不动的（冻结面）
- 带日期戳的实测行（自动化测试流程、字库差集门禁、覆盖率口径里的 67 s / 25 s /
  45 s / ~105 s 四个耗时）、保留变更记录的文档历史行、页面补齐规划里自写「完成即
  冻结」的立项快照表、2026-10-28 那份分工说明、级联框总览.svg（42 节点时代所画，
  无生成器，重画另开一笔）、三处伪命中（字体数据行、芯片手册、m2/m3 数据目录）

自查（真实退出码）：check_doc_links.py --all RC=0（215 个文档、章节引用可判定 80 %，
合并后第一次全库零红）；check_generated_fresh.py RC=0（22 张图 17 一致 / 5 条既有
BASELINE 豁免，生成物零改动）；编号门禁 add 后复扫 RC=0；17 + 4 个改动文件字节体检
全绿（无 BOM / LF / 无 U+FFFD / 无尾随空白 / 单个尾换行）。

2026-10-29 20:04:24 +08:00

board

docs+scripts: 删除测试与架构专项文档并把引用改成就地口径

2026-10-28 22:00:34 +08:00

host

docs(计数): 录波落地后的全仓计数同步（套数/钩子/黄金/菜单/字库）

2026-10-29 20:04:24 +08:00

README.md

refactor(编号): test/host 与 App/Drivers 注释去测试层级号（73 站点 / 64 文件）

2026-10-28 17:52:55 +08:00

run_all_suites.py

chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打

2026-10-26 12:28:14 +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      # 只看计划

# 只编译不烧录（不需要 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`）