wandering1
4a09d4c63f
待发条目 syslog_entry_t 原为 {id, const char *desc}，只存调用方指针，
隐含「desc 必须活到落盘」的契约，但契约既未写进 sys_log.h、也无机械
检查。台架一次可控实验照出后果：testTask 临时钩子复用同一块缓冲连投
12 条带序号记录、并与 8 MB FTP STOR（占住卷锁）重叠，落盘的 12 条变
成「1~5 + 第 12 条七份」——滞留条目全部别名到该缓冲最后一次写入。
叠加卷忙整批回投（条目可滞留到卷空闲），投栈缓冲即成悬垂读。
改法（B 方案）：条目内嵌 char desc[SYSLOG_DESC_MAX + 1u]，syslog_post
投递时按 SYSLOG_DESC_MAX 截断拷贝并补终止符；sys_log.h 参数说明同步
写明「投递即拷贝、不要求生命周期覆盖到落盘」。
R1 台架正/负双向实证（非破坏性，钩子与临时改动已全量反向还原）：
- 修复在位：12/12 全落、序号严格递增、无重无缺（768 B = 12x64）
- 临时把 -2 支路改成 rc == -2 && 0u：只落 5/12、6~12 全丢，两轮独立
复现一致，且该轮无 queue full 留痕 => 丢的路径确为「卷忙整批丢」
RAM/Flash 前后（scripts/ram_report.py 同口径，同一 .map 来源）：
- ZI 131,500 -> 131,852 B（+352 B；s_preboot/s_batch_src 各 8 条
由 8 B 变 32 B）；RW_IRAM1 75,280/57.4% -> 75,632/57.7%
- Code 213,720 -> 213,780 B（+60 B）；RW 1,204 B 不变
- RW_CCM 静态不变（57,376 B / 87.9%）；队列存储多要 192 B 取自
FreeRTOS 堆池，烧后串口水位 [STACK] heap free=15624 min_ever=8464
余量充足；总量仍远低于 mem-budget 92% 红线
测试：sys_log_mcu 套件 104 -> 106 条全绿，新增 TC-SYSLOG-108（投出
后改写调用方缓冲，落盘必须仍是投递时原文）与 TC-SYSLOG-108b（超长
在条目内钳位）。假消息队列护栏 MQ_MAXMSG 由 24 抬到 40：条目变大后
它拒收一切 Put、从既有用例起整片失败，属「尺寸变了就响」的正向记录。
主机侧此前照不出该类问题，是因为用例传字面量、静态存储期无限。
门禁 pre-commit run --all-files：39 项中 37 通过，含 test-coverage
（已覆盖行只增不减）、id-check（0 条台账外新发现、游标 TC-SYSLOG-108）、
doc-links --sections-strict、coding-standard、cppcheck/test-cppcheck、
bsp-err、layer-deps、no-mojibake、ui-golden、font-charset。仅
mem-numbers 与 mem-budget 失败：docs/内存管理/ 受管台账仍记改前
131,500/213,720。按分支约定不在分支上 --write 受管台账，留待合回
主干时统一回填，故 --no-verify 提交。
真机：产品构建 0 错 0 警告，重烧 + 回读校验 OK（suite=NONE dstr=off）、
启动标记齐全、无 [ERR]、VERDICT PASS。
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溢出）
相关文档
docs/测试说明/测试开发标准流程.md— L0~L3 分层与门禁决策表docs/测试说明/自动化测试流程.md—@test细节与失败模式- 各模块测试指南：
docs/测试说明/*_Test_Guide.md docs/测试说明/链路延迟测试说明.md