dsh-loop-guard

多Agent工作流中最隐蔽的资源浪费，往往不是一次调用失败，而是同一个工具调用被反复执行、返回完全相同的结果。Agent 在原地打转，不断消耗步骤和 Token，却产不出任何新信息。dsh-loop-guard 要解决的正是这种看似在跑、实则空转的卡死循环。

它的核心设计是结果感知：只有调用名、规范排序后的参数和返回结果三者完全一致时，才计入重复链。这意味着轮询一个状态在推进的任务、编辑后重新读取文件、重试一条最终表现不同的命令，都不会触发守卫，合法重复被天然放行，无需任何工具名白名单配置。在此基础上，守卫采用两阶段机制：软阶段（默认连续4次）向模型注入提示，告知其调用已完全重复、即将被拒绝，请基于已有信息采取行动；硬阶段（默认连续8次）直接拒绝下一次相同调用并返回纠正性反馈，链在拒绝期间保持冻结，直到模型改变行动才解除。

dsh-loop-guard 与官方包自带的 repeat-tool-reminder 互补而非替代：后者基于参数相同即提醒、纯建议不拦截；本插件额外要求结果相同才介入，且是唯一能在硬阈值处真正终止循环的那一个。两者可同时启用——提醒在前、守卫兜底。适合跑多Agent管线、使用多Harness LLM网关、或经常遇到Agent不报错但不前进问题的开发者。