19 KiB
项目全面审计 - 文档索引
HISTORICAL（2026-09-12 初审快照） 当前发布/缺口 SSOT → ../remediation/gap-matrix.md 协作焦点 → ../ops/CURRENT.md Agent 工作方式 → AGENTS.md · PROJECT.md
审计日期: 2026-09-12 项目: Chat-Agent-System 审计状态: 历史索引（下方 5.7/10 为初审结论，勿作 live status）
核心文档（按阅读顺序推荐）
多意图与 HITL 方案复核（2026-09-15）
文件: 2026-09-15-multi-intent-hitl-plan-review.md
结论: 多意图方向可行，但必须以 app/intentflow 深模块、PG 权威状态机、逐动作即时授权和分波 mutex 防止 intent/coordinator 再耦合；确认、卡片和 SSE 均不能替代授权或权威状态。
设计/计划: 多意图持久计划与 HITL · 核心 U1–U8 与扩面 U9–U12
模块解耦 Phase 2 方案复核（2026-09-15）
文件: 2026-09-15-module-decoupling-phase2-plan-review.md
结论: PG delivery 尚未形成生产闭环；原计划把事件、结构和协议三轨绑成一次交付，并误判 docgov/docrevision 依赖方向。修订版先完成事件生产与历史数据门，再以 PG dispatcher、逐消费者 shadow 和真实刷新/重启恢复收口。
arch-check U1 可重放基线（2026-09-14）
文件: 2026-09-14-arch-check-baseline.md
结论: 四类规则（production import / SQL write / path / event）可重放。import=0，sql_write=5，path=17，event=0。Goose 与测试不计生产写者。新违规与过期例外立即 block。
模块解耦方案复核（2026-09-14）
文件: 2026-09-14-module-decoupling-plan-review.md
结论: 模块化单体方向成立，但原横向 Wave 缺少跨属主事务、可靠事件、多副本互斥、逐动作授权和 FAV 边界；应先完成受控文档可靠性纵向试点，再按证据扩面。
整改: 模块解耦与文档可靠性重构计划
项目 143 workflow-plan 409 与三权全有或全无（2026-09-14）
文件: 2026-09-14-workflow-plan-409-frozen-and-optional-duties.md
结论: 项目 143 已于 2026-09-13 激活 main 工作流（实例 89），SaveWorkflowPlan 因 lifecycle=active 返回 409 PLAN_FROZEN；前端无冻结守卫、错误提示在视口外，表现为「校验并预览无反应」。按文档支持三权全有或全无，但全空仅用于定义允许裁剪的非必需文档，表示“不纳入人工审批”而非“非受控”；必需文档和零治理激活不得被绕过。
整改: workflow-plan 409 + 三权全有或全无整改
项目 143 受控正文 canonical hash 漂移（2026-09-14）
文件: 2026-09-14-project143-controlled-content-404.md
结论: 正文文件存在；revision bootstrap 去掉 5 行具有 Markdown 硬换行语义的双空格并把 canonical SHA 写入账本/DocGov，却未同步文件，正文读取将哈希冲突误报为 404；5 秒 lease no-op 更新又周期性重复 hydration。原文件必须保全，不能用旧 canonical blob 覆盖。
文档版本账本运行时失效（2026-09-13）
文件: 2026-09-13-document-revision-runtime-404.md
结论: 原现场 404（账本仅内存、GET 无 bootstrap、freeform 跳过 PATCH、overlay 空壳、静态假 JSON）已在工程侧修复；Round20 真实 UI PASS（项目 6159，V3/r2）。change report 仍为 fallback，不冒充 PI 叙事。
整改: 运行时整改方案 · short-term · Round20 报告
文档修改与智能体版本专项分析（2026-09-13）
文件: 2026-09-13-document-revision-management-gap-analysis.md
结论: 现有受控文档只有当前工作区正文和哈希，缺少不可变快照、智能体版本边界、人工修订差异、实际变更报告和负责人通知；前端块编辑尚未持久化。
最新专项审计（2026-09-13）
文件: 2026-09-13-document-revision-pg-id-remap.md
结论: 项目 6158 首次生成 PG 已写入 baseline snapshot=249、candidate id=175、output snapshot id=250、report id=175，但内存计数器未同步，临时 ID 覆盖并删除 baseline，commit not found。工程修复已合入；Round20 项目 6159 首次生成 UI-03 PASS。
整改: short-term · Round20 报告
文件: 2026-09-13-document-revision-post-restart-final-snippet.md
结论: 第二次 post-restart 已恢复 V3/r2 与正文；当时失败只因 phase-state 仍断言 UI-06 marker。Round20 bodySnippet=A1-win-mu0gwiez，post-restart PASS。
整改: short-term · Round20 报告
文件: 2026-09-13-document-revision-post-restart-selector.md
结论: 第18轮 main 18 PASS；post-restart 在项目已恢复时，页面级项目名同时命中顶栏与侧栏，strict violation，未到 revision-state。
整改: short-term
文件: 2026-09-13-document-revision-reviewer-duty-sync.md
结论: 第17轮 UI-00–12 PASS；精确职责断言暴露真实缺陷——UI-01 已把 B 设为 reviewer，doc_proj6145_* 的 reviewer_id 却是硬编码 2，矩阵为 viewer。
整改: 项目 reviewer 同步整改
UI-13a 职责单元格误判（2026-09-13）
文件: 2026-09-13-document-revision-duty-cell-assertion.md
结论: 第16轮 UI-13a 已打开 reviewer B 权限矩阵；整行 innerText 含全部 select option，误命中「编制负责人」。须读 select value / badge role。
整改: 职责单元格精确断言整改
受控文档分类导航（2026-09-13）
文件: 2026-09-13-document-revision-workflow-category-navigation.md
结论: 第15轮 UI-00–12 PASS；UI-13a 在私密分类下直接展开文档菜单，找不到 doc_proj*_intake。须先用页面控件切到流程受控。
整改: 受控文档分类导航整改
UI-11 快速完成观测（2026-09-13）
文件: 2026-09-13-document-revision-fast-completion-observation.md
结论: 第14轮 UI-11 上传归档后助手已 completed；验收默认硬等 inflight 60s，把成功终态误判为失败。
整改: 快速完成观测契约整改
质量修复子工作区契约（2026-09-13）
文件: 2026-09-13-document-revision-quality-repair-workspace-contract.md
结论: 第13轮 UI-03 质量门禁正确判缺「阻塞信息/非阻塞信息」；repair TASK 引导 ../../output.md，模型越界改根文件，本地目标缺失，manifest 停在 70。
整改: 质量修复子工作区契约整改
编辑弹窗 hydration 竞态（2026-09-13）
文件: 2026-09-13-document-revision-editor-hydration-race.md
结论: 第十二轮 UI-06 在 fill 窗口完成后台 hydration，块 ID 被重建；保存按旧 ID 找不到目标后静默关窗，未发 PATCH，修订停在 r0。
对话意图运行时审计（2026-09-13）
文件: 2026-09-13-conversation-intent-runtime-state.md
结论: 真实会话被诊断探针污染；客户端名词匹配令只读总结请求误启动写任务；错误动作与文档租约状态刷新后无法恢复。
刷新历史专项审计（2026-09-13）
文件: 2026-09-13-chat-history-refresh-disappears.md
结论: 消息仍在数据库；文档任务与激活前消息缺阶段作用域，被刷新后的窗口过滤器剔除，而统计仍返回未过滤数量。
0️⃣ 当前状态（Live SSOT）
文件: gap-matrix.md 协作: CURRENT.md · AGENTS.md · PROJECT.md 用途: 发布缺口、Codex 再审计闭环证据、发布门禁勾选
1️⃣ 从这里开始：审计总结报告（历史）
文件: 2026-09-12-audit-summary-report.md
用途: 项目整体现状、关键数字、风险评估
适合: 项目经理、技术负责人、快速概览
阅读时间: 15-20 分钟
关键内容:
- 项目评分及各维度打分
- 12 个已确认缺陷分布（critical/high/medium）
- 未完成功能清单
- 开发库数据污染现状（88 个测试定义）
- 整改时间与资源规划
- 立即行动建议
2️⃣ 详细缺陷与整改：综合整改方案
文件: 2026-09-12-comprehensive-audit-and-remediation-plan.md
用途: 12 个缺陷的详细分析 + 3 个新功能的整改方案
适合: 架构师、资深开发工程师
阅读时间: 45-60 分钟
关键内容:
- BUG-01 到 BUG-12 的代码现场与后果分析
- 5 个 high 缺陷的深层原因
- 3 个 MISSING 新功能的实现设计
- 3 个 Phase (A/B/C) 的整改计划
- 风险预案与建议
3️⃣ 可执行的任务拆分：任务清单与验收
文件: 2026-09-12-remediation-tasks-and-acceptance-checklist.md
用途: 具体的代码修改指引、单元测试框架、验收标准
适合: 开发工程师、QA、代码审查人
阅读时间: 60-90 分钟
关键内容:
- Task A1-A6：关键缺陷修复（15h）
- 每个 Task 的修改文件、代码片段、测试用例
- 验收标准与预计工作量
- Task B1-B3：高优先级新功能（26h）
- 受控终止 API 的完整实现
- E2E 测试框架与运行命令
- 项目上下文快照的数据模型与集成点
- Task C1-C7：完善与发布（20h）
- 全套验收检查表
4️⃣ 快速参考与速查：快速指南
文件: 2026-09-12-quick-reference-guide.md
用途: 问题症状→原因→解决方案的快速诊断
适合: 所有开发人员、值班人员
阅读时间: 5-10 分钟（按需查阅）
关键内容:
- 10 个常见症状的诊断矩阵
- 代码热点地图（哪个文件有哪个 bug）
- 整改优先级排序
- 代码修改检查清单
- 数据库迁移清单
- 测试命令参考
- API 变动汇总
- 常见问题 Q&A
配套参考文档
业务需求原文
文件: 2026-09-12-three-workflows-strict-governance-remediation.md
用途: 业务决策、验收标准的原始出处
适合: 产品、架构、QA（需要理解业务背景）
关键章节:
- 第 3 章：不可违反的业务规则
- 第 7 章：验收标准（7.1-7.5）
- 第 8-9 章：已确认决策与实施解释
快速导航
我是 PM/项目经理
1. 读 audit-summary-report.md 第一部分（总体评估）
2. 重点关注第九章（建议行动计划）
3. 查阅 quick-reference-guide.md 第三部分（优先级排序）
4. 预估资源与时间
我是后端开发
1. 读 quick-reference-guide.md（快速了解要改什么）
2. 针对每个 task 查阅 remediation-tasks-and-acceptance-checklist.md
3. 参考 comprehensive-audit-and-remediation-plan.md 理解原因
4. 按照 task 中的"修改文件"和"代码片段"进行开发
5. 执行"测试用例"部分验证修改
我是 QA/测试工程师
1. 读 audit-summary-report.md 第十一章（验收标准清单）
2. 查阅 quick-reference-guide.md 第五部分（检查清单）
3. 针对每个 task 制定测试计划
4. 执行 comprehensive-audit-and-remediation-plan.md 中的验收标准
5. 特别关注 remediation-tasks 的 E2E 部分
我是前端工程师
1. 读 quick-reference-guide.md 第三部分（了解哪些前端需改）
2. 查看 BUG-09、BUG-10、BUG-12 的具体改动
3. 关注 comprehensive-audit 中的前端相关缺陷
4. 参考 remediation-tasks 的 API 变动部分
我是架构师/技术负责人
1. 读 audit-summary-report.md（整体判定）
2. 深入 comprehensive-audit-and-remediation-plan.md（详细分析）
3. 关注第八章（架构建议）和第十二章（结语）
4. 制定整改计划和资源分配
我要处理现场问题
1. 查询 quick-reference-guide.md 第五部分（症状→原因→解决）
2. 找到对应的 bug 号
3. 查阅 comprehensive-audit 的完整分析
4. 按照 remediation-tasks 中的修复步骤操作
5. 若需临时绕过，参考 quick-reference-guide 的建议
文档关系图
入口文档
↓
audit-summary-report.md ← 总体评估与建议
↓
├→ comprehensive-audit-and-remediation-plan.md ← 详细缺陷分析
│ ├─ BUG-01 到 BUG-12 详解
│ ├─ MISSING-01 到 MISSING-04 详解
│ └─ Phase A/B/C 整改计划
│
├→ remediation-tasks-and-acceptance-checklist.md ← 可执行任务
│ ├─ Task A1-A6（关键缺陷）
│ ├─ Task B1-B3（新功能）
│ └─ 验收检查表
│
├→ quick-reference-guide.md ← 快速查询
│ ├─ 症状诊断矩阵
│ ├─ 代码热点地图
│ ├─ 优先级排序
│ └─ 常见问题 Q&A
│
└→ three-workflows-strict-governance-remediation.md ← 业务背景
├─ 业务需求与决策
├─ 验收标准
└─ 来源证据
关键指标速查
| 指标 | 数值 | 位置 |
|---|---|---|
| 项目完成度 | 70% | audit-summary-report.md:1.2 |
| 总体评分 | 5.7/10 | audit-summary-report.md:1.1 |
| 缺陷总数 | 12 个 | audit-summary-report.md:2.1 |
| Critical 缺陷 | 3 个 | audit-summary-report.md:2.1 |
| 整改工作量 | 61h | audit-summary-report.md:9.1 |
| 单元测试覆盖率 | 85% | audit-summary-report.md:1.2 |
| E2E 覆盖率 | 0% | audit-summary-report.md:1.2 |
| 开发库污染定义 | 88 个 | audit-summary-report.md:4.1 |
立即行动清单
今天需要做的事（第一天）：
[ ] 技术负责人读 audit-summary-report.md（20 分钟）
[ ] 架构师读 comprehensive-audit-and-remediation-plan.md（60 分钟）
[ ] 后端 A 开发师启动 Task A1（2h）- 项目生命周期修复
[ ] 后端 A 开发师启动 Task A4（2h）- 对话推进新服务
[ ] QA 准备 E2E 测试框架（同步进行）
[ ] 全队讨论确认整改计划（30 分钟）
本周目标（5 天）：
Day 1: 完成 Phase A 关键缺陷修复（15h）
Day 2-3: 启动 Phase B 新功能开发并行（26h）
Day 4-5: Phase C 完善与发布准备（20h）
+ 每晚运行完整测试套件验证
常见路径快查
"完成工作流后项目仍然是 active" → quick-reference-guide.md 第二部分 症状 1 → comprehensive-audit 第二部分 BUG-01 → remediation-tasks 的 Task A1
"对话推进不起作用" → quick-reference-guide.md 第二部分 症状 3 → comprehensive-audit 第二部分 BUG-04 → remediation-tasks 的 Task A4
"禁用文档仍能被打开" → quick-reference-guide.md 第二部分 症状 2 → comprehensive-audit 第二部分 BUG-05 → remediation-tasks 的 Task A5
"激活 token 可能被重复使用" → quick-reference-guide.md 第二部分 症状 6 → comprehensive-audit 第二部分 BUG-06 → remediation-tasks 的 Task A6
"无法运行测试流程" → quick-reference-guide.md 第二部分 症状 7 → comprehensive-audit 第三部分 MISSING-06 → remediation-tasks 的 Phase B 开始
"需要完整 E2E 验证" → comprehensive-audit 第三部分 MISSING-04 → remediation-tasks 的 Task B2
发布检查清单
上线前必须确认:
整改完成度:
□ Phase A 全部 PASS
□ Phase B 全部 PASS
□ Phase C 全部 PASS
测试覆盖:
□ 单元测试覆盖率 ≥ 85%
□ E2E 测试三工作流完整链路
□ 并发测试通过
□ 数据库迁移兼容性验证
业务验收:
□ 验收标准 7.1-7.5 全部满足
□ 不存在 critical 缺陷
□ 安全性审计通过
运维就绪:
□ 数据库备份与恢复方案
□ 审计日志完整
□ 监控告警配置
□ 性能基准测试
文档维护
这套审计文档为 v1.0，应定期更新：
- 每完成一个 task: 更新对应 task 的状态
- 每发现新缺陷: 补充到 comprehensive-audit-and-remediation-plan.md
- 每月: 做一次整体进度评估和文档更新
审计完毕
下一步: 确认整改计划，进入实施阶段
总体建议: 立即启动 Phase A（关键缺陷），并行启动 E2E 测试框架，一周内完成所有整改。
本索引最后更新于 2026-09-12 15:05 UTC