izz-BLUE/dsh-deepseek-usage-dashboard

DeepSeek Harness Web UI plugin for daily API token usage, cost estimates, and ba

A standalone Web UI plugin that counts the daily DeepSeek token usage of this DSH instance from session logs (exact provider usage only: cache-hit/cache-miss input, output, reasoning), estimates today's cost per model from a user-editable price table, and watches the DeepSeek account balance (host-side, 10-minute refresh). Shown in a Web GUI dashboard, a composer dock line and a settings card. Only real DeepSeek traffic counts (provider route deepseek-official + effective base URL api.deepseek.com — custom gateways do not pollute stats), streaming-safe (only the FINAL usage settles a record), idempotent and durable (SQLite with UNIQUE(session_id, turn, step) + INSERT OR IGNORE). The plugin never calls any LLM interface — idle running and page refreshes cost 0 tokens.

Web UI Enhancements ★ 2 updated 2026-08-17 ✅ runtime-tested
View on GitHub ↗

Install

dsh plugin --profile web add https://github.com/izz-BLUE/dsh-deepseek-usage-dashboard.git

dsh plugin --profile web add https://github.com/izz-BLUE/dsh-deepseek-usage-dashboard.git or dsh plugin --profile web add link:<repo-path>. Built only on the official @deepseek-ai/* NPM SDK; install goes through cordis.patch.yml + the profile plugin mechanism. English README + 简体中文 primary.

Compatibility

DSH web profile; Node 24 (node:sqlite built-in); only official @deepseek-ai/* SDK; never modifies DSH sources; zero model calls.

Details

Recent updates

Daily token usage + cost estimate + balance watch; provider-precise counting; streaming-safe final-settle; SQLite idempotent; zero LLM calls.

FAQ

Does it count usage from custom gateways?
No — only the provider route deepseek-official with effective base URL api.deepseek.com counts; custom gateways do not pollute the statistics.
Does it cost tokens to run?
No — capture, refresh, display and balance queries perform zero model calls, so idle running and page refreshes cost 0 tokens.
Is it safe on restarts?
Yes — SQLite with a UNIQUE(session_id, turn, step) constraint and INSERT OR IGNORE make projection replays, duplicate streaming usage and restart re-scans idempotent.

Alternatives

Ychris12138/dsh-usage-stats · 940842546/dsh-usage-billing · LemCAE/dsh-balance

More plugins in Web UI Enhancements

Browse more in Web UI Enhancements

Guides for Web UI Enhancements plugins