Why GraphAgent zh

为什么是 GraphAgent

诚实的推销，一段话说完：任务就是一场对话时，单智能体循环是对的工具，继续用它就好。任务有阶段、有可并行的部分、有"在扩散之前应该有人先检查一下"的节点时，单循环会让你同时充当调度器、审查员和恢复机制——半夜跑的话就得半夜爬起来。GraphAgent 把这三个角色搬进了 harness。

图买到什么

**不失控的吞吐。**独立切片作为并行子会话跑在并发信号量下；有依赖的步骤等。形状声明一次，等待、唤醒、排队由引擎做。

**能说"不"的门禁。**审查节点编译成独立审查加仲裁。REJECT 是真实结果，且必须在同一唤醒里被处置——extend、replan、或说明理由后停下。验证纪律是红先行：不会失败的回归测试保护不了任何东西，所以探针靠"在 scratch 工作区回退修复、看它变红"来证明可证伪。

**不用守着的恢复。**状态事件溯源；重启时，跑完的会话回填输出，有歧义的暂停等决定。provider 工作绝不重放——不会因为一次崩溃为同一批 token 付两次钱。

**成本塑形在配置里，不在 prompt 里。**判断节点（审查、仲裁、所有 required）跑 advanced 层；跑量扇出到 standard。一个文件声明，所有工作流继承。

**可审计的记录。**每次状态变更是 durable 事件。修订视图显示当前图——被改写的段落退场、活失败保持可见——底下持久历史仍可查询。

实际长什么样

这个仓库历史里的一次真实运行：用户报告恢复会话后无响应。一个工作流端到端处理——红测试复现、审计全库的字典序 id 比较、修复、突变证明验证、审查。审查拒了第一轮（一个加固提交缺可证伪探针）；修复环补上后通过。当天发了版，证据齐全。

这就是这个引擎适配的工作形状：多阶段、可验证、可重启，而且长到一个上下文窗口装不下。

它不试图成为什么

不是对话尺度工作的替代品——纯 opencode 行为完整保留，不碰 DAG 功能零成本。也不是图会自己长出来的全自动智能体框架——deep 模式准入在昂贵的图启动前先问清楚，因为"大规模地建错东西"才是最贵的失败。