峰谷价标 adesbusy/dsh-peak-indicator

dsh-peak-indicator

给 Harness Web GUI 用的 DeepSeek 高峰 / 低谷徽标，以及悬停时打开的对话框。

… 🐟 ⊙ DeepSeek Harness ← 圆点位于品牌标记和文字标记之间
amber = peak · green = off-peak

悬停圆点——或者用键盘聚焦它——会打开一张卡片，显示当前生效的资费、下一次切换的本地时间、UTC 时间和倒计时（「בעוד שעתיים ו־30 דקות」），以及长期有效的每周规则。

它采用的时段表

直接来自 DeepSeek 定价页：UTC 周一至周五 01:00–04:00 和 06:00–10:00，中国法定节假日除外。其余所有时段都是低谷，包括周末和中国法定节假日全程。

有两个后果值得了解，因为它们常让人意外：

- 时段以 UTC 表述，不是机器的本地时间。在以色列（夏季 UTC+3），对应本地时间 04:00–07:00 和 09:00–13:00。
- 高峰定价只在工作日生效，所以周六早上即使落在公布的时段内，也是低谷。

对话框会把下一次切换打印两遍——一遍用查看者的本地时区，一遍用 UTC——这样可以直接拿结果对照公布的时段。

与独立实现交叉核对

test/library-crosscheck.test.mjs 转写了 deepseek-peak-hours-warning v0.2.0（MIT）的规则，那是一个独立项目，按 DeepSeek 的高峰和低谷费率给 pi 会话计费，然后逐分钟比较两套实现：

| 范围 | 分钟数 | 结果 |
| 2027 全年 | 525,600 | 零分歧——时段、工作日规则和周末全部一致 |
| 2026-10-07 → 2027-01-01 | 123,840 | 唯一 420 分钟的分歧都落在中国法定节假日之内 |

最后一行是刻意保留的差异：那个库不对中国法定节假日建模，所以在节假日周里，它按高峰计费，而本插件按低谷计费。DeepSeek 公布的规则排除节假日，所以本插件遵循定价页，并且断言这个差异恰好只留在那里——其他任何地方出现分歧都会让测试套件失败。

从那个库还得到两条发现，现在记录在 client.js 里，而不是留作隐含：

- 周末规则从北京时间 2026-08-23 00:00 开始（UTC 2026-08-22 16:00）。WEEKEND_RULE_START_UTC 保存了这个时刻，那个库也公布了它。
- 周末在两个坐标轴上是同一组时刻。 本插件按 UTC 日判断，那个库按北京日判断；UTC 日进入周六时，北京正好进入自己的周六八小时，所以两者处处一致——2027 全年扫描证明了这一点。

那个库的费率没有采纳：它仍按 2026-08-31 的数字给 deepseek-v4-flash 和 deepseek-v4-pro 定价（Flash 高峰 $0.44/$1.32），而定价页现在列出 deepseek-flash 为 $0.30/$1.20。本插件显示状态，不显示价格，所以只取了时间规则。

它如何就位，以及为什么不用插槽

徽章插入的位置是字标 flex 容器的第一个子节点（.brandName，也就是 ui-sidebar 在 sidebar.brand.name 插槽输出外面渲染的那个 span），这样它就落在字标左侧，间距沿用这一行自己的 6px。徽章自身再加 2px 外边距，所以视觉间距是 8px——和侧边栏在品牌标记与字标之间用的间距一致。

它不是插槽注册，这是约束，不是偏好。sidebar.brand.name 是 single 插槽：一个格子，一个占用者。请求的优先级已被占用时，SlotCore.register 会抛出 single slot "…" already has a registration …，而 dsh-client-ui-brand-official 已经占着默认优先级 0。换一个优先级注册也不会多出一个兄弟节点——entriesOfSlot 每个格子只保留一个胜出者，所以更高优先级只会遮住字标，而不是坐在它旁边。品牌行里没有可叠加的兄弟席位。

这个席位位于 React 掌管的标记内部，所以一次重新渲染就可能把它移除。MutationObserver 会把它重新插回去，以 data-dsh-peak-indicator 属性为键，因此每轮处理都是幂等的，掉落的徽章能自愈；整行被替换时，徽章会被拆除，再安放到新行上。这里不需要 React——手写 DOM 不会和 React 版本冲突。

