linkingoscar/dsh-billing-glass
30Last commit Aug 15, 2026
dsh-billing-glass DSH plugin
The plugin adds a liquid-glass capsule pinned to the bottom-right corner of the DeepSeek Harness Web GUI, displaying the current provider balance at a glance. Click to expand a full billing card with session cost, daily spend, token-bucket breakdown, and a provider list. It supports multi-provider auto-switching and polls balance data every 10 seconds.
How to install the dsh-billing-glass DSH plugin
dsh plugin --profile web add github:linkingoscar/dsh-billing-glassCopying does not run this command. Review the repository and version before installing the dsh-billing-glass DSH plugin.
dsh-billing-glass DSH plugin data source
dsh-billing-glass DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-billing-glass DSH plugin can do
- Always-on glass capsule showing balance, provider name, and status dot
- Expanded billing card with session cost, daily spend, token-bucket breakdown, and provider list
- Per-message cost badge on assistant messages showing token split and model
- Spend ledger (JSONL) with today/month/all-time totals, bucketed by browser timezone
- Pricing sync check button that compares built-in prices against official source
- Multi-provider auto-switching following the current session's provider
- Unknown models marked as unpriced instead of silently priced at zero
Where the dsh-billing-glass DSH plugin fits
- Monitor API provider balance in real-time from the DeepSeek Harness interface
- Track session and daily spending across multiple providers
- Verify that the plugin's pricing matches the official provider price page
- Review historical spend ledger with automatic compaction and migration
Who the dsh-billing-glass DSH plugin is for
- Developers using DeepSeek Harness with multiple API providers
- Users who need to monitor and control API costs in the Harness Web GUI
dsh-billing-glass DSH plugin limitations
- Daily spend row is hidden unless DEEPSEEK_PLATFORM_TOKEN is configured
- Session cost and spend stats are locally computed using built-in price tables, not provider invoices
- Spend stats only cover messages the plugin has seen; historical sessions not processed are missing
- Unknown models are marked unpriced, which may understate totals until a pricing scheme is provided
- Some providers have no public balance endpoint, showing '—' for balance
dsh-billing-glass DSH plugin: from the repository README
Quoted from the linkingoscar/dsh-billing-glass README, the upstream source of the dsh-billing-glass DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) A billing overlay plugin for the DeepSeek Harness Web GUI: a **liquid-glass** capsule pinned to the bottom-right corner showing the provider balance; click to expand a full billing card (session cost, daily spend, token-bucket breakdown, provider list). **DeepSeek-first**, with an extension point for more API providers. ## Features - **Always-on glass capsule**: status dot + provider name + balance at a glance; click to expand. The expanded card's header is draggable (position stored in localStorage; it can be dragged anywhere on the page with no bottom dead zone). The card disables horizontal overflow — no horizontal scrollbar needed to reach content. - **Fresh data**: the client polls every 10s; the DeepSeek balance cache TTL is 10s (other providers 60s); official daily spend is cached for 5 minutes; window focus, tab visibility change and card expansion refresh immediately, and the manual refresh button force-refreshes the current provider balance via POST. - **Liquid-glass material**: `backdrop-filter` frost + translucent theme colors + specular highlight border + refraction sheen layer + soft float shadow; follows the `--dsw-*` l
Read the full READMERepository license: Apache-2.0
dsh-billing-glass DSH plugin questions
How do I install the DSH Billing Glass plugin?
Run the command `dsh plugin --profile web add github:linkingoscar/dsh-billing-glass` in your terminal, then restart `dsh web` and refresh the page. The plugin requires a DeepSeek API key configured in Settings → Models.
Why is the daily spend row not showing?
The daily spend row only appears when you have configured a `DEEPSEEK_PLATFORM_TOKEN` in your `~/.dsh/.credentials.yaml` file. Without it, the row is hidden because balance-delta estimates are unreliable due to top-ups and refunds.
How accurate are the session cost and spend stats?
They are locally computed using the plugin's built-in official price tables and message tokens. They may differ slightly from the final platform bill due to pricing moment, rounding, or peak/valley interpretation. They are not a provider invoice.
What happens if I use a model not in the price catalog?
The plugin marks the message as unpriced and shows `unpricedCalls: N` in the card and spend stats. The ledger stores `priced: false`. You can run `scripts/sync-providers.js` to update the catalog or provide a pricing scheme in chat.
Can I add a custom API provider that is not in the official list?
Yes. The plugin shows a guidance strip for unrecognized providers. You can tell the assistant the pricing scheme in chat, and the generic `defineOpenAiCompatProvider` factory will onboard it permanently. Alternatively, create a custom provider file following the contract in `registry.js`.