MateoBarbato/deepseek-peak-hour-banner

deepseek-peak-hour-banner

一个 DeepSeek Harness Web GUI 插件，让 DeepSeek 的高峰时段费率始终可见，一个时钟，两个位置：

| 状态 | 位置 | 外观 |
| --- | --- | --- |
| 高峰 | conversation.input.dock — 输入框上方的上下文条，紧邻 Todo / Goal / Queue | 琥珀色卡片：⚡ HORA PICO · tarifas al doble · Termina en 1 h 12 min · 04:00 UTC / 01:00 local |
| 非高峰 | conversation.composer.dock — 输入框页脚，紧邻内置的 StatsPills 行 | 柔和胶囊：✓ Fuera de hora pico · próxima 22:00 local (en 1 h 12 min) |

同一时间只渲染一个位置，且各自在下一个 UTC 边界自行切换：当提供商按高峰费率计费时，卡片恰好位于输入框上方；其余时间，时间表则安静地待在页脚中。

周五到周一之间的空档完全没有高峰窗口，最长可达 63 小时，因此一旦下一个窗口不再落在今天，胶囊就会显示星期几并以天为单位倒计时——否则 22:00 local 配上 60 小时倒计时看起来就像个 bug：

✓ Fuera de hora pico · próxima dom 22:00 local (en 2 d 12 h)

这两个字符串都是 lib/client.js 中的纯字面量，默认以西班牙语发布；如需本地化，请编辑它们。

时间表

取自官方定价页面（api-docs.deepseek.com/quick_start/pricing）：非高峰费率为高峰费率的一半，且高峰时段为 UTC 周一至周五 01:00–04:00 和 06:00–10:00。其余所有时间均为非高峰。

窗口始终按 UTC 评估，因为提供商就是按 UTC 计费的。本地时钟时间仅用于显示，绝不用于判断。

同一页面的中文版本以北京时间表述该规则——北京时间周一至周五 9:00–12:00、14:00–18:00——描述的是同一批时刻（北京为 UTC+8，无夏令时）。两种表述在这些窗口的星期几上也一致，因为给 01:00–10:00 UTC 的范围加上八小时永远不会跨过午夜。test/rule.test.mjs 会解析两种表述，并逐分钟检查它们与打包产物在整整一年内是否一致。

如果 DeepSeek 更改了时间表，请编辑 lib/client.js 中的 PEAK_WINDOWS_UTC（以 UTC 午夜起的分钟数表示偏移），更新 test/rule.test.mjs 中引用的规则，然后重新安装。

要求

- 带 web 配置文件的 DeepSeek Harness（dsh --profile web）。
- 具有 patchReload: live 的配置文件（内置的 web 配置文件即是）。

安装

仓库根目录就是插件包，它声明自己为 dsh.bundle，且其浏览器打包产物已提交——因此无需构建步骤，也无需授予构建权限。

git clone https://github.com/MateoBarbato/deepseek-peak-hour-banner.git
dsh plugin --profile web add ./deepseek-peak-hour-banner
dsh plugin 会在 profile 目录中转发给 pnpm，后者会链接检出目录并将该包追加到 dsh.profile.bundles。随后 bundle 补丁（cordis.patch.yml）会插入插件行，因此无需其他操作。由于安装的是指向你检出目录的链接，之后对该仓库的编辑会在保存时被拾取——宿主机的 client-HMR 轮询会在一秒内重新加载浏览器 bundle。

同一命令也接受其他分发形式，它们都不需要构建权限：

dsh plugin --profile web add @mateobarbato/dsh-client-ui-peak-hour        # registry
dsh plugin --profile web add ./deepseek-peak-hour-banner-1.0.0.tgz        # pnpm pack
dsh plugin --profile web add github:MateoBarbato/deepseek-peak-hour-banner

无需启动即可验证该层，然后重启 GUI（bundle 层在启动时组合；只有 profile 补丁会热重载）：

