峰谷计费提醒 54nanmiao/dsh-peak-reminder

dsh-peak-reminder

DeepSeek Harness (DSH) 插件：DeepSeek 按峰时价格计费时提醒你 —— 峰时段每隔几分钟提醒一次，谷时段完全不打扰。

DSH 峰谷提醒插件：峰时段每隔几分钟在界面顶部提醒一次「现在是峰时」，谷时完全不打扰；侧边栏底部常驻一行显示当前峰/谷状态和下一次切换的倒计时。

- 侧边栏底部一行（sidebar.footer.action）：峰时 · 32 分钟后谷 / 谷时 · 1 分钟后峰；橙点是峰时、绿点是谷时、灰点是关掉了。悬停看完整说明，点一下立刻弹一条当前状态。
- 顶部提醒条：进入峰时先给一条「现在是峰时 —— 高峰计价」，之后每 N 分钟（默认 5）再给一条；进入谷时提示「现在是谷时 —— 空闲计价」；谷时期间不会重复提醒。提醒条带「知道了」和「暂停 30 分钟」。
- 设置页一节（settings.section）：总开关、提醒间隔、峰↔谷切换提醒、侧边栏状态行。
- 无网络请求、无凭据，只写一个配置文件 ~/.dsh/peak-reminder.json。

安装

dsh plugin --profile web add dsh-peak-reminder

已发布到 npm：dsh-peak-reminder。也支持 Git 安装和本地安装 —— github: 是 pnpm 的 git 规格，DSH 的插件管理器会把 git 规格交给 pnpm，由它自己拉取。如果你的构建不支持 git 规格，就克隆仓库，让配置档指向本地检出：

git clone https://github.com/54nanmiao/dsh-peak-reminder
dsh plugin --profile web add /absolute/path/to/dsh-peak-reminder

插件声明了 dsh.bundle 清单（cordis.patch.yml），不带构建步骤，也没有依赖，所以从源码安装不需要构建审批。

安装后重新加载 Web UI。侧边栏那一行出现在底部；设置页那一节在「设置」→ 插件区域。

峰谷规则

只看宿主机时钟的北京时间，判断逻辑在 lib/peak.js：

| 峰时（高峰计价） | 周一至周五，北京时间 09:00–12:00 和 14:00–18:00 |
| 谷时（空闲计价） | 其余全部时间：00:00–09:00、12:00–14:00、18:00–24:00，所有周末，所有中国法定节假日，以及调休上班的周末 |

节假日表（lib/peak.js 里的 HOLIDAY_VALLEY）目前只列了 2026 年，与 2026 年公布的计价规则一致（峰谷计价从 2026-08-17 开始，周末全天谷时从 2026-08-23 开始，节假日全天谷时从 2026-09-19 开始）。

国务院公布下一年放假安排后（通常在 11 月），把这些日期加进 HOLIDAY_VALLEY。在那之前，未来的节假日会按普通工作日处理，结果是多提醒，但绝不会漏提醒。

配置

设置页会写 ~/.dsh/peak-reminder.json；你也可以手动改这个文件（不用重启，宿主机每次请求都会重新读取）：

{
"enabled": true,
"intervalMinutes": 5,
"notifyOnSwitch": true,
"showSidebar": true
}

| 键 | 默认值 | 含义 |
| enabled | true | 总开关；关掉后不再提醒，侧边栏那一行显示「提醒已关」 |
| intervalMinutes | 5 | 峰时期间两次提醒之间的分钟数（限制在 1–120） |
| notifyOnSwitch | true | 每个峰↔谷边界也提醒一次 |
| showSidebar | true | 是否显示侧边栏状态行 |

HTTP 接口

宿主端在 DSH web 服务器上注册两个路由（无鉴权，与其他插件路由一致）：

GET /plugins/dsh-peak-reminder/state -> { ok, now, isPeak, peakWindow, nextChangeAt, dayKind, config, rules }
GET /plugins/dsh-peak-reminder/config -> { ok, config, file }
POST /plugins/dsh-peak-reminder/config -> { ok, config, file } body: any subset of the keys above

now 是宿主的 epoch 秒。客户端据此渲染，并校正本地时钟偏差，所以倒计时跟随真正掌握时间的那台机器。峰谷判定从不在浏览器里重新推导——只由宿主决定，因此节假日表只存在一处。

工作原理

- lib/index.js —— 宿主端：apply(ctx, config) 注入 webServer，注册两个路由，并负责配置加载（defaults < cordis patch config < ~/.dsh/peak-reminder.json）。
- lib/client.js —— 浏览器端：通过 slots.register 注入 sidebar.footer.action 和 settings.section；每 30 秒轮询 /state，倒计时每秒跳一次，用原生 DOM 渲染 toast（不依赖任何 DSH 组件包）。
- lib/peak.js —— 纯函数，无依赖：isPeakTime、nextPeakChangeAt、currentPeakWindow、dayKindLabel、isWeekend、isHolidayValley。

测试

node test/run.mjs

检查 09:00/12:00/14:00/18:00 边界、周末、调休周日、国庆、窗口标签、跨周末的 nextPeakChangeAt，以及状态是否在它报告的每个边界上翻转。

中文说明

为什么要有这个插件。 deepseek 的峰谷定价按北京时间切换：工作日 09:00–12:00、14:00–18:00 是高峰计价，其余时间（含周末、法定节假日、调休）是空闲计价。想知道「现在贵不贵」，通常得自己去查规则或者看余额面板；这个插件把状态放在侧边栏常驻一行，并在峰时按你设的间隔提醒。

规则只写在 lib/peak.js 一处，宿主判定、浏览器只负责显示，所以补节假日年份只需要改那一个数组。

已知边界： 节假日表目前只到 2026 年 12 月 31 日；次年放假安排公布后要手工补，补之前会把未来节假日当普通工作日（多提醒，不会漏提醒）。

安装、配置、接口字段见上面的英文部分，两者是同一份内容的两种语言。

License

MIT