Skip to content
Back to search

dsh-cost-meter

Cost tracking for DeepSeek Harness: session and model costs, token usage, budgets, provider balances, and coding-plan quotas. Bilingual English/Chinese UI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Han-1413141/dsh-cost-meter with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Han-1413141/dsh-cost-meter'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/han-1413141--dsh-cost-meter/badge.svg)](/listings/han-1413141--dsh-cost-meter)

HTML

<a href="/listings/han-1413141--dsh-cost-meter"><img src="/api/listings/han-1413141--dsh-cost-meter/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

> Requirements: Node.js ≥ 20 + DeepSeek Harness (a version with the `dsh plugin` command; `npm install -g @deepseek-ai/dsh`) + **pnpm on the DSH process's PATH**, including npm-name installs and Plugin Hub installs. Node.js ≥ 22.13 is recommended for the pinned pnpm 11 below; Node.js 20 users can use pnpm 10.

One-click install (recommended)

**First-time setup on macOS / Linux:** install pnpm in the terminal you use to start DSH (the same commands also work on Windows):

npm install -g pnpm@11.21.0
pnpm --version

On Node.js 20, use `npm install -g pnpm@10` instead. See [pnpm installation and supported Node.js versions](https://pnpm.io/installation).

**npm package name** (published to the npm registry, always tracks the latest version; no git needed):

dsh plugin --profile web add dsh-cost-meter

**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.8.12`** — review the script before running):

irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.8.12/install.ps1 | iex

**Or a plain command line** (the machine must already have pnpm and git; also pinned to the tag):

dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.8.12

Without git, use the GitHub tag archive:

dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.8.12.tar.gz

After installing, **restart** `dsh web` (plugin rows, the Typert manifest and the client bundle are all scanned at startup):

dsh web

Install troubleshooting: pnpm was not found (macOS / Linux)

`dsh: pnpm was not found; install pnpm and make it available on PATH.` means DSH cannot start its package manager; the plugin has not loaded yet. Installing by npm package name still requires pnpm.

After the setup above, check the commands from the **same terminal and OS user** that start DSH:

command -v node
command -v pnpm
command -v dsh

If npm installed pnpm but the shell cannot find it, add npm's global executable directory for the current shell, then retry:

export PATH="$(npm prefix -g)/bin:$PATH"
pnpm --version
dsh plugin --profile web add dsh-cost-meter@latest
dsh web

Stop the existing DSH process before restarting it. Plugin Hub runs inside DSH and inherits that process's PATH; reopening the browser alone will not refresh it. With nvm/fnm, select the Node.js version used by DSH before installing pnpm. If npm reports `EACCES`, use a user-owned Node.js installation/global prefix as described in the pnpm guide, then repeat the PATH check. For a persistent shell setup, add the executable directory to your shell profile. A successful install on your machine is confirmed by the plugin appearing after DSH restarts.

Install troubleshooting: ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION

Symptom: `dsh plugin --profile web add` fails with `[ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION] N lockfile entries failed verification`.

Cause: your environment (pnpm config or a policy bundled into the invoking installer) enforces the "minimum release age" supply-chain protection — any lockfile entry **published more recently than the threshold** is rejected. Plugin releases from before runtime dependencies were exact-pinned declared floating ranges, so a fresh install resolved them to whatever was newest at that moment (`^0.1.0-rc.6` was observed to float onto rc.8 published barely a week earlier), which such a policy refuses.

Fix:

1. **Upgrade the plugin and use the host's plugin installer**: `zod` remains exact-pinned. `@deepseek-ai/dsh-credentials` and `@deepseek-ai/dsh-home-paths` are now peer dependencies supplied by DSH, avoiding duplicate old host packages that can fail dependency preflight (issue #106). Pinning prevents version drift but cannot satisfy every age threshold;

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">dsh-cost-meter</h1>
  2. <p align="center">Cost tracking and subscription quotas for DeepSeek Harness</p>
  3. <p align="center">
  4. <a href="https://github.com/Han-1413141/dsh-cost-meter/releases/latest"><img src="https://img.shields.io/badge/version-1.9.73-4176E6?style=flat-square" alt="version"></a>
  5. <a href="https://www.npmjs.com/package/dsh-cost-meter"><img src="https://img.shields.io/npm/dm/dsh-cost-meter?label=downloads&style=flat-square&color=4176E6" alt="npm monthly downloads"></a>
  6. <a href="https://github.com/Han-1413141/dsh-cost-meter/stargazers"><img src="https://img.shields.io/github/stars/Han-1413141/dsh-cost-meter?label=stars&style=flat-square&color=D9A400" alt="GitHub stars"></a>
  7. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT license"></a>
  8. </p>
  9. <p align="center"><b>English</b> | <a href="README.zh-CN.md">简体中文</a></p>
  10. <p align="center"><a href="#installation">Install</a> · <a href="#feature-overview">Features</a> · <a href="#screenshots--walkthrough">Screenshots</a> · <a href="#documentation">Docs</a> · <a href="#community">Community</a></p>
  11. Track costs and tokens by conversation, model and call. View account balances, subscription quotas and budgets together, with separate API charges and Plan equivalents, multi-provider pricing, peak/off-peak alerts, and configurable sidebar and composer displays.
  12. <p align="center">
  13. <img src="docs/promo.en.png" alt="Whale-themed project illustration" width="1280">
  14. <br><sub>Project illustration</sub>
  15. </p>
  16. <picture>
  17. <source media="(prefers-color-scheme: dark)" srcset="docs/images/conversation-dark.png">
  18. <img src="docs/images/conversation-light.png" alt="Full conversation view with costs, subscription quotas and account balance" width="1280">
  19. </picture>
  20. <p align="center"><sub>Full conversation view in light or dark mode to match your theme. Screenshots use example data.</sub></p>
  21. ## Installation
  22. Requires **Node.js ≥ 20, DSH 0.2.0 or later**, and pnpm available to DSH. See [host compatibility](docs/host-compatibility.md).
  23. ```sh
  24. dsh plugin --profile web add dsh-cost-meter
  25. ```
  26. Restart `dsh web` after installation or updates. **Desktop** uses its bundled CLI and the `desktop` profile; follow the [Desktop guide](docs/install-troubleshooting.md#desktop-安装与更新).
  27. <details>
  28. <summary>Windows installer / pinned version</summary>
  29. The PowerShell installer checks pnpm and Git and uses the `web` profile by default:
  30. ```powershell
  31. irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.73/install.ps1 | iex
  32. ```
  33. Install a pinned Git tag:
  34. ```sh
  35. dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.73
  36. ```
  37. See [installation and updates](docs/install.en.md) for uninstalling or installing without Git.
  38. </details>
  39. Current release **v1.9.73**: [release notes](docs/update-notes-1.9.73.md#english) · [troubleshooting](docs/install-troubleshooting.md)
  40. ## Feature overview
  41. - **Conversation and call costs**: Cost entries in the composer, header and each turn. Inspect rates, tokens, recorded inputs and tool results, including parent/subagent cost attribution.
  42. - **Statistics and exports**: Filter by date, provider and model; inspect trends, rankings, cache hit rates and token heatmaps. Export one or all retained conversations, and view local-model API-equivalent costs separately.
  43. - **Quotas and balances**: Codex / ChatGPT, OpenCode Go, MiniMax, Claude, GLM, Kimi, Qianwen, MiMo, OpenDesign and other plans, plus CLIProxyAPI multi-account quotas and custom HTTP balance sources.
  44. - **Multi-provider pricing**: Automatic model matching, editable rates and multipliers, and peak/off-peak tiers. Sync DeepSeek official prices and the OpenRouter catalog; separate API charges from Plan equivalents.
  45. - **Budgets and pricing alerts**: Daily, monthly, cumulative or custom-date budgets. Peak/off-peak schedules and countdowns, with popup and system notifications before a change.
  46. - **Display and history**: Configure sidebar cards, composer entries, quota strips and turn costs. Chinese/English UI, dark themes and mobile layouts; historical imports, retention and storage controls.
  47. See [features and screenshots](docs/features.en.md) for entry points and [model and plan support](docs/model-and-plan-adaptation.en.md) for providers and credentials.
  48. ## Screenshots & walkthrough
  49. | Cost trends and model ranking | Conversation cost distribution |
  50. |---|---|
  51. | [![Cost trends](docs/images/statistics.png)](docs/images/statistics.png) | [![Conversation treemap](docs/images/treemap.png)](docs/images/treemap.png) |
  52. | Subscription quotas and balances | Display settings and interactive preview |
  53. |---|---|
  54. | [![Quotas and balances](docs/images/quotas.png)](docs/images/quotas.png) | [![Display settings](docs/images/display.png)](docs/images/display.png) |
  55. Select an image for full resolution. [More views: call details, prices, history, dark themes and mobile](docs/features.en.md).
  56. ## Documentation
  57. | Topic | Guides |
  58. |---|---|
  59. | Setup and use | [Install, update and uninstall](docs/install.en.md) · [Troubleshooting](docs/install-troubleshooting.md) · [Display settings](docs/display-settings.md) |
  60. | Statistics and billing | [Billing rules](docs/billing.en.md) · [Statistics and details](docs/billing-statistics.md#english) · [Models and plans](docs/model-and-plan-adaptation.en.md) · [Peak schedules](docs/provider-peak-schedules.md) |
  61. | Balances and quotas | [Credentials](docs/balance-credentials.md) · [Custom balances](docs/custom-balance-sources.en.md) · [Gateway quotas](docs/cliproxyapi-quota.md) · [Plan estimates](docs/token-plan-stats.md#english) |
  62. | History and storage | [Retention and cleanup](docs/pricing-history-storage.md) · [Repricing](docs/model-history-repricing.md) · [External usage](docs/external-usage.md) · [Ledger recovery](docs/ledger-lock-recovery.md#english) |
  63. | Development | [Architecture and development](docs/architecture.en.md) · [Contributing](CONTRIBUTING.md) · [Host compatibility](docs/host-compatibility.md) |
  64. | Releases | [Update history](docs/UPDATE-HISTORY.md) · [CHANGELOG](CHANGELOG.md) |
  65. ## Community
  66. [Open an issue](https://github.com/Han-1413141/dsh-cost-meter/issues) with plugin and host versions, reproduction steps and relevant logs. The WeChat group is available for usage questions and feature discussions.
  67. <p align="center">
  68. <a href="docs/community-wechat.png"><img src="docs/community-wechat.png" alt="WeChat community QR code" width="280"></a>
  69. </p>
  70. ## Contributors
  71. Thanks to everyone who contributes reports, ideas, documentation and code.
  72. <a href="https://github.com/Han-1413141/dsh-cost-meter/graphs/contributors">
  73. <img src="https://contrib.rocks/image?repo=Han-1413141/dsh-cost-meter" alt="Contributors">
  74. </a>
  75. ## Star History
  76. <a href="https://www.star-history.com/?repos=han-1413141%2Fdsh-cost-meter&type=timeline&legend=bottom-right">
  77. <picture>
  78. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&theme=dark&legend=bottom-right" />
  79. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
  80. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
  81. </picture>
  82. </a>
  83. ## License
  84. [MIT](LICENSE) © 2026 dsh-cost-meter contributors

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.