dsh-bill
DSH 费用统计插件：会话费用明细 + 成本归因报告，使用 llm-pricing 动态定价。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-bill@0.17.0DSH 成本归因和使用情况仪表板，使用 llm-pricing 定价。
Bill 以 dsh-bill 发布，当前版本为 0.17.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Cost tracking for DSH (DeepSeek Harness). A line under each turn tells you what that turn cost; the Cost tab tells you what the money went on.
Per-turn cost in the conversation
dsh plugin --profile web add dsh-bill
Restart dsh web to pick it up.
git / pnpm / rg), tool input, attachments, system reminders, user input. The sunburst drills in.bill_stats, so the model can answer questions about spend directly. agentTool: false in the plugin config leaves it unregistered, for anyone who never asks the model about spend and would rather not pay its schema on every request.Three substantive differences:
No hand-maintained price table. Every other plugin ships a built-in table of 2–4 DeepSeek models, which means no prices at all once you switch provider — and which is why they all need a "edit the price table by hand" entry point. dsh-bill pulls models.dev and OpenRouter through llm-pricing, covering 8000+ entries, so a new model is priced the day it ships.
Price is a timeline, not a number. The others compute a cost and store it (or recompute at today's price), so history goes wrong the moment a vendor changes its rates or a call crosses a peak/off-peak boundary. dsh-bill prices each call at that call's own instant, and never recomputes history.
It answers "on what". The others answer only "how much" — they consume the provider's aggregate token counts and never look at the request content. dsh-bill splits the request into classified segments at capture time and apportions cost by position in the cache prefix.
They do some things better: usage-stats reads balances and subscription quotas from 11 providers (dsh-bill only does DeepSeek), cost-meter can read OpenCode Go's subscription quota, and both surface more always-on entry points than dsh-bill does.
The sample is the cost-related plugins under the GitHub dsh-plugin topic with ★ ≥ 40, plus the four published to npm. Lower-starred plugins such as deepseek-harness-wallet were not checked individually.
| dsh-bill | cost-meter | usage-stats | dsh-cost | cost-log | dsh-usage | usage-billing | |
|---|---|---|---|---|---|---|---|
| stars / version | — | ★42 / 1.3.1 | ★40 / 0.2.0 | ★3 / 0.2.1 | ★2 / 1.0.0 | ★2 / 0.1.1 | 0.2.2 |
| price source | online catalogue | built-in table + hand-scraped docs | none | built-in table | built-in table | user-entered | built-in table |
| models covered | 8000+ entries | 4 DeepSeek | — | 4 DeepSeek | 2 DeepSeek | one at a time, by hand | DeepSeek |
| unlisted model | flagged, excluded from totals | billed at flash rate | flagged unknown | billed as v4-pro | flagged ≈ | flagged -- | counted as 0 |
| history never recomputed | ✓ | ✗ | — | ✗ | ✓ | ✓ | manual backfill |
| content attribution | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
| forecast | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
| budget | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| account balance | ✓ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
| pre-install history | ✓ | ✗ | ✓ | ✗ | ✓ | ✓ | ✓ |
| agent tool | ✓ |
? and excluded from totals — nothing is estimated;priceOverrides can override or add any price (rarely needed).Every request pays for the full context again, so one tool output read into the conversation keeps being billed on every subsequent request until it slides out of the window. Attribution is computed per request and summed.
Two things matter:
Per-segment token counts are estimated from character share (providers return only a total), and the total is the real billed figure, so the parts sum exactly to what you paid.
The session log holds token counts and model routes but not the request bodies — which is why pre-install history can be backfilled as spend, but cannot be attributed retroactively. The report states what fraction is covered.
The budget, its currency, the display currency shared by every figure, and which of the four surfaces are shown are all set on the Cost page in settings, and stored in $DSH_HOME/dsh-bill/prefs.json. The two currencies are separate settings: the budget's is the promise ("¥100 a month") and does not follow the display. (Not in the harness's own settings document: its API proxy serves a fixed allowlist of namespaces to the browser, so a plugin's namespace is never readable or writable from there.)
maxRecords (the in-memory ring buffer size, default 20000), agentTool (register bill_stats, default true) and priceOverrides are plugin config and are validated at startup — a mistyped field is reported by name rather than leaving the report quietly empty. ~/.dsh/profiles/web/cordis.patch.yml is only needed when you want to override a price:
- insert:
- id: bill
name: 'dsh-bill'
config:
priceOverrides:
'anthropic/claude-sonnet-4-6':
inputPerM: 3.0 # USD per million input tokens (uncached)
outputPerM: 15.0
cacheReadPerM: 0.3
cacheWritePerM: 3.75
$DSH_HOME/dsh-bill/records.jsonl (a 20 000-entry ring buffer; older entries are folded into a rollup);| Layer | How |
|---|---|
| Capture | hooks the llm/stream waterfall, wraps the stream to observe usage chunks, passes everything through untouched |
| Pricing | llm-pricing resolves catalogue / peak rate / override at the call's own instant |
| Attribution | the request is split into classified segments at capture time and apportioned by position in the cache prefix |
| Backfill | scans the session log for sessions it never recorded, deduplicating on turn:step |
| Per turn | the billTurns session projection folds the session log host-side and pushes to the client — no polling |
| Storage | in-memory ring buffer plus append-only JSONL, folded into a rollup before eviction; preferences in their own small JSON document; atomic replace and file locking borrowed from dsh-atomic-write |
| Transport | the ctx.connection.rpc channel /dsh-bill when there is one, falling back to POST /dsh-bill/api |
| UI | conversation.view / conversation.chat.turnTail / conversation.composer.dock / sidebar.footer.action / settings.section, built on the host's --dsw-* design tokens |
MIT
| ✗ |
| ✗ |
| ✗ |
| ✗ |
| ✗ |
| ✓ |
| currencies | 166, live rates | 3, fixed rates | — | follows UI language | ¥/$ | single | ¥ only |