docs(门禁): 主机侧单测覆盖面改写成口径陈述,第三处计数不同源一并修

「22 根专属钩子」是**口径**不是缺口:test/host 实测 42 个目录去掉 common/__pycache__
= 40 套带 run_unit_test.py,配置里带 -unit-test 后缀的只有 22 根 ⇒ 其余 18 套
(含 ui_sink、console_log、net_socket、lftpd 三兄弟、sys_log_mcu、iec104_serv、
task_prof…)没有独立 files: 触发面,但每次提交都被 test-coverage 总闸全量真跑,
失败照样拦——执行面无洞的证据核到源码:check_test_coverage.py:134 用 rglob 发现
全部 40 套,:44-46 的退出码语义写死「有单测失败即 1」。缺的只是秒级归因。

补钩子的判据也现成:pre-commit 4.x 移除了 always: true,没有 files: 触发面就等于
永不跑,所以**不能**靠"补第 23 根"解决,要补就得先给该模块划触发面。

顺带查出同类的第三处不同源(也在 docs/门禁说明/ 内):host-unit-tests.md 自己还写
着「16 个钩子 / 另有 12 套 / 总闸跑 28 套」,三个数全部过期,已改成 22 / 18 / 40,
§1 表补齐 2026-10-25 增补的六行,§6 第 4 条重写成覆盖面台账,§9 留变更记录。
另用 git log -S 核实原句「23 个 / 含 ui-sink 七个」是双重错:ui-sink-unit-test、
iec104-serv-unit-test、console-log-unit-test 在配置历史里**从未存在**过。
页数不变(26 篇),钩子数不变(声明 50 / 实跑 50 / 专属单测钩子 22)。
This commit is contained in:
2026-10-26 19:27:01 +08:00
parent 7d9db33a25
commit 0f8b88337e
3 changed files with 34 additions and 12 deletions
@@ -160,6 +160,8 @@ test/host/cfg_file/cfg_file_test.c
| **TC-CONFIG-053** | 变更后重载 + 挂回调段差异触发回调 | 变更响应 |
| **TC-CONFIG-055** | `(size, mtime)` 令牌不变 → 不重载(令牌 = 变更信号) | 令牌契约 |
| **TC-CONFIG-054** | poll 检出超长 → 工厂默认 + 重建模板 + 留痕;**不触发回调** | 在线修复通道保留 |
| **TC-CONFIG-056** | `[comm]` 段容量钉:段数上限 8、键数上限 16 写进断言(改上限必须同批改本行与用例) | 段/键上限是配置引擎的公开契约,不能靠"跑起来看看" |
| **TC-CONFIG-057** | 段/键写满后再新增 → 拒绝保存且原文件不动(满则拒,不是静默截断) | 溢出语义与 TC-CONFIG-043 同源,覆盖 `[comm]` 新增段 |
**当前结果**:139/139 PASSED(`failed=0`)。