173787247/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.2.0-rc.2）— 套件唯一真源
套件档位	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