dsh-balance-plugin

💰 DeepSeek Balance Monitor & Usage Stats

A DeepSeek Harness (DSH) plugin — balance monitoring · official top-up link · Miyu-style usage statistics · third-party plugin manager

✨ Features · 📥 Install · 🖼 Screenshots · ❓ FAQ · 📖 Docs · 🌐 中文

✨ Features

📥 Install

Prerequisites

• DeepSeek Harness installed and running
• (Optional) DeepSeek API Key — get one at platform.deepseek.com; if DEEPSEEK_API_KEY is already configured on this machine, the plugin re-reads it on every poll — changing the key needs no restart

One-click install (recommended)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex

Restart DeepSeek Harness after installation — three icon buttons appear on the right of the input box. Use DSH_PROFILE=<name> to target another profile.

Update the plugin

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | UPDATE=1 bash

# Windows PowerShell
irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex
# Then in PowerShell run: $env:UPDATE='1'; irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex

Or click "Check Update" → "Update" in the DSH plugin panel (recommended).

Uninstall the plugin

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/uninstall.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/uninstall.ps1 | iex

🖼 Screenshots

Screenshot	Description
	Three icon entries on the right of the input toolbar plus a persistent balance bar below
	Balance monitoring panel: balance table, low-balance alerts, account config, thresholds & refresh interval, top-up entry
	Usage page top: range switcher, stat tiles, live performance metric bar, GitHub-style usage calendar
	Usage page bottom: trend bar chart, model consumption details, call record details
	Third-party plugin manager: stat badges, plugin list, "Open Directory" action

❓ FAQ

Q: Are my settings preserved after restart? A: Settings are automatically persisted to config.json in the plugin directory and restore after restart.

Q: Will the plugin still be there after a restart? A: Yes — static plugins are installed persistently and survive restarts. The auto-read DEEPSEEK_API_KEY account needs no reconfiguration and restores automatically after restart.

Q: I can't see the entry button at the bottom of the sidebar? A: The DSH sidebar bottom slot is exclusively occupied by the official Cordis panel plugin. This plugin's entry is fixed on the right of the input toolbar and does not depend on that slot.

Q: Will my Key leak? A: No. Keys are saved only in config.json in the plugin directory on your machine and the UI only shows masked values; neither the source code nor the README contains any secrets.

Q: Why not use dsh plugin add dsh-balance-plugin? A: A third party owns a same-named package on npm (dsh-balance-plugin@0.1.0), so the bare name would install the wrong one. Use the one-click script or the github: source.

See the full FAQ for more questions.

📖 Docs

💬 Community

👥 Contributors

Made with contrib.rocks.

📄 License

MIT © 2026 Black Cat (yxxbc)