faith1688/dsh-usage-meter-harness

dsh-usage-meter-harness

English | 简体中文

DeepSeek Harness（DSH）的实时用量 / 费用 / 余额计量插件。 在聊天输入框旁直接看到 token 用量、消费金额和真实钱包余额——官方 DeepSeek 模型和你注册的任何自定义模型都支持。

安装

前置（方式一、二）：DSH CLI 本身基于 pnpm，每台机器装一次即可： npm install -g pnpm（或 corepack enable），用 pnpm --version 验证。

三选一。方式一和方式二需要 pnpm（DSH CLI 本身的一次性前置要求，任意插件都一样）： npm install -g pnpm 或 corepack enable。

方式一 —— npm 源（需要 pnpm）

dsh plugin --profile web add --verbose @faith1688/dsh-usage-meter-harness@latest

（--verbose 显示安装进度，可去掉。@latest 显式请求最新版——请始终这样安装。）

方式二 —— GitHub 源（需要 pnpm）

dsh plugin --profile web add --verbose github:faith1688/dsh-usage-meter-harness#main

（--verbose 显示安装进度。）

方式三 —— 一行命令安装，不需要 pnpm（推荐）

npx -y @faith1688/dsh-usage-meter-harness@latest

一条命令：自动装进 DSH web profile 并注册 bundle（幂等）。 （@latest 显式请求最新版——请始终这样安装。）

不想用 npx？仓库里也带了同样的脚本：

Windows（cmd）：

curl -fsSL https://raw.githubusercontent.com/faith1688/dsh-usage-meter-harness/main/scripts/install.cmd -o "%TEMP%\um-install.cmd" && "%TEMP%\um-install.cmd"

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/faith1688/dsh-usage-meter-harness/main/scripts/install.sh | sh

脚本会自动完成全部步骤：进入 DSH web profile → 安装包（可见进度）→ 注册 dsh.profile.bundles（幂等，升级后重跑安全）。

注意：方式三用的是原生 npm，不做 pnpm 协调。如果你的 profile 由 pnpm 管理（dsh plugin 的默认方式），推荐用方式一。

任选一种方式后：重启 dsh web。

更新

分两种情况——请对号入座：

全新安装（从没装过），或使用 npx 方式： 直接跑安装命令即可，永远拉取最新版。

升级已有安装（插件已存在）： profile 的 package.json / pnpm-lock.yaml 可能锁在旧版本，不带版本号的 add 会被 pnpm 判定"已满足"而跳过。升级时 务必显式指定新版本：

dsh plugin --profile web add @faith1688/dsh-usage-meter-harness@latest

或在 profile 目录（~/.dsh/profiles/web）里执行：

pnpm update @faith1688/dsh-usage-meter-harness

（也可以指定精确版本，如 ...@1.0.28。）

在插件市场里点「更新」失败？ 如果提示「更新目标为 vX，但实际安装为 vY；已自动 恢复原版本」，那是 pnpm 的新版本冷静期（刚发布的版本约 24 小时内会被跳过）， 不是你装坏了，配置和余额数据都没动。等 24 小时再点一次即可；想立刻升级就用 下面的 npx 方式，或在 profile 的 pnpm-workspace.yaml 里把 minimumReleaseAgeExclude 加上本包名（不带版本号）。

更新后：重启 dsh web（或刷新浏览器页面）。注意：重启本身不会拉取 新版本——它只是重新加载 node_modules 里已有的包。

为什么这样更新绝不会产生重复挂载记录、也绝不会动你的配置：

• 挂载记录在插件包内部（cordis.patch.yml，dsh.bundle 机制）。每个版本 自带完整的一条挂载记录；DSH 启动时从已安装的包里读取——装上新版本包， 自动就带上新版本的正确记录。
• 安装器只改 profile 的 package.json（dsh.profile.bundles，自动去重）和 node_modules。从不写 profile 根目录的 cordis.patch.yml——你在里面 自己加的内容（或其他插件的配置）原样保留。
• 重复挂载记录只可能发生在：你手动往 profile 根 cordis.patch.yml 里加了 相同的 id——安装器永远不会这样做。

功能一览

对话用量卡（聊天输入框旁）

计费引擎

设置与体验

支持的模型

• DeepSeek 官方模型（deepseek-chat、deepseek-reasoner 等）：自动预填官方价， 通过 API Key 显示真实钱包余额。
• 任意自定义模型（DSH 注册的 OpenAI 兼容厂商、Ollama、OpenRouter 等）： 自行填写单价与余额即可，其余功能完全一致。

截图

设置页：

用量弹窗：

配置

所有配置都在 usage-meter 设置命名空间，可直接在插件界面里修改：

兼容性

• 需要 Node.js ≥ 22。
• peer 版本跟随所支持的 DSH 版本（见 package.json）；DSH 升级不影响本插件， 本插件也不会影响你的其他插件。

License

MIT © faith1688

隐私

• 插件无任何遥测、无统计。
• 网络请求全部由你主动发起，共四处可选：① 用你自己配置的 API Key 查询 DeepSeek 官方余额接口； ② 获取公开的 USD→CNY 汇率；③ 一键同步官方价格时抓取 DeepSeek 官网价格页； ④ 仅当价格页规则解析失败时，把该页内容发给 DeepSeek 官方接口（用你的全局 Key）提取。 除此之外没有任何数据离开你的机器。
• 源码 MIT 协议，GitHub 上完全可查。