Preface¶

When running long sessions or orchestration tasks in DeepSeek Harness (DSH), your account balance is continuously consumed with each model call. Usage statistics in other parts of the interface may not sync with the wallet amount. Checking the platform side separately not only interrupts your workflow but also makes it easy to remain unaware of low balance. The plugin introduced below keeps the balance fixed at the bottom status bar of the Web GUI and provides a reminder when it falls below a threshold. It is suitable for desktop users who have logged into DSH using a DeepSeek account.

What is it¶

dsh-balance-monitor is released by maintainer kousenlee, categorized as a network tool, and can be found in the SkillHub directory and GitHub. The plugin is designed for the DeepSeek Harness Web GUI: it reads the platform wallet amount via DSH’s built-in account capabilities, displays the real-time balance at the bottom of the interface, and supports low-balance thresholds along with optional system notifications. The license is MIT, and the current package version is 1.0.0.

Core Features¶

Persistent Balance Bar¶

There is a thin status bar at the bottom of each DSH view. It defaults to refreshing approximately every 60 seconds and pulls data again when the window regains focus or the page becomes visible. It displays as ● Balance ¥x.xx: a green dot indicates a successful read; amber indicates the last read failed, showing the previous successful value; a red dot with a Low badge indicates the available total has fallen below your set threshold.

Details Panel and Manual Refresh¶

Clicking the status bar opens a panel: the top section displays top-up balance, bonus quota, available total, and the last update time, along with a Refresh now button; the bottom section contains reminder-related settings (threshold, auto-refresh interval, reminder toggle, etc.).

Low Balance Alert¶

The default threshold is ¥5.00. When the available total falls below the threshold, the status bar turns red and displays Low; a message similar to Low balance: ¥4.19 left, below the ¥5.00 threshold. will appear within the application; if the browser has granted notification permissions, you can also choose to send OS-level notifications.

Settings and Persistence¶

Thresholds, auto-refresh intervals (30 seconds / 1 / 5 / 10 minutes), in-app reminders, and system notification toggles can be modified in the status bar panel or configured under Settings → Balance reminder. Preferences are saved in the current browser’s localStorage and persist after page refresh or app restart. The interface language switches according to the Chinese/English settings in DSH.

Data and Display Rules¶

The balance is queried from the DeepSeek platform by the DSH Host via ctx.remote.account.getBalance(...). The plugin does not access, store, or transmit login tokens. Available Total = Top-up Balance + Bonus Quota (same currency); the Bonus Quota is deducted first, followed by the top-up wallet. For multi-currency scenarios, no conversion is performed, and the panel can switch between CNY/USD based on the data. If a read fails, the balance will not be displayed as zero; instead, it retains the last successful value and marks it as stale.

Environment and Prerequisites¶

• DeepSeek Harness Desktop 0.2.2-rc.1 or a compatible version.
• You must log in with a DeepSeek account; installations using only an API Key without account login cannot read the account balance, and the status bar will display as logged out.

Installation and Enablement¶

The plugin runs with the permissions of the current DSH process. It is recommended to read the repository source code and the MIT license before installing. The following commands are all from the project README.

Method A: Install via Agent in a DSH Session (Recommended, No Restart Required)¶

In any DSH session, ask the Agent to install this plugin, or call the tool directly:

plugin_manager install_bundle  target = github:kousenlee/dsh-balance-monitor

The application: applied in the return result indicates the plugin is immediately effective in the running GUI.

Method B: CLI Installation and Restart¶

# The desktop CLI is usually located at:
#   <DSH install>\resources\runtime\cli\bin\dsh.cmd
dsh plugin --profile desktop add github:kousenlee/dsh-balance-monitor

Then add "dsh-balance-monitor" to dsh.profile.bundles in <DSH_HOME>/profiles/<profile>/package.json (default %USERPROFILE%\.dsh) and restart DeepSeek Harness. The install.ps1 provided in the repository can automate this process.

Method C: Local Development (Windows PowerShell)¶

The maintainer has explained in the README how to run install.ps1 from a cloned repository; on macOS or Linux, it is recommended to use Method A or B, as the plugin itself is cross-platform.

Typical Usage¶

1. After installing and logging into a DeepSeek account, observe ● Balance ¥x.xx and the meaning of the dot colors at the bottom of each page.
2. Click the status bar to open the panel, check the top-up/bonus/total balance and the last update time, and click Refresh now if needed.
3. Modify the threshold in the panel or Settings → Balance reminder and press Enter to confirm; if the current balance is already below the new threshold, it will trigger a single reminder, and subsequent reminders within the same low-balance cycle will be at least 30 minutes apart.
4. Enable in-app reminders and system notifications as needed, and select the auto-refresh interval.

Suitable Scenarios and Limitations¶

Suitable for: Developers or daily users who have logged into the DSH Desktop version using a DeepSeek account and wish to continuously monitor their wallet balance in the GUI and receive alerts when it is low.

Not suitable or requires attention:

• In scenarios using only an API Key, the account balance cannot be read.
• Alerts depend on the GUI page being open; no alerts will be triggered if the application is completely closed.
• Polling is at least 30 seconds fast, and there is no client-side cache on the platform side; the balance may differ slightly from usage statistics in other parts of DSH.
• Non-owner shared views, such as LiveShare, do not have account remote permissions and will not mount the balance bar.
• Settings are saved per browser profile and are not synced across devices.

To uninstall, execute the following in the DSH Agent:

plugin_manager remove_bundle  target = dsh-balance-monitor

Or use uninstall.ps1 and restart the application.

Conclusion¶

dsh-balance-monitor connects the DeepSeek account balance to the bottom of the DSH Web GUI, using configurable thresholds and refresh strategies to reduce the risk of “discovering the balance is empty only when it’s too late,” while explicitly stating that it does not hold login tokens and only queries wallet amounts via the Host. For more information and screenshots, please see the repository README; you can install it by jumping to the SkillHub directory page or by using the github:kousenlee/dsh-balance-monitor specification mentioned above.

• Directory Page: https://www.skillhub.cn/plugins/kousenlee/dsh-balance-monitor
• GitHub: https://github.com/kousenlee/dsh-balance-monitor