DeepSeek Harness plugin

dsh-balance-plugin-francisx

DeepSeek 余额监控与用量统计(DSH 插件):余额监控 · 官方充值入口 · Miyu 风格用量统计 · 三方插件管理

Jump to install

Source facts

Repository
Francis-Xavier-code/dsh-balance-plugin
Latest update
Aug 21, 2026
Category
Plugin Markets & Managers
GitHub stars
54
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Francis-Xavier-code/dsh-balance-plugin
Plugin: dsh-balance-plugin-francisx
Author: Francis-Xavier-code

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.en.mdSource · read only
README language

<div align="center">

💰 DeepSeek Balance Monitor & Usage Stats

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

![license](LICENSE) ![platform](https://github.com/Francis-Xavier-code/dsh-balance-plugin) ![version](https://github.com/Francis-Xavier-code/dsh-balance-plugin)

[✨ Features](#-features) · [📥 Install](#-install) · [🖼 Screenshots](#-screenshots) · [❓ FAQ](#-faq) · [📖 Docs](#-docs) · 🌐 中文

</div>

---

✨ Features

ModuleCapability
Balance monitoringMonitors DeepSeek API balance (CNY / USD dual balance pool) with parallel multi-account queries; auto-reads the DSH credential DEEPSEEK_API_KEYno manual entry needed
Low-balance alertsIndependent CNY / USD thresholds (default ¥10 / $2, configurable); the balance bar turns red when below threshold
One-click top-upJumps straight to the official DeepSeek top-up page platform.deepseek.com/top_up, plus a usage-details page link
Usage statistics1:1 recreation of the Miyu WebUI usage page: stat tiles / GitHub-contribution-style usage calendar / three-segment stacked trend bar chart / model consumption donut chart with detail table / recent 50 call records
Performance metricsTurns · steps · LLM duration · tool-call duration · avg first-token latency · tok/s · cache hit rate
Third-party plugin managerLists unofficial (non-@deepseek-ai) web plugins: package name / local path / Bundle rev / dependencies, with a one-click "Open Directory" to locate source code
Model toolRegisters the query_api_quota tool — just ask "How much DeepSeek balance is left?" and get a balance summary
Persistent settingsConfig auto-saves to config.json in the plugin directory and restores after restart
One-click updateCheck for updates and update directly in the DSH plugin panel — no manual operations needed

---

📥 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 auto-reads it at startup — no manual input required

One-click install (recommended)

macOS / Linux:

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

Windows (PowerShell):

irm https://raw.githubusercontent.com/Francis-Xavier-code/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/Francis-Xavier-code/dsh-balance-plugin/main/install.sh | UPDATE=1 bash

# Windows PowerShell
irm https://raw.githubusercontent.com/Francis-Xavier-code/dsh-balance-plugin/main/install.ps1 | iex
# Then in PowerShell run: $env:UPDATE='1'; irm https://raw.githubusercontent.com/Francis-Xavier-code/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/Francis-Xavier-code/dsh-balance-plugin/main/uninstall.sh | bash

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

---

🖼 Screenshots

ScreenshotDescription
![Input preview](assess/输入框预览.png)Three icon entries on the right of the input toolbar plus a persistent balance bar below
![Wallet settings](assess/钱包设置页面.png)Balance monitoring panel: balance table, low-balance alerts, account config, thresholds & refresh interval, top-up entry
![Usage stats top](assess/用量统计界面-顶部.png)Usage page top: range switcher, stat tiles, live performance metric bar, GitHub-style usage calendar
![Usage stats bottom](assess/用量统计界面底部.png)Usage page bottom: trend bar chart, model consumption details, call record details
![Plugin manager](assess/三方插件管理界面.png)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](docs/faq.md) for more questions.

---

📖 Docs

DocumentDescription
[Configuration](docs/configuration.md)Detailed settings, persistence, update methods
[Architecture](docs/architecture.md)Dual-face architecture, RPC routes, persistence
[FAQ](docs/faq.md)Full FAQ, troubleshooting, installation issues
[Contributing](.github/CONTRIBUTING.md)How to contribute

---

💬 Community

<div align="center"> <img src="assess/qq-qun.png" alt="QQ Community" width="220" /> </div>

---

👥 Contributors

<a href="https://github.com/Francis-Xavier-code/dsh-balance-plugin/graphs/contributors"> <img src="https://contrib.rocks/image?repo=Francis-Xavier-code/dsh-balance-plugin" /> </a>

Made with contrib.rocks.

---

📄 License

[MIT](LICENSE) © 2026 Black Cat (Francis-Xavier-code)