dsh-token-usage-dashboard
Codex 风格 Token 用量统计仪表盘：5 统计卡 + 每日/每周热力图 + 洞察 + 模型用量排名（DeepSeek Harness 插件）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:solstice621/dsh-token-usage-dashboard#6b1ff22eff2bae4ab3f3ae27861eb4e1fe204fc2
Token Usage Dashboard 以 dsh-token-usage-dashboard 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
A Codex-style token usage dashboard for DeepSeek Harness (dsh) Web UI: 5 stat cards + a GitHub-style activity heatmap (daily / weekly) + insights + per-model usage ranking. The UI follows the DSH language setting: Chinese interface → Chinese dashboard, anything else → English.
dsh-token-usage-dashboard screenshot
Aug 15, 2026: 273k tokens · 34 requests;
Daily / Weekly view toggle (weekly = bottom-up 7-cell bars, hover for the week total)assistant/message usage + request/header model attribution + turn/start/turn/end durations), live incremental updates, persisted snapshot + incremental sync for fast restartsThe plugin has two runnable forms that share the same aggregation logic:
dsh plugin add; the npm package contains lib/index.js (host half) and lib/client.js (client half). The host half registers GET /api/token-stats and POST /api/token-stats/rescan through connection.fetch, behind the Web UI's Host/Origin and browser-session checks; the client half registers a "Settings → Stats" section and fetches the API.host.js and client.js are pasted into cordis_define for in-session deployment without restarting the profile.Data flow:
session/event / session/created and also performs an initial backfill over historical session logs.assistant/message.usage, request/header model attribution, and turn/start/turn/end durations into in-memory aggregates.token_stats (normally <DSH_HOME>/storages/token_stats.json); on restart the snapshot is loaded first, then only new events are incrementally folded. Older Harness versions expose sessionPersistence.readFrom for suffix reads; versions without it use sessionQuery.readSession to read the full log while still folding only new events.GET /api/token-stats (2s while scanning, 30s after ready) and renders the dashboard.An explicit rescan rebuilds from the current logs and replaces all aggregates only after every read succeeds. Repeated or simultaneous rescans do not accumulate history again. Live events received during replay are merged in sequence order. Normal restarts retain statistics for deleted sessions; an explicit rescan removes that history when the logs are gone. A failed rescan preserves the last complete result and reports an error.
Both forms use the host's storage / storage.backend.json services for persistence; the JSON backend owns its configured root, atomic writes and directory creation. These services are required for normal Cordis activation (verified on DSH Desktop 0.2.1-rc.2). When the native unit is empty, a readable legacy token-stats/snapshot.json is migrated without modifying the old file. Directly embedded hosts without native storage may still provide fs; its legacy path uses profileContext.home, or an explicit dshHome. Bundle additionally falls back to DSH_HOME / the OS user's .dsh; Dynamic without any known home stays in memory. The dynamic plugin continues to use the authenticated Harness RPC channel.
Enable only one form per host. Bundle and Dynamic share the token_stats storage unit, which permits one active handle at a time.
Run npm ci && npm test for regression tests covering both host implementations. The optional real-Harness HTTP and native-storage integration tests require Node 24 and a Harness source checkout; see TESTING.md for commands, the pinned contract revision, and coverage limits.
dsh plugin --profile web add github:solstice621/dsh-token-usage-dashboard
dsh --profile web # restart to apply
Then open Settings → Stats for the full dashboard. Local install:
dsh plugin --profile web add file:/path/to/dsh-token-usage-dashboard.
On first open the plugin scans all historical sessions (seconds to a minute), then updates in real time via
session/event; the dashboard auto-refreshes every 30s — no manual action needed.
This repo also maintains a dynamic Cordis plugin (toksta-5, deployed in-session via cordis_define,
handy for iterating without restarting the profile):
cordis_inspect_list / cordis_inspect_query (sessionQuery, session/event,
session/created, harness, React/host/styles builtins, settings.section, timer, locale);cordis_define: plugin.kind: "new", idPrefix: "toksta", code.host = host.js, code.client = client.js;cordis_run (mode=run/update) to activate.⚠️ The bundle and the dynamic plugin register the same settings section id (
token-stats); don't run both at once — stop one before enabling the other.
| File | Description |
|---|---|
lib/index.js | Bundle host half: folder + backfill + live listeners + GET /api/token-stats (POST /api/token-stats/rescan as fallback) |
lib/client.js | Bundle client half: window.__ModuleLoader__.load factory, registers "Settings → Stats" |
cordis.patch.yml | bundle patch: inserts the id: token-stats plugin row |
package.json | npm package manifest (dsh.bundle / dsh.client) |
host.js / client.js | Dynamic-plugin host/client function bodies (paste into cordis_define) |
plugin.json | Plugin metadata & package history (pkg-9 … pkg-27) |
plan.md / progress.md | Design docs & progress log (incl. every bug/fix) |
assets/dsh-token-usage-dashboard.png | Dashboard screenshot |
| Symptom | Cause / fix |
|---|---|
pnpm not found on PATH | dsh plugin needs pnpm: corepack enable pnpm (bundled with Node ≥16.10) |
| Two "Stats" sections in Settings | bundle + dynamic plugin (toksta-5) both active; stop one |
| Plain text, no styles at all | CSS not injected: dynamic styles is a Client Builtin (styles.insert(css)), not ctx.get('styles'); bundle injects via <style> |
Client render crash ctx is not defined | ctx only exists in apply(ctx); components use the module-level timer bridge (intervalRef = (cb, ms) => ctx.interval(...)) |
service "timer" is not declared | client has no timer Service; drop inject: ['timer'] |
| Horizontal scrollbar flashes under the heatmap | old month-label nowrap text inflated scrollable overflow; container & month row are overflow:hidden now |
console.warn throws | Host builtins only expose console.log/error; use console.error |
usage are counted (skipped when assistant/message.usage is absent);assistant/message has no model field — usage is attributed to the session's latest
request/header provider/model;session/title-llm-request) are not counted.verified, one-click install pinned to github:solstice621/dsh-token-usage-dashboard#<commit>, auto-refreshed every 2h);docs: add dsh-token-usage-dashboard (UI & Experience, bilingual entry).MIT