harness-ledger
DeepSeek Harness 的令牌使用量和成本台账。跟踪总量、各提供商和各模型的使用情况、当月热力图，以及按会话和按请求记录的数据。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add harness-ledger@0.1.2
Harness Ledger 以 harness-ledger 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A token usage and cost ledger for DeepSeek Harness. It reads usage already recorded in Harness sessions and shows totals, per provider and per model breakdowns, a monthly heatmap, and per session and per request records in a draggable browser panel. It makes no model calls and keeps its cache in the dsh user data area.
| Full panel in the default theme with the Chinese interface | The same panel in the Matrix theme with the English interface |
| Default theme, Chinese interface | Matrix theme, English interface |
| The per model pricing editor in the Paper theme | The compact view and the collapsed pill in the Midnight theme |
| Per model pricing editor, Paper theme | Compact view and collapsed pill, Midnight theme |
The panel refreshes every ten seconds. It displays up to thirty highest-usage sessions and up to twelve recent requests for an expanded session.
The plugin is a normal dsh plugin bundle, so it installs with the standard dsh plugin flow and shows up in the installed plugins list with its own enable toggle. It never needs an entry in cordis.patch.yml.
Open the Plugins page, install from the repository address, then restart Harness.
https://github.com/yuyuanjingxuan/harness-ledger
dsh plugin --profile desktop add https://github.com/yuyuanjingxuan/harness-ledger
Replace desktop with your profile name. Restart Harness after the install finishes.
Every provider discovered by Harness starts at zero per million tokens, so the panel works without a pricing block. Click the ¥ button in the panel header to enter input and output prices. Choose either By provider or By model; only the selected mode is used for estimates. Model rates are keyed by both provider and model, so identical model names from different providers remain distinct. Both rate tables persist in the browser's local storage. In provider mode, local provider rates take precedence over profile-configured rates.
The provider key must match the ID reported by Harness. Profile configuration remains available when rates should be shared across browsers or managed centrally:
- id: ledger
config:
pricing:
GWDG_CHAT_AI:
inputPerM: 2.0
outputPerM: 6.0
inputPerM and outputPerM are prices per million uncached input tokens and output tokens. Zero is valid and means free.
The plugin reads session history through Harness services. Its cache contains folded session metadata and usage totals, not full message bodies. Cached totals are returned immediately while session history refreshes in the background.
The cache lives in the dsh user data area at ~/.dsh/storages/harness-ledger, next to the other dsh storages, so it survives reinstalls and upgrades. Set DSH_HOME to use a different dsh root, or set HARNESS_LEDGER_CACHE before starting Harness to point at a dedicated cache directory. The legacy DSH_LEDGER_CACHE name remains supported.
The host and browser modules are plain ES modules with no build step.
node --check lib/index.js
node --check lib/client.js
node --check lib/store.js