dsh-loop-brake

Agent 在无人监督时会陷入最朴素的死循环：用完全相同的参数反复调用 search，读结果，再调用，再读结果，直到预算烧完或有人发现。dsh-loop-brake 就是为这个场景设计的断路器——它只认一件事：同一会话内，同一次工具调用（参数经过规范化排序后逐字节相同）连续出现达到阈值（默认 3 次），下一次直接拒绝执行，抛出带 LOOP_BRAKE 错误码、计数、上限和调用哈希前缀的异常。原始参数永远不出现在错误信息里，日志可以放心落盘。

这个插件刻意不做语义判断、不做嵌入相似度、不引入任何模型调用。它只做精确哈希匹配，开销是微秒级，不会幻觉，凌晨三点读到拒绝日志时能立刻看懂发生了什么。它抓不住参数里藏了时间戳或分页游标的伪重复，也抓不住 A-B-A-B 交替——这是它诚实的边界，也是它和那些"看起来像"方案的根本区别。

适合所有在 DeepSeek Harness 中编排多工具 Agent、又担心某个工具链陷入空转烧光的团队。它不往模型的工具列表里加任何东西，不改变模型可见的接口，只是在已有注册表上包一层逐会话的计数与拦截；停用或重载时干净还原，不跨会话记忆。一个旋钮 maxRepeats，零运行时依赖，Node 22 即可跑起来。