Introduction¶

When running agents with DeepSeek, users typically have to open a new browser window, log in to the platform console, and then view their account balance and today’s consumption. Checking once is fine, but repeatedly switching windows while tasks run for a long time is annoying, and it is easy to forget exactly how much was spent today.

This plugin compresses this process into one line: displaying the balance and daily consumption directly at the far right of the account row in the DSH sidebar. Hovering the mouse shows more detailed request and token information, and clicking refreshes the data. Below, I introduce its positioning, features, installation method, and usage notes.

What is this¶

chipcats/dsh-sidebar-wallet is a DeepSeek Harness (DSH) client plugin maintained by chipcats, categorized as a client, currently with 0 stars. It solves a very specific problem: allowing DSH users to continuously see their account balance and daily consumption within the interface without switching back to the console.

It is worth noting that DSH’s ecosystem philosophy is “everything is a plugin,” maintained by community authors; the community directory site is an independent site with no official affiliation to DeepSeek or High-Flyer, so this is not an official product, nor is it an app listed in the official app store.

Core Features¶

The plugin renders a row of readings at the far right of the DSH sidebar account row, formatted like this:

Balance ¥128.00 · Today ¥12.34

The specific capabilities are limited to four points, as stated in the README:

• Balance: Calls the official GET /user/balance. Prioritizes the saved DEEPSEEK_API_KEY, and falls back to the logged-in DeepSeek account wallet if unavailable.
• Daily Consumption: Uses the official Platform usage export, aggregated by Beijing calendar day. The numbers match the Usage page in the console; if unavailable, it falls back to local session log estimation, marked with ≈.
• Hover and Click: Hovering displays balance, daily consumption, request count, input tokens (hit/miss), output tokens, cache hit rate, peak/valley countdown, update time, and data source; clicking triggers a refresh.
• Language: The readings follow the DSH interface language (Chinese/English) and change in real-time when the language setting is switched.

Installation and Enablement¶

The installation command provided in the README is as follows. DeepSeek Harness ≥ 0.2.1-rc.1 is required (the author tested on 0.2.1-rc.5):

dsh plugin --profile desktop add github:chipcats/dsh-sidebar-wallet

The package version is 0.2.6, the license is MIT, and the runtime environment requires Node.js ≥ 20. The DSH engine constraint declared in package.json is >=0.2.1-rc.1 <0.3.0-0, so you can confirm your current DSH version falls within this range before installing.

Typical Usage¶

No additional configuration is needed after installation. The plugin directly draws the readings in the sidebar account row; daily usage simply involves looking and clicking:

• The sidebar defaults to showing two columns of numbers: balance and daily consumption, following the interface language.
• Hovering over the readings pops up a detailed information card, which includes request count, input/output tokens, cache hit rate, peak/valley countdown, update time, and data source.
• Clicking the reading area manually triggers a refresh.

The plugin does not require manual token entry: official usage is read via DSH’s deepseekAccount.getPlatformSession() for the logged-in account session. If it expires, it automatically falls back to local estimation, and the readings will not be blank.

Applicable Scenarios and Notes¶

Suitable for developers who use DSH to run tasks daily and wish to conveniently check consumption within the interface.

A few points to note:

• The plugin runs with the permissions of the current DSH process. It is recommended to read the source code and verify the license (MIT) before installing.
• The official amount scope covers the total of all API calls under the account, not limited to a specific API key or client; local session estimation only counts the current session.
• When not logged into a DeepSeek account, only the local estimate value is displayed.
• Peak/valley schedules and holiday tables only affect local estimation and countdowns, and do not affect the official export amount.
• Regarding privacy, the plugin only accesses two hosts: api.deepseek.com (balance) and platform.deepseek.com (usage). Tokens remain in the Host process memory and are not sent to the browser or written to disk; it only exposes a read-only GET /dsh-sidebar-wallet/state.json, using loopback / same-origin isolation. There is no writing, no telemetry, and no third-party runtime dependencies.

Conclusion¶

The philosophy of dsh-sidebar-wallet is minimalist: no new control panel, no changes to billing logic, simply moving existing balance and usage information to a fixed display in the interface for DSH users who need to frequently confirm consumption.

• Community Directory Page: https://www.skillhub.cn/plugins/chipcats/dsh-sidebar-wallet
• GitHub: https://github.com/chipcats/dsh-sidebar-wallet