跳到主要内容
赞助推荐 搬瓦工怎么选:三网直连 CN2 GIA-E
核对于 2026-11-05
课程目录 · 11 节

Agent 框架源码

第 10 节:Router 不规划,四种决定里只有一种开工

核对 2026-11-05 更新 1 次 引用 2 个来源

Super-agent 原型用常驻 Router 加分派 Worker 替代单会话循环,Router 只判断该给谁,Worker 直连话题省掉转发。授权先于能力,四种决定里留了 unavailable 一档,承认判断不了。

关键事实 · 5 条口径随行标注
原型体量
12390 行src 下 TypeScript 代码,MIT 协议,标注研究用途
调度结构
Router 加 Worker 双层Router 只管分派,Worker 独立上下文并行
授权结论
accept·stop·ignore·unavailable四种,unavailable 用于承认判断不了
过滤层级
两级程序规则先筛,大模型再判,两道都过才派任务
延迟中位数
12.4 分钟文中合成负载与简化环境实验,非容量依据

Router 不规划,只分派:和「主 agent 带子 agent」的差别

Super-agent 原型(dsh-superagent-prototype,MIT,12390 行 TypeScript)用两层结构替代单会话循环:持续运行的 Router 收多渠道消息、维护共享上下文、决定这件事推给谁,自己不深入执行;Worker 各带独立上下文并行干活。

        群聊 / GitHub / 邮件 / CI 事件
                    │
                    ▼
        ┌───────────────────────┐
        │  Router(常驻)        │  只判断「该给谁」,
        │  共享上下文 · 分派      │  不规划任务细节
        └───────┬───────────────┘
                │ 分派(不转发后续消息)
      ┌─────────┼─────────┐
      ▼         ▼         ▼
   Worker A   Worker B   Worker C
   独立上下文  独立上下文  独立上下文
   独立目录    独立目录    独立目录
      │         │         │
      └────┬────┴────┬────┘
           │  订阅同一话题,互相发现冲突
           ▼
       Outbox → 原渠道回复(PR / 评论 / 消息)

和常见的「主 agent 带几个子 agent」比,差别在谁承担推理负担。主 agent 模式里,主 agent 要理解任务细节、规划子任务、高频协调,上下文和推理量都很重;Router 只管「这件事该推给谁」,决策面窄得多。

还有一条更关键的差异写在授权文档里:Worker 接手任务后可以直接订阅后续消息,省掉经 Router 转发的协调开销。这意味着 Router 不是消息总线,它只做首次路由。后续对话在 Worker 和话题之间直连。

授权先于能力:四种决定,三种拒绝

这套系统最值得抄的不是架构图,是它对「什么时候可以行动」的严格定义。系统里有一个 Gate(闸门),对每一条候选消息给出四种决定之一:

四种结论里只有一种会真正开工
决定 含义 结果
accept 这是一个明确的工作请求 建 Ticket,分派 Worker
stop 不该做,终止 不产生任何副作用
ignore 不需要判断,直接忽略 连 Eval 都不进入
unavailable 判断不了(信息不足 / 模型不可用) 不假装成功,挂起等人工

unavailable 这一档是设计上的诚实。判断不了就说判断不了,而不是猜一个结论——很多 agent 系统只有「做」和「不做」,遇到模糊情况就被迫二选一,结果要么乱动要么静默丢弃。

授权的边界也划得很清楚:消息、评论、引用文档都是决策的输入,不能改变权限。也就是说,别人在群里说「你可以改这个仓库」,不会扩展你的 granted 范围。允许清单、规则、Mandate 由宿主执行,只认配置不认内容。

这条边界正是提示词注入的主要防线。只要「内容能否扩展权限」的答案永远是否,注入就只能触发权限内的动作。所以它对「主动」这件事极度克制:只在被请求、或团队事先写好规则允许时行动;没有结果就不播报过程;没有权限就不擅自动手。

两级过滤与静默复现:主动但不扰民

「主动」是这套系统最容易出事的地方:绝大多数群聊消息不需要 AI 介入。它的处理是两级过滤,成本递增:

一条群聊消息
  │
  ├─ 第一级:程序规则      正则 / 来源 / 发送者 / 是否 @ —— 便宜,筛掉明显无关
  │      └ 不通过 → 丢弃
  │
  ├─ 第二级:大模型判断    是随口吐槽,还是真有问题 —— 贵,只处理剩下的
  │      └ 判为吐槽 → 忽略
  │
  └─ 两道都通过 → 派任务
        │
        └─ 后台静默复现 → 确认存在 → 找到简单修法 → 提 PR → 交人验收
              (全程不播报,直到有结果或需要人决策)

第二级之后的行为叫「静默复现并修复」:没人 @ 它,它在后台复现问题、确认存在、找到修法,然后提 PR 交人验收。中途不吭声。

这个策略的判据在原型仓库的哲学文档里:一个能替整个团队行动的 agent,也能浪费整个团队的注意力。所以它只在「有人必须行动」或「结果确实可用」时说话。工程上这比提高准确率更难,因为「不说话」没有指标可优化,只能靠纪律。

落到实现上,Engine 是触发器、线程、决定、工单、分派的唯一写者,所有方法同步,一个命令一个事务;需要外部动作的端口在事务内入队,提交后由适配器执行。这样「领域状态变了但外部动作没发出去」这种半完成状态在结构上不成立。

剩余的架构手段写在文章里但原型未全部实现:存算分离(循环在云端、状态入库、本地只留轻量 daemon)、外部 watchdog 检测无效循环、异步 ReActLoop 让执行慢任务时仍能响应新指令、不确定结果时先投机执行。原型 README 明确标了「部分是未来方向,未在本原型实现」。

怎么用这套东西:三个可以直接搬的判断

原型本身标注「研究代码,非生产可用」,且文中实验基于合成负载与简化环境。所以别照抄实现,抄判断。

能搬走的三条,和不该照搬的两条
可以搬 理由
Router 只管分派,Worker 直连话题 把推理负担从协调层移走,是所有多 agent 系统都该做的减法
授权结论留 unavailable 一档 承认判断不了,比强制二选一更安全
内容永不扩展权限 这是提示词注入的唯一结构性防线,不是可选项
不该搬:单仓库假设 原型只面向一个 GitHub 仓库。多仓库要重做隔离与并发
不该搬:合成负载的延迟数字 文中中位数 12.4 分钟来自简化环境,不能当容量规划依据

最后回到第 1 节那个比例:1056431 行里循环 2127 行。Super-agent 是这套结构的一次实战检验——它没有改循环,只是在循环之上叠了一层协调、一层授权、一层分派。

这也是 dsh 值得学的真正原因:它不是给了一个更强的 agent,是给了一套让不同 agent 长出来的结构。能不能用好,取决于你愿不愿意先想清楚「哪些行为必须落盘、哪些规矩必须外挂、哪些能力必须可换」——这三件事想不清楚,再多插件也只是把复杂度搬了个位置。

依据:dsh-superagent-prototype 的 docs/000-philosophy.md、002-authorization.md、007-architecture.md;deepseek-harness 的 docs/architecture.zh.md。

变更记录

日期类型改了什么范围
新建 按原型仓库 docs 与授权文档写,明确标出未实现的未来方向 全页
赞助推荐 一键部署 AI 大模型
赞助推荐 一键部署 AI 大模型