MIT-licensed native DSH plugin for DeepSeek balance monitoring and usage analytics — multi-account CNY / USD balance, low-balance alerts, one-click top-up, Miyu-style usage dashboard, and a `query_api_quota` model tool. Reads `DEEPSEEK_API_KEY` automatically; settings persist in config.json.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-02
License
MIT
01What can it help you accomplish?
Keep your DeepSeek API credit in view across CNY and USD balance pools without leaving DeepSeek Harness
A live balance bar per account (multi-account parallel query) with configurable low-balance thresholds (default ¥10 / $2) that turns red when a balance drops below the line, plus a direct link to the official top-up page
DSH users who top up a DeepSeek account and want balance visibility next to the chat input
Understand where your DeepSeek tokens go from inside the harness
A Miyu-style usage dashboard — GitHub-style usage calendar, stacked trend bars, model-consumption ring chart and detail table, the last 50 call records, plus round / step / latency / tok-s / cache-hit metrics
Heavy API users who want to spot costly models and track cache-hit rate
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness must be installed and running — the README says it must be installed and running first
- A DeepSeek API Key is optional: if your machine already has the `DEEPSEEK_API_KEY` credential, the plugin reads it automatically on launch and you never type it in
Installation steps
- 01
macOS / Linux: run `curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | bash`
$ curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | bash
- 02
Windows (PowerShell): run `irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex`
- 03
Restart DeepSeek Harness; the three icon buttons on the right of the input box appear and the plugin is active. Use `DSH_PROFILE=<name>` to target another profile.
Verify the integration
- After restart, three icon buttons show up on the right of the input box — that is the success signal
03DSH integration and capability boundaries
Native DeepSeek Harness (DSH) plugin — installs into the DSH plugin panel and lives in the input-box tool row, not an external bridge.
Balance monitor (CNY / USD dual pool)
DSH `DEEPSEEK_API_KEY` credential (read automatically) or a configured DeepSeek API Key→Multi-account parallel balance query for CNY / USD pools; low-balance alert turns the bar red under threshold
Usage analytics dashboard
Your DeepSeek call history (pulled from the account)→Miyu-style usage calendar, stacked trend bars, model-consumption ring chart and table, last 50 call records, plus round / step / latency / tok-s metrics
query_api_quota model tool
A natural-language question such as "how much DeepSeek balance is left"→A balance summary returned by the registered `query_api_quota` tool
Third-party plugin manager
Unofficial (non-`@deepseek-ai`) DSH web plugins installed locally→A list with package name / local path / bundle rev / dependencies, and a one-click "open directory" to locate the source
04Who is it for? When not to use it?
Good for
- DSH users who top up a DeepSeek account and want balance visibility next to the chat input
- Heavy API users who want to spot costly models and track cache-hit rate
Not for
- Do not run `dsh plugin add dsh-balance-plugin` — an unrelated same-name package (`dsh-balance-plugin@0.1.0`) exists on npm, so the bare name installs the wrong one. Use the one-click script or a `github:` source.
05Compatibility, maintenance and safety notes
- Do not run `dsh plugin add dsh-balance-plugin` — an unrelated same-name package (`dsh-balance-plugin@0.1.0`) exists on npm, so the bare name installs the wrong one. Use the one-click script or a `github:` source.
- Your API key is stored only in the local plugin directory `config.json` and shown masked in the UI; the source code and README contain no secrets.
- The plugin entry buttons live in the input-box tool row on the right, not the sidebar bottom slot (which the official Cordis panel plugin occupies exclusively), so don't look for them in the sidebar.
MIT · latest release v1.3.0 (2026-08-22)
06Frequently asked questions
Do my settings survive a restart?
Yes — settings are auto-persisted to `config.json` in the plugin directory and restored on restart.
Does the plugin itself survive a restart?
Yes — it is a static plugin installed persistently, so it is still there after restart; the auto-read `DEEPSEEK_API_KEY` needs no re-entry.
I don't see the entry buttons at the bottom of the sidebar?
The plugin entry is fixed to the right of the input-box tool row and does not use the sidebar bottom slot, which the official Cordis panel plugin occupies exclusively.
Will my API key leak?
No — the key is stored only in the local plugin directory `config.json` and shown masked in the UI; the source code and README contain no secrets.
Why not `dsh plugin add dsh-balance-plugin`?
An unrelated same-name package (`dsh-balance-plugin@0.1.0`) exists on npm, so the bare name installs the wrong one. Use the one-click script or a `github:` source.
07Related DSH workflows
dsh-context
by bowenliang123
Context dashboard tab + /context command showing context-window composition, per-turn history, compaction/prune events, per-message token costs
api-relay-audit
by toby-bridges
Local security audit for AI API relays and LLM proxies: detects prompt injection, model substitution, tool-call rewriting, SSE anomalies, error leakage, and Web3 wallet risks.
awesome-deepseek-harness-plugins
by zhiyuan-fan
Curated DeepSeek Harness (DSH) plugins, extensions, tools, skills, clients, runtimes, integrations, and verified references — English and Chinese.
awesome-ai-pedia
by awesome-ai-pedia
One-stop AI resource encyclopedia for dsh — LLMs, agents, RAG, multimodal, MLOps, AI tools, vibe coding and learning roadmaps, constantly updated.
08Data and sources
DeepSeek Harness（DSH）插件
在 DSH 插件面板内直接检查更新并一键更新，无需手动操作
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-02. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.