回合预算熔断 Nunchakus888/dsh-turn-budget

dsh-turn-budget

dsh-turn-budget 是 DeepSeek Harness 的故障关闭型资源管控器。它针对每个 Agent turn 独立限制模型步数、根级与嵌套工具执行次数，以及服务商上报的精确 token 用量。

插件只使用 Harness 公开的扩展点：

- agent/pre-step 拒绝会超出步数或服务商 token 上限的模型请求。
- tools/pre-execute 在 turn 已耗尽工具调用额度时，于派发前拒绝工具主体。
- 现有的 tool/result 与 turn/end 记录会把最终策略结果写入规范 Session 日志。

这是熔断器，不是计费系统。它不估算货币金额，不重写工具参数，不替代沙箱或审批，也不会在某个步骤中途终止不配合的模型或工具操作。

从检出安装

git clone https://github.com/Nunchakus888/dsh-turn-budget.git
dsh plugin --profile web add ./dsh-turn-budget
dsh --profile web --dump-config
dsh --profile web

随附的 profile 层启用保守基线：每个 turn 24 个模型步、40 次工具执行。部署需要不同上限时，在 profile 的 cordis.patch.yml 中覆盖整行：

- update:
id: turn-budget
config:
maxStepsPerTurn: 16
maxToolCallsPerTurn: 32
maxProviderTokensPerTurn: 250000

每个配置的上限都必须是正的安全整数。至少需要配置一个上限。

执行语义

| 上限 | 执行点 | 计入的工作 | 结果 |
| maxStepsPerTurn | 下一个模型请求之前 | 当前 turn 中已进入的请求 | 拟执行的步骤被拒绝；turn 以 blocked 关闭。 |
| maxToolCallsPerTurn | 每个工具主体之前 | 根级调用，加上携带 Agent 的 Code Mode/嵌套派发 | 超额调用返回策略错误，指明超出的预算；模型保留一次机会，不再调用工具即可完成。 |
| maxProviderTokensPerTurn | 下一个模型请求之前 | 每步最新的服务商用量，含缓存读/写桶 | 上报总量达到上限后，拟执行的步骤被拒绝。 |

只有服务商上报用量时，token 执行才是精确的。缺失的服务商用量不做估算。服务商可能在当前响应内超出配置上限；由于公开生命周期不暴露抢占式 token 流预算，插件会阻止后续请求。

工具账本是进程本地的，以存活的 Agent 身份为键。冷恢复会先关闭中断的 turn，使其无法继续，因此进程重启后无法恢复旧的进行中账本。

开发

pnpm install
pnpm run check
集成测试用已发布的 Harness testkit 启动真实的 Agent Loop。覆盖范围包括：步骤拒绝、派发前工具拒绝、每轮重置、最终响应放行、服务商 token 计费，以及重复用量替换。

许可证

MIT