峰谷计费提醒 PuluWang/dsh-peak-hours

dsh-peak-hours · 高峰时段计费提醒

一个纯前端小插件，给 DeepSeek Harness（DSH）Web 客户端用：工作日高峰时段提醒你「花费 ×2」，并倒数距离空闲时段还有多久。

非官方项目。 与 DeepSeek 无隶属或背书关系，只是使用 DSH 公开的插件协议。价格与时段以官方页面为准。

状态

- 代码只使用浏览器 API（window / document / localStorage / Date），无原生依赖、无文件路径，Windows / macOS / Linux 共用同一份 client.js。
- Windows 桌面版已实测：装进 desktop 配置档后重启客户端，右下角正常出现提醒浮层，宿主能把它加载进浏览器名册。
- macOS 尚未实测，代码里没有任何平台相关调用，预期一致；有 Mac 环境的话欢迎反馈。
- 时段判定、周末/节假日、倒计时、拖动定位经过两轮静态复查，尚未补充自动化测试。
- 面向 DSH 现有客户端组合协议（dsh.client + window.__ModuleLoader__ + cordis.patch.yml），未做跨大版本兼容。

计费口径

依据 DeepSeek 官方 模型 & 价格：

空闲时段价格为高峰时段价格的一半。北京时间周一至周五（不含中国法定节假日）9:00–12:00、14:00–18:00 为高峰时段；其余时段，包括周末及中国法定节假日全天均为空闲时段。

以 deepseek-flash 为例（元 / 百万 tokens）：

| | 空闲 | 高峰 |
| 输入（缓存命中） | 0.02 | 0.04 |
| 输入（缓存未命中） | 1 | 2 |
| 输出 | 4 | 8 |

所以「高峰 = 花费 ×2」成立，但高峰不是全天：

- 高峰：周一至周五 09:00–12:00、14:00–18:00（北京时间），法定节假日除外
- 空闲（5 折）：工作日其余时间 + 周末全天 + 法定节假日全天

如果你走的是第三方中转、代理或别的计费体系，这个提醒就不适用。

效果

高峰时段（默认展开，橙色）：

● 高峰时段 · 花费 ×2 – 现在是工作日高峰（北京时间 09:00–12:00、14:00–18:00）， token 花费是空闲时段的 2 倍。
距空闲（5 折）还有 45 分钟高峰 周一至周五 09:00–12:00、14:00–18:00 空闲 其余时段 · 周末与法定节假日全天本时段不再提示

点右上角 – 最小化：卡片以右下角为原点缩小淡出，收成一颗胶囊 ● 花费 ×2。胶囊上点文字展开，点边框是拖动，两种操作不会互相误伤。

倒计时下方有一个勾选项 「启用提醒（随客户端打开）」（默认勾选）。取消勾选 = 彻底关掉提醒：卡片和胶囊都消失，客户端重启后也不会再出现。想重新打开，按 Alt + Shift + P（插件一直在后台监听这个快捷键），或者在浏览器里清掉 dsh_peak_hours_auto_open 这个 cookie。

位置随你拖：按住胶囊边框或卡片标题栏（cursor: grab）拖到任意位置，松手即记住，下次打开还在原地；双击标题栏（收起时先用文字点开）恢复默认的右下角。展开/收起时浮层以右下角为锚点，不会因为变宽而跑出屏幕；窗口缩小也会自动夹回可视区。

| 操作 | 行为 |
| – | 最小化，显示「花费 ×2」胶囊 |
| 点胶囊文字 | 展开卡片 |
| 勾选「启用提醒」 | 显示提醒，并在启动、时段切换时自动展开 |
| 取消勾选 | 彻底隐藏（无卡片、无胶囊），重启后也不出现 |
| Alt + Shift + P | 重新打开被取消勾选的提醒 |
| 拖动胶囊边框 / 标题栏 | 移动位置，松手保存（拖到窗口外松手也不会卡住） |
| 双击标题栏 | 位置复位到右下角 |
| 本时段不再提示 | 本轮高峰内完全隐藏，进入空闲后自动恢复 |
| 存储 | Cookie dsh_peak_hours_dismissed / _pos / _auto_open（主），localStorage 同键（回退） |

动画在 prefers-reduced-motion: reduce 下自动关闭。

目录结构

dsh-peak-hours/
├── package.json # dsh.bundle + dsh.client 声明，exports["./client"] ├── cordis.patch.yml # 往组合树插一行，name 必须等于包名 ├── index.js # host 半侧：空实现，只为让包被扫描到 ├── client.js # 浏览器半侧：__ModuleLoader__ 懒工厂 + 原生 DOM 浮层 ├── install-windows.ps1 # 一键安装 / 卸载（Windows） ├── install-macos.sh # 一键安装 / 卸载（macOS / Linux） ├── LICENSE └── README.md

安装

方式一：官方 CLI（推荐）

dsh plugin --profile <profile> add <插件目录>

<profile> 一般是 desktop 或 web，<插件目录> 是本仓库克隆下来的路径。装完重启客户端——包清单、exports、client 名册都在进程内缓存。

