super_agent_bot
9608b7a8ea
真机台架被断电和断线卡住，这一段只推进纯软件侧：把 UDP 数据面的随机序列
扫起来，并修掉随机长跑逼出的两条"测法自误"。
- ns_s7_udp.c 新增 UDP-24：固定种子 20261104 的 240 轮随机交互，每轮随机
载荷长度 1~112（112 = 假件收包流 128 B 上限减 8 字节信息头）、源端口、
源 IP、SERVER/CLIENT 形态、显式对端 sendto 与按记账对端 sendto，每 17 轮
close + 重 bind 一次。断言收在六族不变量上（长度等于芯片宣布值、既不吞
信息头也不丢真字节、源地址按形态分别取自表头/对端记账、udp_mode 与命令
一致、close/重 bind 后出参槽与挂起槽不残留、每次 sendto 交给芯片恰好 len
字节），并要求 ≥90% 轮次端到端干净（实测 240/240）。
- 长跑逼出的两处都是测法问题，不是被测码 bug，但只有长跑才逼得出：
1) 连续 sendto 不注入 SENBUF_FREE 时，第二次发送会合法转挂起，而本套的
挂起 send 替身从不完成，于是 FATAL 掐死整套件（连汇总行都没有）。改法
照 440i/440j：set_sint_sticky(SENBUF_FREE) + push_glob + g_ns_int_pin_set=0，
注释点名 TRAP-NET-04，背靠背发送的真机面留给 TC-NET-1609。
2) 假件 ch395f_get_recv_len 是"按调用序号取、耗尽后重复最后一个"的脚本且
容量有限，240 轮只追加不清空，序号撞满容量后每轮读到同一个陈旧长度
（症状：len 在随机而 n 恒为 28，前 24 轮全绿，最容易误判成产品 bug）。
补加法助手 ch395f_fake_reset_recv_len(sock)，只归零该 sock 的脚本长度与
序号，既有单轮用例不调用它、行为一字未变。
- 覆盖率口径第 4 轮同步：用例面记到 24 组、全套 654/654（改造前 470），
新增一条"随机长跑逼出两条测法自误"的教训（长跑对假件的第一要求是
状态可重排，不是能追加）。
验证：net_socket 套件 654/654 绿；全量覆盖率 47/47 退出码 0，net_udp.c
237/239 行 99.2%、14/14 函数，net_socket.c 966/969 行 99.7%、59/59 函数，
总行 8372/9290（90.1%），无 REGRESS；cppcheck（--hook-stage manual）退出码 0；
check_doc_links --all 通过（213 个文档，无法判定 0）；pre-commit 对本批文件
全绿。基线 JSON 无变化（本轮只加测试，未动生产码），故不随本提交改动。
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 = 只编译不烧录（纯离机） |
本文 §多套件回归 |
运行方式
# /serial-boot-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 则相反：只改宏 + /keil-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—/serial-boot-test细节与失败模式- 各模块测试指南：
docs/测试说明/板级测试/*_Test_Guide.md docs/测试说明/专项验证/链路延迟测试说明.md