🌊 dsh-usage

A persistent floating dock, a fully customizable balance / token-usage panel, an activity heatmap, and a dual-channel usage comparison for the DeepSeek Harness Web GUI (dsh web) and official Windows Desktop. See the host scope below.

✨ Feature tour

🌊 Persistent dock

Your key numbers stay visible at all times — balance glows green (red only when out of credit), rows are separated by hairlines, and a settings gear plus one-click refresh sit in the corner. When the sidebar collapses, the dock folds into a tiny balance pill.

<table><tr> <td width="44%"><img src="docs/images/dock.png" alt="dsh-usage dock" width="100%"></td>

• 🟢 Balance — green when healthy, red when drained
• 📊 Today / Month / Cache hit — glanceable token stats
• ⚙ Gear opens the panel · ↻ refresh re-queries instantly
• 🧲 Mirrors your pins — every change applies immediately

</tr></table>

🎛️ Detail panel — all seven widgets

A two-column card layout; every widget has a detail and a compact form, and can be drag-reordered, collapsed, hidden, or pinned.

<table><tr>

Widget	What it does
💳 Balance	Big number on the left, available / topped-up / granted rows on the right; provider switchable
📊 Today	Today's tokens plus input / output / cache-read breakdown
📈 This month	Monthly tokens plus the same breakdown
🎯 Cache hit	Today's and all-time cache hit rates
↔️ Channel share	DSH channel vs Claude Code channel ratio bar
📜 Usage log	Last 14 days per-day list, click to drill into per-model detail
🔥 Activity heatmap	28-day × 6-band dot grid (dates across, 0–24h down)

<td width="46%"><img src="docs/images/panel.png" alt="dsh-usage panel" width="100%"></td> </tr></table>

🎨 Everything customizable

Accent (presets + color picker), background, and panel opacity are adjustable live. Drag-reorder, pin, collapse, hide — every number presents your way, echoing DeepSeek Harness's "everything is a plugin" spirit.

<p align="center"><img src="docs/images/customizer.png" alt="dsh-usage customizer" width="78%"></p>

At a glance

	Feature	Notes
💳	Persistent dock	Pinned compacts always visible; collapses into a balance pill when the sidebar folds
🎨	Everything customizable	Widgets: pin / collapse / hide / drag-reorder with a dashed placeholder and glide animation; accent, background, opacity; persisted in localStorage
📊	Balance & usage panel	Provider picker, balance breakdown, today/month totals in k/M/B units, cache hit, usage log with per-model drilldown
🔥	Activity heatmap	GitHub-style dots: 28 days × 6 four-hour bands with date labels
↔️	Channel share	DSH channel vs Claude Code channel (incremental JSONL aggregation of ~/.claude/projects)
🔄	Background refresh	Refresh at startup, then every 5 minutes: balances, DSH tokens, Claude Code aggregation
🔒	Local-only security	Three loopback-only GET endpoints; credentials resolved server-side; upstream forced HTTPS with DNS pinning; Claude logs aggregate numbers only — message text never leaves the machine

UI supports Chinese and English. Balance requests resolve keys in memory through Harness's credential service; keys are not included in plugin caches or browser responses.

Quick start

…