DeepSeek Harness Balance
An independent DeepSeek Harness (DSH) Web plugin that shows the current DeepSeek API account balance in the sidebar footer, above Settings. It refreshes automatically every 30 seconds and can be refreshed manually.
中文版：README.zh.md
Requirements
- DSH
0.1.0-rc.8 Web profile
- Node.js 22 or later
- A DeepSeek API key saved in Settings → Models or supplied to the DSH process as
DEEPSEEK_API_KEY
Install
dsh plugin --profile web add @tempuspatia/dsh-deepseek-balance
Restart the Web server, then hard-refresh the browser:
dsh web --no-open
Open http://127.0.0.1:3080. The balance entry appears at the bottom of the sidebar, above Settings. A compact sidebar shows a status dot; expanding it shows the primary balance. Click it to refresh immediately.
Privacy and network boundary
Your API key stays in the local DSH host process. The browser never receives, stores, logs, or renders it. The plugin only requests GET https://api.deepseek.com/user/balance from the host and returns normalized public balance totals to the local browser over DSH's loopback server. It does not send conversation messages, files, filesystem paths, or telemetry.
Troubleshooting
| Status | What to do |
|---|
| Balance unavailable | Confirm DSH is running and refresh the browser. |
| Save a DeepSeek API key first | Add DEEPSEEK_API_KEY in Settings → Models, then restart DSH. |
| Unable to read balance | Check that the selected provider is DeepSeek-compatible and that your API key has access to /user/balance. |
Upgrade and uninstall
dsh plugin --profile web update @tempuspatia/dsh-deepseek-balance
dsh plugin --profile web remove @tempuspatia/dsh-deepseek-balance
Restart DSH after either command. Uninstalling removes only the plugin; it does not change your DSH models, credentials, or conversations.
Development and release
npm ci
npm test
npm run lint
npm run validate:manifest
npm run validate:package
npm pack --dry-run
See CONTRIBUTING.md and SECURITY.md. Released under the MIT License.
