失败熔断器 icyaaaww/dsh-tool-failure-circuit-breaker

dsh-tool-failure-circuit-breaker

一个 DeepSeek Harness 防护插件，当某个工具调用已经反复失败后，阻止 agent 使用相同参数再次派发同一个工具。当模型重试一个无法成功的未变更操作时，它可以节省工具延迟、网络请求、命令执行以及提供商成本。

该插件有意比官方的 @deepseek-ai/dsh-repeat-tool-reminder 更窄：官方插件会对每一次重复调用给出建议，但从不阻止调用。本插件只观察权威的失败 tools/result 结果，并在达到配置的阈值后拒绝下一次相同的派发。

该包面向 DeepSeek Harness 0.1.1-rc.2，并已针对其进行组合。

安装

从本检出目录的父目录执行：

dsh plugin --profile web add ./dsh-tool-failure-circuit-breaker

对于 Harness 的源码检出，请将 dsh 替换为 pnpm dsh。

配置

包含的 bundle 会插入以下行：

- id: tool-failure-circuit-breaker
name: dsh-tool-failure-circuit-breaker
config:
maxFailures: 2
include: []
exclude: []
errorPreviewChars: 300

- maxFailures：在下一次尝试被拒绝之前，允许的已完成相同失败次数。默认值：2。
- include：要防护的 通配符工具名模式。为空时防护所有工具。
- exclude：绕过防护的 通配符工具名模式。
- errorPreviewChars：在拒绝信息中重复的最新失败的最大字符数。默认值：300。

对于其预期契约要求进行未变更轮询调用的工具，请使用 exclude。

行为

失败链按每个活动 agent 隔离，并以工具名加上规范化 JSON 参数作为键。对象键顺序不会改变身份。一次成功的工具结果、一条新的用户消息，或一次参数不同的失败调用，都会打开上一个熔断。没有 agent 的调用会被忽略。

该防护在 tools/pre-execute 处监听，因此被拒绝的重试永远不会到达工具主体。它观察不可变的 tools/result 事件，并且不会将自己的拒绝计为另一次操作性失败。

当熔断打开时，模型会看到其原始工具错误。一旦被阻止，它会收到：

The identical call already failed consecutive times. Last failure: . Change the arguments or approach, inspect external state, or ask the user instead of retrying unchanged.

该拒绝会作为正常的工具结果被记录，因此重放和模型历史与 Harness 行为保持一致。该插件不添加任何工具 schema，在阻止调用之前也不添加任何 token。

测试

npm test

限制

- 状态保存在内存中，当进程或插件重启时会重置。
- 已经派发的并行调用可能全部失败，之后阈值才能阻止后续调用。
- 精确的规范化参数匹配无法检测近乎相同的重试。
- 阻止功能通过安装该 bundle 选择启用；对于合法的重复探测，请选择排除项。