前言¶
在 DSH 中使用 DeepSeek 时，账户余额、价格档位和本会话花费通常分散在外部页面或日志里。峰谷计价生效后，同一模型的成本会随北京时间变化，开发者需要在调用前判断当前是否处于 peak 或 off-peak。下面介绍 dsh-balance-tide，它把账户余额、峰谷计价潮汐提示和本会话估算花费放进 DSH Web 插件中。
这是什么¶
dsh-balance-tide 是由 huanyuLv 维护的 DSH Web 插件，定位为：DeepSeek Harness (DSH) Web plugin: account balance + peak/off-peak pricing tide indicator。
它主要解决三件事：
- 查看当前账户余额。
- 判断当前价格档位以及距离下一次峰谷切换的时间。
- 按当前计价周期估算本会话花费。
当前版本为 0.4.0，许可证为 MIT。
核心功能¶
- 显示
standard/peak/off-peak价格档位徽章，按北京时间实时判断。 - 显示距下一次峰谷切换的倒计时，并每秒刷新。
- 从官方
/user/balance端点读取账户余额，区分granted与topped-up。 - 按当前计价周期估算本会话花费，复用
sessionProjections；同一turn/step样本替换而非重复计算。 - 悬停时显示当前与下一周期完整价格表、峰谷价差（
peak = off-peak × 2）、峰谷时间窗和使用建议。 - 提供
?图标，打开官方定价页。 - 零配置场景下复用 DSH 凭证中的
DEEPSEEK_API_KEY，仓库中不存放密钥。 - 支持中文 / English 界面语言。
峰谷计价规则¶
根据已核实信息：
- 峰谷计价自
2026-08-17 00:00生效；之前为当前平价。 - 北京时间
09:00–12:00与14:00–18:00为peak。 - 其余时间为
off-peak。 off-peak为peak的一半。
安装与启用¶
安装前需要 pnpm 环境。下面按 npm、Git URL、本地目录三种方式安装。
npm：
dsh plugin --profile web add dsh-balance-tide
Git URL：
dsh plugin --profile web add https://github.com/huanyuLv/dsh-balance-tide
本地目录：
dsh plugin --profile web add file:/path/to/dsh-balance-tide
安装后重启 dsh web 生效。
配置¶
插件配置放在：
$DSH_HOME/profiles/web/cordis.patch.yml
可配置项包括：
refreshIntervalMs
clientPollIntervalMs
currency
allowedHosts
如果官方价格或日程变化，也可以用配置覆盖：
tideCutoff
peakWindows
tidePrices
安全与限制¶
安全方面：
- 优先使用 DSH 凭证中的
DEEPSEEK_API_KEY。 apiKey配置项仅为逃生通道，避免明文写入配置。baseUrl必须为https，明文http会被拒绝。/query-tide会检查读取方：Host必须为localhost、IP 字面量或allowedHosts中注册的域名。- 携带
Origin的请求必须同源。 - 被拒绝的读取返回
403。 - 服务器仅向浏览器发送少量错误码，原始异常文本进入日志，自定义
baseUrl不泄露到前端。
限制方面：
- 成本为按当前计价周期估算，官方账单为准。
- 多币种账户的读出行只显示第一个币种，其余币种显示在
tooltip中。 deepseek-chat/deepseek-reasoner未再列于官方定价页，静态价格仅为fallback，不是已验证报价。
适用场景与注意¶
适合：
- 使用 DSH web profile 的开发者。
- 需要在 Web 界面中查看余额、峰谷计价和本会话估算花费的场景。
- Node.js
20/22/24环境。
兼容：
- DeepSeek Harness
0.1.0-rc.6+（web profile）。 - 纯 JavaScript + 标准浏览器 CSS，无原生模块。
注意：插件以当前 dsh 进程权限运行。安装前建议检查源码与许可证；本项目许可证为 MIT。
结尾¶
dsh-balance-tide 提供账户余额、峰谷计价潮汐提示和本会话花费估算，适合放在 DSH Web 日常使用。项目地址：https://github.com/huanyuLv/dsh-balance-tide
