faith1688/dsh-usage-meter-harness

dsh-usage-meter-harness

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——安装器永远不会这样做。

功能一览

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

| 功能 | 说明 |
| --- | --- |
| 实时费用 | 会话累计费用，CNY / USD 可切换，每步实时更新 |
| Token 明细 | 输入(未命中) / 缓存命中 / 缓存写入 / 输出 分桶统计 |
| 本轮用量面板 | 逐轮小计，单价带峰/谷标记 |
| Token 速度 | 模型输出时实时 tokens/s；输出停止或工具执行时自动清零，不冻结旧值 |
| 缓存命中率 | 会话级缓存命中占比 |
| 账户余额 | DeepSeek 官方真实钱包余额；其他厂商按本地账本估算 |
| 预算与剩余 | 设置预算后显示已用 / 剩余 / 超支 |

计费引擎

| 功能 | 说明 |
| --- | --- |
| 6 种计费模板 | 基础 · 缓存命中/未命中 · 峰谷分时（DeepSeek 官方时段）· 缓存写入+命中 · 输入+输出合并 · Batch 半价 |
| 自定义单价项 | 最多 4 行自定义行；弹窗与你配置的内容逐格一致 |
| 峰谷分时计费 | 北京时间星期 + 时段窗口，支持跨零点时段；按每次请求的发起时刻计费 |
| 回合归因精确 | 每轮费用记在真正执行它的模型名下——会话中途切模型不会把未结束或已结束的回合重新打标；回合币种在本轮首个计费用量到达时定标，美元定价的回合换算正确 |
| 每模型独立计价 | 每个模型可单独设置币种（CNY/USD）、单价与余额 |
| 共享余额钱包 | 一个供应商下所有模型共用一个钱包，一个复选框开关 |
| 官方价预填 | DeepSeek 官方模型自动预填官方价与官方峰谷时段 |
| 内置价格表 | 内置 19 家厂商 137 个模型价格；可选 LiteLLM 形状的远端价格源 |
| 汇率自动刷新 | USD→CNY 自动获取，超过 24 小时自动更新 |
| 一键同步官方价格 | 设置页一键抓取 DeepSeek 官网价格页，解析最新价格与峰谷时段并写入覆盖（需先填全局 API Key），随时保持官方价最新 |
| 旧数据迁移 | 旧版手动初始余额/充值记录自动迁移为厂商钱包，余额不丢失 |

设置与体验

| 功能 | 说明 |
| --- | --- |
| 中英双语界面 | 设置页右上角语言切换：跟随系统 / 中文 / English，设置页与弹窗全部即时生效，选择自动记住。只影响显示，绝不改动你保存的数据 |
| 主题 | 20 个内置主题（浅色系在前、深色系在后，默认 forest-beach-dawn）+ 每个主题可自定义胶囊颜色与呼吸颜色——用量弹窗顶部快速切换，设置页完整配色，选择保存在本机 |
| 使用中锁定 | 模型正在生成时锁定其编辑器，保证进行中的轮次价格一致 |
| 弹窗所见即所得 | 用量卡的行名与格子完全抄自你选择的模板 |
| 无侵入 | 标准 DSH cordis 插件；不改动其他插件，不动 DSH 核心文件 |
| 峰谷胶囊 | 谷价时胶囊变浅绿、峰价时变浅红（计费中带柔和呼吸光晕），一眼看清当前是峰价还是谷价 |
| 未保存/已保存 | 模型卡编辑后显示「未保存」，点保存后显示「已保存」——不再有含糊的「保存中」 |
| 当前会话看板 | 弹窗默认直接展开「当前会话」视图（总计 + 分项金额 + 每轮费用）；坐标标签用 provider · model，同名官方/自定义模型一眼可分 |
| DS API Key 守卫 | 非官方模型勾选「DS API Key」时提示该选项仅 DeepSeek 模型使用；自定义模型绝不回落官方全局 key，未设置显示「未配置」 |

支持的模型

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

截图

设置页：

设置页

用量弹窗：

用量弹窗

配置

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

| 键 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| currency | string | CNY | 显示币种 |
| budget | number | – | 会话预算；设置后显示「剩余」 |
| priceSourceUrl | string | – | LiteLLM 形状的价格 JSON 地址；可选 |
| refreshIntervalMs | number | 4h | 价格 / 余额 / 汇率刷新周期 |
| deepseekApiKey | secret | – | 仅用于查询 DeepSeek 余额（AES 加密存储；不读取环境变量 DEEPSEEK_API_KEY） |

兼容性

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

License

MIT © faith1688

隐私

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