工具调用熔断器 George-Java/dsh-tool-governor

dsh-tool-governor

一个 DeepSeek Harness 插件，在失控的工具调用烧光 token 预算之前把它拦下来。

功能

- 重复调用熔断 —— 同一工具 + 参数组合重复 N 次后拒绝执行
- 失败循环截断 —— 工具连续失败后暂停
- 可选的每轮上限 —— maxToolCallsPerTurn / maxStepsPerTurn，默认都是 0（不限制）
- 单调守卫 —— 拒绝即终局；下游层无法重新放行已拦截的调用

安装

dsh plugin --profile web add dsh-tool-governor

安装后重启 DSH。确认插件包已注册：

dsh --profile web --dump-config | findstr dsh-tool-governor

锁定版本，或直接从源码安装：

dsh plugin --profile web add dsh-tool-governor@1.1.0
dsh plugin --profile web add github:George-Java/dsh-tool-governor

兼容性

| 项目 | 值 |
| DSH | 0.2.x（在 0.2.1-rc.2 上测试） |
| 平台 | Windows / macOS / Linux |
| Node.js | ^22.19.0 \|\| >=24.0.0 |

插件在配置档根目录挂载 tools/pre-execute、tools/post-execute、ctx.tools.guard 和 agent/pre-step，因此只需要全局 tools 服务。它从 exec.agent / event.agent 读取当前执行的智能体。

判定逻辑

- 新的用户消息会重置该智能体的账本，所以重复计数和失败计数每轮都从头开始。
- 只有结构化的 result.isError === true 才算工具失败。调用成功、只是输出里恰好提到错误，不算失败。
- maxToolCallsPerTurn 和 maxStepsPerTurn 默认都是 0：正常的长任务永远不会被截断。只有想要显式保险丝时才设正值。

配置

所有字段都可选 —— 省略时应用默认值。

| 字段 | 默认值 | 说明 |
| maxToolCallsPerTurn | 0 | 每轮最大工具调用数；0 关闭上限 |
| maxStepsPerTurn | 0 | 每轮最大模型步数；0 关闭上限 |
| repeatThreshold | 3 | 第 N+1 次相同的工具 + 参数调用时拒绝 |
| consecutiveFailureThreshold | 3 | 工具连续 N 次结构化失败后暂停 |
| denyTools | [] | 始终拒绝的工具 Glob 模式（如 ["browser_*"]） |
| denyMessage | 内置 | 调用被拒绝时注入的消息 |

通过配置档的 cordis.patch.yml 覆盖：

- id: dsh-tool-governor
name: dsh-tool-governor
config:
repeatThreshold: 5
opt-in hard caps:
maxToolCallsPerTurn: 100
maxStepsPerTurn: 50

卸载

dsh plugin --profile web remove dsh-tool-governor

许可证

MIT