会话工具调用限额173787247/dsh-tool-budget

dsh-tool-budget

DeepSeek Harness 插件：按单场会话工具调用预算做硬拦截。

与 dsh-repeat-stop 搭配。属于 dsh-wsl-kit。

English → README.md

在套件里的位置

单个会话的工具调用到达预算就硬停。完全相同的循环是 dsh-repeat-stop。

flowchart LR
calls["同一会话的工具调用"] --> budget["dsh-tool-budget"] --> stop["硬停"]

整套关系图和版本快照：dsh-wsl-kit 中文说明。本插件是 0.1.2（daily）。不要把那份总表抄进本 README。

兼容性

| 项 | 值 |
|----|----|
| 插件 | dsh-tool-budget 0.1.2 |
| 最低 dsh | ≥ 0.1.2（Windows 中继 :3081 一次性 ?token=） |
| 最新验证 | 以 dsh-wsl-kit 兼容性 为准（当前 0.1.5-rc.1）— 套件唯一真源 |
| 套件档位 | daily（亦含于 github / full；fetch+net 亦在 llm） |
| 云端 Flash | settings / llm-deepseek 使用 deepseek-flash（V4.1 Flash）；本插件不配置模型 id |
| Agent Teams | 上游实验包；本插件不依赖 |

套件版本地板：check-plugin-versions.sh。故障树：TROUBLESHOOTING.zh.md。

为什么需要

dsh-repeat-stop 管的是「同一工具 + 同一参数」连击刷屏。本插件管的是「一场会话里换着花样调很多工具、没完没了」——长 WSL 任务容易把 API 额度烧光时特别有用。

默认允许 80 次计入统计的调用，第 81 次拒绝。job_ 状态类工具默认不计。

这是一条安全护栏，不是产品授权上限。觉得紧就调大 maxCalls，或关掉。

安装

dsh plugin --profile web add github:173787247/dsh-tool-budget

重启 dsh web。不会出现新工具。拦截时 Trajectory 显示 dsh-tool-budget: blocked。

配置

- id: dsh-tool-budget
name: dsh-tool-budget
config:
enabled: true
maxCalls: 80
exclude:
- job_output
- job_list
- job_kill
include: []   # 若设置，则只统计这些名称

| 键 | 默认 | 含义 |
|----|------|------|
| enabled | true | 总开关 |
| maxCalls | 80 | 每场会话允许计入的调用次数 |
| exclude | job_ | 不计次的工具名 |
| include | （空） | 若设置，则只统计这些名称 |

与 dsh-repeat-stop 的区别

| 插件 | 拦截对象 |
|------|----------|
| dsh-repeat-stop | 连续相同调用 |
| dsh-tool-budget | 整场会话工具总次数 |

测试

npm test

常见问题

会不会取代 dsh-repeat-stop？ 不会。repeat-stop 拦相同连击；本插件限制整场会话总次数。

会拦 job_* 吗？ 默认不会——它们在排除列表里，方便观察长时间跑的 shell 任务。

怎么提高上限？ 在 profile 的 cordis.patch.yml 里设置 config.maxCalls，然后重启 dsh web。

许可

MIT