dsh-empty-turn-guard
在终端中运行以下命令:
dsh plugin install Paradox1278/dsh-empty-turn-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行安装命令安装本插件,或在配置中启用后从源码仓库 https://github.com/Paradox1278/dsh-empty-turn-guard 按 README 完成 profile 装配并重启客户端。
插件介绍
在 DeepSeek Harness 里,有时会出现一轮助理回复看起来「什么都没做」,界面却直接显示「已完成」,思考和工具链都停了。根因往往在于:上游把 stop_reason 译成「工具调用结束」,但消息里根本没有 tool-call 块;agent-loop 只数块、不核对结束原因,于是把残缺响应当成正常收尾。
dsh-empty-turn-guard 走官方扩展点,在 assistant 流里统计内容块与 tool-call 块,并在轮次即将关闭前介入:当判定为「声称 tool-calls 却无 tool-call」或除 usage/finish 外零产出时,通过 steer 往下一步塞简短续跑提示,让轮次继续而不是静默结束。默认关闭,异常 fail-open,并可按配置限制连续空步、单 turn 补救次数或绝对上限(0.4.0 起默认不限次数,仅保留程序性保险丝)。
适合经常在 DSH 里跑长链路 Agent、且遇到过「finish=tool-calls 但只有 reasoning/空块」的用户;也适合需要可观测介入日志(含 [empty-turn-guard] steer 消息)来确认是否真的救回轮次的调试场景。它不修改 app.asar,也不修复上游为何丢 tool-call,只负责把误标完成的轮次拉回执行。
使用场景
- 界面显示已完成,但模型既没调工具也没给出正文汇报
- finish 为 tool-calls,消息里只有 reasoning 或除 usage/finish 外零块
- 长会话中间歇出现残缺步,需要自动注入继续执行而非误收尾
适合人员
- 在 DSH 中频繁使用 Agent 循环的开发者
- 遭遇 tool-calls 与真实 tool-call 块不一致的用户
- 需要可配置 fail-open 与日志可观测的运维/调试者