ManualGen v6.3.0 - CLI 硬校验层（约束强制执行器）

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。

v5.1.1

ManualGen v5.1.1 - 新增参考文档模块

更新摘要

本次更新新增参考文档模块，提升用户体验和问题排查效率：

1. 反模式说明文档

• 收集常见错误用法案例
• 每个案例包含：现象 → 根本原因 → 正确做法 → 改进对比
• 帮助用户避免典型陷阱

2. 深度 FAQ

• 覆盖边缘场景和深度技术问题
• 与主文档 FAQ 互补
• 解答进阶技术问题

新增文件

文件路径	说明
references/anti-patterns.md	反模式说明文档
references/faq-deep.md	深度 FAQ 文档

版本更新

• SKILL.md: 版本号更新至 v5.1.1
• CHANGELOG.md: 添加 v5.1.1 更新记录

兼容性

• ✅ 完全兼容 v5.x
• ✅ 无需迁移数据

v5.1.0

ManualGen v5.1.0 - 智能业务分析与操作手册生成引擎

版本更新摘要

本次更新对 ManualGen 进行全面审查与架构升级，核心变化如下：

1. 全面审查优化

• 重构审查流程，覆盖所有中间产物
• 引入审查等级制：快速审查 / 标准审查 / 深度审查
• 审查结果结构化输出，支持自动修复建议

2. 分批分析机制

• 将大型分析任务拆分为可控的批次，每批处理 3-5 个模块
• 每批独立产出分析报告，支持中间结果持久化
• 批次间自动传递上下文，保证分析连续性

3. 模块级模板选择

• 根据模块类型（CRUD/工作流/报表/配置/集成）自动匹配文档模板
• 每种模板预定义章节结构、关注点和输出格式

4. 防跳过验证链

• 每个阶段完成后强制进行产物验证，未通过则阻断进入下一阶段
• 验证链串联所有阶段：探索 -> 提取 -> 分析 -> 编写 -> 整合 -> 审核

5. 跨模块闭环验证

• 自动检测模块间数据依赖、接口引用、状态流转的一致性
• 闭环验证通过后才能进入文档整合阶段

6. 质量控制体系统一

• 合并原有分散的质量检查点，形成统一的质量控制框架
• 定义质量等级：L0（草稿）/ L1（可用）/ L2（标准）/ L3（优质）

7. 隐私保护全局化

• 将隐私过滤从单一环节扩展到所有数据处理环节
• 隐私过滤日志可审计，确保不遗漏

8. 文件路径统一

• 标准化所有输出文件路径，遵循 docs/manualgen/ 体系
• 消除路径硬编码，统一通过配置管理

新增/修改文件

• protocols/baton-protocol.md - 接力棒协议 v5.0 更新
• protocols/phase-protocol.md - 阶段执行规范，新增 REFINE/REFERENCE_CHECK
• protocols/todo-protocol.md - TODO 标记协议
• protocols/progress-protocol.md - 进度反馈协议
• agents/00-master-controller.md - 主控制器 v5.0 重构
• agents/07-gap-analyst-agent.md - GAP 分析师（新增）
• quality-control/00-quality-system.md - 质量控制系统（新增）
• knowledge-base/ - 知识库体系（新增）
• privacy/privacy-notice.md - 隐私保护声明（新增）

兼容性

• 主要兼容 v4.x，部分路径配置需手动迁移
• 新增配置文件有默认值，可直接使用
• 历史数据（v4.x）可通过迁移工具升级