技能｜系统操作手册无人值守运维审计SOP
适用场景
需要对手册（系统操作手册）做"齐套性、版本一致性、时效性"的无人值守核查，并据真实运行状态刷新补齐文档时复用。典型触发：每日定时审计手册是否缺章节/版本滞后/前缀误用、按程序真实状态生成或刷新指定文档。
操作步骤
- 齐套性核查：
auto-doc-audit.py只读扫描手册全部文档，输出 JSON（版本滞后/前缀误用/主题缺失：菜单9项、公文报告总结、M1–M7、m4 m5 m7 作用域共用、AI 五周期文书），不改文件。 - 缺口补齐与刷新：
auto-refresh-docs.py只写"既有章节目录"下新版本号文件（绝不覆盖旧版、绝不新建目录），内容取自程序真实运行态（门禁日志/源码常量/安装器实测），不臆造。 - 新文档校验：
auto-newdoc-verify.py对生成文档做结构/数值校验；_auto_report_check校验报告与库一致；_auto_src_change_probe探测源码变更触发文档刷新。 - 编排：多步串行（审计→刷新→校验），幂等可反复；接入每日自动化（如 03:30 两遍复跑）做门禁与留痕。
- 单一真相源：当前版本常量（如 PC V1.3.0 / APK V1.0.0）集中定义，滞后判定以此为准。
注意边界
- 只读审计不改文件；刷新只落新版本号、不覆盖旧版、不新建目录（严守存储规则）。
- 刷新内容须来自程序真实状态，禁止凭空编造数据/版本。
- 版本常量集中维护，升版时同步更新滞后判定基准。
- 长任务（门禁约 4 分钟、服务器端 ISCC 约 8.5 分钟）须后台运行，避免前台超时。
反例避雷
- ❌ 刷新覆盖旧版或新建目录：破坏基线追溯与目录铁律。正：只写既有目录新版本号。
- ❌ 用臆造数据填文档：失真。正：取自门禁日志/源码/安装器实测。
- ❌ 前台跑长任务：2 分钟上限被 SIGTERM。正：后台 run_in_background。
