dsh-plugin-agent-budget
在终端中运行以下命令:
dsh plugin install winter-street/dsh-plugin-agent-budget
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install winter-street/dsh-plugin-agent-budget 即可安装该插件,完整源码地址为 https://github.com/winter-street/dsh-plugin-agent-budget
插件介绍
在 DeepSeek Harness 的多代理工作流中,一个根代理可能派生若干子代理并触发 workflow 后代,Token 消耗分散在各次调用中,难以统一设限。dsh-plugin-agent-budget 将整棵代理树视为一个共享预算账户(scope: tree),也可按会话独立计费(scope: session),让管理员或模型自身都能在调用发生前感知剩余额度,超限后以 TOKEN_BUDGET_EXHAUSTED 错误 fail-closed 拒绝后续请求。
插件把账本以 append-only 事件流写入插件自有的侧车目录(默认 ~/.dsh/agent-budget/),不混入会话日志,卸载插件即可完整保留所有历史会话。账本可重放、可恢复,旧版本混入会话日志的 budget 事件还能通过一次迁移工具清理。模型侧可调用只读的 budget_status 工具获取限额、已用、剩余及四个用量分桶;Web 客户端的设置页面则提供进度条可视化,支持在线调整限额与重置用量,无需手动编辑文件。
该插件无外部服务依赖,以纯本地 bundle 形式运行,适合正在使用 DSH 子代理、workflow、compaction 等多节点工作流并希望将 Token 用量纳入统一预算管控的开发者。
使用场景
- 统一管理根代理与子代理、workflow 后代的 Token 总消耗,防止预算无限膨胀
- 为每个会话设置独立 Token 上限,避免单个会话耗尽全部资源
- 让模型在调用前通过只读工具自查剩余额度,超限后自动拒绝后续请求
适合人员
- 使用 DSH 子代理或 workflow 多节点工作流、需要统一 Token 设限的开发者
- 希望将多会话、多代理的用量纳入集中预算管控而不依赖外部服务的团队
- 正在构建或扩展 DSH 插件生态、关注 fail-closed 计量语义的贡献者