dsh-session-cost-cap
限制单个会话在模型调用上的支出上限的 DeepSeek Harness 插件。跟踪实际令牌用量和价格，在接近上限时向模型发出警告，并在超出上限前停止或询问。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-session-cost-cap@0.1.0Session Cost Cap 以 dsh-session-cost-cap 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
You give the agent a task before lunch. It hits a flaky test, decides the fix is a refactor, starts three subagents to "investigate", and re-reads the same 4,000-line file twenty times. When you come back the task isn't done, and the session has cost more than the rest of your week.
This DeepSeek Harness plugin keeps a running total of what each session spends, from the token counts the model actually reports, priced per model. Subagents count toward the session that started them. As the budget runs low the model is told to wrap up, and once it's spent, tool calls stop until you approve more:
[dsh-session-cost-cap] This session has used $4.12 of $5.00 (2.4M tokens), 82% of its budget.
Finish the task efficiently: skip optional exploration, avoid re-reading large files, and batch small edits.
dsh-session-cost-cap: this session has reached its cost cap ($5.03 of $5.00 (2.9M tokens)).
The user was asked to approve this call. If they decline, stop and tell them what you finished and what is left.
dsh plugin --profile web add dsh-session-cost-cap
That's the web profile, the browser UI you start with dsh web. If you run DSH another way, use headless (scripts and CI) or acp (editor integrations) instead. Each profile keeps its own plugin list, so add it to every profile you use. It's on as soon as it's installed, with a $5 cap per session. Remove it with dsh plugin --profile web remove dsh-session-cost-cap.
It's also part of dsh-guard-pack, which installs nine guards at once.
ask, the default) or is refused (deny). Approving one lets the session spend another 50% of the cap before it asks again. In deny mode the model is told to stop and summarise what's done and what's left.If a model isn't in llm-tally's table (a local model, a fine-tune, a new release), its tokens still count toward a token cap but not toward the dollar cap, and the DSH log says so once. Give it a price under prices to fix that.
The easy way: open Plugins in DSH's sidebar, click dsh-session-cost-cap, change what you want and press Save. It applies at once, no restart needed.
Or add a row like this to ~/.dsh/profiles/<profile>/cordis.patch.yml, or to ~/.dsh/cordis.patch.yml for every profile. Keys you leave out keep their defaults.
- id: session-cost-cap
config:
maxUsd: 5 # dollars per session, subagents included; 0 = no dollar cap
maxTokens: 0 # input + output tokens per session; 0 = no token cap
mode: ask # or deny
extendBy: 0.5 # after an approval, allow 50% more of the cap before asking again
warnAt: 0.8 # tell the model at 80% of the budget; 0 = never
prices: # USD per 1M tokens, for models llm-tally doesn't know
my-local-model: { input: 0, output: 0 }
my-fine-tune: { input: 3, output: 12, cachedInput: 0.3 }
npm install # from the repository root
npm test -w packages/dsh-session-cost-cap
npm run test:e2e # real dsh runs against a scripted local model, no API key needed
MIT licensed. Written by acus9345. Bug reports and ideas are welcome in the issues.