前言¶

在 DeepSeek Harness（dsh）的网页端使用 DeepSeek API 时，常见问题不是“有没有 token 统计”，而是统计之后还缺几步：当前会话大概花了多少钱、余额还剩多少、今天是否接近预算、哪个模型花得最多、官方账单里的真实扣费能不能对上。

下面介绍一个针对 dsh web 的社区插件：fancr-code/dsh-plugin-usage-meter。它把用量、费用、余额、预算提醒和官方账单放到输入框下方的按钮式用量条里，适合长期在 Harness 中跑 DeepSeek 任务的开发者使用。

这是什么¶

dsh-plugin-usage-meter 是一个 MIT 许可的纯 Web 插件，由社区维护，通过 dsh 的官方 profile 机制挂载，不修改 dsh 源码，卸载后还原。

已核实资料描述其体积约 0.6MB，无 Electron、无独立进程、无遥测、无第三方运行时依赖。它不是独立应用，而是嵌入 dsh web 的前端插件。

核心功能¶

插件在输入框下方提供按钮式用量条，点击后展开面板。已核实的主要能力如下：

• 实时显示当前会话 token 用量，并按官方刊例价估算费用；配置 API Key 后显示账户余额。
• 显示当日和近 7 天按模型堆叠的柱状图，以及模型费用分布。
• 支持峰谷计价，支持 CNY/USD 双币种官方报价，不做汇率换算。
• 可选接入官方账单，读取 platform.deepseek.com 的按日账单，显示官方真实扣费。
• 历史费用按刊例价生效区间计价，支持官方调价自动识别。
• 预算提醒：每日预算进度，达到 80% 以上显示黄色，超支显示红色。
• 上下文压力三档预警：30%、50%、85%，并支持一键 /compact。
• 显示消耗段位，并生成梁祖分享卡片，可通过 canvas 导出 PNG。
• 面板内检查更新和一键更新。
• 跨会话账本本地持久化。

安装与启用¶

先确认本地已安装 DeepSeek Harness，并且 dsh web 能正常启动。插件的环境要求为 node >=22，peerDependencies 要求 react ^18.2.0。

从 npm 安装：

dsh plugin --profile web add dsh-plugin-usage-meter

安装后重启 dsh web 并刷新页面。输入框下方出现按钮式用量条，即表示生效。

也可以从 GitHub 安装：

dsh plugin --profile web add github:fancr-code/dsh-plugin-usage-meter

或者克隆后本地安装：

git clone https://github.com/fancr-code/dsh-plugin-usage-meter.git
dsh plugin --profile web add ./dsh-plugin-usage-meter

插件自带 dsh.bundle.patch，dsh plugin 会自动把它注册进 profile 的 bundle 层，无需手动编辑 cordis.patch.yml。

验证挂载状态：

dsh --profile web --dump-config

确认输出中存在 usage-meter 层即可。

卸载：

dsh plugin --profile web remove dsh-plugin-usage-meter

然后重启 dsh web。

典型用法¶

基本显示¶

不配置额外信息时，插件也能提供除余额外的主要功能：会话 token 用量、刊例价费用估算、当日和近 7 天柱状图、预算提醒、上下文压力预警、检查更新等。

余额查询需要 DeepSeek API Key，通常是在 Web「模型」页写入的 DEEPSEEK_API_KEY。

配置文件¶

编辑 $DSH_HOME/settings.yaml 的 usage-meter 节。已核实资料中给出的可配置项包括 currency、budget、pricing，可写成类似形式：

usage-meter:
  currency: USD
  budget: 50
  # pricing: 可覆盖某模型单价

字段含义如下：

• currency：计费币种，可为 CNY 或 USD。
• budget：每日预算金额；设为 0 或省略表示关闭预算提醒。
• pricing：用于覆盖某模型单价。

价格优先级为：settings.yaml 覆盖 > 官方生效区间/实时 > 内置快照；内置 2026-08-17 快照兜底。

官方账单¶

官方账单为可选功能。接入后，面板可以显示 platform.deepseek.com 的按日账单和官方真实扣费。

方式一：从本机浏览器自动导入 userToken。需要本机浏览器保持登录 platform.deepseek.com。可用环境变量禁用自动导入：

USAGE_METER_AUTO_PLATFORM_TOKEN=0

方式二：将 DEEPSEEK_PLATFORM_TOKEN 写入 $DSH_HOME/.credentials.yaml：

DEEPSEEK_PLATFORM_TOKEN: <userToken>

如果平台 token 过期，且平台返回 40002 或 40003，插件会退回刊例价估算，并冷却 30 分钟后自动重试或重扫。

峰谷与历史计价¶

官方高峰规则为：UTC 01:00–04:00、06:00–10:00，即北京时间 09:00–12:00、14:00–18:00，且仅周一至周五。高峰价格为空闲价格的 2 倍。

历史费用按刊例价生效区间计价。插件会识别官方调价，调价前后的用量分别按当时生效的刊例价估算。

适用场景与注意¶

这个插件适合以下场景：在 dsh web 中持续使用 DeepSeek API，需要实时查看会话费用、账户余额、每日预算、模型费用分布，并愿意接入官方账单核对真实扣费。

使用前建议确认以下几点：

• 许可证为 MIT，源码可在 GitHub 检查。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 账本位置为 $DSH_HOME/usage-meter/ledger.json，只存 token 桶、模型名与刊例价生效区间快照，不含对话内容。
• 账本写入使用 2s 防抖和原子写入（临时文件 + rename），并自动清理。
• 不配置 API Key 时，余额查询不可用，其他功能仍可使用。
• 不配置官方账单 token 时，账单功能不可用，插件退回刊例价估算。

本文基于已核实资料；资料中 README 的“已知限制”与“数据与隐私”部分不完整，因此本文不展开这些未完整提供的内容。

结尾¶

dsh-plugin-usage-meter 的价值是把 dsh web 的用量信息从单纯的 token 统计，扩展为费用估算、余额、预算、模型分布、官方账单和上下文压力提醒。它轻量、可卸载、可配置，适合放在日常开发环境中长期观察 DeepSeek API 的消耗情况。

GitHub：https://github.com/fancr-code/dsh-plugin-usage-meter。目录页未给出可核实的 URL；如需从社区目录安装，可按插件名 dsh-plugin-usage-meter 检索。