How to use dsh-balance-plugin
A balance and usage visualization plugin for DeepSeek Harness: monitors multi-account balances, provides low balance alerts, enables one-click recharge, includes Miyu-style usage statistics, and offers a third-party plugin management panel.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
dsh-balance-plugin
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add dsh-balance-plugin
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
- DeepSeek Harness installed and running
-
- id: dsh-balance-plugin
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
Is the plugin still there after restarting DSH?
Yes. The static plugin is persistently installed and remains effective after restart; manually configured account Keys via the panel will be reset, auto-discovered DEEPSEEK_API_KEY accounts will automatically restore on startup (lib/index.js:144 discoverAutoKeys).
Why isn't the entry button at the bottom of the sidebar?
The bottom slot of the DSH sidebar is exclusively occupied by the official Cordis panel plugin; this plugin's entry is fixed on the right side of the input box toolbar (💰 Wallet / 📊 Usage / 🧩 Third-party Plugins) and the persistent balance bar below the input box (lib/client.js:799-816).
Will the API Key be leaked?
No. Keys are only stored in the memory object of the local plugin process; the UI only displays a mask (last 4 digits), and the source code and documentation contain no credentials; curl calls are forwarded through the Host shell with no disk logging (lib/index.js:33-53 authHeaderFor / keySourceOf).
What to do if the balance query fails?
Check the error message in the panel: Unconfigured Key shows 'API Key not configured'; using $env: but missing variable shows 'Environment variable xxx not set'; Invalid Key will expose DeepSeek's 401 response (lib/index.js:43-91).
Why doesn't the usage statistics have earlier historical data?
The plugin scans session events from the past 90 days on startup and deduplicates them by seq, but it can read a maximum of 60 sessions at a time (lib/index.js:345); earlier sessions or those exceeding this limit are not included in the statistics; 'Average first token latency' only counts real-time captured streaming data after the plugin starts running.
Why not directly use dsh plugin add dsh-balance-plugin?
There is another package with the same name on npm ([email protected]), and using the bare package name will install the wrong one. The installation command must use the github: source pointing to this repository (README.md:163 / install.sh:43-65).
How to uninstall?
One-click uninstall: run uninstall.sh via curl; or manually execute dsh plugin --profile web rm dsh-balance-plugin, and clean up the - insert block of this plugin in ~/.dsh/cordis.patch.yml (uninstall.sh:13-51).
Can clicking 'Open Directory' in the third-party plugins panel be used on Windows?
No. This feature executes open -R <path> through the Host shell (lib/index.js:535), which is a macOS Finder exclusive command; Windows/Linux don't have open, clicking will get an 'Open failed' error, but the list display itself still works normally.
— source: plugin_wiki.faq_json
Compatibility
- DSH: 未声明
- Node: 未声明
- Platforms: 跨平台, macOS
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule