sanguo_moziplus_v2/docs/review/round1-4-review-summary.md

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	部分解决	"每次被唤醒全新视角"但具体实现待编码时确定