Skip to content
dsh-market Browse plugins GitHub 中文

Hou-DL/dsh-token-pulse

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.

Stars ★ 4 Category Usage & Billing Listed 2026-08-28 npm dsh-token-pulse

Install

Inside DeepSeek Harness, with dsh-market

dsh plugin --profile web add dshmarket

Or from the command line

dsh plugin --profile web add dsh-token-pulse

Installing runs third-party code with your own permissions — it can read your files, use your credentials and reach the network. Review the source first, and pin a commit (github:owner/repo#sha) when you can.

Screenshots

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:zlib zstd decoding, no extra install); on older Node it falls back to an external zstd CLI (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/sessions contains session logs with a usage field.
  • 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

Content from the project README on GitHub ↗

Comments

Comments live in GitHub Discussions. Sign in with GitHub to post or react.