Usage Pulse · 峰谷用量
A DSH Web UI plugin that keeps DeepSeek's peak / off-peak pricing, your token spend and your
hourly usage visible right below the composer — updated live, no page reload.
一个 DSH Web UI 插件：在输入框下方实时显示 DeepSeek 的峰谷时段与价格、token 用量与花费，以及分时用量图表。
Features · 功能
- Live regime badge —
峰时 / 谷时 5 折 with a countdown to the next price switch, computed in
Beijing time (Asia/Shanghai), including Chinese statutory holidays (peak is Mon–Fri 09:00–12:00
and 14:00–18:00, holidays and weekends are always off-peak).
- When the cheap window starts — the expando shows the next off-peak window (
下一谷段 今天 12:00 开始 · 4 小时后) and when the current segment began, and while peak is running the pill itself shows
谷段 12:00 起.
- Today at a glance — today's spend in CNY plus total tokens, refreshed every 5 seconds.
- Session breakdown — expand the pill to see this session's requests, tokens and cost, plus the
cache-hit / cache-miss / output split and how much of today's spend happened in peak vs off-peak
hours.
- Hourly & daily usage — 24 one-hour bars (amber = peak hours) and the last 7 days, so you can see
when you spend.
- Official unit prices — the current tier's CNY / 1M-token prices for
deepseek-flash and
deepseek-v4-pro (peak and off-peak are exactly ×2 / ×1).
- Bilingual UI — 中文 / English through the harness locale service.
How pricing is computed · 计费口径
Prices follow the official page https://api-docs.deepseek.com/quick_start/pricing/ (verified
2026-10-22, CNY per 1M tokens):
| Model | Band | Cache hit | Cache miss | Output |
|---|
deepseek-flash | peak | 0.04 | 2 | 8 |
deepseek-flash | off-peak | 0.02 | 1 | 4 |
deepseek-v4-pro | peak | 0.30 | 9.0 | 27.0 |
deepseek-v4-pro | off-peak | 0.15 | 4.5 | 13.5 |
Peak = Beijing time Mon–Fri 09:00–12:00 and 14:00–18:00, excluding Chinese statutory holidays.
Everything else (nights, weekends, holidays) is off-peak, at exactly half the peak price.
Usage is read from the harness session event feed (assistant/message → usage), where
inputTokens already excludes cache hits: cost = miss·missRate + hit·hitRate + output·outRate
(cacheWriteTokens is billed at the cache-miss rate). Estimates only — Search / Fetch request fees
are not included.
Privacy · 隐私
Only aggregates are stored, never conversation content: per-hour counters (tokens and cost) and
per-session totals, kept for 35 / 120 days respectively and capped at 300 sessions. The file lives at
~/.dsh-usage-pulse/usage.json (override with DSH_USAGE_PULSE_DIR). All computation is local; the
widget talks to the host over a same-origin route only.
Install · 安装
This repository is a DSH plugin bundle: package.json declares the dsh.bundle manifest and
cordis.patch.yml inserts the plugin, so it installs the same way as any other plugin.
# once the entry is listed in the community catalog
dsh plugin add onfzi/dsh-plugin-usage-pulse
For a local checkout, point the DSH plugin manager at the directory containing package.json
(plugin_manager install_bundle in the Web UI). No restart is needed: the widget appears in the
composer dock right after install.
Files
| File | Purpose |
|---|
index.js | Host half: event aggregation, pricing, persistence, GET /usage-pulse/api/snapshot |
client.js | Client half: composer-dock widget + detail panel |
holidays.js | Chinese statutory holidays (off-peak days) |
locale/ | Bundle metadata (zh / en) |
cordis.patch.yml | Loader patch that inserts the plugin |
Notes
- Peak-regime accuracy depends on
holidays.js: add the next year's State Council holiday list once
it is published (usually the preceding November). A stale list only mislabels holiday days.
- Usage that happens while the plugin is disabled is not backfilled (the persisted session log is a
concatenated zstd frame stream that Node cannot decode frame-by-frame reliably).
Licensed under the MIT License.
