前言¶
在 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 检索。
