From 7efcedec42cc4e71eb83e7491f1050d023ff2d55 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Fri, 29 May 2026 20:41:45 +0800 Subject: [PATCH] auto-sync: 2026-05-29 20:41:45 --- docs/design/architecture-v3.0.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/design/architecture-v3.0.md b/docs/design/architecture-v3.0.md index b001571..3e63db1 100644 --- a/docs/design/architecture-v3.0.md +++ b/docs/design/architecture-v3.0.md @@ -536,6 +536,7 @@ Ticker.tick() | Agent 角色 | 被动执行者（固定步骤 prompt） | 自主决策者（读黑板→想→干→写回） | | 谁决定执行路径 | Daemon（if/else + YAML） | Agent（根据黑板信息自主判断） | | Agent 间通信 | 无（Daemon 中央调度） | 黑板 comment + observation + @mention | +| Session 管理 | `--session-id UUID` → 新 session → 爆炸 | main session + subagent delegation | **业界印证**： @@ -551,6 +552,14 @@ Ticker.tick() 3. ❌ blackboard_* 工具封装（优先级低，当前 curl + API 方式可用） 4. ❌ Skill 集群模板（和 Agent 自主决策矛盾） +**Spawn 改造方向**（详见 `docs/design/02-main-session-delegation.md`）： + +现行 `openclaw agent --session-id UUID` 导致 session 爆炸（E2E 测试 6 Agent 产生 68 个 session）。改造为： +- 所有 spawn 统一走 `spawn_full_agent(use_main_session=True)`（复用 Mail 路径已验证的模式） +- Agent main session 收到任务后自主决定执行方式（直接做 / sessions_spawn subagent / @mention 协作） +- subagent 通过 `cleanup: "delete"` 用完即删，不堆积 +- 三层幻觉门控：Daemon 确定性检查 → 文件存在性验证 → AI 验证 + > ⚠️ **澄清**：§10.5 Handoff Schema 不是 Pipeline 框架。Handoff 是 Agent 间的结构化交接文档（上家写给下家），是信息传递，不是执行编排。Pipeline 框架指的是 PipelineRouter/SingleStepPipeline 等代码级执行模式抽象，已明确不做。 **涉及文件**: `src/daemon/ticker.py`、`src/daemon/dispatcher.py`、`src/daemon/spawner.py`、`src/daemon/router.py`