wandering1
794906cdc8
P2 五个文件全部进分母（三名队友并行，写范围互斥、零越界）：
net_socket 420 条 / 881-883=99.8%、52-52 函数（S1~S6 分片）
sys_log_mcu 75 条 / 310-313=99.0%、12-12
console_log 104 条 / 188-189=99.5%、15-15
cfg_file_store_mcu 34 条 / 97-97=100%、10-10
soe_store 26 条 / 78-79=98.7%、4-4
合计 659 条断言，P2 本体 1554-1561=99.6%、93-93 函数。
账：套件 28→33 全绿；files_tested 32→37；未触及 112→107（.c 34→29，
恒等式 29 = 0(P1剩) + 0(P2) + 29(P3) 咬合，§9 终点判据达成）；分母
4684→6245 插桩行；line 85.8%→89.3%；func 90.1%→92.2%（这批 5 个文件
全都以 ≥98.7% 进分母，故未摊薄）。--update-baseline 前后逐文件比对：
下降 0 个文件。
基建：新建 test/host/common/fatfs_fake.{h,c}（以真实 ff.h 为声明源、只
定义三文件实际调用的 9 个 f_*，缺哪个链接期响；卷忙/短写/FR_DENIED
可注入；短名违规分档）；扩展 ch395f_fake 为纯新增（g_fx/g_fxchip 另开
一份世界 + ext_reset 挂进既有复位，既有三套面一字不动），并按真头修正
两个错值常量（SOCKET_OPEN 0x01→0x05、TCP_ESTABLISHED 0x05→0x04），
另在 net_socket runner 加真头/假件同名常量文本核对闸（负例验证过）。
存量回归：net_listener 34、net_events 34、net_pending 43、net_select 22、
nand_port 149、lftpd_io 33、vol_lock 33、soe 32、cfg_file 151 全绿。
编号：补 TC-HOST-{NETSOCK,SYSLOG,CFGFST,SOESTORE,CONLOG} 五族（22→27，
先补族再引号）；net_socket 模块码由自取的两字母 NS 正名为 NETSOCK；
id-check 增量拦截无台账外新账，可判定比例 83.27%（基线 82.6%）。
文档：覆盖率口径 §9 新增「P2 落地」（含两套分母口径差、10 条现状表、
12 条可复用手法与并发红线），§8 第 1 条改「清单已吃穿」，补变更记录。
本提交未改任何生产代码（App/Drivers/Src/Lib/MDK-ARM 零触碰）。
10 条现状已逐条登记在 §9（含 sys_log_mcu.c:509~537 卷忙整批丢日志、
net_socket.c 同文件两套 IP 字节序、UDP 两 API 绕过 netTask），已获指示
全部修复，另开一轮（含测试字面量统一纯 ASCII）。
gate: pre-commit run --all-files → 39 hooks, 38 Passed; only mem-numbers
Failed（本工作树从未 @build，无 .map 事实源，属分支期已知陷阱）；
mem-budget Passed；test-coverage 与 id-check Passed。RAM/Flash 增量 = 0
（纯测试批次）。按仓内分支约定走 --no-verify，台账回填留待主树合并后。
test/host/common/ — 主机侧测试公共库
L0.5 主机侧单元测试的通用 harness：被各模块的单测运行器共享， 集中承载工具链探测与编译/运行/判定的公共细节。
文件一览
| 文件 | 作用 |
|---|---|
unit_test_harness.py |
通用单测 harness（纯标准库）：探测本机 MSVC → 拼 INCLUDE/LIB → 编译测试单元 → 运行 → 判定退出码 |
为什么要有这层（2026-10-01 抽取，T-3）
看门狗单测最早的运行器（test/host/watchdog/run_unit_test.py）把工具链探测、
INCLUDE/LIB 拼接、GBK 解码、/wd4819 抑制、退出码契约全写死在模块目录内。
第二个 L0.5 单测出现时须整段复制——工具链细节一旦修正（新增 VS 版本、SDK 布局
变化、编码处理调整）就会发散。抽取后各模块运行器只剩"声明式"配置。
边界：harness 不认识任何模块——源码路径、桩目录、额外 include、断言 汇总行特征全部由调用方传入。新单测只写一个
TestBuild(...)+ 一行sys.exit(...)。
用法（模块侧 run_unit_test.py 模板）
import os, sys
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
from unit_test_harness import TestBuild, run_host_unit_test
BUILD = TestBuild(
name="<模块名> Tests", # 人类可读名（打印用）
src=os.path.join(HERE, "<模块>_test.c"), # 测试单元（内部 #include 生产源）
include_dirs=[ # 顺序敏感：桩目录必须在生产目录之前
os.path.join(HERE, "stub"),
os.path.join(ROOT, "App", "util"),
HERE,
],
summary_marker="=== <模块名> Tests:", # 运行输出中必须出现的汇总行前缀
)
if __name__ == "__main__":
sys.exit(run_host_unit_test(BUILD))
另一写法（不落 run_unit_test.py，直接内联）：
from unit_test_harness import TestBuild, run_host_unit_test
raise SystemExit(run_host_unit_test(TestBuild(name="...", src="...", ...)))
退出码契约（各模块运行器统一遵循）
| 码 | 含义 |
|---|---|
0 |
PASS——编译 + 运行成功，且日志含 summary_marker |
1 |
FAIL——有测试用例未通过 |
2 |
环境错误——找不到编译器 / 编译失败 / 未产生汇总行 |
TestBuild 字段
| 字段 | 必填 | 说明 |
|---|---|---|
name |
✓ | 打印用名称；同时用于派生 exe 名与 obj 目录名 |
src |
✓ | 测试单元 .c 的绝对路径（内部 #include 生产源，保证测的是真代码） |
include_dirs |
/I 目录列表；桩目录需排在前面才能覆盖真实头 |
|
summary_marker |
运行输出中必须出现的汇总行前缀；空 = 不校验 | |
extra_flags |
追加的 cl.exe 开关 |
|
exe_name / obj_tag |
覆盖派生的产物名 / 中间目录名（默认由 name 派生，落在系统 temp） |
环境要求
同 L0.5 通用要求（见 ../../../docs/测试说明/测试开发标准流程.md §4.2）：
MSVC cl.exe（装了 VS 即有）+ Windows SDK + 纯标准库 Python；不调 vcvars64.bat
（内部 reg.exe 受限），直接拼环境变量调 cl.exe。
⚠️ 注意
- 本目录在 pre-commit 的 cppcheck / 代码规范排除范围（
test/豁免） - 改动本 harness 会触发
watchdog-unit-test钩子（files正则已含本文件）