wandering1
f754d59218
分层：流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/， 顶层只留新增的目录导航 README.md（归层判据 + 硬约束 + 本次处置记录）。 - 搬迁 28 个路径：测试数据三个目录 58 个文件为纯改名（R100，内容逐字节不变） - 全库引用同步 124 个文件：AGENTS / docs 索引 / skills / 门禁注释 / scripts - 门禁面：scripts/check_test_traceability.py 的 glob 改 rglob （分层后不递归扫描＝追溯门禁直接瞎掉） - scripts/rename_ref.py：收尾的 ℹ 提示在 GBK 代码页抛 UnicodeEncodeError， 让进程以退出码 1 收场而改写其实已落盘（RC 与真实结果相反）；改为把 stdout/stderr reconfigure 成 UTF-8，与 check_doc_links.py 等同法 - docs/文档规范.md §1.1 补「子目录文件过多时再分一层」；§3.6 补 rename_ref 搬整目录的两个实测坑：① 会改写目录内部文件的内容 ② 内部文件的 ../ 出链 不补层级（本次 23 个被误改的证据文件已按 HEAD 原始字节逐字节还原） - docs/README.md §6 改为与六个子目录一一对应，并补登原先漏登记的 「启动日志原子性复验流程」一行 - .cubemx_survival_baseline.json：App/util/task_watchdog.c 的注释路径也随分层更新， 该文件是存活审计的 watchdog-module 漂移锚点，按脚本自己的提示跑 --write 重建基线 （实测重建后仅 watchdog-module 一条哈希变化） - 铁律 4 例外（本次在任务树里改了单写者文件）：AGENTS.md 与 .pre-commit-config.yaml 只被 rename_ref 改写路径字面量（后者全在注释行）， 任务表块与钩子声明一字未动 验证：check_doc_links.py --sections-strict 覆盖全部 88 个改动 .md 全绿； check_test_traceability.py 输出与主树逐行一致；196 个文本文件无 BOM、无新增 CR、无 U+FFFD、无行尾空白；陈旧引用面由主树 25 处降到 6 处（无新增断链）。
63 lines
3.2 KiB
Markdown
63 lines
3.2 KiB
Markdown
# test/ — 测试代码与主机端脚本
|
||
|
||
> 测试分两部分，**物理隔离**在两个子目录：
|
||
> - **`board/`** —— 板端测试套件（`.c/.h`，编入固件由 testTask 执行）
|
||
> - **`host/`** —— 主机端脚本（`.py`，PC 侧驱动板子并判读结果）
|
||
|
||
## 目录结构
|
||
|
||
| 目录 | 内容 | README |
|
||
|---|---|---|
|
||
| `board/` | 板端测试套件（编入 Keil 工程，占 RAM） | [`board/README.md`](board/README.md) |
|
||
| `host/` | PC 端测试/判读脚本（Python） | [`host/README.md`](host/README.md) |
|
||
| `run_all_suites.py` | **多套件回归编排**（改宏 → 构建 → 烧录 → 采集，`try/finally` 保证还原开关）；`--check-build` = 只编译不烧录（纯离机） | 本文 §多套件回归 |
|
||
|
||
## 运行方式
|
||
|
||
```bash
|
||
# @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` 溢出）
|
||
|
||
## 相关文档
|
||
|
||
- `docs/测试说明/流程与规范/测试开发标准流程.md` — 测试验证分层与门禁决策表
|
||
- `docs/测试说明/流程与规范/自动化测试流程.md` — `@test` 细节与失败模式
|
||
- 各模块测试指南：`docs/测试说明/板级测试/*_Test_Guide.md`
|
||
- `docs/测试说明/专项验证/链路延迟测试说明.md`
|