Preface¶
DeepSeek Harness (dsh) treats models, tools, sessions and interfaces as replaceable plugins. The Web interface allows opening multiple sessions simultaneously and connecting both official DeepSeek and third-party models. However, account balance, session token usage, and completion status of background tasks are often scattered across platform backend, streaming events, and browser tabs. Tasks will interrupt when the balance runs out; after peak-valley pricing launched, estimated costs for the same conversation will vary across different time periods. Switching to platform.deepseek.com every time to check will disrupt your workflow.
Community maintainer feibi-mochi created deepseek-harness-wallet: a persistent chip placed next to the Web GUI input box to view official account balance, track session spending, and jump to the official top-up page. The npm package name remains deepseek-harness-wallet; the current source code repository is released under the name DeepSeek Harness Control Center, and the installation identifier has not changed. Below is a collation based on verification against the community directory page, GitHub repository, npm package version 0.1.4 and official Harness documentation: what it is, which installation command to use, how to use the interface, and its limitations.
What it is¶
deepseek-harness-wallet is a session and messaging plugin for DeepSeek Harness Web, licensed under MIT, primarily written in JavaScript, and maintained by feibi-mochi. The community directory positions it as: view account balance and complete top-ups within Harness. The repository README describes it as a multi-provider wallet chip next to the input box: the official channel provides balance, session costs, and token breakdown, while third-party channels only count tokens without estimating balance or calculating costs.
A few names that need to be clarified separately:
- Installation and compatibility identifier: deepseek-harness-wallet (used dsh-wallet before version 0.1.1)
- Product display name: DeepSeek Harness Control Center
- Current GitHub repository: feibi-mochi/deepseek-harness-control-center (npm’s repository / homepage points here)
- The community directory entry still uses https://github.com/feibi-mochi/deepseek-harness-wallet
The GitHub repository page shows 21 stars; the community directory page shows 8 stars at the same period, indicating that directory data may lag behind. The directory is collected by an independent website and has no official affiliation with DeepSeek / Fangxin, and should not be treated as an official app store.
It addresses three things users frequently check: how much official balance remains, what this conversation has used, and if there are any reminders that need clicking. The plugin does not register tools for models, inject prompts, or consume additional model tokens.
Core Features¶
The current npm version is 0.1.4 (2026-08-17), and the README states compatibility with DeepSeek Harness 0.1.0-rc.6. package.json requires Node.js ^22.19.0 || >=24.0.0, and the client platform is declared as web.
A chip next to the input box¶
After installation and refreshing the Web interface, the chip will appear near the session input area, with the following display format (numbers are from the README example, not a real billing record):
Balance ¥5.89 · Session ¥0.72 · Official 18.8M | Third-party 800K · ↗Top Up
The official DeepSeek side includes:
- Real-time balance, refreshed globally about once every 60 seconds, with quick retries on startup
- Session cost: locked to the official price at the time each usage event arrives, including peak-valley pricing for v4 models starting from 2026-08-17; subsequent price changes will not retroactively modify historical estimates
- Token breakdown (input / cache hit / output)
The third-party side only counts session tokens, also isolated per session. A GLM session will not display DeepSeek balance, and DeepSeek costs will not be calculated using third-party token counts multiplied by unit prices.
Clicking the chip opens the details panel, where you can view balance by currency, cost and token breakdowns, manually refresh, and set a low balance threshold saved in RMB with two decimal places. The threshold only compares against the RMB balance, and will not alert after summing multiple currencies.
Low balance reminder and official top-up¶
When the balance drops below the threshold, the chip will turn red with a breathing animation, and send a desktop notification at the same time; it will automatically reset when the balance returns above the threshold. The top-up entry is hardcoded to the official address https://platform.deepseek.com/top_up and cannot be modified by users. The first click will first bring up a domain confirmation, which is a phishing prevention design; version 0.1.3 also fixed the issue where “the first click confirmation box was unreliable when the panel was closed”.
The plugin does not collect payment information. The cost figures are estimates based on the official price list, and the balance returned by the API is the authoritative value.
Layout, zooming and floating window¶
Version 0.1.4 changed the chip to be directly draggable: it can stay next to the input box, or snap to the bottom of the input area, viewport edge, or main content divider. Drag previews the drop position, and a single gesture can cross regions. The control panel provides 75%–125% zoom, and independent visibility toggles for official and third-party data; both cannot be turned off at the same time. When the input area is too narrow, instead of squeezing the entire chip under the model selector, a clickable balance/token value (about 44px) will remain.
The details panel can be dragged into a floating window and remembers its position, and will reposition itself within the viewport when the window changes. Minimizing it turns it into a movable dot, which turns red when the balance is below the threshold. Layout, zooming, visibility and reminder options are saved in browser-compatible local storage.
The interface uses --dsw-alias-* theme variables, and both light and dark modes follow Harness’s theme. Clicking outside the panel will close it; when near the screen edge, the opening direction will flip.
Completion reminders and session-related operations¶
There are two optional session completion reminders: one that stays until you close it, or one that automatically disappears after a set time. Multiple concurrent completions will be queued, deduplicated, and their ownership coordinated across multiple tabs; clicking the notification will open the corresponding session. If system notifications are unavailable, it will fall back to in-page prompts instead of silently discarding them.
Two operations should not be confused:
- Clear this session’s wallet data: only clears the token/cost records for this plugin in the current conversation, the conversation itself remains, and other conversations are not affected
- Permanently delete session: this npm package does not include a deletion engine. Only if the current dsh host declares real deletion capability will an enabled switch appear in the control panel, which still requires a second confirmation; the control remains disabled when the host does not support it
Accounting and key handling¶
| Item | Behavior (from repository Data & trust) |
|---|---|
| Token accounting | Listens to llm/stream, buckets data by provider (deepseek-official and others) and session; locks the official price at the time of each usage event |
| Balance request | The DEEPSEEK_API_KEY in credentials is only sent as the Authorization header for official /user/balance requests, leaving the local machine |
| Session logs | The plugin does not write to the Harness event stream; accounting data is stored in $DSH_HOME/storages/wallet.json |
| Top-up address | Hardcoded official top-up page, non-configurable |
Installation and Activation¶
The installation command given on the community directory page (as per the original directory text):
dsh plugin add github:feibi-mochi/deepseek-harness-wallet
This is a Web GUI plugin. The repository README recommends explicitly specifying the web profile, and preferring the npm package name:
dsh plugin --profile web add deepseek-harness-wallet
To install from the current GitHub repository:
dsh plugin --profile web add github:feibi-mochi/deepseek-harness-control-center
After installation, restart dsh web and force-refresh the page. Use the same package name for updates and uninstallation:
dsh plugin --profile web update deepseek-harness-wallet
dsh plugin --profile web remove deepseek-harness-wallet
If you previously installed the old name dsh-wallet, uninstall it first before installing the new name, otherwise you may encounter the “loaded without registering” failure after the 0.1.1 rename, where the entire plugin fails to start:
dsh plugin --profile web remove dsh-wallet
For reproducible installations, pin the commit hash as instructed on the directory page, for example:
dsh plugin add github:feibi-mochi/deepseek-harness-wallet#<commit>
The directory page states that the plugin runs with the permissions of the current dsh process, and may execute code during installation. You should review the source repository and license before installing.
Typical Usage¶
- Confirm that you can open DeepSeek Harness Web locally (the official quick launch command is
npx @deepseek-ai/dsh web, default address ishttp://127.0.0.1:3080), and the API key for the official channel has been configured via the credential slot. - Install the plugin into the
webprofile following the previous section, restart and force-refresh the page. - Locate the chip near the input box. The official balance will update automatically at intervals; click the chip to open the details panel, and use manual refresh when needed.
- Set the RMB low balance threshold (two decimal places, saved globally) in the details panel. Only the RMB account is compared, and foreign currency accounts will not be incorrectly summed up to trigger false alerts.
- When clicking “Top Up” for the first time, verify that the popped-up domain is
platform.deepseek.combefore confirming to redirect. - To move the chip away from the input area, simply drag it to the edge or divider; adjust zoom and visibility in the control panel, and your choices will be saved locally.
- When running long tasks in background tabs, enable completion reminders. Rejection of system notifications will not affect the fallback in-page prompts.
- To only clear usage counts without deleting the conversation, use “Clear this session’s wallet data”. Do not confuse this button with deleting a conversation.
The repository also documents optional adaptation for desktop shells (Electron / Tauri etc.): set window.__DSH_WALLET_ADAPTER__ before the plugin bundle loads, to bridge notifications, storage and external links. All fields are optional; if the host restricts these capabilities, the plugin will fall back to browser defaults without modifying accounting logic. The README states that testing coverage includes Windows + current Edge + DSH Web; Chrome / Firefox / macOS Safari etc. are listed as compatible targets, not “every combination has been tested”.
Applicable Scenarios and Notes¶
It is particularly suitable for:
- Users who mainly use official DeepSeek, frequently run consecutive sessions in Harness Web, and need a quick glance at balance and session spending
- Users who mix official and third-party models and do not want the two sets of usage counts to interfere with each other
- Users since 2026-08-17, when v4 models entered peak hours (9:00–12:00, 14:00–18:00 Beijing Time, with off-peak prices at half of peak prices). The plugin locks prices at the time the event arrives to avoid retroactively modifying historical estimates
- Users who need low balance alerts, completion reminders, and the ability to drag the chip to an unobtrusive position
Points to note:
- This is a community plugin, not an official DeepSeek application. The directory site, GitHub and npm are independent sources; use the installation command that matches your actual setup, and verify the repository.
- The plugin runs with the permissions of the current dsh process. The API key will not be written to configuration or displayed in the browser, but the balance request will still send the Authorization header to the official interface; you should read the source code and MIT license before installing.
- Third-party models currently only support token counting. The roadmap includes third-party price lists, balance history charts, and balance interfaces for other vendors (such as Zhipu AI), but none have been implemented yet.
- “Permanently delete session” depends on support from the buildable dsh host, with reference patches pinned to a specific commit of DSH 0.1.0-rc.5; different Harness versions require semantic modifications, and closed, non-rebuildable desktop applications are not supported. Do not assume you can delete a conversation just by using the plugin switch.
- Session cost estimates are for reference only. Reconciliation should use the official balance API.
Summary¶
deepseek-harness-wallet brings official balance checking, session spending tracking and top-up access right next to the Harness Web input box, with accounting separated by session and provider, and top-ups only redirecting to the official domain. The current 0.1.4 version also includes draggable layout, completion reminders, and host-switchable deletion capabilities; the installation identifier remains this package name.
Community Directory Page: https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-wallet/
GitHub (directory entry address): https://github.com/feibi-mochi/deepseek-harness-wallet
Current Source Repository: https://github.com/feibi-mochi/deepseek-harness-control-center
npm: https://www.npmjs.com/package/deepseek-harness-wallet