v6.3.0 核心变化:把「AI 自评闸门」升级为「可运行的硬校验」
背景(为什么要做 v6.3)
v6.2 曾暴露严重缺陷:AI 伪造接力棒(谎报完成)、跳过中间产物、把 API 端点/数据库名写进用户手册,导致生成的手册只有几百行且满是技术参数。根因不是约束写得不够,而是约束只被「声明」、没被「执行/校验」——闸门是 AI 自评的,不是被强制的。
v6.3 用新增的 manualgen_tools/run.py 把可验证的事项全部交给脚本机器判定:产物缺失即阻断、计数禁止手填、技术泄漏零容忍、流程图缺图即打回。AI 只负责智识工作,不再自证合规。
新增:manualgen_tools/run.py(八大 action)
verify:校验接力棒声称完成的层产物与计数是否真实存在(status 兼容 completed/completed_with_pending/done)scan_tech:技术泄漏扫描(API 端点/HTTP 代码/数据库名/框架名/参数名/代码块),P0 命中即阻断,按模式分组报告scan_flowcharts:流程图硬门——每模块 ≥1 张非空 Mermaid 流程图、每个操作小节 ≥1 张(不可共用)、手册全文 ≥3 张、graph 旧语法与空图均阻断check_deliverables:完整产物清单(六层/图谱 6 文件/阶段报告/_modules/附录 B~F)coverage:L1 模块 vs 手册章节覆盖比对baton_fix:从磁盘反推各层计数(兼容 _nodes.json dict 包装 schema),禁止 AI 手填reset/ping:重置接力棒 / 工具自检
CLI 健壮性(对齐 conspect/skill-medic)
- 参数三通道:--params-file > 命令行 JSON > stdin 管道(防非交互环境 stdin 挂死)
- 异常结构化 JSON(E400/E500)+ 非零退出码;Ctrl+C 优雅退出(退出码 130)
文档全链路接线
- SKILL.md / chunk-05 阻断表 / README / CHANGELOG 统一为八大 action
- AUDIT 阻断项(内容合规/覆盖/产物/流程图)全部脚本化
- 修复审计发现的死链接、faq-deep 题数与目录名错误、版本脚注统一
实测验证
在真实项目(知识库管理系统)全流程运行:L1:10/L2:10/L3:56/L4:119/L5:32 全部真实产物,技术泄漏 0 处,每模块 6~12 张流程图,手册 5070 行,10/10 模块全覆盖。所有硬门 PASS。