Home zh

首页-zh

GraphAgent wiki 中文区。

GraphAgent 是 opencode 的 fork，加了 DAG 工作流引擎：智能体把任务拆成子智能体依赖图并驱动跑完。状态持久化，崩溃可恢复，整张图在终端里可看可控。

新手速览

整个项目，一块讲完：

• 它是什么。 opencode 的 fork：智能体可以把任务拆成一张子智能体依赖图（工作流）并驱动跑完——能并行就并行，关键处有门禁，崩溃可恢复。
• 最小配置。 装一个 release 二进制，再放一个文件：~/.config/opencode/dag.jsonc，配一个模型即可。其余配置都有可用默认值。
• 第一张图。 TUI 里输入 /dag-flow <一件有阶段的活>——智能体自己设计图、启动、报工作流 ID。仓库挂在 GitHub/GitLab 上的话，先跑一次 /dag-init 验证平台连接；之后 /dag-auto 可以无人值守推完六积木全流程（探索→设计→开发→验收→发布→汇总），只在需要你拍板的地方停。
• 看图。 命令面板（ctrl+k）→ dag.open：工作流列表、按波次排列的节点状态，enter 钻进任意节点的子会话；p/r/s/x 暂停/恢复/单步/取消。
• 会看到什么。 一批批节点 queued → running → completed。审查门禁可能给出 REJECT——工作流在检查点以 completed 收尾等决定；拒绝是裁定，不是崩溃。失败节点保持可见，直到被 replan 替换。
• 成本旋钮。 判断型节点（审查、仲裁、所有 required）跑 advanced 模型层，跑量的活跑 standard——在 dag.jsonc 里声明一次；先只配一层也能跑。

然后从头到尾读一遍快速上手-zh。

---

如果你没有参与过这个项目的建设，从这里开始：

1. 快速上手-zh——约五分钟，从安装到第一张跑起来的图。
2. 为什么是 GraphAgent-zh——它买到什么，什么情况该用它。
3. 与 opencode 的差异-zh——fork 加了什么，怎么选。
4. 概念-zh——节点、波次、门禁、修订、所有权。
5. Harness 机制-zh——入口、授权边界、调度、事件溯源、门禁、修订、预算与恢复，八层讲完。
6. 编写工作流-zh——写自己的图 spec 并复用。
7. 真实案例-zh——完整案例带真实运行转录。
8. 引擎内幕-zh——状态机、事件、崩溃恢复、修订视图的实现细节。
9. 常见问题-zh——模型配置、成本控制、与上游的关系。

English pages: Home.

README 是同一套内容的浓缩版；这里放完整的循序渐进教程。