Native DeepSeek Harness billing plugin — aggregates real usage from session logs into a cost dashboard with live multi-provider pricing, subscription/balance reconciliation, and cost-attribution analytics.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-05
License
MIT
01What can it help you accomplish?
See exactly how much every DeepSeek Harness model run costs, in one dashboard
A sidebar cost card plus a six-zone billing dashboard (overview / tokens / usage / trends / rates / settings) aggregating real usage from persisted session logs, priced against live multi-vendor rates
DeepSeek Harness users who want per-run, per-model cost visibility instead of a raw token count
Close the loop on subscriptions, balances, relay quotas and ledger reconciliation
Subscription-plan quotas, multi-provider balances, relay quotas, declared endpoints and official-vs-local ledger reconciliation across providers
Heavy multi-provider DSH users who need to track plan quotas, balances and cross-check their billing
Explain where the cost actually goes, beyond the total
Input cache-hit/miss buckets (incl. reasoning), official vs third-party buckets, per-workspace/session/relay drilldown, per-round cost-spike attribution, and a per-model performance panel (TTFT mean / P50 / P90, tokens/s)
Engineers optimizing DSH spend who want cost attribution and latency-per-model insights
02How to install into DeepSeek Harness
Prerequisites
- A running DeepSeek Harness host that auto-discovers the plugin via `dsh.client` / `cordis.patch.yml`.
- Host `sessionPersistence` enabled — without it the plugin falls back to a local stats file (`~/.dsh-usage-stats.json`) and only estimates usage.
Installation steps
- 01
Add the plugin to the host’s `cordis.patch.yml`: insert id `ui-usage-billing` with name `@kenz1117/dsh-ui-usage-billing`.
- 02
Or run `npm install @kenz1117/dsh-ui-usage-billing` in the host project, then start the host — a billing entry appears above Settings with no extra config.
$ npm install @kenz1117/dsh-ui-usage-billing
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Native DSH plugin discovered via the host’s `dsh.client` / `cordis.patch.yml`; adds a billing dashboard surface and loopback-only HTTP APIs on top of the host’s `sessionPersistence` and credential seam.
Real-time usage aggregation
persisted session logs (via the host’s sessionPersistence)→cost metrics — this month / today / estimated / heatmap / trends — priced in CNY against live multi-vendor rates
writes a persistent usage ledger at `~/.dsh/.dsh-usage-ledger.json`Billing dashboard UI
aggregated stats JSON from the server→sidebar trigger card + six-zone full-screen dashboard (overview / tokens / usage / trends / rates / settings)
Subscription, balance & relay closed loop
official / subscription / relay balance APIs (via credential seam)→subscription quotas, multi-provider balances, relay quotas, declared endpoints, and official-vs-local ledger reconciliation
reads multi-provider balance / pricing APIs over the networkwrites the `~/.dsh` ledgerCost attribution & performance analytics
per-session / per-round cost and latency data→input cache-hit/miss buckets, official vs third-party buckets, per-round cost-spike attribution, and a per-model latency panel (TTFT mean / P50 / P90, tokens/s)
04Who is it for? When not to use it?
Good for
- DeepSeek Harness users who want per-run, per-model cost visibility instead of a raw token count
- Heavy multi-provider DSH users who need to track plan quotas, balances and cross-check their billing
- Engineers optimizing DSH spend who want cost attribution and latency-per-model insights
Not for
- Declared permission level is `high`: reads persisted session logs (files), calls multi-provider balance / pricing APIs (network), reads `apiKeyEnv` via the credential seam, and writes the `~/.dsh` ledger — but it does NOT execute shell commands.
- Update channel is `user-reviewed`: because the plugin has file / network / credential capabilities, DSH STORE requires local manual confirmation on every install; review the repo, pin a Commit, and lifecycle scripts before installing.
- Preview line (npm latest/alpha, 1.0.x) targets DSH 0.1.2 series; stable line (npm stable, 1.1.x) targets older hosts 0.1.0-rc.8 ~ 0.1.1-rc.2. Requires Node.js ^22.19.0 || >=24.0.0.
05Compatibility, maintenance and safety notes
- Declared permission level is `high`: reads persisted session logs (files), calls multi-provider balance / pricing APIs (network), reads `apiKeyEnv` via the credential seam, and writes the `~/.dsh` ledger — but it does NOT execute shell commands.
- Update channel is `user-reviewed`: because the plugin has file / network / credential capabilities, DSH STORE requires local manual confirmation on every install; review the repo, pin a Commit, and lifecycle scripts before installing.
- Preview line (npm latest/alpha, 1.0.x) targets DSH 0.1.2 series; stable line (npm stable, 1.1.x) targets older hosts 0.1.0-rc.8 ~ 0.1.1-rc.2. Requires Node.js ^22.19.0 || >=24.0.0.
MIT · actively maintained (latest release v1.1.7, 2026-09-04)
06Frequently asked questions
How do I install dsh-ui-usage-billing into DeepSeek Harness?
Add it to your host’s `cordis.patch.yml` with insert id `ui-usage-billing` and name `@kenz1117/dsh-ui-usage-billing`, or run `npm install @kenz1117/dsh-ui-usage-billing`. After the host starts, a billing entry appears above Settings in the sidebar; no extra config is needed, and real aggregation works when `sessionPersistence` is available.
Where does the cost data come from — does it use fake samples?
The server aggregates real usage from persisted session logs and prices it against live multi-vendor official rates; before data arrives it shows an all-zero empty snapshot and never fabricates samples.
What providers’ balances and subscriptions can it track?
It tracks subscription-plan quotas, multi-vendor balances (DeepSeek, Kimi, StepFun, SiliconFlow, xAI, Z.ai GLM, Tencent Cloud TokenHub and more), relay quotas, declared endpoints, and official-vs-local ledger reconciliation — forming a cross-checkable billing loop.
Does the plugin need high permissions, and how is it updated?
Its declared permission level is `high` (reads session logs, calls balance/pricing APIs, reads `apiKeyEnv` via the credential seam, writes the `~/.dsh` ledger) but it does not execute shell commands; the update channel is `user-reviewed`, so DSH STORE requires local manual confirmation on every install.
Which DeepSeek Harness versions are supported?
The preview line (npm latest/alpha, 1.0.x) targets the DSH 0.1.2 series; the stable line (npm stable, 1.1.x) targets older hosts 0.1.0-rc.8 ~ 0.1.1-rc.2, and it requires Node.js ^22.19.0 || >=24.0.0.
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
本包为独立 npm 包，发布后即可被其他 DeepSeek Harness 宿主安装。
启动宿主后，侧边栏设置上方即出现计费入口。无需额外配置；`sessionPersistence` 可用时自动聚合真实用量。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-05. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.