dsh-usage: A Persistent Balance & Usage Panel for DeepSeek Harness
aisland-sjl/dsh-usage
Persistent dock and fully customizable balance/usage panel for DeepSeek Harness, with activity heatmap and dual-channel comparison, local-only.
Provides a persistent dock and customizable usage panel for the DeepSeek Harness Web GUI, keeping balance and token usage in clear view.
dsh plugin --profile web add github:aisland-sjl/dsh-usage- Category
- Models & Reasoning
- Platform
- DSH-Plugin
- Author
- aisland-sjl
- Distribution
- Plugin
dsh-usage Key Features
dsh-usage Repository
dsh-usage Repo Summary
dsh-usage is a DeepSeek Harness (DSH) plugin that brings a persistent floating dock and a fully customizable balance/usage panel to the dsh web GUI. It solves the problem of users lacking real-time visibility into token consumption, balance changes, and multi-channel usage comparison, keeping key numbers always in view. Core capabilities include a persistent dock (balance, today/month usage, cache hit rate), a seven-widget detail panel with deep customization, a 28-day activity heatmap, dual-channel usage comparison between DSH and Claude Code, and a fully local, privacy-first design. Maintained by Aisland-SJL under the MIT license, last updated in 2026-08, the repository currently has 20 stars and 1 fork, written in JavaScript.
What core features does the dsh-usage DSH plugin support?
- Persistent dock: Balance glows green when healthy, red when drained; collapses into a small balance pill when the sidebar folds.
- Seven-widget detail panel: Balance, today, month, cache hit, channel share, usage log (14-day daily list with per-model drilldown), and activity heatmap (28 days × 6 four-hour bands).
- Full customization: Drag-reorder, pin, collapse, hide widgets; accent (presets + color picker), background, and opacity adjustable live, persisted in localStorage.
- Dual-channel comparison: Aggregates incremental JSONL from
~/.claude/projects, showing a ratio bar between DSH channel and Claude Code channel. - Background refresh: Refreshes at startup and every 5 minutes: balances, DSH tokens, Claude Code aggregation.
- Local-only security: Only three loopback GET endpoints; credentials resolved server-side; upstream forced HTTPS with DNS pinning; Claude logs aggregate numbers only — message text never leaves the machine.
How to install dsh-usage?
Requires a DeepSeek Harness web profile (@deepseek-ai/dsh >= 0.1.0-rc.6). Install with:
dsh plugin --profile web add github:aisland-sjl/dsh-usage
After installation, restart dsh web and hard-refresh the browser; the dock appears at the bottom-left. To update or remove:
dsh plugin --profile web update dsh-usage
dsh plugin --profile web remove dsh-usage
How does dsh-usage handle credentials and privacy?
Balance providers read credential references from Harness's ~/.dsh/.credentials.yaml; the plugin never reads, caches, or echoes secrets. All network requests go through loopback addresses only, and upstream is forced HTTPS with DNS pinning to prevent tampering. Claude Code log aggregation keeps only numeric statistics; message content never leaves the machine, aligning with a privacy-first philosophy.
Which DeepSeek Harness versions and platforms does dsh-usage support?
The plugin targets the DeepSeek Harness Web GUI (dsh web) and requires @deepseek-ai/dsh >= 0.1.0-rc.6. The UI supports both Chinese and English and works in mainstream browsers. The repository is maintained by Aisland-SJL under the MIT license, last updated in 2026-08, with no open issues currently.