前言¶

用 DeepSeek Harness 桌面版跑 agent 时，API 按峰谷计价：工作日部分时段为高峰（1×），其余为错峰低谷（0.5×）。规则写在官方定价页，需要自己换算北京时间、排除节假日，才能判断「现在算不算高峰」。下面介绍社区插件 dsh-offpeak-alert（维护者 wenxiuncle，分类：客户端）：在桌面版窗口标题栏常驻一个小角标，显示当前高峰/低谷、距下一次切换的倒计时，高峰时角标变为深红，便于一眼决定是否适合大批量调用。

这是什么¶

dsh-offpeak-alert 是适配 DeepSeek Harness 桌面版 的 DSH 客户端插件。角标默认贴在视口顶边居中（top: 4px），在桌面版里对应自绘窗口标题栏正中；可拖动到任意位置。插件不联网，峰谷判定与节假日数据硬编码在 client.js 中，口径对齐 DeepSeek API 官方定价页。

• 目录页：https://www.skillhub.cn/plugins/wenxiuncle/dsh-offpeak-alert
• 源码：https://github.com/wenxiuncle/dsh-offpeak-alert
• 许可证：MIT（package.json 版本 1.0.0）

浏览器版（DSH Web）没有桌面版那条标题栏，角标会落在页面最顶端，未做适配与验证。

峰谷规则与角标文案¶

判定口径（与 README 一致）：

• 高峰：UTC 01:00–04:00 与 06:00–10:00，仅周一至周五，中国法定节假日除外
• 低谷：其余时间（含周末与法定节假日全天），价格为高峰的 0.5×
• 折合北京时间：工作日 09:00–12:00、14:00–18:00 为高峰

角标每 30 秒复算一次，跨时段边界最多延迟约 30 秒变色。节假日当天文案会带上节日名。

视觉约定：高峰为深红底 + 近白文字（浅色、深色主题相同）；低谷为中性灰底，安静提示。插件不改动任何背景色或主题令牌，界面配色由 DSH 主题决定。

安装与启用¶

插件以本地目录方式安装（profile 里登记为 link: 依赖），仓库改动在重载插件后直接生效；升级可在本地目录 git pull 后重载插件。README 未提供 dsh plugin add github:... 一类命令，不要凭插件名拼接安装命令。

1. 将仓库克隆或下载到本地任意目录（路径示例见下一步）
2. 打开 DeepSeek Harness 桌面版，进入侧边栏 Plugins（插件面板）
3. 点击「添加插件」
4. 在「包名或地址」中填入该目录的绝对路径，例如：

<你存放本仓库的绝对路径>\dsh-offpeak-alert

5. 确认安装，并在插件列表中启用

Host 侧仅导出 apply，效果全在浏览器端；package.json 中 dsh.client 为 platform: "web"、immediately: true。

典型用法¶

关闭与恢复角标¶

角标右侧 × 可关闭。关闭状态记在 sessionStorage，本次运行内不再出现；重开应用后会重新出现。想立刻恢复，在开发者工具 Console 执行：

__dshOffpeak.showBadge()

拖动与复位¶

默认位置为标题栏水平居中、贴窗口顶边。按住角标任意区域（关闭按钮除外）可拖动；位置存 localStorage，重开应用后保持。未拖过时窗口变宽会重新居中。回到标题栏居中：

__dshOffpeak.resetPosition()

控制台查询¶

__dshOffpeak.status()      // { status:'peak'|'off-peak', holidayName, reason, beijing, ... }
__dshOffpeak.nextSwitch()  // { at: <时间戳>, peak: <切换后的状态> }
__dshOffpeak.showBadge()   // 恢复被 × 关掉的角标

规则过期与维护¶

插件不联网，官网若调整峰谷或节假日安排，不会自动跟上。内置提醒（纯本地）在两种情况下触发：距 SCHEDULE_VERIFIED_ON 超过默认 90 天，或当前年份没有 OFFICIAL_HOLIDAYS 精确数据（农历估算）。触发时角标末尾出现 · 规则待核，并带 data-stale 小黄点；Console 每会话打印一次告警，__dshOffpeak.status() 返回中含 scheduleNotes、scheduleVerifiedOn。

核对高峰时段时，打开官方定价页，必要时改 client.js 里 statusAt() 的分钟判断，并将 SCHEDULE_VERIFIED_ON 改为核对当天。2026 年法定节假日在 OFFICIAL_HOLIDAYS；新年度需按国办通知补年份条目。

改配色可编辑 client.js 的 BADGE_CSS（ deliberately 使用字面色值，深浅主题高峰需各写一条选择器）。改完后需重新加载插件；替换已安装包有时需重启 DSH。

适用场景与注意¶

适合谁：长期在 DSH 桌面版里开发、希望随时看到 API 峰谷与倒计时、又不想让插件改主题或背景的开发者。

运行与权限：插件随当前 DSH 进程在客户端文档中注入角标；安装前应阅读 index.js、client.js 与 MIT 许可证，确认可接受本地存储（位置 localStorage、关闭状态 sessionStorage）与固定定位 UI。

已知边界（摘自 README）：

• 只影响主窗口文档；终端、文档预览等独立 iframe 内不显示角标
• 角标 position: fixed，除拖动/关闭外不做其它交互；默认在标题栏居中，若与其它元素重叠可拖开
• 卸载即还原，不注册全局事件

DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-offpeak-alert 把官方峰谷规则做成标题栏角标：高峰深红、低谷中性灰，带切换倒计时与可选「规则待核」提醒，适合桌面版日常开发时扫一眼计价窗口。详情与截图见 GitHub README；安装走插件面板的本地绝对路径。

• 插件目录：https://www.skillhub.cn/plugins/wenxiuncle/dsh-offpeak-alert
• 仓库：https://github.com/wenxiuncle/dsh-offpeak-alert