DeepSeek Harness Plugin: dsh-balance

DSH provides plugin extension capabilities. During agent development or debugging, the remaining quota of a DeepSeek account needs to be monitored in real time. The dsh-balance plugin embeds balance information directly in the input box toolbar (next to the model selector), so it can be viewed without switching pages.

Plugin Description¶

• Project Name: wyxcn445/dsh-balance
• Maintainer: Wyxcn445
• License: MIT

Core Features¶

• Balance Capsule: Displays the main wallet balance (preferring RMB) in the input box toolbar, with a status color dot.
• Details Panel: Click the capsule to expand a panel where you can view top-up balances (by currency), granted credits, usage details, a top-up entry, and the last updated time.
• Auto Refresh: Auto-refreshes every 20 seconds; refreshes immediately when the tab becomes visible again; force-refreshes when the panel is opened.
• Graceful Degradation: When not logged in, the service is missing, or the query fails, it displays a readable message without causing input box errors.

Data Source and Security¶

• Request Path Design: The browser does not directly access platform APIs. Account credentials are visible only on the host side.
• Request Routing: Data is retrieved via the read-only route GET /api/dsh-balance registered on the host side.
• Access Restrictions: The route accepts requests only from loopback addresses (127.0.0.1 / ::1).
• Authentication Mechanism: This route does not use DSH token authentication and relies only on loopback restrictions.
• Performance Notes: Balance queries are external network requests and may incur a brief delay on first load.

Prerequisites¶

This plugin reads account data from the DSH built-in deepseekAccount service.

A DeepSeek account (platform session) must already be logged in to DSH. If you only configured DEEPSEEK_API_KEY but have not logged in to an account in DSH, the capsule will display “Balance not logged in”.

Installation and Enablement¶

dsh plugin --profile <你的profile名> add github:Wyxcn445/dsh-balance

After installation, refresh the browser page to see the balance capsule.

Usage¶

• No Configuration Required: The endpoint is read-only and requires no configuration.
• View Balance: After refreshing the page, view the balance capsule in the input box toolbar (next to the model selector).
• View Details: Click the capsule to expand the panel and view detailed top-up, granted credit, and usage information.

Notes¶

• Credential Security: The browser does not directly access platform APIs; credentials are visible only on the host side.
• Network Requests: Balance queries are external network requests and may incur a brief delay on first load.
• Access Scope: Requests are accepted only from loopback addresses (127.0.0.1 / ::1).
• Authentication Method: This route does not use DSH token authentication and relies only on loopback restrictions.