值守文档: 把体检工具接进手册

Browse Source
上一轮新增了 audit_runs.py 但只在提交信息里提过 —— 又是一次"写了没人知道"。
手册第一节现在把值守要跑的两个命令并列出来:

  python scripts/modules_status.py   看历史(每轮结果/模组变化/狂气那一栏)
  python scripts/audit_runs.py       体检(日志与报告交叉核对, 揪出可疑记录)

并写明"异常行先过它一遍再下结论"、以及为什么不能手敲核对(我第一次 6 条全误报)。

test_doc_refs.py 会自动核对文档里引用的 scripts/xxx 是否存在, 所以这次接进去
同时也被测试覆盖到了。全套 310/310 通过。
This commit is contained in:
Codex Agent
2026-10-16 12:01:53 +08:00
parent 3959645351
commit 324f9d23b8
+12 -1
View File
@@ -16,7 +16,18 @@
脚本入口:`scripts/convert_modules.py`
报告:`~/lc_mcp/modules/convert_*.json`,日志:`~/lc_mcp/modules/convert.log`
汇总:`python scripts/modules_status.py`
值守时跑这两个:
```powershell
python scripts/modules_status.py # 看历史: 每轮结果 / 模组变化 / 狂气那一栏
python scripts/audit_runs.py # 体检: 日志与报告交叉核对, 揪出可疑记录
```
`audit_runs.py` 退出码 0 = 全部吻合。它检查"每份报告都有对应的开始行、时间关系
成立、耗时和结果文本一致", 外加识别 mock 残留(同一秒扎堆、内容自相矛盾)。
**异常行先过它一遍再下结论** —— 手敲 PowerShell 核对很容易把"数据没问题"误判成
"数据有问题"(我第一次就 6 条全误报,见第八节)。
## 二、体力账本(实测标定)