文档目录

工作

Router

你说话的对象:只判断,不执行。合同的组成、投递、守卫与通知队列。

Router 是你说话的对象:一个常驻的 Worker,角色是 router。它只做判断:这件事属于哪个 Repo、是什么意图,然后派发、转交或告知,不亲自执行。步骤之间的流转、评审、收尾都由引擎做,不经过它。

Router 会话

合同

Router 靠一份合同办事。合同是三段拼成的文本,由引擎生成:

段 来自
规则 官方默认插件的 router/contract.md
意图表 workflows.yaml 里每个意图的名字、工作流和「用于」
项目表 主仓里每个 Repo 的 id、名称、用途、别名,以及它禁用或限定的意图

合同有版本和摘要。角色、工作流、Repo 的登记或规则本身有任何变化,引擎就重新注册一次:重新生成合同,版本加一。Router 的下一条消息因此带着新合同,它办事时用的总是最新的。

合同的投递

引擎随发给 Router 的消息推送合同:每 10 轮全量一次,其余轮只带版本行、自检句和紧凑看板。

自检句要求 Router 先核对上下文里是否还完整保留着这一版合同。如果没有(例如会话被压缩过),它只回一个固定标记 [[NEED_CONTRACT]],引擎立即把同一条消息改成全量的一轮重发。这样平时省下大部分合同输入,会话压缩之后也不会带着残缺的规则办事。

守卫

Router 做不了执行类的事,靠合同里的规则约束:

越界看得见:Router 调用的每个工具都作为事件记在它的会话里,你在 Router 页签里看得到。

通知队列

运行需要 Router 时,引擎把通知排进它的队列;你在 Router 页签里打的字也进同一个队列。Router 空闲时,引擎把队里的合成一条消息送出:你的话在前,通知在后。

什么时候通知:运行结束,Worker 受阻,工作流无法继续。waiting、progress、评审往返和对话中的 Worker 不通知:它们不需要 Router。