DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在使用 API 进行开发或调试时，开发者需要实时掌握账户余额、当前会话的花费以及不同模型的价格差异。dsh-usage-monitor 插件将 DeepSeek API 的官方定价、会话用量花费、累计花费和账户余额集成到了 DSH 界面中。
功能¶
本插件提供以下能力：
- 账户余额：显示总余额、充值余额和赠金，支持手动刷新。
- 本会话花费：按模型和时段增量计价，切换模型时数字不会跳变；若账本尚未记录该会话，则退回本地估算并标注「估算」。
- 模型明细：按模型分桶记录 token 与金额，分别展示 Flash 与 V4-Pro 的详情。
- 累计花费：本地账本记录跨会话用量，采用增量计价，跨高峰/空闲时段也能准确累计；不打开面板也会持续记录。
- 自动定价：内置官方定价，自动区分高峰与空闲时段。
- 双入口：在对话主视图新增「用量」Tab 展示完整面板，在输入框上方 dock 条常驻显示余额、本会话花费、当前模型单价和计价时段。
安装¶
安装前请确保已安装 DSH，并使用 web profile。运行以下命令安装：
dsh plugin --profile web add github:liyiersan/dsh-usage-monitor
也可以从本地目录安装：
dsh plugin --profile web add /path/to/dsh-usage-monitor
安装后，重启 DSH：
dsh web
使用¶
在打开的 Web 界面中，通过环境变量 DEEPSEEK_API_KEY 或配置文件 ~/.dsh/.credentials.yaml 设置 API Key。配置完成后，在对话主视图顶部即可看到「用量」Tab，或在输入框上方看到用量 dock 条。
定价与计费¶
插件内置官方定价，自动区分高峰与空闲时段。高峰时段为北京时间周一至周五 09:00-12:00、14:00-18:00，空闲时段价格为高峰的一半。计费单位为元 / 百万 tokens。
| 模型 | 时段 | 缓存命中 | 缓存未命中 | 输出 |
|---|---|---|---|---|
| DeepSeek-V4.1-Flash | 空闲 | 0.02 | 1 | 4 |
| DeepSeek-V4.1-Flash | 高峰 | 0.04 | 2 | 8 |
| DeepSeek-V4-Pro | 空闲 | 0.15 | 4.5 | 13.5 |
| DeepSeek-V4-Pro | 高峰 | 0.3 | 9 | 27 |
计费规则：
* cacheRead（缓存命中输入）按缓存命中单价；
* uncachedInput（缓存未命中输入）按未命中单价；
* output 按输出单价；
* cacheWrite（写入缓存）按未命中单价保守计算；
* 无法识别的模型名按 Flash 兜底并在界面标注。
金额由本地账本按增量计价得出，与官方账单口径一致。
隐私与安全¶
- 不收集数据：插件不收集、不上传遥测数据。
- Key 安全：不保存 API key；key 仅由 DSH credentials 服务或进程环境变量提供。
- 余额查询：仅发生在宿主侧，目标为
api.deepseek.com。 - 本地账本：保存在
$DSH_HOME/usage-monitor/ledger，只记录会话 ID、token 用量及按模型分桶的金额，不会提交到仓库。 - 建议：不要将本地账本或凭据文件提交到 Git。
兼容性与维护¶
- 兼容 DSH
0.1.5-rc.1(web profile) 和0.1.1-rc.2。 - 价格调整需同时修改
lib/pricing.js和lib/client.js。
结语¶
该插件适合需要在调试过程中实时监控成本的开发者。更多细节可参考其 GitHub 仓库。
