前言¶
DeepSeek Harness (DSH) 作为一个开放的插件生态，允许用户根据需求扩展功能。在频繁调用大模型进行开发或测试时，实时掌握账户余额以及 DeepSeek 官方的峰谷计费规则（尤其是 2026 年起实施的周末全天低谷规则）非常必要。dsh-valley-meter 专注于解决这一痛点，它不依赖其他插件，直接在 DSH Web 界面的输入框上方提供余额查询与峰谷时间轴可视化。
这是什么¶
dsh-valley-meter 是一个客户端插件，由用户 uckkk 开发。它通过在输入框上方挂载一个余额数字徽章，并在悬停时展示 24 小时峰谷时间轴，帮助开发者直观地监控费用消耗。该插件独立查询官方余额、独立监听实时计费，并维护本地账本。
核心功能¶
余额数字徽章
默认情况下，输入框右上角显示一枚极简的余额数字徽章，仅包含人民币符号「¥」和当前数值。官方余额通过插件独立查询，每 5 秒自动刷新一次。
一键充值
点击徽章中的「¥」符号，会在新页签中打开 DeepSeek 官方充值页面。该入口设计为悬浮于徽章左侧，与徽章左端圆角重合，方便快速充值。
悬停时间轴
当光标悬停在余额徽章上时，左侧会浮现一条 24 小时横向时间轴。时间轴使用峰/谷双色区分时段（峰为橙色，谷为蓝色），顶部刻度包含 00/06/12/18/24。一条白色发光指针指示当前本地时刻。若当天为周末，整条时间轴将显示为谷色。
独立计费
插件完全独立运行，不依赖其他插件。
* 今日消耗：监听 llm/stream 事件捕获每次调用的用量，按内置模型价格表（含峰/谷两档）折算费用，并写入本地账本 ~/.dsh/storages/valley-meter/ledger.json。
* 账户余额：使用 DSH 凭据库或环境变量 DEEPSEEK_API_KEY 查询 DeepSeek 官方 /user/balance 接口。
周末全天低谷规则
根据官方规定，自 2026-08-23 00:00 起，周六、周日全天不再区分峰谷，统一按低谷价计费。插件按北京时间判断周末，当天整条时间轴显示为谷色，计费自动走低谷价。
配色方案
内置 10 套沉稳配色预置（包括 One Dark、Dracula、Nord 等编辑器主题及中国传统色、潘通色），支持通过拾色器自定义峰谷颜色，配置即时生效。
安装与启用¶
使用 npm 安装：
npm install dsh-valley-meter
安装完成后，重启 dsh web 页面即可在输入框上方看到余额数字徽章。
进入 设置 → 峰谷电表 面板，可以进行配色调整、开关余额/花费标题、开启或关闭周末全天低谷规则等配置。
典型用法¶
- 打开 dsh web 页面，输入框上方会出现余额数字徽章。
- 将鼠标悬停在余额徽章上，查看 24 小时峰谷时间轴及当前时刻指针。
- 点击徽章中的「¥」符号，在新页签中打开官方充值页面。
- 观察时间轴颜色判断当前是否处于峰时或谷时，或是否为周末全天低谷。
注意事项¶
- 独立运行：该插件独立计费与查询，不依赖其它插件。
- 网络权限：插件需要网络权限访问
https://api.deepseek.com以查询余额和进行计费。 - API Key 配置：如果未配置 API Key，余额显示为「暂无数据」，但今日消耗仍会正常累计。
- 兼容性：需安装 DeepSeek Harness 版本
>=0.1.0-rc.5。
总结¶
dsh-valley-meter 是一款功能单一但聚焦的工具，它通过数字徽章和悬停时间轴，将复杂的峰谷计费规则和余额查询变得直观。对于需要精细控制使用成本的开发者，这是一个实用的辅助插件。
插件目录与源码：dsh-valley-meter
