dsh-empty-turn-guard

兜住一类空回合：模型整轮只产出思考（reasoning），既没有正文、也没有调用任何工具，而 agent 循环把它当作正常完成收尾——界面上只有一个思考气泡，标记「已完成」，一个字没输出。

插件监听 agent/turn-stopping，用纯结构判断认出这种轮次，然后往同一轮里 steer 一条提示，让循环再走一步。

它治的是什么

在 216 个会话、13758 条 assistant 消息里统计到的 49 例「只有思考、没有输出」，按结束原因分：

结束原因	数量	说明
max-tokens	16	思考把输出额度（4096）吃光，还没轮到写正文
aborted	14	用户中断
completed	11	正常结束但零输出 ← 本插件的主要目标

其中「思考退化」有两种典型形态，都是模型侧的重复循环：

… **writing** ✅. Let me go. Hmm — **the tool call** ✅. Let me go. Hmm — the script ✅. Hmm — go.
… 做。 做。 做。 做。 做。 做。 做。 做。 做。 做。 做。 做。 做。 …

DSH 看到「没有工具调用、也没有文本」，判定模型已经给出最终答复（空），按 completed 收尾。它无法区分「模型认为不需要回答」和「模型卡死了说不出话」。

与 dsh-loop-continue 的区别

dsh-loop-continue 治的是相邻但不同的问题：模型写了「现在我重新应用修改」却忘了调用工具。它的两条硬门槛是：

1. 结束在只有文本的 step；
2. 本回合此前至少调用过一次工具。

本插件的场景两条都不满足（一个字都没有，首次 step 就卡死也可能），所以另起一个。

另一个差别：dsh-loop-continue 需要一个裁判模型判 true/false（因为「这句话是不是承诺了动作」是主观判断）；本插件是三个布尔值就能定的结构判断，不产生额外的模型调用。

安装

dsh plugin --profile <profile> add @nlflora/dsh-empty-turn-guard

本地开发：

dsh plugin --profile <profile> add link:/path/to/dsh-empty-turn-guard

配置

在 profile 的 cordis.patch.yml 里按 id empty-turn-guard 覆盖：

- id: empty-turn-guard
  config:
    enabled: true
    maxContinuations: 2        # 每轮最多补救几次
    minReasoningChars: 40      # 思考少于这个字数就不管
    detectRepetition: true     # 是否检测重复退化
    repetitionMinRepeats: 6    # 同一短语连续重复多少次算退化
    assumedMaxOutputTokens: 4096
    debug: false

字段	默认	说明
enabled	true	总开关
maxContinuations	2	每轮最多补救次数，防止无限循环
minReasoningChars	40	思考太短视为「模型就是选择不回答」，不干预
detectRepetition	true	是否做重复检测（只影响日志里的原因标注）
repetitionMinRepeats	6	判定退化的重复次数阈值
assumedMaxOutputTokens	4096	判断是否撞到输出上限
steerText	内置	常规补救提示，可整段替换
steerTextCapped	内置	撞到输出上限时的提示（要求压缩思考）
debug	false	打印每次判定

判定规则

要补救，必须同时满足：

1. 本轮没有非空 text 块；
2. 本轮没有 tool-call 块；
3. 本轮至少有一条 assistant 消息；
4. 思考文字 ≥ minReasoningChars。

不满足任何一条就放行，让回合正常结束。正常的「只调用工具不说话」的 step 有 tool-call，不会被误伤。

它不做什么

• 不改模型行为。重复退化是模型侧的问题，插件只能事后补救一次，不能保证下一次不犯。
• 不调裁判模型，所以也不增加 token 消耗。
• 不处理 aborted：用户主动中断的轮次不该被自动续上。

License

MIT