峰谷计费提示 Shadid516/dsh-off-peak-hours

非高峰时段

CI
npm
license: MIT
topic: dsh-plugin
tests: 98 passing
node: >=22

一个 DeepSeek Harness（dsh） bundle，当 Session 的模型来自一个具有时段价格的 provider 时，会在 composer 下方放置一个环境 pill。这个 pill 一眼就能回答一个问题：下一个 token 是按高峰还是非高峰费率计费？

Off-Peak Hours pill 与自带的 stats pill 并排显示，其面板在它们上方打开

一个周日傍晚的实时 session。周末是非高峰时段，因此面板指出了结束这一状态的变化：周一 01:00 UTC 窗口开启，还有 2 小时 9 分钟。该 pill 位于自带的 stats pill 旁边——就是显示 13% 的那个。

● Off-peak · 50% off · starts in 6h 40m ● Peak · full rate · ends in 1h 12m

倒计时说明了当前状态会持续多久，但没有说明它会导向什么。点击该 pill——就像它旁边的两个 stats pill 一样——会打开一个面板来说明这一点。

安装

已发布到 npm，名称为 dsh-off-peak-hours。在 PATH 中有 dsh 的 shell 中——声明了 dsh.bundle 的包一经安装就会被添加到 profile 的 bundle 层中，因此一条命令即可启用它：

dsh plugin --profile web add dsh-off-peak-hours # from npm
dsh plugin --profile web add github:Shadid516/dsh-off-peak-hours # latest main

在 DSH session 中：

plugin_manager install_bundle dsh-off-peak-hours

从本地检出目录安装时，将 install_bundle 指向绝对目录：

plugin_manager install_bundle /absolute/path/to/dsh-off-peak-hours

该 bundle 是一个客户端装饰，没有配置、没有服务、没有状态，因此之后无需进行任何设置。如果 pill 没有立即出现，请重新加载页面。

它显示什么

| 状态 | Pill |
| 非高峰 | 绿点 · Off-peak · 50% off · starts in … |
| 高峰 | 琥珀色点 · Peak · full rate · ends in … |

点的颜色是唯一能在扫一眼后留下的区别，因此它承载了整个判断；文字则是为了在扫一眼不够用时提供信息。

对于没有任何 plan 声明的 provider，该条目完全不渲染任何内容——没有 pill，也没有占位符。未知 provider 会被隐藏而不是被猜测，因此一个指向这些供应商之一、但计划未声明的名称的自定义路由，在该计划的 matches 被扩展之前不会显示任何内容。

面板

点击胶囊按钮会打开一个面板，其外观与已发布的统计对话框相同：

DeepSeek 非高峰（五折） ────────────────────────────────────────────────────────────── 高峰将在 2 小时 9 分钟后开始，即周一 01:00 UTC 高峰时段 01:00-04:00 和 06:00-10:00 UTC，周一至周五，不含中国法定节假日。
时间 Sun 22:50 UTC · Mon 06:50 UTC+8 节假日日历 2025-2026 供应商 deepseek-official

- 标题用文字重述胶囊按钮的结论。
- 答案行指明即将开始的状态，而不是把“2 小时 9 分钟后开始”留给用户去解读。
- 距离不到一天的变更会标注星期几（Mon 01:00 UTC）；更远的变更会加上日期，因为仅凭星期几已无法确定是哪一天。

当节假日或活动生效时，它会排在详情列表的最前面，位于它所覆盖的时段表之上：

节假日 国庆节 - 全天非高峰活动 全天五折，2026-09-25 至 2026-10-07

它的行为与已发布的面板一致：通过 portal 挂载到 document.body，锚定在触发元素上方并限制在视口内，通过 Escape 或在其自身和触发元素之外的 pointerdown 关闭。胶囊按钮是一个 button，带有 aria-haspopup="dialog" 和 aria-expanded；面板是一个 role="dialog"，以计划作为标签。

计划

每个计划拥有自己的时段表，所选供应商决定使用哪个计划。同一时刻对一个计划可能是高峰，对另一个可能是非高峰，因此胶囊按钮只报告实际生效的计划。

DeepSeek

| 时段 | 费率 |
| 01:00–04:00 和 06:00–10:00 UTC，周一至周五，不含中国法定节假日 | 高峰（全价） |
| 其他所有时刻——剩余小时、整个周末、中国法定节假日全程 | 非高峰（半价） |

即使节假日安排将周末指定为调休补班日，周末仍保持非高峰。中国日历以中国标准时间（UTC+8）判定“节假日”；在高峰时段内，UTC 日期、中国日期和星期几始终一致，因此两者永不冲突。

z.ai（GLM Coding Plan）

| 时段 | 费率 |
| 新加坡时间（UTC+8）14:00–18:00 = 06:00–10:00 UTC，周一至周五 | 高峰（全价） |
| 其他所有时刻，包括周末 | 非高峰（半价） |

