Francis-Xavier-code/dsh-balance-plugin
211Last commit Aug 15, 2026
dsh-balance-plugin DSH plugin
This plugin adds a balance monitor with multi-account support, low-balance alerts, and a one-click top-up link to the official DeepSeek platform. It also provides a full usage statistics panel inspired by Miyu WebUI, including charts, a contribution calendar, and call records. Additionally, it includes a third-party plugin manager that lists unofficial plugins and allows you to open their source directories.
How to install the dsh-balance-plugin DSH plugin
dsh plugin --profile web add github:Francis-Xavier-code/dsh-balance-pluginCopying does not run this command. Review the repository and version before installing the dsh-balance-plugin DSH plugin.
dsh-balance-plugin DSH plugin data source
dsh-balance-plugin DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-balance-plugin DSH plugin can do
- Real-time balance monitoring for CNY and USD pools with parallel multi-account queries
- Customizable low-balance alerts with color-coded indicator (red when below threshold)
- One-click navigation to DeepSeek top-up page and usage details page
- Usage statistics panel with stat tiles, GitHub-style contribution calendar, trend bar chart, model consumption donut chart, and recent 50 call records
- Performance metrics display: turns, steps, LLM duration, tool-call duration, average first-token latency, tokens per second, cache hit rate
- Third-party plugin manager listing unofficial web plugins with package name, path, bundle revision, dependencies, and 'Open Directory' action
- Model tool `query_api_quota` that can be invoked via natural language (e.g., 'How much DeepSeek balance is left?')
Where the dsh-balance-plugin DSH plugin fits
- Keep track of DeepSeek API spending and avoid unexpected charges
- Analyze historical usage patterns with detailed charts to optimize costs
- Quickly top up your account when balance is low
- Manage third-party plugins installed outside the official `@deepseek-ai` scope
- Get a quick balance summary by asking a natural language question to the model
Who the dsh-balance-plugin DSH plugin is for
- Developers who use DeepSeek API and want to monitor their balance and usage
- DeepSeek Harness users who want to extend functionality with a visual balance and usage dashboard
- Plugin developers who need to manage non-official plugins in their Harness environment
dsh-balance-plugin DSH plugin limitations
- Requires DeepSeek Harness to be installed and running; not a standalone application
- Depends on a valid DeepSeek API Key; if not pre-configured, manual entry is needed
- Historical usage data is only scanned from the last 90 days at startup
- Average first-token latency is only available for streaming data captured after the plugin is running
- The third-party plugin manager only lists plugins not published by `@deepseek-ai` on npm, and may not reflect all installed plugins
dsh-balance-plugin DSH plugin: from the repository README
Quoted from the Francis-Xavier-code/dsh-balance-plugin README, the upstream source of the dsh-balance-plugin DSH plugin. Copyright remains with the original authors.
**A DeepSeek Harness (DSH) plugin** — balance monitoring · official top-up link · Miyu-style usage statistics · third-party plugin manager [](LICENSE) [](https://github.com/Francis-Xavier-code/dsh-balance-plugin) [](https://github.com/Francis-Xavier-code/dsh-balance-plugin) **🌐 [English](README.md) · [简体中文](README.zh-CN.md)** [✨ Features](#-features) · [🖼 Screenshots](#-screenshots) · [📥 Install](#-install) · [⚙️ Configuration](#️-configuration) · [🎮 Usage](#-usage) · [🗑 Uninstall](#-uninstall) · [🏗 Architecture](#-architecture) · [❓ FAQ](#-faq) </div> --- ## ✨ Features | Module | Capability | | --- | --- | | **Balance monitoring** | Monitors DeepSeek API balance (CNY / USD dual balance pool) with parallel multi-account queries; auto-reads the DSH credential `DEEPSEEK_API_KEY` — **no manual entry needed** | | **Low-balance alerts** | Independent CNY / USD thresholds (default ¥10 / $2, configurable); the balance bar turns red when below threshold | | **One-click top-u
Read the full READMERepository license: MIT
dsh-balance-plugin DSH plugin questions
Will the plugin persist after restarting DeepSeek Harness?
Yes, the plugin is installed as a static plugin and will survive restarts. However, manually added account API keys will be cleared on restart (the auto-read account using DEEPSEEK_API_KEY will restore automatically).
Why can't I see the plugin buttons in the sidebar?
The plugin buttons are located on the right side of the input toolbar, not in the sidebar. The sidebar bottom slot is reserved for the official Cordis panel plugin. Look for the wallet (💰), bar chart (📊), and grid (🧩) icons next to the text input area.
Is my API key safe?
Yes. API keys are only kept in the plugin process memory on your local machine and are never sent to any third party. The user interface only shows masked values. Neither the source code nor the README contains any hardcoded secrets.
Why does the balance query fail?
Check the error message in the balance panel. Common causes: no API key configured (`API Key not configured`), missing environment variable (`Environment variable xxx not set`), or an invalid key (401 error). Resolve accordingly.
Why is there no historical usage data?
The plugin scans session events from the last 90 days only at startup. Additionally, the 'average first token' metric is only available for streaming data captured after the plugin is running. If you just installed it, you may need to wait for new sessions to appear.