Files

T

weichenandCursor 39df2d88f7 docs(ops): claim post-restart durable body snippet task

Record that the second restart already restored V3/r2 and that only the stale UI-06 bodySnippet expectation was wrong.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-09-13 23:28:17 +00:00

15 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-13）

文件: 2026-09-13-document-revision-runtime-404.md

结论: Wave0–6 合入后现场仍 404——账本仅内存、GET 无 bootstrap、freeform 跳过 PATCH、overlay 未装饰、agent 报告为静态假 JSON。

整改: 运行时整改方案 · short-term

文档修改与智能体版本专项分析（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

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

整改: 对话刷新恢复与阶段授权一致性整改方案

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

15 KiB Raw Blame History Unescape Escape

项目全面审计 - 文档索引

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

文档版本账本运行时失效（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/测试工程师

我是前端工程师

我是架构师/技术负责人

我要处理现场问题

文档关系图

关键指标速查

立即行动清单

常见路径快查

发布检查清单

文档维护

15 KiB

Raw Blame History