dsh-usage-stats: A Local Usage and Quota Dashboard for DeepSeek Harness
jockjrop/dsh-usage-stats
A local usage dashboard for DeepSeek Harness Desktop that shows token usage heatmaps, hourly call charts, per-model breakdowns, and provider quota balances.
dsh-usage-stats is a dashboard plugin that adds usage visibility to DeepSeek Harness Desktop, turning token consumption scattered across local sessions into charts and quota panels. It answers questions like how much was used today, how much in total, and how much is left — things you would otherwise have to dig through logs to confirm — without leaving DSH. It shows today's and lifetime tokens, active days, hourly calls, a daily/weekly heatmap, and per-model breakdowns, while the Quotas tab gathers account balances and subscription windows and the Controls tab handles refresh intervals, custom quota queries, and an optional model/reasoning panel. It ships as an external bundle patch with no changes to DSH source, and its UI text follows the Chinese, English, or Japanese setting in DSH.
How to Install
dsh plugin --profile web add @sligqoer/dsh-usage-stats- Category
- Models & Reasoning
- Platform
- DSH Plugin
- Author
- jockjrop
- Distribution
- Plugin
dsh-usage-stats Key Features
dsh-usage-stats Repo Summary
What Does It Do?
Usage Stats (dsh-usage-stats) is a DSH plugin for DeepSeek Harness that turns local session token consumption into readable charts and quota panels. It solves the problem of not knowing how much you have used or how much is left, letting you see today's and lifetime usage, hourly call patterns, and per-model breakdowns directly in DSH Desktop instead of digging through logs or opening another tool. It ships as an external bundle patch with no changes to DSH source, is maintained by Jockjrop under the Apache-2.0 license, and was last updated in 2026-10.
Core Features
- Usage overview: shows today's and lifetime tokens, active days, hourly calls, a daily/weekly heatmap, and model breakdowns.
- Quota checks: gathers configured account balances, subscription windows, and optional WorkBuddy credits in one place.
- Time-range filtering: filters historical charts by 7 / 30 / 365 days or all history, and compares providers and models.
- Refresh control: fetches manually or on a schedule, with automatic quota refresh off by default and custom quota queries supported.
- Model selection: optionally enables a model/reasoning panel with an effort slider; disabling it restores the official selector.
- Desktop fit: light/dark themes, responsive charts, pinned tabs, and UI text that follows DSH's Chinese, English, or Japanese setting.
How to Use This Plugin?
After enabling it in DSH Desktop, open Settings → Usage Stats to see the usage page; data is read from your local DSH sessions. Switch to the Quotas tab and click a refresh button to query account balances, and use the Controls tab to set a refresh interval, configure custom quota queries, or enable model details and the advanced model selector. Historical charts can be filtered by 7 / 30 / 365 days or all history for provider and model comparisons. If the plugin manager asks you to restart, restart DSH for the changes to take effect.
How to Troubleshoot This Plugin?
If the usage page shows no data, first confirm that local DSH session records exist, since statistics are read only from local sessions. If quota queries fail, check that the account configuration is complete, or switch to a custom quota query that maps the provider's JSON response. If the UI text does not follow your language switch, note that user-defined names and quota labels stay as configured and are not translated automatically.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: jockjrop/dsh-usage-stats. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
