dsh-damage-pulse: A Damage-Pulse Token Balance Monitor DSH Plugin for DeepSeek Harness
wssfk12138/dsh-damage-pulse
DSH plugin with game-style damage pulse animations for real-time DeepSeek token balance and usage monitoring.
Turn DeepSeek Harness token consumption into game-style damage animations, making balance changes obvious at a glance.
dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse- Category
- Models & Reasoning
- Platform
- DSH-Plugin
- Author
- wssfk12138
- Distribution
- Plugin
dsh-damage-pulse Key Features
dsh-damage-pulse Repository
dsh-damage-pulse Repo Summary
dsh-damage-pulse is a DSH plugin for DeepSeek Harness that monitors token balance with game-style damage pulse animations. Each time tokens are consumed, the balance number bounces as if hit, and a red charge value floats up, making cost changes visually obvious. It solves the problem of developers lacking intuitive awareness of token consumption and account balance within DeepSeek Harness, while providing session usage, precise amounts, and real-time balance. The plugin is maintained by wssfk12138, licensed under MIT, written in TypeScript, and last updated on 2026-08-19.
What core features does the dsh-damage-pulse DSH plugin support?
This DSH plugin provides per-call usage rows (input/cache hit/output/reasoning with precise amounts), session cumulative bars (based on tokenCost session projection), cache-aware damage animations (pure cache hits show a normal red -x.xx¥, while cache misses display a larger red float with horizontal shake), a draggable balance widget with position memory (localStorage), recharge animations (green +x.xx¥), and peak/off-peak indicators. It includes a built-in DeepSeek pricing table (2026-08-17) with peak/off-peak rates, and historical charges automatically use old prices based on call timestamps. Precise billing is based on actual model names (deepseek-v4-pro / deepseek-v4-flash), distinguishing cache hits and misses.
How to install dsh-damage-pulse?
Since version 0.2.0, it is a standard DSH Host + Client bundle with precompiled artifacts, requiring no source copying or manual patching. Install with:
dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse
After installation, restart the Web profile:
dsh --profile web
If upgrading from an earlier source-integrated version, remove any manual --patch or duplicate mounts. Optional native sidebar amount source enhancement requires the full DSH source and running the scripts/apply-sidebar-integration.ps1 script.
How to configure API Key and price table for dsh-damage-pulse?
Configure DEEPSEEK_API_KEY via DSH credentials mechanism (~/.dsh/.credentials.yaml). If not configured, the balance card shows a guidance state, but token metering remains unaffected. The price table is built-in by default and can be overridden via the settings namespace dsh-token-monitor's priceTable field. Peak hours default to Beijing time 9:00–12:00 and 14:00–18:00.
What HTTP endpoints does dsh-damage-pulse provide?
The plugin registers several HTTP endpoints: GET /api/token-monitor/balance retrieves DeepSeek account balance (including currency/total balance/gift balance); GET /api/token-monitor/usage?sessionId= queries usage history; GET /api/token-monitor/charge-events?since=<seq> fetches incremental charge events (including damageKind, driving cache-aware damage animations).
What are common issues with dsh-damage-pulse?
If the balance card shows "Not configured", DEEPSEEK_API_KEY is missing, but token metering still works. The absence of amounts in the native left sidebar session list is a source enhancement, not part of the standard bundle; the input-area session cumulative is unaffected. Old session amounts are backfilled automatically on plugin startup (cold read fold), so wait a few seconds after startup before refreshing. If no animations appear after window startup, confirm the target profile has been restarted and remove any old manual patches or duplicate mounts.