DSH主循环启动之后,为什么不直接把消息发给大模型?
文章目录
在上一篇(EP.02)中,我们顺着“先纵后横”的阅读路线,看清了 DSH 驱动器如何通过收件箱持久化入队(send())和三态并发状态机(wakeDriver()),安全启动了最外层的主循环 while (await this.turn()) {}。
这一期(EP.03),我们正式进入单回合调度函数 turn() 的上半段(packages/core/agent-loop/src/agent.ts)
读 Agent 框架源码最核心的视角,是用 Harness 的思维去审视边界:写一个能调通大模型的脚本只需十几行代码,但要让智能体在真实环境里稳定运行,底座必须在正式发起推理前兜住各种失控与状态不一致的风险
因此,在看具体代码之前,我们先思考一个关键的 Harness 边界问题:
主循环已经启动运转,收件箱(Inbox)里也已经有了待处理的用户消息,为什么不直接组装请求发给大模型?
如果在拿到消息的瞬间就盲目发起模型请求,至少会撞上三个真实的运行边界:
-
无效请求的 Token 浪费与历史污染:如果用户发来的消息命中了安全策略拦截、斜杠指令截断,或者被外部插件判定当前不应继续推理,直接发请求不仅白白消耗 Token,还会把无效的问答写进持久化对话历史。
-
回合边界(Turn)与步骤边界(Step)混淆:在事件溯源架构下,“一个完整回合”和“回合内的一次模型推理”是两层不同粒度的生命周期。哪怕这一轮还没来得及调大模型就被拦截或改写为空,事件日志里也必须明确记录“这一轮确实开启过,并在准入阶段干净结束”,保证 turn/start 与 turn/end 严格成对闭环。
-
资源生命周期与中断信号的精确对齐:在准备阶段申请的工具集(toolSet)等作用域资源,无论准入阶段是被拒绝、消息为空还是中途被取消,都必须在退出路径上被确定性地回收,防止资源泄漏
DSH 的解法:回合立界与三级准入控制流
了把上述边界严格锁住,DSH 在 turn() 的前半段设计了三步克制的控制流:
-
校验运行状态并确立回合边界(turn/start) 进入 turn() 后,驱动器首先校验当前阶段是否确实为 running,并提取本轮专属的中断信号(AbortSignal)。确认未被取消后,将回合号 turn 递增 1,向 Session 不可变事件日志写入本轮的第一条边界事件 turn/start,同时将初始消息认领目标设为 'next-turn'。
-
调用 preStep() 发起步进准入提案 随后进入内部 while (true) 循环的第一圈(step = 1),调用 this.preStep(target, { turn, step })。这一步负责从收件箱认领(claim)本轮待处理消息、锁定模型配置快照、装配工具集与系统提示词,并经过插件拦截瀑布流(agent/pre-step),最终返回一个结构化的准入决策 decision。
-
准入闸门分流:零消耗退场或正式立步(step/start) 拿到 decision 后,主循环没有直接执行模型推理,而是先经过两道准入分流检查:
-
显式拦截拒绝(decision.kind === 'reject'):如果前置插件明确驳回了本次提案(preStep() 内部此时已自行释放 toolSet),驱动器直接将本轮结束原因标记为 { kind: 'blocked' } 并返回 false 退出(触发 finally 块写入 turn/end)。
-
空消息批次退场(phase.step === 0 && decision.messages.length === 0):如果插件返回了 enter 决策但把首步消息列表改写为空(或者唤醒消息在认领前已被移除),驱动器同样不开启 step/start、不发起任何大模型请求,直接将结束原因标记为 { kind: 'completed' } 返回 false,同时借助 try/finally 自动释放 decision.toolSet。
-
准入放行(写入 step/start):只有同时通过上述两道检查,驱动器才会向日志写入 step/start 并正式更新 phase.step,确保日志里的每一个执行步都是有效且可追溯的。
以下为 packages/core/agent-loop/src/agent.ts 中的真实源码切片:
下一期预告(EP.04)
这一期我们看清了 turn() 如何立住回合边界,并通过 decision 准入闸门拦截掉无效请求。而真正负责从收件箱取出消息、锁定配置快照、装配上下文并执行拦截决策的核心方法,正是上面这行 await this.preStep(target, { turn, step })。
下一期(EP.04),我们就直进 入preStep() 的完整源码:看它是如何精确协调收件箱认领、系统提示词组装、工具集解析以及 agent/pre-step 插件瀑布流的
沿着这个主题继续读
从一篇文章,找到相关的教程、经验和阅读路径。






