dsh-ds-balance
In a curated listMaintenance: Activedsh-plugin-lab/dsh-ds-balance
DSH plugin: shows your DeepSeek account balance at the bottom of the left sidebar (native UI)
$ dsh plugin add dsh-ds-balanceInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work5
stars
2
forks
TypeScript
Language
MIT
License
2026-09-17
Created
2026-11-14
Last push
README
dsh-ds-balance
DeepSeek account balance in the DSH sidebar
把 DeepSeek 账户余额放进 DSH 的左边栏
Per-version changes → Releases (one-to-one with npm versions)
A status ring is pinned to the bottom of the sidebar; clicking it shows the actual balance figures. To change settings, open the Plugins page in the sidebar and pick this plugin. The key and the account both follow the official Models page, and the endpoint is the official one — none of the three is set here.
Data and credentials
The balance is read directly from the official DeepSeek API, not estimated from usage.
- The credential is resolved through DSH's credential channel; the plugin stores no key of its own: a key never lands in a settings file.
- The UI only ever sees a head-and-tail mask (
sk-cf08d*****3b84, the same shape the DeepSeek platform console uses); the full key never crosses the wire, is never logged, and is never written to any file of this plugin. - Only
api.deepseek.comis contacted; no other traffic is proxied or forwarded. - Balance snapshots are stored per credential — changing the key starts keeping records afresh, so old figures are never mixed in.
Getting started
Prerequisites: DSH on its current RC line (specify @next when installing); Node >= 20. The only source for the compatible range is engines.dsh in package.json.
-
Install the host. Neither
latestnoralphais the line we declare, so specify the version line:npm install -g @deepseek-ai/dsh@next -
Install the plugin:
dsh plugin --profile web add dsh-ds-balance -
Start (or restart)
dsh --profile web; the balance entry appears at the bottom of the sidebar.
From source: git clone, then pnpm install && pnpm run build, then dsh plugin --profile web add "$PWD" — the same restart applies.
That pnpm install cannot be skipped: under a path install the repository supplies its own dependencies, and missing them makes the plugin show as "not running".
What it shows
Three surfaces, each with one job:
| Surface | Where | What it does |
|---|---|---|
| Status ring | Pinned to the bottom of the sidebar | See at a glance how much is left and how close you are to the warning threshold |
| Balance popover | Click to expand | See the total, the granted / topped-up split, and how many minutes old the data is |
| Settings card | This plugin's details page under Plugins | Check both ways of reading your balance, and set the currency, the warning thresholds and the refresh cadence |
The entry is pinned to the bottom of the sidebar; clicking it opens the balance popover: the total, the granted / topped-up split, how many minutes ago the data was, and manual refresh at the bottom right.
The ring itself is "what is going on right now", five states you can tell apart at a glance:
| The ring | Meaning | What you do |
|---|---|---|
| Coloured ring + an arc | There is a balance; the colour says more or less | Read the number |
| Grey ring + a rotating gap | Fetching, no result yet | Wait |
| Grey ring + a + in the middle | Not connected to your account yet | Configure it |
| Grey, empty ring | Connected to your account, which simply has no balance | Nothing |
| Red ring + a cross in the middle | No usable number here | Check it |
What each thing is
More in Usage & Billing
dsh-cost-meter
by han-1413141
Cost tracking for DeepSeek Harness: session and model costs, token usage, budgets, provider balances, and coding-plan quotas. Bilingual English/Chinese UI.
dsh-usage-stats
by ychris12138
Provider balances, subscription quotas, and token-usage analytics for the DeepSeek Harness Web GUI (dsh web).
dsh-plugin-langfuse
by linyp
Langfuse observability for DeepSeek Harness (dsh): exports agent sessions as OpenTelemetry trace trees (GenAI semconv) to Langfuse's OTLP endpoint
dsh-token-usage
by laoyuehanni
按请求粒度记录模型 token 用量(按天 JSONL,首次启动自动补齐历史),Web 设置面板「Token 用量」统计页(GET /token-usage/stats 路由)