方式二：一键脚本

Windows（PowerShell 5.1+ / 7+）：

powershell -ExecutionPolicy Bypass -File .\install-windows.ps1 -Profile desktop

macOS / Linux：

PROFILE=desktop bash ./install-macos.sh

脚本做两件事，幂等、可逆：

1. 把本目录复制到 ~/.dsh/profiles/<profile>/node_modules/dsh-peak-hours；
2. 在该配置档的 cordis.patch.yml 末尾追加一段 insert 行，带 # >>> dsh-peak-hours >>> 标记。

不会动配置档里的其他配置。介意脚本改配置的话，手动做这两步效果相同。

验证

1. 右下角出现卡片或胶囊；
2. DevTools Console 里 document.getElementById('dsh-peak-hours-root') 返回节点；
3. 在客户端地址后拼 /plugins/dsh-peak-hours/client.js（本机默认形如 http://127.0.0.1:4722/plugins/dsh-peak-hours/client.js）能返回源码。

卸载

powershell -ExecutionPolicy Bypass -File .\install-windows.ps1 -Profile desktop -Uninstall

PROFILE=desktop bash ./install-macos.sh --uninstall

或手动删掉 node_modules/dsh-peak-hours，再删掉 cordis.patch.yml 里那段标记块，重启。

配置

改 client.js 顶部 CONFIG：

| 字段 | 默认 | 说明 |
| peakWindows | [{540,720},{840,1080}] | 高峰窗口，北京时间分钟数 |
| peakMultiplier | 2 | 高峰倍数，用于「花费 ×2」 |
| offPeakDiscount | '5 折' | 空闲折扣文案 |
| holidayRanges | 2026 全年 | 法定节假日区间（含首尾），全天算空闲 |
| tickMs | 10000 | 刷新间隔 |
| margin | 8 | 拖动/吸附时与视口边缘的最小距离（px） |

节假日需要每年维护

holidayRanges 目前只覆盖 2026 年（依据国务院办公厅《关于2026年部分节假日安排的通知》，国办发明电〔2025〕7号）。国务院一般在每年 11 月发布次年安排，届时在数组里按 ['2027-01-01','2027-01-03'] 的格式追加即可；没追加的年份，节假日会被当成普通工作日（显示为高峰）。

周末的「调休上班日」按官方文字仍属周末，插件按空闲处理。

改名 / Fork 注意

包名出现在三个地方，必须一致，否则宿主编不进浏览器名册：

1. package.json 的 name
2. client.js 里 window.__ModuleLoader__.load({ id: '...' })
3. cordis.patch.yml 里的 name: 和 id:

另外 install-windows.ps1 / install-macos.sh 里的 $PluginName / PLUGIN_NAME 与标记文本也要同步。

隐私

- 不联网、无遥测、不读写会话内容，只读本机时间。
- 持久化只有三条偏好：隐藏截止时间、浮层位置、是否跟随客户端自动打开。以 cookie（dsh_peak_hours_，1 年）为主，localStorage 只做回退——客户端每次启动端口都不同，纯 localStorage 会按 origin 隔离而丢失。
- 浮层是 document.body 下的一个 position: fixed 节点，随插件卸载一起移除。

实现要点

- host 半侧是空插件：dsh-client-modules 只扫描「已启用的 Loader 条目」，所以必须有一行 host row；index.js 只导出 name 与空的 apply。
- client 半侧不用 React、不注册 slot：在 apply(ctx) 里直接建浮层，不依赖任何 UI 包版本，也不会因为 slot 名字变化而崩。
- 判定全按北京时间：真实时刻 +8h 换成「北京墙上时间」再读 getUTC，周末/节假日/时段都按北京日历。
- 下一次切换靠逐分钟扫描（最多 14 天，覆盖春节长假），比手写跨周末分支更不容易错。
- 最小化动画用 CSS transition + transform-origin: 100% 100%，visibility 延迟隐藏避免不可见元素仍可被 Tab 聚焦。
- 拖动定位：位置存的是「浮层右下角」的视口坐标，而不是 left/top，所以展开/收起、窗口缩放都以同一个角为锚点；拖动用 Pointer Events（鼠标、触屏、笔通用）并做指针捕获，超过 4px 才判定为拖动；胶囊内部再分出两个热区——文字展开、边框拖动，靠点击目标与 e.detail 区分（键盘 Enter/Space 的 detail === 0 也算展开）；松手时把右下角夹回视口内再落盘。
- 清理走 ctx.effect(() => cleanup, label)；无 ctx.effect 时退回 beforeunload。

已知边界

- 只在 Web 客户端（含桌面端 Web 视图） 生效；headless/TUI 没有 DOM，会静默不挂载。
- 节假日表是静态数据，不会自动更新。
- 官方若调整价格或时段，改 peakWindows / peakMultiplier / offPeakDiscount 即可，但需要手动跟进。

License

MIT © SHANGHAI PULU NETWORK TECHNOLOGY CORPORATION LIMITED

可免费商用：MIT 允许在闭源商业产品中使用、修改、分发，只需保留版权声明和许可文本。