该计划没有记录任何节假日排除，因此时段内的工作日即使在法定节假日也是高峰——这与 DeepSeek 不同，后者会让整个节假日时段让位。这种不对称是有意为之，并有测试覆盖。

活动。 从 2026-09-25 到 2026-10-07（UTC+8 日期，含首尾），全天使用按非高峰费率计费。活动生效期间，胶囊按钮会附加一个 campaign 备注，面板会在 Campaign 行中列出其日期。活动结束后，从 promotions 中删除该条目；在此之前它会被应用，而非假定。
pi-ai 目录为此方案提供的两条路由——zai 和 zai-coding-cn——解析为同一时间表。

提供商如何解析

该标签需要先知道当前生效的是哪个方案，才能显示任何内容，而在会话打开时尚未选择任何模型。因此它按顺序读取两个来源：

1. 模型目录，以会话为键。这是权威来源，并覆盖空白会话的情况，因为它解析的是下一轮将要使用的提供商，而不是等待某一轮到来。
2. 会话的投影模型选择，作为目录尚未给出答案时的回退。

当两者都无法给出提供商时——即会话的模型来自任何方案都未描述的地方时的正常状态——该条目不渲染任何内容。

添加方案

一切都位于 client.js 顶部的 PLANS 表中。一个条目就足够了：

{
id: 'example',
labelKey: 'plan.example', // 显示名称（字典键） scheduleKey: 'schedule.example', // 供应商自己的措辞（字典键） source: '...', // 供应商的措辞，紧邻时间窗口保留
peakWindowsUtc: [[9, 12]], // UTC 中的 [startHour, endHour)
usesChinaHolidays: false,
promotions: [], // 可选的带日期的全天非高峰窗口
matches: (provider) => provider === 'example',
}

将匹配的 plan.example 和 schedule.example 字符串添加到 EN 和 ZH 字典中——测试套件会断言这两个字典保持同步。以本地时区表述的时间窗口会按固定偏移转换为 UTC，因为这些方案所用的每个时区都是 UTC+8，且没有夏令时。

布局

| 文件 | 作用 |
| package.json | 打包清单：dsh.bundle.patch、dsh.client 浏览器声明、exports["./client"]，以及插件管理器卡片读取的显示元数据。 |
| cordis.patch.yml | 插入单个 Host 行。 |
| index.js | Host 部分。有意留空——服务端不计算任何内容。 |
| client.js | 整个功能：方案、节假日表、提供商解析、标签、面板。 |
| locale/en.json、locale/zh.json | 插件卡片标题和描述。 |
| icon.svg | 插件卡片图稿。 |
| test/schedule.test.mjs | 针对随附客户端模块的 98 个测试。 |
| scripts/check-manifest.mjs | 校验安装和发现契约。 |

更新节假日日历

client.js 中的 HOLIDAY_RANGES 是除活动之外唯一会随时间过时的部分。
它以连续区块的形式保存官方休息日，来源于国务院办公厅通知：

- 2025 — 国办发明电〔2024〕12号
- 2026 — 国办发明电〔2025〕7号

下一年的安排大约在 11 月初发布，因此 2027 年尚缺。在添加之前，表外的年份会回退到仅凭工作日/周末规则，并且该标签会在警告颜色中追加 calendar ends 2026，而不是默默假装已知假期。该警告仅限定于查询日历的计划；z.ai 从不显示它。

调休工作日有意不列出：它们在这里是普通周末，而周末是非高峰时段。

开发

npm ci
npm run check # manifest contract, then the test suite

npm test 单独运行测试套件。测试完全像浏览器那样加载 client.js——通过 window.__ModuleLoader__.load——并用一个小型 React 替身驱动已注册的组件，因此每个预期都是针对已发布代码而不是重新实现来检查的。该替身提供组件实际会用到的东西：一个 hook 存储，它将副作用推迟到提交之后，并强制执行 React 的位置 hook 契约（一次渲染调用不同数量的 hook，正是浏览器中会淘汰某个 slot 条目的情况）、document/window 事件目标、绑定到具有可设置几何信息的替身节点的 refs，以及一个记录面板去向的 react-dom createPortal。

npm run check:manifest 验证生态系统所依赖的契约：该补丁是顶层 YAML 数组，其行命名此包，并且 manifest 承诺的每个文件都已发布。更改日程数据前请参阅 CONTRIBUTING.md。

兼容性

该 bundle 需要一个提供 conversation.composer.dock 和 modelDirectories 服务的 dsh。它是针对 DSH 0.1.7-rc.2 编写的，并且不导入任何 Harness 客户端包：客户端 bundle 不得依赖 @deepseek-ai/dsh-client-ui-primitives，因此面板外壳在此插件自己的 opkh- 前缀下重新实现，并使用相同的主题令牌。

没有持久状态，也没有迁移，因此升级就是更新包。

许可证

MIT