dsh-deepseek-usage
In a curated listMaintenance: Activedougen/dsh-deepseek-usage
Shows a card in the sidebar footer with the DeepSeek account balance (read from the official /user/balance endpoint with the API key DSH already stores) and the unit prices of the active model — input, cache read and output — taken from a built-in snapshot of the official price table. A dot marks the current billing window and a countdown shows the time left until it flips: peak is Mon–Fri 9:00–12:00 and 14:00–18:00 Beijing Time, excluding Chinese public holidays, and everything else is off-peak. Prices and the dot appear only for official DeepSeek models; for any other model the card shows the balance alone. The card refreshes every 30 seconds, on click, and when the model changes, and follows the app theme and the DSH language.
$ dsh plugin add dsh-deepseek-usageInstall
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 work10
stars
6
forks
JavaScript
Language
2026-09-24
Created
2026-11-18
Last push
README
dsh-deepseek-usage
English | 中文
A DeepSeek Harness (DSH) sidebar plugin that shows, right in the DSH main window, how much money or quota is left on the account behind the currently selected model, and what that model costs right now — without leaving DSH. It supports nine providers.
Balance mode (DeepSeek, Kimi, Z.ai, OpenRouter…): the account balance, the current model's input / cache / output unit prices, and the peak / off-peak indicator in the top-right corner.
Subscription mode (Kimi For Coding, OpenCode, MiniMax, Claude Code / Codex…): one D-shaped gauge per usage window — the number in the middle is the remaining quota, the grey arc is what has been used, the green arc is what is left (red once 80% is used), and the badge names the window (5H = 5-hour, 7D = weekly, 1M = monthly).
What this plugin does
DSH lets you switch between many model providers, but each provider hides its account status on a different website. This plugin resolves the provider behind the model you have selected in DSH and puts a live status card for that account at the bottom of the sidebar:
- Account reading. Two forms, depending on what the provider offers:
- Balance providers (DeepSeek, Moonshot / Kimi, Z.ai, OpenRouter) publish the account balance, so the card shows it with its currency symbol (
¥/$). - Subscription providers (Kimi For Coding, OpenCode, MiniMax, Claude Code, OpenAI Codex) publish no balance, only usage windows. The card draws one gauge per window — 5-hour, weekly, monthly, whatever the endpoint returns — and shows how much of each quota remains, turning red once 80% is used.
- The card always follows the selected model, so switching provider switches the reading; no per-provider setup beyond the credential.
- Balance providers (DeepSeek, Moonshot / Kimi, Z.ai, OpenRouter) publish the account balance, so the card shows it with its currency symbol (
- Unit prices of the current model. The card lists input, input-cache and output prices for the billing period in effect right now, in the provider's own currency. When a provider bills by time of day — DeepSeek's official peak / off-peak schedule (Mon–Fri 09:00–12:00 and 14:00–18:00 Beijing time is peak, evenings, weekends and holidays are off-peak) or OpenRouter's time-of-day pricing — an orange / green dot marks which window is active, and hovering it shows the time left until the next switch.
Installation and usage
Step 1 — configure the provider's credential. The plugin queries each provider with the key you already use for that provider: fill it on the Models page in DSH, or export it as an environment variable (DEEPSEEK_API_KEY, MOONSHOTAI_API_KEY, ZAI_API_KEY, OPENROUTER_API_KEY, KIMI_CODING_API_KEY, OPENCODE_API_KEY, MINIMAX_API_KEY, …). The deepseek-account route is the exception: it needs no key — sign in to DeepSeek inside DSH and the card reads that account grant.
Step 2 — install the plugin into the web profile:
dsh plugin --profile web add @dougen/dsh-deepseek-usage
Step 3 — restart dsh web and open the URL it prints. The card sits at the bottom of the sidebar, below the Cordis panel button; click it to refresh right away. Provider mappings and subscription tokens are configured in Settings → DeepSeek Usage; when the route behind the selected model is not supported, the card offers a Set up mapping button that opens that page directly.
Using a Claude Code / OpenAI Codex subscription (OAuth)
An API key cannot read these subscriptions — they share an OAuth token instead. When DSH detects Claude Code or OpenAI Codex (or a provider mapping targets one of them), a token field appears in Settings → DeepSeek Usage, under the provider mappings. Paste the token there and the sidebar card starts reporting that subscription's remaining quota:
- Claude Code — on a machine signed in to Claude Code, copy
claudeAiOauth.accessTokenfrom~/.claude/.credentials.json(on macOS: theClaude Code-credentialskeychain item). A token minted byclaude setup-tokenalso works. - OpenAI Codex — copy
tokens.access_tokenfrom~/.codex/auth.jsoninto the token field, andtokens.account_idinto the account ID field.
Tokens are stored through DSH's credential service (~/.dsh/.credentials.yaml) and never leave this machine: no response, log line or page element carries one back. The Clear button removes them again.
Uninstall
dsh plugin --profile web remove @dougen/dsh-deepseek-usage
Then restart dsh web.
Supported DSH versions
Use a plugin version that matches your DSH:
| DSH version | Plugin version to install |
|---|---|
0.2.x (from 0.2.0-rc.1 on) |
0.11.0 or later |
0.1.x (from 0.1.0-rc.6 on) |
0.10.x, or 0.11.0 or later |
Run dsh --version to check your DSH version. Installing without an explicit version picks the newest compatible release automatically; if the newest release does not match your DSH, pin an exact one, e.g. @dougen/dsh-deepseek-usage@0.10.2.
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 路由)
