#!/usr/bin/env python3 # -*- coding: utf-8 -*- """IEC 104 真实回环验收门禁包装器(manual 阶段专用)。 为什么要这根钩子(2026-11-18): `test/host/iec104_dtu/` 下有两个 runner,但**只有** `run_unit_test.py` 会被 `scripts/check_test_coverage.py` 的 `rglob("run_unit_test.py")` 发现,而它只跑 7 条 decoder/oracle 用例;真正的产品验收 `run_tcp_test.py`(13 条真实 TCP 回环) 一直**没有**被任何门禁登记。结果是覆盖率表里 `iec104_dtu` 赫然在列, 却让人误以为"104 的验收已经被门禁覆盖了"——这是最容易骗人的那种假象。 本钩子把那 13 条接进门禁,把假象补成真话。 为什么是 `stages: [manual]` 而不是提交期自动跑: 实测全量 14.5 s(把 `--sbo-timeout` 从 30 s 降 2 s 之后;新增 2 条标准参数 用例各约 0.3 s),仍在本仓 "2~4 秒自动门禁"判据之外(见 .pre-commit-config.yaml 里 cppcheck 那段的口径: 一个逼人 --no-verify 的门禁等于没有门禁)。故与 cppcheck / test-coverage 同档, 只在 `scripts/ci_local.py` 的 manual 段与手工复跑时执行。 为什么远端 CI 跑不了它: `.gitea/workflows/ci.yml` 不构建模拟器(grep `lvgl_sim|build_sim|simulator` 零命中), 而本钩子需要 `simulator/build/Debug/lvgl_sim.exe`。所以它在远端只能靠 "本机有构建产物"这一前提,**远端 CI 不跑它**;这也是它没有进提交期自动门禁的 第二个理由。缺 exe 时本脚本**显式 FAIL 并给出可执行提示,不"跳过当通过"** (与 uinav-selftest 的缺帧教训同一条:跳过即绿灯,绿灯即遗忘)。 被包装脚本不吃文件参数: pre-commit 会把本次变更的文件名传给钩子,而 `run_tcp_test.py` 是按"整套 13 条用例" 工作的、不接受文件参数,故本包装器**有意忽略** argv(与 check_ui_golden.py 同形)。 本地手工复跑: & '.venv\\Scripts\\python.exe' scripts/check_iec104_tcp.py 或只跑一根用例:`python test/host/iec104_dtu/run_tcp_test.py --exe --only test_link_start` """ import os import subprocess import sys ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) BUILD_BAT = os.path.join(ROOT, 'simulator', 'build_sim.bat') EXE = os.path.join(ROOT, 'simulator', 'build', 'Debug', 'lvgl_sim.exe') # 能力档位边界(2026-11-18 实测,必读):本钩子调 `build_sim.bat`,编出的是 # **vendor 默认容量**(RX 2048 / HIGH 1024 / NORMAL 4096 / RECORD 32 / EVENT 68), # 不是产品固件实际使用的 P6a 档(RX 256 / HIGH 288 / NORMAL 272 / RECORD 4 / EVENT 11)。 # 因此本钩子证明的是"协议栈在默认容量下行为正确",**不证明 P6a 档**。P6a 的证据是 # `ci-artifacts/iec104-cutover/build_sim_p6a.ps1`(独立 build-p6a 目录注入 5 个宏) # 加同一 runner 的 13/13 PASS。两者的用例集相同、容量档不同,别拿这一份当另一份。 RUNNER = os.path.join(ROOT, 'test', 'host', 'iec104_dtu', 'run_tcp_test.py') OUTPUT = os.path.join(ROOT, 'ci-artifacts', 'iec104-tests', 'tcp-gate') PY = sys.executable def run(cmd): """执行一条命令,透传输出,返回退出码。 参数:cmd - 命令列表 list[str] 返回值:子进程退出码 int """ return subprocess.call(cmd, cwd=ROOT) def main(): """先增量构建模拟器,再跑 13 条真实 TCP 回环验收。 返回值:0 - 全部用例通过 1 - 构建失败或用例失败 2 - 环境错误(没装 VS / 工具链探测失败),与 pre-commit 的 2 号语义一致 """ print('[iec104-tcp] 增量构建模拟器 ...') rc = run([BUILD_BAT]) if rc == 3: print('[iec104-tcp] 环境错误:模拟器构建找不到 VS 工具链(build_sim.bat 返回 3)。') print('[iec104-tcp] 这是环境问题、不是本改动的问题;装好 VS 2019/2022/2026 后重跑,') print('[iec104-tcp] 或临时 SKIP=iec104-tcp 提交(远端 CI 不构建模拟器,本就跑不了这根)。') return 2 if rc != 0: print('[iec104-tcp] FAIL 模拟器构建失败(build_sim.bat 返回 %d),无法做回环验收' % rc) return 1 if not os.path.exists(EXE): print('[iec104-tcp] FAIL 构建成功但没找到 %s' % os.path.relpath(EXE, ROOT)) print('[iec104-tcp] 这说明构建产物布局变了(build_sim.ps1 的 $Config 默认 Debug),') print('[iec104-tcp] 请核对后同步本脚本的 EXE 常量 —— 不跳过、不当作通过。') return 1 print('[iec104-tcp] 跑 13 条真实 TCP 回环验收 ...') rc = run([PY, '-B', RUNNER, '--exe', EXE, '--output', OUTPUT]) if rc == 0: print('[iec104-tcp] PASS 13/13 真实 TCP 回环用例通过(证据目录 %s)' % os.path.relpath(OUTPUT, ROOT)) return 0 print('[iec104-tcp] FAIL run_tcp_test.py 退出码 %d' % rc) print('[iec104-tcp] 证据(逐例耗时、simulator.log 的 START/READY/STOP 摘要)在 %s' % os.path.relpath(OUTPUT, ROOT)) return 1 if __name__ == '__main__': sys.exit(main())