对话框不会闪烁

卡片元素只构建一次并复用，每次 tick 只重写它的 textContent。如果改成重建——为了换一句话就替换节点——它的入场动画会每秒重放一次，指针停在 12px 圆点上时看起来就是在频闪。关闭同样由 CLOSE_DELAY_MS（160ms）防抖，所以光标划过圆点边缘不会反复移除再插入卡片。test/dom-seat.test.mjs 对这两点都有断言：节点经历三次 tick 仍未被替换，以及离开后再次进入复用同一个节点。

安装

这个包是一个 bundle：dsh.bundle.patch 指向 cordis.patch.yml，由它插入自己那一行 Loader，dsh plugin add 能对它生效正是靠这个。

from GitHub
dsh plugin add github:adesbusy/dsh-peak-indicator

or from a local checkout
dsh plugin add "C:\path\to\dsh-peak-indicator"

插件管理器通过它的 install_bundle 动作完成同样的安装，DSH 插件市场也把它列出来供一键安装。无论哪种方式，配置档的 package.json 和补丁层都由该命令写入，绝不手写。

首次安装这个 bundle 后需要刷新页面：已打开页面的模块图在启动时就已组合完成，这个环境的页面不会自己拾取新入口。

文件

| 文件 | 作用 |
| index.js | 宿主侧。刻意留空：这里不需要宿主，也没有宿主↔客户端 RPC。 |
| client.js | 整个功能——座位、徽章、对话框和日程表。由客户端模块注册表提供给浏览器。 |
| cordis.patch.yml | 插入单独一行 Loader，用来挂载宿主端。客户端不需要任何行。 |
| test/schedule.test.mjs | 资费规则的边界测试。 |
| test/format-delay.test.mjs | 倒计时的希伯来语措辞，包括双数和最后一分钟。 |
| test/library-crosscheck.test.mjs | 与 deepseek-peak-hours-warning v0.2.0 逐分钟对比。 |
| test/dom-seat.test.mjs | 座位、修复和拆除的契约，基于专门构建的假 DOM。 |
| test/dom-harness.mjs | 那个假 DOM，加上加载器，在作用域内用桩评估 client.js。 |
| locale/.json | 插件管理器卡片文本。 |

每个测试套件都直接读取 client.js——日程和措辞套件从 bundle 中切出标记为 // >>> schedule 和 // >>> delay 的区域，座位套件则针对测试框架评估整个文件——所以它们都不会偏离实际发布的内容。

npm test

维护节假日列表

client.js 中的 CN_HOLIDAYS 保存中国法定节假日，以中国日期（UTC+8）为键，针对 2026 年——范围见国办发明电〔2025〕7号。2027 年的通知预计在 2026 年 11 月发布。在加入其范围之前，徽章对 2027 年回退到工作日规则，这意味着它会在 2027 年节假日周声称高峰定价，而不是在工作周声称非高峰定价——这是两种错误中较安全的一种。

添加节假日意味着扩展列表并向 test/schedule.test.mjs 添加边界用例，这样下次编辑就有东西可以失败。

验证

- node --check client.js 和 node --check index.js——两端都能解析。
- npm test——四个套件：18 条资费边界断言（每个窗口的两端、周末、国庆和春节范围、不是*窗口边缘的节假日边界 UTC 午夜，以及没有节假日表的年份）；21 条倒计时措辞，加上保证数字 1 永远不会与复数名词相邻；座位契约（第一个子元素位置、悬停/焦点对话框、不重建卡片的实时倒计时、防抖关闭、点击遏制、重新渲染后修复、幂等传递、替换行后修复，以及完全拆除）；以及与独立库对比的 649,440 分钟。
- bundle 补丁用加载器使用的同一个 js-yaml 解析，行 id/名称对照清单检查。
- 这里没有验证的：渲染后的像素。此环境中没有可用的浏览器控制，所以放置、颜色和卡片外观由源代码、假 DOM 契约和发布的侧边栏标记确定——而不是截图。