dsh-deepseek-balance: A Sidebar Balance Indicator for DeepSeek Harness
kyya/dsh-deepseek-balance
A DSH plugin that displays real-time DeepSeek API balance in the sidebar footer, with status indicators, hover details, and manual refresh, keeping API keys secure in Node.
dsh-deepseek-balance is a plugin for DeepSeek Harness that displays real-time DeepSeek API account balance at the bottom of the web sidebar, letting you monitor balance status without manual checks. It uses status dot colors to indicate available, unavailable, fetch failure, and loading, and hovering shows details like total, granted, topped-up, and update time. The plugin supports scheduled refresh and click-to-force-refresh, and API keys are never sent to the browser for security. Configuration is flexible, allowing adjustment of refresh interval and API endpoint, suitable for all DeepSeek Harness developers.
How to Install
dsh plugin --profile web add github:kyya/dsh-deepseek-balance- Category
- Models & Reasoning
- Platform
- DSH Plugin
- Author
- kyya
- Distribution
- Plugin
dsh-deepseek-balance Key Features
dsh-deepseek-balance Repo Summary
What Does It Do?
dsh-deepseek-balance is a DSH plugin for DeepSeek Harness that displays real-time DeepSeek API account balance at the bottom of the web sidebar. It solves the problem of manually checking API balance frequently, letting you monitor balance status directly within the harness. Core capabilities include status indication, hover details, scheduled refresh, and manual force refresh, with API keys never sent to the browser for security.
Core Features
- Real-time balance display: shows a balance indicator at the sidebar bottom (above the settings button), with status dot colors indicating available, unavailable, fetch failure, and loading.
- Hover details: hovering the indicator shows full balance details including total, granted, topped-up amounts, and update time.
- Scheduled and manual refresh: the Node side fetches balance periodically, the browser polls every 30 seconds, and clicking the indicator forces an immediate refresh.
- Secure credential handling: API keys are resolved via the credentials service on each fetch and never sent to the browser.
- Configurable refresh interval: adjust the background refresh interval, credential reference, API base URL, and endpoint via configuration file.
How to Use This Plugin?
After enabling the plugin in DSH, restart dsh web and open http://127.0.0.1:3080 to see the balance indicator at the bottom left of the sidebar. It reads the DEEPSEEK_API_KEY credential by default (from ~/.dsh/.credentials.yaml, environment variable, or the key saved in Settings → Models). To adjust the refresh interval or API endpoint, override the config field in ~/.dsh/profiles/web/cordis.patch.yml, for example setting refreshMs to 60000 milliseconds.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: kyya/dsh-deepseek-balance. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.