MIT-licensed, game-style DeepSeek Harness token-balance monitor: a live balance widget, cache-aware damage animation, per-call cost lines and peak/valley billing by Beijing time.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-25
License
MIT
01What can it help you accomplish?
Watch token spend and the DeepSeek balance drain during a DSH session
A draggable balance widget with hit-recoil animation, red floating `-x.xx¥` damage numbers, cached/hit pulse, and per-session token + cost totals
DSH users who want game-style, real-time visibility into token consumption and DeepSeek account balance
See precise per-call cost with DeepSeek's peak/valley pricing
Per-call token detail (input / cache hit / output / reasoning) with an exact ¥ amount, weekday peak/valley hours and flat weekend valley pricing
Cost-conscious DSH users who track spend by model and by Beijing-time billing window
02How to install into DeepSeek Harness
Prerequisites
- DSH `0.1.1-rc.2` or a higher compatible version (README states this as a hard requirement)
- Optional: set `DEEPSEEK_API_KEY` via DSH credentials (`~/.dsh/.credentials.yaml`) to show live balance — token metering still works without it
Installation steps
- 01
Run `dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse` to add the prebuilt Host + Client package
$ dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse
- 02
Restart the web profile with `dsh --profile web` so the balance widget loads
$ dsh --profile web
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Standard DSH Host + Client package — a Host plugin listens to `session/event` for precise per-token billing, registers the `tokenCost` session projection, a balance polling service and HTTP endpoints, while a Client package renders the BalanceWidget.
Balance widget with damage pulse
Token spend events from DSH `session/event` and DeepSeek balance polling→A draggable balance card with hit-recoil animation, red floating `-x.xx¥` deduction numbers, green `+x.xx¥` recharge pulse, and a peak/valley traffic-light indicator
Card drag position is remembered in the browser localStoragePer-call usage line & session total
Each model call's token usage→A token detail line (input / cache hit / output / reasoning) inserted into the chat stream, plus a session total bar above the input box
Peak/valley precise pricing
The actual model name and token counts of each call→Exact ¥ cost using the built-in DeepSeek 2026-08-23 price table, weekday peak/valley hours by Beijing time and flat valley on weekends; cache hit/miss billed separately
Optional native left-sidebar amount (source enhancement)
Full DSH source tree + running the sidebar integration script→Per-session cost shown at the end of the native left sidebar session rows
The script first backs up three target files and idempotently writes `projectionValues.tokenCost.cost`; it stops (no guessed writes) if the upstream structure doesn't matchOnly applies with full DSH source; the standard package does not modify the host DOM
04Who is it for? When not to use it?
Good for
- DSH users who want game-style, real-time visibility into token consumption and DeepSeek account balance
- Cost-conscious DSH users who track spend by model and by Beijing-time billing window
Not for
- When upgrading from the old source-integration version, remove your previous manual `--patch` or duplicate mount entries first; otherwise the same plugin may load twice and misbehave.
05Compatibility, maintenance and safety notes
- The standard package does not modify the host DOM and cannot inject amounts into the left session list — DSH has no public third-party slot there. Left-sidebar amounts need full DSH source + the sidebar script.
- When upgrading from the old source-integration version, remove your previous manual `--patch` or duplicate mount entries first; otherwise the same plugin may load twice and misbehave.
MIT · actively maintained (latest release v0.3.1, 2026-08-23)
06Frequently asked questions
How do I install dsh-damage-pulse on DeepSeek Harness?
Run `dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse`, then restart the web profile with `dsh --profile web`. It ships prebuilt as a standard Host + Client package — no source copy, tsconfig edit or `--patch` needed.
Do I need a DeepSeek API key for it to work?
Token metering works without one, but the live balance card only shows real numbers once `DEEPSEEK_API_KEY` is set via DSH credentials (`~/.dsh/.credentials.yaml`). Without it the card shows a setup-guide state; token counting is unaffected.
Why doesn't the left sidebar show per-session cost?
Native left-sidebar amounts are a source-enhancement feature, not part of the standard package — DSH has no public third-party slot for that area. The input-area session total works in the standard package; for the left list you need full DSH source and the sidebar integration script.
How are costs calculated — does it match DeepSeek's pricing?
It uses a built-in DeepSeek pricing table (dated 2026-08-23): weekday peak/valley hours by Beijing time, weekends flat valley, per-call model name with longest-prefix version matching, and cache hit/miss billed separately. You can override it via the `dsh-token-monitor` settings `priceTable`.
I upgraded from the old source-integration version and see no animation — what now?
Remove your old manual `--patch` or duplicate mount entries; loading the plugin twice breaks it. Also make sure you restarted the target profile. The standard package needs no patch and won't inject into the host DOM.
07Related DSH workflows
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表；接入 Agent preset（standard/code/minimal/cordis）、Skills、MCP、Goals、Todos、子代理，/ 命令注册表与随附技能（audit/bug/review/practice/pr_comments/release-notes/vuln-check）；纯插件挂载零核心改动。
dsh-tianshu-tui
by huiliyi37
DeepSeek Harness 交互式终端 UI 插件：会话工作区、图片端到端（剪贴板/视觉桥）、slash 下拉、审批卡片、推理可视化，纯展示层
dsh-popout-sidebar
by e2mcc
A sidebar can pop out a separate browser tab (drag it to another monitor)
08Data and sources
本仓库从 `0.2.0` 起是标准 DSH Host + Client 组合包，已提交预编译产物。
Host 插件 | `plugins/dsh-token-monitor` | 监听 `session/event`，精确计费（token × 单价），注册 `tokenCost` session projection、余额轮询服务、HTT…
Client 包 | `packages/client/ui-token-monitor` | Web GUI 组件：余额悬浮窗（BalanceWidget）、单次用量行、会话累计条，读投影与 HTTP 端点渲染
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-25. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.