dsh-usage-stats: A Balance and Usage Monitoring Panel for DeepSeek Harness
ychris12138/dsh-usage-stats
A DSH plugin for the DeepSeek Harness Web GUI that tracks multi-provider balances, subscription quotas and token usage, with cost estimates, budget alerts and CSV/JSON export.
dsh-usage-stats is an account and usage monitoring panel added to the DeepSeek Harness Web GUI, gathering balances, subscription quotas, and token spend from separate provider consoles into one sidebar view. Unified account cards separate balance-type from subscription-type providers, while a calendar heatmap and drill-down reports cover today, this month, and all-time consumption, with costs estimated by matching historical prices to event time. Credentials are resolved server-side only, data endpoints accept loopback requests only, and the interface is bilingual.
How to Install
dsh plugin --profile web add @ychris12138/dsh-usage-stats- Category
- Models & Reasoning
- Platform
- DSH Plugin
- Author
- ychris12138
- Distribution
- Plugin
dsh-usage-stats Key Features
dsh-usage-stats Repo Summary
What Does It Do?
It is a DSH plugin for DeepSeek Harness that adds provider balances, subscription quotas, and token-usage analytics to the DeepSeek Harness Web GUI (dsh web). It solves the problem of balances, plan quotas, and token spend being scattered across separate provider consoles, letting you read account cards and usage reports straight from the DSH sidebar. Maintained by Ychris12138 under the MIT license, it ships a bilingual (Chinese/English) interface and resolves credentials server-side only, so API keys, cookies, and raw upstream responses never reach the browser.
Core Features
- Unified account cards: API providers show balances while token plans show per-window quotas, and the panel presents only the currently selected provider at a time.
- Token usage analytics: today, this month, all-time totals, cache hit rate, and a calendar heatmap, with drill-down by date, provider, and model.
- Cost estimation and budgets: matches historical prices by event time to produce daily/monthly costs and session-level aggregation, with optional budget alerts.
- Adaptive background monitoring: accounts refresh in active/detail/background tiers with a configurable interval or fully disabled, while local token aggregation keeps running independently.
- Extensible adapters: built-in New API, Sub2API, and generic balance templates plus declarative JSON Pointer queries cover balance and subscription providers such as DeepSeek, OpenRouter, Moonshot, Z.ai, Kimi For Coding, and MiniMax.
- Safe export and local security boundary: daily/session CSV and versioned JSON exports, with data endpoints accepting loopback GET requests only and credentials parsed server-side.
How to Use This Plugin?
Enable it in the DSH web profile, restart dsh web, and hard-refresh the browser; a Usage/Balance entry then appears at the bottom of the sidebar. Open the panel to see the current provider's account card and usage report. The plugin auto-discovers the official DeepSeek route and provider profiles in llm-pi-ai, and only queries remote accounts for providers that expose a public account endpoint or an explicit monitor; token usage statistics need no extra credentials. To adjust behavior, change the refresh interval in settings or turn background refresh off entirely. Manual refresh updates usage and the provider list and force-refreshes the current account without bulk-requesting other providers, and exports are available as daily/session CSV or versioned JSON.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: ychris12138/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.