Files

T

weichen af327950bd docs(plan): 对话办公能力全景盘点与 P0–P3 整改计划

盘点 32 ActionKey 与 HTTP 169 路由对话边界，明确假成功/dry-run 与 UI 专属红线；分期消除假成功、live 化 intentflow、查询真源与新写意图扩展。

2026-09-25 20:20:25 +00:00

22 KiB

Raw Blame History

项目全面审计 - 文档索引

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）

核心文档（按阅读顺序推荐）

对话办公能力全景盘点（2026-09-25）

文件: 2026-09-25-dialogue-office-capability-research.md

结论: 32 ActionKey 双轨脱节（主链假成功 vs intentflow 部分 live）；HTTP 169 = A46/B66/C44+基线13；治理结构写永久 UI 专属。整改见 P0–P3 计划。

整改: 对话办公扩展计划 · task dialogue-office-expansion-2026-09-25

模块化重构方案审核检查清单（2026-09-23）

文件: 2026-09-23-modular-refactor-plan-review-checklist.md

结论: 产物机器方案（modular-contract-standard-2026-09-22）本机不可见；本清单按已生效模块开发规范与 A–G/验证契约，覆盖阶段 1、阶段 2 与取消状态契约自查项，并留「22 条规范」映射回填。不实施业务代码。

任务: short-term

模块耦合现状（2026-09-20）

文件: 2026-09-20-module-coupling-audit.md

结论: 模块化单体与事件总线已在；残留扩散点是 server 具体类型装配、chat/app/coordinator 逻辑环、docgov 词汇泄漏，以及 2026-09-28 到期的 sql_write/path 例外。不改 production_ready。

整改: 分批计划 · 开发规范

系统全量体检（2026-09-20）

文件: 2026-09-20-system-triage-audit.md

结论: 迁移 00054 断链 + 三项 IDOR + taskrun channel panic + 凭证硬编码/暴露为 P0；main 分支与生产 schema 脱节记 backlog。

整改: P0 热修方案 · short-term

可选职责空审核人 CreateOrGetDocument FK（2026-09-17）

文件: 2026-09-17-docgov-optional-duty-null-fk.md

结论: 无 reviewer 职责时 CreateOrGetDocument 写 reviewer_id=0 触发 FK，被 ClassifyError 掩盖为 INTERNAL_ERROR；heal 路径已有 nullIfZero，创建路径漏改。

整改: short-term · branch fix/docgov-optional-duty-null-fk

FEATURE-MATRIX production-ready 连续性审计（2026-09-16）

文件: 2026-09-16-feature-matrix-production-readiness-audit.md

结论: 排除纯软件项目自举后没有新增发布 blocker；矩阵需要拆分能力成熟度、发布关系、补证、增强和 deferred 状态，并修复 schema、D3/D5、IAM、前端与 FAV 叙事漂移。

整改: FEATURE-MATRIX Production-Ready Continuity - Plan

多意图与 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 和真实刷新/重启恢复收口。

整改: Phase 2 持久事件交付与后续解耦路线

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 覆盖。

整改: canonical hash 漂移整改计划

文档版本账本运行时失效（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

结论: 现有受控文档只有当前工作区正文和哈希，缺少不可变快照、智能体版本边界、人工修订差异、实际变更报告和负责人通知；前端块编辑尚未持久化。

设计/整改: 系统设计 · 实施方案

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。

整改: 编辑弹窗 hydration 竞态整改

对话意图运行时审计（2026-09-13）

文件: 2026-09-13-conversation-intent-runtime-state.md

结论: 真实会话被诊断探针污染；客户端名词匹配令只读总结请求误启动写任务；错误动作与文档租约状态刷新后无法恢复。

整改: 对话意图、可恢复任务状态与文档占用可见性整改

刷新历史专项审计（2026-09-13）

文件: 2026-09-13-chat-history-refresh-disappears.md

结论: 消息仍在数据库；文档任务与激活前消息缺阶段作用域，被刷新后的窗口过滤器剔除，而统计仍返回未过滤数量。

整改: 对话刷新恢复与阶段授权一致性整改方案（2026-09-22 口径裁定：gap CHAT-HISTORY-REFRESH = PASS；见 reconcile）

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

2026-09-17：系统全面体检（任务收口 / 缺陷 / 未启用功能；配套整改方案 Wave0–7）。
2026-09-17：首次加载性能诊断与改进（三入口重启首访；U2 已验收，主 JS ~624 KB；U1/U3–U7 待实施）。

22 KiB Raw Blame History Unescape Escape

项目全面审计 - 文档索引

核心文档（按阅读顺序推荐）

对话办公能力全景盘点（2026-09-25）

模块化重构方案审核检查清单（2026-09-23）

模块耦合现状（2026-09-20）

系统全量体检（2026-09-20）

可选职责空审核人 CreateOrGetDocument FK（2026-09-17）

FEATURE-MATRIX production-ready 连续性审计（2026-09-16）

多意图与 HITL 方案复核（2026-09-15）

模块解耦 Phase 2 方案复核（2026-09-15）

arch-check U1 可重放基线（2026-09-14）

模块解耦方案复核（2026-09-14）

项目 143 workflow-plan 409 与三权全有或全无（2026-09-14）

项目 143 受控正文 canonical hash 漂移（2026-09-14）

文档版本账本运行时失效（2026-09-13）

文档修改与智能体版本专项分析（2026-09-13）

最新专项审计（2026-09-13）

UI-13a 职责单元格误判（2026-09-13）

受控文档分类导航（2026-09-13）

UI-11 快速完成观测（2026-09-13）

质量修复子工作区契约（2026-09-13）

编辑弹窗 hydration 竞态（2026-09-13）

对话意图运行时审计（2026-09-13）

刷新历史专项审计（2026-09-13）

0️⃣ 当前状态（Live SSOT）

1️⃣ 从这里开始：审计总结报告（历史）

2️⃣ 详细缺陷与整改：综合整改方案

3️⃣ 可执行的任务拆分：任务清单与验收

4️⃣ 快速参考与速查：快速指南

配套参考文档

业务需求原文

快速导航

我是 PM/项目经理

我是后端开发

我是 QA/测试工程师

我是前端工程师

我是架构师/技术负责人

我要处理现场问题

文档关系图

关键指标速查

立即行动清单

常见路径快查

发布检查清单

文档维护

22 KiB

Raw Blame History