余额峰谷潮汐 huanyuLv/dsh-balance-tide

dsh-balance-tide

dsh-plugin
license
version

DeepSeek Harness（DSH）Web 插件：余额 + 峰谷计价潮汐提示。

在输入框下方显示一行实时读数：

[现行价] 峰谷计价 2天5时 后生效 | 余额 ¥28.78 | 本会话约 ¥0.42 | ?

8 月 17 日峰谷定价生效后，徽章与倒计时随北京时间实时切换：

[谷价] 距高峰 2时15分 | 余额 ¥28.78 | 本会话约 ¥0.42 | ? ← 空闲时段 [峰价] 距低谷 1时30分 | 余额 ¥28.78 | 本会话约 ¥0.42 | ? ← 高峰时段

功能

- 峰谷徽章：现行价（2026-08-17 前）/ 峰价 / 谷价，按北京时间实时判定
- 倒计时：距下一次档位切换的剩余时间，每秒刷新，提前规划使用时间
- 余额：官方 /user/balance 实时余额（赠送/充值拆分）
- 本会话消耗：按当前时段单价估算（复用 sessionProjections 折叠，同 turn/step 样本替换不重复计数）
- 悬停明细：当前价与切换后价格的完整单价表、峰谷差距（高峰 = 低谷 × 2）、高峰窗口与使用建议
- ? 图标：直达官方定价页
- 零配置：复用 DSH credentials 中的 DEEPSEEK_API_KEY，无需再填密钥，代码仓库中不含任何密钥
- 双语界面：中文 / English 跟随界面语言

峰谷计价规则（北京时间）

依据官方定价页（2026-08 版，最后核对于 2026-08-15）：

- 2026-08-17 00:00 起采用峰谷定价；此前为现行统一价
- 高峰时段：09:00–12:00、14:00–18:00；其余为低谷（空闲）时段
- 低谷价 = 高峰价的一半

| 模型（每 1M token） | 现行价（命中/未命中/输出） | 低谷价 | 高峰价 |
| deepseek-v4-flash | 0.02 / 1 / 2 | 0.05 / 1.5 / 4.5 | 0.10 / 3.0 / 9.0 |
| deepseek-v4-pro | 0.025 / 3 / 6 | 0.15 / 4.5 / 13.5 | 0.30 / 9.0 / 27.0 |

安装

方式一：npm（推荐）

dsh plugin --profile web add dsh-balance-tide

方式二：Git 地址

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 生效。需要 pnpm（npm i -g pnpm）。

配置（写入 $DSH_HOME/profiles/web/cordis.patch.yml）

- id: dsh-balance-tide
config:
refreshIntervalMs: 300000 # 服务器拉取余额频率 clientPollIntervalMs: 30000 # 浏览器轮询频率 currency: CNY
allowedHosts: [] # 经域名反代访问时，在此登记该域名

官方调价或调整时段时，无需等插件发版，直接覆盖对应配置即可：

- id: dsh-balance-tide
config:
tideCutoff: '2026-08-17T00:00:00+08:00' # 峰谷定价生效时刻 peakWindows: # 高峰时段（北京时间整点，左闭右开）
- { start: 9, end: 12 }
- { start: 14, end: 18 }
tidePrices: # 各档位单价（每 1M token） flat:
deepseek-v4-flash: { cacheHit: 0.02, cacheMiss: 1, output: 2 }
peak:
deepseek-v4-flash: { cacheHit: 0.1, cacheMiss: 3, output: 9 }
offpeak:
deepseek-v4-flash: { cacheHit: 0.05, cacheMiss: 1.5, output: 4.5 }

peakWindows: [] 表示不存在高峰时段（官方日后取消峰谷定价时可这样配）。

安全

- 密钥：优先走 DSH credentials 的 DEEPSEEK_API_KEY。配置项 apiKey 仅作应急，它会以明文落在配置文件里，不建议填写。baseUrl 必须是 https，明文 http 会被拒绝（否则密钥会暴露在链路上）。
- 余额端点：/query-tide 会返回账户余额，因此对读取方做了校验——Host 必须是 localhost、IP 字面量或 allowedHosts 中登记的域名（阻断 DNS rebinding）；带 Origin 的请求必须同源（阻断任意网页读取你的余额）。被拒时返回 403。
- 错误信息：服务端只向浏览器下发有限的错误码，原始异常文本仅写入日志，避免自定义 baseUrl 的完整地址回流到前端。

已知限制

- 花费为估算值，按当前时段单价折算，实际扣费以官方账单为准。
- 多币种账户的主行只显示第一种货币，其余在悬停明细中列出。
- deepseek-chat / deepseek-reasoner 已不在官方定价页公示，prices 中的静态价仅作回退。

开发

npm install
npm test

兼容性

- DeepSeek Harness 0.1.0-rc.6+（web profile）
- Node.js 20 / 22 / 24（CI 覆盖）
- 跨平台：纯 JavaScript + 标准浏览器 CSS，无原生模块（macOS 已验证；Windows/Linux 设计兼容）
- 许可证：MIT