dsh-ui-usage-billing: A Usage Billing Dashboard Plugin for DeepSeek Harness
kenz1117/dsh-ui-usage-billing
A DSH plugin usage-billing dashboard: aggregates real usage from session logs, estimates costs with live multi-provider pricing, and surfaces it all in a sidebar card and full-screen dashboard.
dsh-ui-usage-billing is a usage billing dashboard built for DeepSeek Harness (DSH), consolidating model spend scattered across multiple providers into one place. It aggregates real usage from session logs, estimates costs at live official prices, supports peak/off-peak pricing, subscription quotas, and balance reconciliation, and allows custom unit prices. The sidebar trigger card and full-screen six-tab dashboard make month-to-date, today, trends, and heatmaps clear at a glance, helping developers precisely control every cent of model spend.
How to Install
dsh plugin --profile web add @kenz1117/dsh-ui-usage-billing- Category
- Models & Reasoning
- Platform
- DSH Plugin
- Author
- kenz1117
- Distribution
- Plugin
dsh-ui-usage-billing Key Features
dsh-ui-usage-billing Repo Summary
What Does It Do?
dsh-ui-usage-billing is a DSH plugin for DeepSeek Harness that brings every cent of model spend into clear view. It solves the problem of scattered multi-provider costs and hard reconciliation, letting you see real usage and cost estimates directly in the sidebar and a full-screen dashboard. Core capabilities include aggregating real usage from session logs, billing at live multi-provider official prices, and supporting peak/off-peak pricing plus subscription and balance reconciliation.
Core Features
- Real usage aggregation: the server aggregates from persisted session logs in real time and estimates at live multi-provider official prices, showing empty snapshots before data arrives—never fake samples.
- One-screen dashboard: a sidebar trigger card plus a full-screen six-tab dashboard (Overview / Trends / Details / Stats / Rates / Settings) with month-to-date, today, forecast, heatmap, and trends.
- Subscription and balance reconciliation: recognizes subscription quotas, multi-provider balances, and relay station quotas, with declared endpoints and balance-difference reconciliation for a cross-verifiable billing loop.
- Peak/off-peak pricing with reminders: weekday peak/off-peak split (peak ×2), weekend all-day off-peak, with pop-up or system notifications before switching, and configurable lead time.
- Custom unit prices: fill in actual paid prices for models not in the catalog or with changed prices, bind different prices per relay source, and take effect immediately for out-of-catalog models.
- Offline self-contained: no chart libraries, no external CDN, pure design tokens, minimal dependencies, ready to use.
How to Use This Plugin?
After enabling it in DSH, a dashboard trigger card appears above the settings button in the sidebar, showing this month's cost and a 7-day sparkline. Click to open the full-screen dashboard: use Overview for hero numbers and heatmap, Trends to switch 7/30-day cost or token curves, Details for per-turn costs and official/third-party buckets, Rates to verify model unit prices, and Settings to configure budget, peak/off-peak reminders, custom prices, and multi-provider balances. A persistent live cost bar sits below the input box, showing current turn and session costs plus peak/off-peak countdown.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: kenz1117/dsh-ui-usage-billing. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.