dsh-loop-guard
在终端中运行以下命令:
dsh plugin install xfgil/dsh-loop-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install xfgil/dsh-loop-guard,或按仓库 https://github.com/xfgil/dsh-loop-guard 说明手动加入 profile bundles。
插件介绍
跑 Agent 时,两种失败很常见:同一文件或命令被反复改写、重试十几遍,用户界面却只剩「一直在思考」;或者工具一路狂跑、几分钟里一句正文都没有。这和上下文太长不是一回事——就算把上下文压短,模型仍会在同一个坑里换姿势继续撞。
dsh-loop-guard 挂在宿主通用的 pre-step 与 tools.guard 上,在每次工具调用前记账。同一目标被动过多次、完全相同的调用重复、连续失败换工具也救不了、或单轮调用数触顶时,会拒绝这次调用,并把一句带「别的出路」的说明当作工具结果喂回去,推动直接向用户交代已试什么、卡在哪、需要谁拍板。另有一条长任务播报:本轮已跑过设定时长却还没说过正文,会在下一步注入进展提醒;若 Agent 已在同步,则不再多嘴。
它只维护「本轮」指纹账本,轮末清账,不改 system prompt,也不判断任务该不该做。零依赖,对所有会话一视同仁,适合任何希望减少原地打转和长时间沉默的 DSH Agent 工作流。
使用场景
- 写脚本—运行—小改再跑,同一文件被动十几次仍不停
- 单轮工具调用很多、界面长时间只有思考无正文
- 连续失败换工具仍走不通,需要强制停下来向用户说明
适合人员
- 日常跑 DSH Agent 且遇到过原地打转的人
- 希望长任务中间有进展同步、别被晾着的人
- 做通用 Agent 钩子、不想绑特定渠道或人格插件的开发者