Files

T

wandering1 4a4ad6bc5f chore(全仓): @build/@test 旧文档别名清退为技能调用名

现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名，
不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。

- AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改
  「编译（/keil-build）」「串口回归（/serial-boot-test）」
- keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree
  方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围）
- 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入
  等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子

验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all
rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52
钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。

2026-10-30 13:03:12 +08:00

2.7 KiB

Raw Blame History

test/board/ — 板端测试套件

⚠️ 编入固件的测试代码（由 testTask 执行）。这些 .c 已注册到 Keil 工程 MDK-ARM/STM32F4-Demo.uvprojx，占用 MCU 的 RAM/Flash。

文件一览

文件	测试对象 / 作用
`test_config.c/h`	测试任务配置：`TEST_SUITE_*` 套件选择开关（互斥）+ `ENABLE_DESTRUCTIVE_TESTS`
`test_common.h`	公共断言内核：`test_stats_t` + `TEST_CHECK_IMPL`/`TEST_REPORT_IMPL`；各套件用一行宏绑定自身统计变量
`ch395f_test_task.c/h` + `ch395f_test.h`	CH395F 以太网（硬件层 Phase 1~~5 / NET 层 Phase 6~~11）
`gd5f_test_task.c/h` + `gd5f_test.h`	GD5F2GQ5UE SPI NAND 存储
`sd2506_test_task.c/h` + `sd2506_test.h`	SD2506 RTC
`storage_test_task.c/h` + `storage_test.h`	存储性能
`net_test_task.c/h`	网络层测试
`net_latency_test.c/h`	链路时延探针（DWT CYCCNT 时基，MCU 专属）

⚠️ 构建约束（`AGENTS.md` 详述）

套件互斥：test_config.h 的 TEST_SUITE_CH395F/STORAGE/GD5F/RTC 一次只能启用一个（违反则 #error）；全部注释 = 产品构建
⚠️ 测试固件不得静默提交：TEST_SUITE_* 开关受 pre-commit 钩子 test-suite-switch 门禁——默认要求全部注释。跑完套件回归务必改回产品构建再提交（2026-10-01 实测已提交 HEAD 里 TEST_SUITE_CH395F 就是开启状态，纯靠人记得改；故补此门禁）。确需提交测试构建时用 ALLOW_TEST_BUILD=1 git commit ... 或 python scripts/check_test_suite.py --allow-test-build 显式放行
破坏性用例默认关闭：ENABLE_DESTRUCTIVE_TESTS（默认注释）控制写/擦 NAND、格式化、坏块注入。关闭时为只读模式（横幅 mode: READ-ONLY），可随时在在用设备上跑
⚠️ 实测一轮破坏性 GD5F 运行即让 dhara 多记一个坏块（容量下降且需全片擦除恢复）—— 只在产线首启或明确需要时打开
CH395F 套件：硬件层与 NET 层模式互斥
总线独占：CH395F 硬件层模式下 netTask 自挂起，testTask 独占 CH395F

添加新测试套件

在 test_config.h 加开关（并入互斥 #error 检查）
新建 <模块>_test_task.c/h
注册进 Keil 工程（<FilePath>..\test\board\xxx.c</FilePath>）
跑回归：/serial-boot-test（.dsh/skills/serial-boot-test/scripts/run_boot_test.py）

2.7 KiB Raw Blame History Unescape Escape

test/board/ — 板端测试套件

文件一览

⚠️ 构建约束（AGENTS.md 详述）

添加新测试套件

相关文档

2.7 KiB

Raw Blame History

⚠️ 构建约束（`AGENTS.md` 详述）