dsh --profile web --dump-config   # shows a "# == @mateobarbato/dsh-client-ui-peak-hour" layer

卸载

dsh plugin --profile web remove @mateobarbato/dsh-client-ui-peak-hour

工作原理

| 文件 | 作用 |
| --- | --- |
| package.json | 声明 dsh.bundle（可安装层）、dsh.client.platform: web，以及 dsh-client-modules 所发现的 ./client 导出。 |
| cordis.patch.yml | bundle 层：在 profile 中挂载插件的 insert 行。 |
| lib/index.js | 宿主端：一个空的 apply()，仅用于让该行挂载到宿主 Loader 树中。 |
| lib/client.js | 浏览器端：一个经典脚本，在 window.__ModuleLoader__ 上注册一个惰性工厂。 |
| test/schedule.test.mjs | 时间表测试：窗口边界、周五→周一的间隔，以及逐分钟扫描。 |
| test/rule.test.mjs | 规则一致性：解析两种已发布的措辞，并与 bundle 逐分钟比对一整年。 |
| test/render.test.mjs | 渲染测试：在冻结时钟下用真实 React 对两个席位进行服务端渲染，每个状态各一个。 |

四项契约使这成为一个插件而非分支：

- bundle 侧 — package.json 声明 dsh.bundle.patch，它以补丁层回答“这个包贡献了什么？”。这正是 dsh plugin add 将该包追加到 profile 的 dsh.profile.bundles 中，而不是将其作为惰性依赖安装的原因。
- 宿主侧 — package.json 声明 dsh.client，其中 platform: "web" 并导出 ./client，因此 client-modules 宿主端会在 /plugins/@mateobarbato/dsh-client-ui-peak-hour/client.js 提供该 bundle，并将其放入 window.__DSH_BOOT__。
- 浏览器侧 —— 该 bundle 注册一个工厂函数（factory(require) → exports），其导出是一个普通的 Cordis 插件（apply + inject）。react 是平台种子词，因此无需 dsh.client.external 条目，且工厂函数体在物化时运行，而非在脚本加载时运行。
- 座位几何布局 —— 该卡片复制了随附的 GoalBar 停靠框（侧边间距加上四个停靠内边距），因此其最大宽度解析为 --dsh-chat-content-width，并与输入框卡片和消息操作行对齐，而不是横跨整个窗格。底部胶囊则复制了 StatsPills 行：相同的列宽、相同的居中方式、相同的 --dsw-alias-label-tertiary 颜色和 13px 字号，因此它读起来像是多了一个统计项，而不是第二条横幅。

为什么胶囊不在 StatsPills 内部

StatsPills 在 @deepseek-ai/dsh-client-ui-chat 中渲染一个 root 元素，且其内部不暴露任何插槽，因此插件无法向该行添加子元素——conversation.composer.dock 正是该行所占用的插槽。占用它会把胶囊放入相同的底部区域和块中，紧跟在统计项之后，这就是为什么该座位复制了那一行的几何布局，而不是嵌套在其中。

开发

npm install    # react + react-dom，仅由渲染测试使用
npm test       # 规则一致性 + 调度 + 两个座位在两种状态下的渲染

浏览器部分没有构建步骤：lib/client.js 按原样提交。链接安装会在保存时拾取编辑——宿主机的客户端 HMR 轮询会在一秒内重新加载浏览器 bundle，页面刷新则是后备方案。只有对 cordis.patch.yml 的更改需要重启，因为 bundle 层是在启动时组合的。

发布

该包已准备好进行 npm publish：名称已限定到其作者，files 会发布 lib/、补丁和文档，且没有需要生成的构建产物（或者如果你更愿意分发 tarball，也可以用 pnpm pack）。

状态

已在 dsh 0.1.5-rc.1（web profile）上验证：调度逻辑和两个座位均由测试套件覆盖，且该包通过真实的 Cordis 补丁引擎作为 bundle 层组合进 profile 的入口列表。没有端到端浏览器测试。

许可证

MIT