Concepts zh

概念

五个词，讲完后面所有文档要用的东西。

节点（node）

一个工作单元：一个真实的子会话，有自己的智能体、上下文窗口和工具。节点声明谁来跑（worker_type）、prompt 是什么（内联文本或模板 id）、依赖谁，可选地声明超时、重试预算和结构化输出契约。

两个"不是"：节点不是函数调用（主智能体能用的工具它都能用）；节点也不是 prompt 片段（它和兄弟节点不共享上下文——隔离本身就是意义）。

波次（wave）

依赖全部就绪的那批节点。一次波次内并行执行，受并发上限约束（max_concurrency，默认 5）。一波完成，下一波准入。100 个节点的扇出不会一次拉起 100 个会话——拿到并发许可才会创建会话。

门禁（gate）

职责是判断而非生产的节点：审查、验证、仲裁。门禁输出裁定（ACCEPT / REVISE / REJECT / BLOCKED），下游节点可以基于裁定条件执行。处置契约要求父智能体在同一唤醒里处置非 ACCEPT 裁定——extend、replan、或说明理由后停下。只复述结论就结束回合，按编排失败算。

修订（revision）

图是会被改写的。父智能体替换失败段落时，被替换的节点标记为已替代，工作流的修订号递增。所有视图——状态输出、HTTP API、TUI 检查器、摘要计数——只渲染当前修订。已完成节点和它们的产出原样存活进新修订。当前图上活着的失败会一直显示，直到真的被修掉。

持久化历史不会删：被替代节点仍可按 id 从 result store 查询——智能体靠这个审计自己的改写。TUI 只是故意不给入口。

所有权（ownership）

DAG 运行时按目录隔离，但持久化存储是进程级全局的。所以每条工作流行都带一个目录戳，来自创建它的会话，每次所有权检查都从数据库重读。同一项目的兄弟 worktree 共享项目 id——戳就是用来阻止它们替对方收养、唤醒、派生的。会话迁移目录时，戳在同一事务里跟着走。

---

这五个词吃透，引擎内幕-zh 剩下的都是细节：波次怎么调度、状态怎么持久化、崩溃了会发生什么。