Preface¶

The DSH ecosystem emphasizes “everything is a plugin”; the community directory is an independent site with no official affiliation to DeepSeek / High-Flyer. For those using DeepSeek Harness (DSH), a common need is to view the DeepSeek account balance directly in a session or the Web GUI, rather than leaving the current work environment to check on the platform.

dsh-balance is a DeepSeek Harness plugin that provides the /balance slash command and displays the real-time DeepSeek account balance in the composer-dock of the Web GUI. This article only covers its features, installation methods, typical usage, and precautions based on verified information.

What Is This¶

dsh-balance is maintained by deepforce and licensed under MIT. The plugin repository is named deepforce/dsh-balance.

It calls the official DeepSeek Get User Balance endpoint, returning total, topped-up, and granted balances per currency.

Core Features¶

The following verified capabilities are described below.

• /balance slash command: Prints the full balance details in the session.
• Web GUI display: Shows a Balance: ¥… line in the conversation stats area, with hover revealing topped-up / granted details.
• Top up link: Points to the DeepSeek platform top-up page.
• Manual refresh button.
• Session ≈ ¥…: Displays an estimated session cost, with hover showing token buckets × unit prices.
• Last {days}d ≈ ¥…: Hover shows an SVG bar chart for the recent usageDays days.
• Bilingual display: Follows the active dsh language, supporting Chinese / English.
• The browser obtains public balance data via the host /dsh-balance route; API keys never enter the browser.

Installation and Enablement¶

First, install the plugin:

dsh plugin --profile web add github:deepforce/dsh-balance

After installation, restart dsh web to load the new entry into the client plugin table:

dsh web

Following these steps, both the host-side commands and browser-side display of the plugin will be ready for use.

Typical Usage¶

In the session composer, enter:

/balance

Example output:

Balance (CNY): 110.00
  Topped up: 100.00
  Granted:   10.00

In the Web GUI, the stats area below the composer will display:

Balance: ¥110.00 ⟳

Hover to see topped-up / granted details, and use the ⟳ button to refresh.

Configuration and Estimation¶

Session ≈ ¥… is an estimate, not a billing record. It uses the configured estimateModel prices, and cache-write tokens are not priced.

Prices can be adjusted via the following configuration fields:

• offpeakPrices
• peakMultiplier
• peakWindows

The documented configuration items include:

apiKeyEnv
baseURL
timeoutMs
estimateModel
offpeakPrices
peakMultiplier
peakWindows
topUpUrl
usageDays

Among these, usageDays relates to the historical day window for the daily-spend chart.

Security and Permissions¶

The API key is resolved at each call via a credential seam or environment variables; it is not written into configuration, returned text, or the browser.

The documentation states the plugin only calls:

GET https://api.deepseek.com/user/balance

and no other data leaves the process. The browser obtains public balance data via the host /dsh-balance route.

Still, it is recommended to review the source code and license before installation. The plugin runs with the current dsh process permissions, and running the installation command is equivalent to introducing new code into that DSH environment.

Compatibility and Build¶

Compatibility testing is based on DeepSeek Harness 0.1.0-rc.6 (web profile, Windows 11) and was verified on 2026-08-14.

The documentation states that the @deepseek-ai/dsh-* npm packages are pre-release and offer no compatibility guarantees; if dsh updates affect the conversation.composer.dock slot or the webServer service, a re-check is required.

Local builds use pnpm and rely on pnpm-workspace.yaml overrides to resolve missing dependencies from upstream npm.

Applicable Scenarios and Notes¶

dsh-balance is suitable for scenarios where you need to view the DeepSeek account balance, top-up entry, and session cost estimates within DSH sessions or the Web GUI.

It is not suitable for treating Session ≈ ¥… as a billing record; it is only an estimate.

If you install from the community directory, note that the directory is an independent site with no official affiliation to DeepSeek / High-Flyer. Before installing, verify the source and check whether the MIT license meets your usage requirements.

Summary¶

The value of dsh-balance lies in bringing DeepSeek balance, top-up entry, and session cost estimates into the DSH workflow.

The repository address is:

https://github.com/deepforce/dsh-balance

The currently verified materials do not provide a directory page URL; if you need to search via the community directory, please confirm the entry point yourself.