diff --git a/docs/review/round1-4-review-summary.md b/docs/review/round1-4-review-summary.md new file mode 100644 index 0000000..9aff95b --- /dev/null +++ b/docs/review/round1-4-review-summary.md @@ -0,0 +1,121 @@ +# moziplus v2.0 四轮评审讨论变更点汇总 + +> 整理者:庞统 🐦 +> 日期:2026-05-14 +> 目的:让用户一目了然——讨论了什么、结论是什么、还有什么没结论 + +--- + +## 一、讨论议题总表 + +| # | 议题 | 讨论轮次 | 状态 | 结论 | +|---|------|---------|------|------| +| 1 | 编排模式:纯状态机 vs AI 参与 | R1 | ✅ 已结论 | 状态机骨架 + AI 大脑,AI 做决策,状态机做执行 | +| 2 | 信息存储:Blackboard vs SQLite+文件系统 | R1 | ✅ 已结论 | SQLite 为唯一权威,文件系统为索引缓存 | +| 3 | 事件链:推送 vs 拉取 | R1 | ✅ 已结论 | 推送式(事件驱动),非拉取式 | +| 4 | Agent 调度机制 | R1→R2 | ✅ 已结论 | `openclaw agent` CLI 替代自建 WS Client 和 sessions_send | +| 5 | 庞统上下文恢复 | R2 | ✅ 已结论 | 每次被唤醒时 GET /api/tasks/{id}/status 重建认知 | +| 6 | Agent 任务消息模板 | R2 | ✅ 已结论 | 标准化模板:任务标题+意图+end_state+上下文+约束+回报URL | +| 7 | 质量治理框架 | R1→R2 | ✅ 已结论 | 三重预算(token/时间/成本)+ 两层质量门 + 三质量等级 | +| 8 | 经验蒸馏层级 | R1 | ✅ 已结论 | 先两层(surface+heuristic),验证后扩展 | +| 9 | PRD 自矛盾(6.1 "增量" vs 实际"全量") | R3 | ✅ 已修正 | 6.1 改为"全新实现" | +| 10 | PRD 自矛盾(6.2 三种模式共存 vs 中央调度) | R3 | ✅ 已修正 | 6.2 改为"中央调度 + 共享状态" | +| 11 | PRD C5 自主协作 vs 设计缺失 | R3→R4 | ✅ 已修正 | v2.4 通过 observations/ + 自主行为协议补上 | +| 12 | PRD B3 实时共享感知 vs 设计不成立 | R3→R4 | ✅ 已修正 | v2.4 通过文件系统直读(status.json + observations/)补上 | +| 13 | PRD C4 "实时信息空间"描述不准确 | R3 | ✅ 已修正 | 改为"通过 Daemon 共享状态空间,按需查询",v2.4 再升级为文件系统直读 | +| 14 | PRD B3 "共享感知"仅限按需查询 | R3→R4 | ✅ 已修正 | v2.4 升级为文件系统直读 + observations 目录 | +| 15 | Agent 自主协作被妥协为中央调度 | 用户质询→R4 | ✅ 已修正 | v2.4 恢复三层自主模型:庞统定方向 + Agent 自主执行 + 共享感知 | +| 16 | AI 持续参与被妥协为完成时通知 | 用户质询→R4 | ✅ 已修正 | v2.4 恢复庞统持续意识:四类事件触发 | +| 17 | Agent 自主的真实边界 | R4 | ✅ 已结论 | 执行开始时获取全局快照,执行过程中不感知变化 | +| 18 | Observation 通知机制 | R4 | ✅ 已结论 | Agent 主动 POST API 通知 daemon,不依赖 inotify | +| 19 | daemon vs 庞统角色透明化 | R4 | ✅ 已结论 | 确定性逻辑 vs AI 决策明确区分(见对照表) | +| 20 | 文件系统可靠性(status.json 竞争写) | R4 | ✅ 已结论 | atomic_write(tmp → rename) | +| 21 | observations 文件命名冲突 | R4 | ✅ 已结论 | {agent}-{timestamp}-{uuid短}.md | +| 22 | Observation 写入标准与滥用防护 | R4 | ✅ 已结论 | 写入标准 + 频率限制(每步每Agent最多3个) | +| 23 | 庞统上下文膨胀 | R4 | ✅ 已结论 | 每次被唤醒全新视角,不累积历史推理 | +| 24 | B1 贯穿性(steer 时的意图一致性检查) | R4 | ✅ 已结论 | 庞统在用户改方向时先评估影响再执行 | +| 25 | propose→validate→commit 三阶段写入 | R2 | ⚠️ 延后 | YAGNI——仅 6 个 Agent,低并发,延至 v2.1+ | +| 26 | Fidelity 3层路由 | R2 | ⚠️ 延后 | YAGNI——延至 v2.1+ | +| 27 | Boids 协作规则 | R2 | ⚠️ 延后 | 延至 v2.1+ | +| 28 | Experience→Skill 自动转换 | R2 | ⚠️ 延后 | 延至 v2.1+ | +| 29 | 经验蒸馏从2层扩展到5层 | R1 | ⚠️ 延后 | 先验证2层,v2.1+ 再扩展 | +| 30 | Agent 并行执行时的运行时感知 | R4 | ⚠️ 未解决 | 当前设计:不感知。未来可能需要庞统 steer 触发 | +| 31 | 多 Agent session 的上下文膨胀 | 用户→R3 | ⚠️ 未解决 | 记录为 M2 讨论,v2.0 先用 cleanup:delete 隔离 | + +--- + +## 二、PRD 变更记录 + +### R1/R2 触发的 PRD 变更 +- C5 改为"中央调度为主,v2.1+ 目标 peer-to-peer"(后被 v2.4 再次修正) +- C4 改为"通过 Daemon API 查询共享状态"(后被 v2.4 再次修正) +- B3 改为"通过 Daemon 共享状态空间,按需查询"(后被 v2.4 再次修正) + +### R3 触发的 PRD 变更 +- **Section 6.1**:删除"不是砍掉 engine.py",改为"全新实现" +- **Section 6.2**:删除三种模式共存,改为"中央调度 + 共享状态" +- **Section 10.1** 新增:安全红线(6条:实盘交易、数据删除、配置变更、大额token、不受控行为、连续失败) +- **Section 10.2** 新增:v2.0 范围声明(v2.0 vs v2.1+ 分界) +- **Section 10.3** 新增:多任务并发 +- **Section 10.4** 新增:任务失败恢复 +- 附录更新:Agent 通信改为 Daemon HTTP API + CLI + +### 用户质询/R4 触发的 PRD 变更 +- v2.4 修正了 C5 的"妥协"方向,恢复 Agent 自主协作 +- v2.4 修正了 B3 的"按需查询",升级为文件系统直读 + observations + +--- + +## 三、设计文档变更记录 + +### v2.0 → v2.1(技术架构修订) +- 废弃 sessions_send / sessions_spawn / cron +- 改用 Daemon HTTP API + SQLite +- 文件系统作为产出物存储 + +### v2.1 → v2.2(完整设计) +- Section 3.9 共享意识空间物理结构(SQLite 表 + 文件系统目录) +- Section 3.10 Daemon API 接口定义 +- Section 3.11 经验沉淀引擎 +- states.yaml / step-states.yaml / events.yaml / exceptions.yaml 配置化 +- 执行历史归档设计 +- Agent 调度混合方案 +- 质量治理框架 + +### v2.2 → v2.3(评审修订) +- Section 3.8 重写:openclaw agent CLI 调度方式 +- 新增 3.8.1 Agent 调度具体实现 +- 新增 3.8.2 庞统上下文恢复协议 +- 新增 3.8.3 Agent 任务消息模板 +- 清理所有 sessions_send / cron / Gateway WS API 残留引用 +- 决策表新增 #3, #15-18 + +### v2.3 → v2.4(AI native 修正) +- **新增 Section 3.12**:中央协调 + Agent 自主(~180 行) + - 3.12.1 三层自主模型 + - 3.12.2 Agent 自主行为协议(感知→执行→观察) + - 3.12.3 Agent 任务消息模板增强 + - 3.12.4 庞统持续意识机制 + - 3.12.5 文件系统 = 实时共享感知 + - 3.12.6 Agent 主动协作场景 + - 3.12.7 实现注意事项(司马懿 R4 反馈) +- 新增文件结构:observations/ 目录 + status.json +- 决策表新增 #19-22 +- 术语表新增 4 条 +- 调研来源新增 16 个项目/论文 +- 实现清单更新 + +--- + +## 四、未结论/延后事项 + +| # | 事项 | 来源 | 状态 | 备注 | +|---|------|------|------|------| +| 1 | propose→validate→commit 三阶段写入 | R2 | 延至 v2.1+ | 6 个 Agent 低并发,YAGNI | +| 2 | Fidelity 3层信息保真路由 | R2 | 延至 v2.1+ | 当前全部信息共享 | +| 3 | Boids 协作规则 | R2 | 延至 v2.1+ | 群体智能涌现 | +| 4 | Experience→Skill 自动转换 | R2 | 延至 v2.1+ | 当前手动 | +| 5 | 经验蒸馏扩展到 5 层 | R1 | 延至 v2.1+ | 先验证 2 层 | +| 6 | Agent 并行执行时运行时感知 | R4 | 未解决 | 当前依赖庞统 steer | +| 7 | 多 Agent session 上下文膨胀 | 用户 | 未解决 | v2.0 用 cleanup:delete 隔离 | +| 8 | 庞统 session 上下文管理策略 | R4 | 部分解决 | "每次被唤醒全新视角"但具体实现待编码时确定 |