Local-first token usage heatmap inside DSH settings: GitHub-style week/month/quarter/year grids, hourly usage per day, per-model and per-provider Top 5, and persisted history that survives session deletion. Zero network, zero billing.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-token-pulse
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
中文版：见 README.md
A local Token usage heatmap plugin for DSH Web — GitHub-style calendar views, built into the Settings pane.
Requirements
- Node.js ≥ 23.8 (built-in
node:zlibzstd decoding, no extra install); on older Node it falls back to an externalzstdCLI (sudo apt install zstd/brew install zstd). - A running DSH Web profile (
dsh web).
Install
# From npm (recommended, shortest)
dsh plugin --profile web add dsh-token-pulse
# Or from GitHub
dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
# Or from Gitee (faster in China)
dsh plugin --profile web add "git+https://gitee.com/HouDL/dsh-token-pulse.git"
Restart, then open Settings → Token Pulse.
- Zero network, zero billing — reads local session logs only, never touches billing/balance APIs
- Persistent — history is stored on disk; deleting sessions never loses data
- Multiple views — Week (per-hour) / Month (calendar) / Quarter (last ~90 days) / Year (full year, two rows)
- Stats — Today / This week / This month / All time + Top 5 by model and by provider
Screenshots
Features
| Module | Description |
|---|---|
| View switcher | Week / Month / Quarter / Year, colored with a view-adaptive 25 / 50 / 75 / 100% palette |
| Week view | 24 hourly bars per day to spot peak hours; click a row to see that day's Top 5 |
| Month view | Calendar cells showing date and daily usage |
| Quarter / Year | GitHub-style grids; quarter is enlarged for readability, year laid out in two rows |
| Top stats | Today / Week / Month / All-time, M / k abbreviated |
| Top 5 models | By model or provider, switching with the view window / clicked date |
| Refresh | Manual refresh + auto refresh (5 / 10 / 30 / 60 min, or off) |
| Language | 中 / English switch |
FAQ
- Everything shows 0? Make sure
$DSH_HOME/sessionscontains session logs with ausagefield. - Does it go online? No. Fully local.
- Timezone? Fixed to Asia/Shanghai, weeks start on Monday.
- How to reset? Settings page → ⋯ menu (top-right) → Reset history.
Development
pnpm install && npx tsdown # build
node --test src/ # run tests
License
MIT
Links
More in this category
bowenliang123/dsh-context★ 1999
DSH context insight panel: Context dashboard + /context command + Context browser — one-stop context lifecycle management with categorized composition, content details, evolution trends, compaction/injection events, and stats.
Han-1413141/dsh-cost-meter★ 391
Per-session and daily API cost, budget with usage %, official balance, history dashboard, and one-click official price sync with peak/off-peak pricing.
wssfk12138/dsh-damage-pulse★ 258
Tracks DeepSeek token usage, per-call and session costs, and account balance with cache-aware charge animations in the DSH Web UI.
zh667/TokenLedger★ 202
Sidebar usage panel that attributes tokens to the relay site that served each request, read from your existing provider config: today/month/all-time totals, per-site and per-model breakdowns, a year activity heatmap, and New API / Sub2API / DeepSeek balances.
Ychris12138/dsh-usage-stats★ 171
Multi-provider usage dashboard with provider/model token breakdowns, calendar drill-downs, account balances, and OpenCode Go / Z.ai subscription quota tracking.
PolinniZhong/dsh-personal-center★ 118
Personal center for DeepSeek Harness: cross-session usage statistics, per-model cost estimation, global custom instructions, a global font-size adjuster, a data-driven desktop pet with bitmap & vector skins, and a conversation status overview, all local and offline.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.