文档目录
工作
Router
你说话的对象:只判断,不执行。合同的组成、投递、守卫与通知队列。
Router 是你说话的对象:一个常驻的 Worker,角色是 router。它只做判断:这件事属于哪个 Repo、是什么意图,然后派发、转交或告知,不亲自执行。步骤之间的流转、评审、收尾都由引擎做,不经过它。
Router 会话
- 一个 Desk 至多一个 Router 会话。它在哪台 Client 上、用哪个 Harness 和模型,就是角色
router的绑定。 - 它的工作目录只放草稿。
- 第一次有消息要给它时由引擎建立;你可以在 Router 页签里重开。
- 它所在的 Client 不在线时,给它的消息留在队列里,连上后再送。
合同
Router 靠一份合同办事。合同是三段拼成的文本,由引擎生成:
| 段 | 来自 |
|---|---|
| 规则 | 官方默认插件的 router/contract.md |
| 意图表 | workflows.yaml 里每个意图的名字、工作流和「用于」 |
| 项目表 | 主仓里每个 Repo 的 id、名称、用途、别名,以及它禁用或限定的意图 |
合同有版本和摘要。角色、工作流、Repo 的登记或规则本身有任何变化,引擎就重新注册一次:重新生成合同,版本加一。Router 的下一条消息因此带着新合同,它办事时用的总是最新的。
合同的投递
引擎随发给 Router 的消息推送合同:每 10 轮全量一次,其余轮只带版本行、自检句和紧凑看板。
自检句要求 Router 先核对上下文里是否还完整保留着这一版合同。如果没有(例如会话被压缩过),它只回一个固定标记 [[NEED_CONTRACT]],引擎立即把同一条消息改成全量的一轮重发。这样平时省下大部分合同输入,会话压缩之后也不会带着残缺的规则办事。
守卫
Router 做不了执行类的事,靠合同里的规则约束:
- 能用的命令只有
ail的这些子命令:dispatch、continue、send、stop、archive、result、board、map、log、repo find、journal、op。 - 读写文件只限它的工作目录。
- 再小的事也派 Worker:不自己读仓库、不自己查资料来回答。
越界看得见:Router 调用的每个工具都作为事件记在它的会话里,你在 Router 页签里看得到。
通知队列
运行需要 Router 时,引擎把通知排进它的队列;你在 Router 页签里打的字也进同一个队列。Router 空闲时,引擎把队里的合成一条消息送出:你的话在前,通知在后。
什么时候通知:运行结束,Worker 受阻,工作流无法继续。waiting、progress、评审往返和对话中的 Worker 不通知:它们不需要 Router。