yingjunnan/dsh-deepseek-quota
32Last commit Aug 14, 2026
dsh-deepseek-quota DSH plugin
This plugin adds a floating card at the bottom-right corner of the DeepSeek Harness web interface. It displays your total balance, availability, current conversation cost, and today's consumption. The card auto-refreshes and follows the app's light/dark theme.
How to install the dsh-deepseek-quota DSH plugin
dsh plugin --profile web add dsh-deepseek-quotaCopying does not run this command. Review the repository and version before installing the dsh-deepseek-quota DSH plugin.
dsh-deepseek-quota DSH plugin data source
dsh-deepseek-quota DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-deepseek-quota DSH plugin can do
- Displays total balance, granted balance, topped-up balance, and availability status.
- Shows current conversation cost with detailed token pricing on hover.
- Auto-refreshes balance every 60 seconds and conversation cost every 5 seconds, with manual refresh button.
- Supports accurate today's consumption via optional platform token, or fallback estimate based on balance change.
- Follows the application's light/dark theme using CSS custom properties.
- Explicit error states for missing API key, network failure, or provider errors.
Where the dsh-deepseek-quota DSH plugin fits
- Monitor real-time DeepSeek API balance to avoid unexpected exhaustion.
- Track the cost of individual conversations to optimize prompt engineering.
- View daily consumption to manage API budget.
- Quickly check balance without leaving the DSH web interface.
- Detect API key issues or network problems affecting quota access.
Who the dsh-deepseek-quota DSH plugin is for
- Developers using DeepSeek Harness for AI applications.
- DSH users who need to monitor API usage and costs.
dsh-deepseek-quota DSH plugin limitations
- Requires a running DSH web environment with pnpm and DSH CLI installed.
- Today's consumption is only accurate when the optional platform token is configured; otherwise it uses an estimate based on balance difference.
- Balance auto-refresh interval is 60 seconds, not real-time.
- Conversation cost is calculated using the official DeepSeek price table; any price changes not reflected in the pricing engine may cause inaccuracies.
- Only available in the DSH web GUI; no CLI equivalent.
dsh-deepseek-quota DSH plugin: from the repository README
Quoted from the yingjunnan/dsh-deepseek-quota README, the upstream source of the dsh-deepseek-quota DSH plugin. Copyright remains with the original authors.
A plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) **web GUI** that shows your remaining **DeepSeek API quota (balance)** in a floating card pinned to the **bottom-right corner** of the page.  `中文说明见下文。` ## Features - Bottom-right overlay card (registered into the frame-wide `shell.overlay` slot — additive, never blocks the app). - Shows **total balance**, availability, **current conversation cost**, **today's consumption**, and the **granted** / **topped-up** balance. - **Current conversation cost** (`当前对话费用`): the host prices every `assistant/message` with the official DeepSeek price table (incl. peak/off-peak since 2026-08-17; pricing engine ported from [dsh-web-billing](https://github.com/bpc-oss/dsh-web-billing), MIT) and reports the current session's accumulated cost via `GET /api/deepseek-session-cost?sessionId=<id>` — the whole conversation is replayed from its persisted log, so the figure includes history from before the plugin was installed. Hover the circled **ⓘ** next to the value to see the live formula with real numbers (`输入/缓存命中/输出 tokens × 单价 = 小计`, with the effective blended ¥/
Read the full READMERepository license: MIT
dsh-deepseek-quota DSH plugin questions
How do I install dsh-deepseek-quota?
Run `dsh plugin --profile web add dsh-deepseek-quota` in your terminal. This requires the DSH CLI and pnpm to be installed. After installation, restart the web app with `dsh web` and refresh the page. The balance card should appear at the bottom-right.
Why is today's consumption showing an estimate instead of the exact value?
The exact value requires a platform token from DeepSeek's official website. To get it, log in to https://platform.deepseek.com, open DevTools Console, run `JSON.parse(localStorage.getItem('userToken')).value`, and store the token as `DEEPSEEK_PLATFORM_TOKEN` in your credentials file. Without the token, the plugin uses the balance difference as an estimate.
Does the plugin send my API key to any external server?
No. The API key never leaves your machine. The browser only communicates with local routes registered by the host half of the plugin. All API calls to DeepSeek are made from your local DSH instance.
The floating card is not showing after installation. What should I do?
First, ensure you have restarted the web app with `dsh web` after adding the plugin. Then hard-refresh the browser page. If it still doesn't appear, check that the plugin is listed in your profile's bundle layers by running `dsh plugin --profile web list`. Also verify that the DSH web GUI is running on http://127.0.0.1:3080.
Can I use this plugin without the DSH web GUI?
No. This plugin is designed specifically for the DSH web interface and registers a component into the `shell.overlay` slot. It does not have a CLI version.