dsh-usage-mini: A Floating Usage Window for DeepSeek Harness
teethyachi/dsh-usage-mini
A floating usage widget for DeepSeek Harness Web that shows Claude/Codex subscription quotas with reset countdowns plus DeepSeek API spend and balance, draggable, collapsible and following your DSH language setting.
dsh-usage-mini is a persistent floating widget for DeepSeek Harness Web that keeps subscription usage and API spend pinned on screen instead of scattered across browser tabs. It collects nothing itself, gathering Claude and Codex subscription windows, used and remaining percentages and reset countdowns alongside DeepSeek API daily spend, call counts and official balance. The window can be dragged, collapsed and remembers its spot, follows the host language, and polls every 60 seconds while expanded and visible.
How to Install
dsh plugin --profile web add dsh-usage-mini- Category
- UI & Experience
- Platform
- DSH Plugin
- Author
- teethyachi
- Distribution
- Plugin
dsh-usage-mini Key Features
dsh-usage-mini Repo Summary
What Does It Do?
Usage Window is a DSH plugin for DeepSeek Harness that adds a small floating usage dashboard to DSH Web. It does not collect data itself; it keeps subscription usage and API spend on screen so you do not have to hunt through browser tabs to check your meter. It currently covers Claude subscriptions, Codex (ChatGPT) subscriptions, and the DeepSeek API, and is maintained by teethyachi under the MIT license.
Core Features
- Subscription usage display: shows available usage windows, used and remaining percentages, reset times, and countdowns for Claude and Codex subscriptions, without inventing a dollar balance for a subscription.
- DeepSeek API spend: shows today's locally recorded official-provider spend and call counts, plus the upstream cached official account balance, with a Flash breakdown when present.
- Host language following: reads the DSH language setting and renders in Chinese or English, switching live when you change Settings → Language, with no language switch of its own.
- Controllable window behavior: drag it anywhere, collapse it into the nearest corner, and it remembers its spot in the current browser; it polls every 60 seconds while expanded and the page is visible, and stops polling when collapsed or hidden.
- Settings toggle and manual refresh: show or hide the widget from Settings and trigger a refresh by hand.
- Feedback bar: a single line at the bottom of the window opens a pre-filled issue, and adopted suggestions ship in the next release with credit.
How to Use This Plugin?
After enabling it in your DSH Web profile, open Settings → 用量小窗 to show or hide the widget. It relies on separately enabled subscription and cost-tracking plugins in the same profile to supply Claude/Codex and DeepSeek data; those providers are not bundled or silently installed. If an endpoint is unavailable, that section shows a notice while the other section can still work. The window can be dragged and collapsed, its position is remembered in this browser, and its language follows your DSH language setting.
How to Troubleshoot This Plugin?
Usage Window is a display plugin, not a replacement account connector, so missing data usually comes from the required providers rather than the widget itself. If the Claude/Codex section shows a notice, confirm the subscription usage plugin is enabled and the relevant subscription is signed in; if the DeepSeek section shows a notice, confirm the cost-tracking plugin is enabled with its ledger and official balance configured. Compatibility depends on the RPC contracts between these plugins, not merely on having a similarly named package installed. The plugin declares only a specific Node version and DSH release as verified, so check the compatibility declaration per the official instructions if you hit unexpected behavior.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: teethyachi/dsh-usage-mini. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
