MIT-licensed, local-only DeepSeek Harness (`dsh web`) plugin that shows a persistent balance/usage dock and activity heatmap, comparing the DSH and Claude Code channels without ever sending message text off-machine.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-30
License
MIT
01What can it help you accomplish?
Keep DeepSeek Harness balance, credit and token usage permanently visible inside the dsh web GUI
A persistent floating dock plus a customizable balance / token-usage panel (today, month, cache hit) that glows green when healthy and folds into a balance pill on collapse
DeepSeek Harness (dsh web) users who want their balance and token stats glanceable at all times instead of buried in logs
Compare DSH vs Claude Code channel usage and inspect cache hit rates locally
A channel-share ratio bar, a 14-day usage log with per-model drilldown, and a 28-day activity heatmap
Users who run both DeepSeek Harness and Claude Code and want a local-only dashboard of cross-channel token usage
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`
Installation steps
- 01
$ dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"
- 02
Restart `dsh web`, then hard-refresh the browser.
$ dsh web
Verify the integration
- After restarting `dsh web` and hard-refreshing the browser, the dock appears at the bottom-left.
Rollback
- dsh plugin --profile web remove dsh-usage
03DSH integration and capability boundaries
Installed as a `dsh web` plugin via `dsh plugin --profile web add`; runs a persistent floating dock and balance/usage panel inside the DeepSeek Harness web GUI (`dsh web`).
Persistent floating dock
DeepSeek Harness web GUI (`dsh web`)→Always-visible balance pill/dock at bottom-left that mirrors your pins and folds into a tiny pill when the sidebar collapses
Persists widget layout, accent, background and panel opacity in localStorageBalance & usage panel (seven widgets)
Credential references from `~/.dsh/.credentials.yaml`→Balance breakdown, today/month token totals, cache hit rates, channel share and usage log with per-model drilldown
Local-only usage API
Loopback-only GET requests→JSON provider list, unified balance snapshot and per-day/per-model token aggregates via `/api/usage/*`
Serves three loopback-only GET endpoints; non-loopback callers get `403`Credentials resolved server-side through Harness's credentials seam; secrets are never cached or echoedActivity heatmap & dual-channel comparison
DSH token usage and Claude Code `~/.claude/projects` JSONL→28-day × 6-band activity heatmap and a DSH-vs-Claude Code channel ratio bar
Parses and discards Claude Code logs line-by-line; only aggregated numbers reach the cache
04Who is it for? When not to use it?
Good for
- DeepSeek Harness (dsh web) users who want their balance and token stats glanceable at all times instead of buried in logs
- Users who run both DeepSeek Harness and Claude Code and want a local-only dashboard of cross-channel token usage
Not for
- Do not expose these loopback endpoints through a reverse proxy to LAN or the public internet.
- Requires the DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`.
05Compatibility, maintenance and safety notes
- Do not expose these loopback endpoints through a reverse proxy to LAN or the public internet.
- Requires the DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`.
- Providers without a public balance API show an explicit "no public balance interface" state — the plugin never guesses a balance.
MIT — actively maintained (latest release v0.2.0, 2026-08-16)
06Frequently asked questions
How do I install dsh-usage with DeepSeek Harness?
Run `dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"`, then restart `dsh web` and hard-refresh the browser. The dock appears at the bottom-left. Requires the DeepSeek Harness `web` profile (`@deepseek-ai/dsh >= 0.1.0-rc.6`).
What are the prerequisites for dsh-usage?
You need a DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`. Provider credentials (e.g. `DEEPSEEK_API_KEY`) live in `~/.dsh/.credentials.yaml`; the plugin reads credential references from there and never touches the secrets directly.
How does dsh-usage connect to DeepSeek Harness?
It is a `dsh web` GUI plugin. It serves three loopback-only GET endpoints and resolves credentials server-side through Harness's credentials seam; upstream calls are HTTPS-only with DNS pinning. It does not run inside the agent — it renders a floating dock in the `dsh web` interface.
How is dsh-usage different from a generic usage tracker?
It is purpose-built for DeepSeek Harness: it mirrors your pins, compares the DSH channel against the Claude Code channel (parsing `~/.claude/projects` JSONL), and keeps everything local-only — message text never leaves the machine — with a privacy-first, loopback-only design.
How do I remove or update dsh-usage?
Update with `dsh plugin --profile web update dsh-usage`; remove with `dsh plugin --profile web remove dsh-usage`. After removal the dock disappears on the next `dsh web` restart.
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-damage-pulse
by wssfk12138
Game-style token-usage / balance damage-pulse visualization for DeepSeek/DSH.
08Data and sources
for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web GUI (`dsh web`).
Requires a DeepSeek Harness `web` profile (`@deepseek-ai/dsh >= 0.1.0-rc.6`).
dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-30. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.