@jalilahmad.fazeli/deepseek-peak-indicator

dsh plugin --profile web add @jalilahmad.fazeli/deepseek-peak-indicator

<p align="center">

<img src="https://raw.githubusercontent.com/jalilahmad/deepseek-peak-indicator/main/assets/readme-banner.png" alt="DeepSeek 峰谷时段指示器 —— 随时了解 DeepSeek API 处于峰时还是谷时定价。" />

</p>

DeepSeek 峰谷时段指示器

[English](README.md) · [فارسی](README.fa.md) · 简体中文

一个轻量的 DeepSeek Harness 插件，直接在侧边栏底部显示当前 DeepSeek API 定价时段——峰时（Peak）

或谷时（Off-Peak）——从应用启动即可见，无需打开任何 Session。点击它可查看**距离下次定价切换的

倒计时**。

插件不需要 API 密钥，不发起网络请求，也不轮询任何内容：时段完全由本地时钟和一个内置且已核实的

中国节假日日历在本地计算得出。

Peak 指的是官方 API 定价时段，与服务器拥塞或服务健康状况无关。

指示器只报告 DeepSeek 规定的计费时段，不对 API 负载、延迟或可用性作任何说明。峰时适用较高的

峰时费率，谷时则为半价费率。

---

安装

需要 DeepSeek Harness Desktop v0.2.1-rc.5 或更高版本。 插件运行行为保持不变。无需额外的

运行时、构建步骤或 npm 依赖。

包名为 @jalilahmad.fazeli/deepseek-peak-indicator。可从 npm 或直接从 GitHub 安装：

从 npm 安装

dsh plugin --profile web add @jalilahmad.fazeli/deepseek-peak-indicator

从 GitHub 安装

dsh plugin --profile web add github:jalilahmad/deepseek-peak-indicator

安装后重新加载 Harness Web GUI（或重启 DeepSeek Harness Desktop）。在支持 HMR 的 harness 上，

通常刷新页面即可。

<details>

<summary>改用插件管理器安装</summary>

1. 在 Harness 侧边栏打开 Plugins。

2. 选择 Add plugin → Install a third-party plugin。

3. 输入 npm 包名 @jalilahmad.fazeli/deepseek-peak-indicator，或 GitHub 规格

github:jalilahmad/deepseek-peak-indicator 并安装。

4. 确认该 bundle 已切换为 On，然后重新加载页面。

</details>

---

功能特性

• 一眼即知，三种状态——🟢 OFF-PEAK、🔴 PEAK、⚪ UNKNOWN。
• 下次切换倒计时——弹出层以整小时和整分钟显示剩余时间。
• 边界准确——状态恰好在官方时段边界切换；倒计时每分钟刷新一次，切换本身由精确定时器完成。
• 始终在场——位于 root 作用域的侧边栏底部条目，在任何 Session、Conversation 或 Composer

打开之前就已存在。

• 感知节假日——2025 与 2026 年的中国法定节假日日期均已核实；未核实的年份会如实报告为

UNKNOWN，绝不猜测。

• 时区安全——时段按 UTC 判定，节假日日期按中国标准时间判定，所有换算都使用浏览器的 IANA

Intl 数据库（无硬编码偏移，对夏令时安全）。

• 小巧且私密——一个客户端 bundle、一个 Host 行、一个 60 秒定时器外加一个切换定时器；无 API

密钥、无后端、无数据库、无遥测、无网络轮询。

• 生命周期干净——定时器、监听器、观察器和样式在卸载时全部释放；重新加载只会创建一个指示器。

---

截图

以下截图均来自运行本插件的 DeepSeek Harness Desktop v0.2.1-rc.5 的真实画面。为保护隐私，工作区名称

与会话标题已做模糊处理。

完整应用——侧边栏底部的指示器

带极简弹出层的 OFF-PEAK

插件管理器中的插件条目

PEAK 与 UNKNOWN 截图仍待补充，因为这两种状态需要拍摄时并不存在的真实时段条件：PEAK 只出现

在官方工作日峰时窗口内，UNKNOWN 只在当年中国法定节假日日历尚未核实时出现。它们将在下一个真实 PEAK

时段之后补充；具体条件与拍摄步骤见

[docs/screenshots/SCREENSHOTS_NEEDED.md](docs/screenshots/SCREENSHOTS_NEEDED.md)。

---

工作原理

指示器注册在 sidebar.footer.action 中——这是随附的 @deepseek-ai/dsh-client-ui-sidebar 包

所声明的、位于 Settings 旁边的 root 作用域列表插槽。它属于常驻的应用外壳，因此不依赖 Session、

Conversation 或 Composer。侧边栏展开时显示一个小胶囊（圆点 + 标签）；56 px 窄栏则显示只有圆点的

紧凑形态。

状态

状态 · 含义

🔴 PEAK · 处于官方峰时窗口内、日期为周一至周五，且该日期不是已核实的中国法定节假日。适用较高的 API 价格。

🟢 OFF-PEAK · 其他所有情况：不在两个每日峰时窗口内、处于周末，或处于已核实的中国法定节假日。适用半价 API 价格。

⚪ UNKNOWN · 处于工作日峰时窗口内，但该年份的本地节假日日历未核实（缺失、未发布或格式错误）。插件拒绝猜测。

周末全天为谷时，包括周末调休上班日，这遵循 DeepSeek 关于周末和节假日“全天”谷时的表述。

极简弹出层

点击指示器；再次点击、按 Escape，或点击外部即可关闭。弹出层恰好只有两行：

🔴 PEAK
Off-Peak starts in: 2h 13m

🟢 OFF-PEAK
Peak starts in: 61h 29m

⚪ UNKNOWN
Next transition cannot be reliably determined.

倒计时仅显示整小时和整分钟（绝不显示秒）。它每分钟刷新一次，而一个精确的切换定时器会在官方边界翻转

状态。如果当前时段的结束时间会落在节假日日历尚未核实的年份，插件会显示 UNKNOWN 那一行，而不是

编造一个倒计时。

时区处理

• 峰时窗口按 UTC 的当日分钟数比较。
• 中国节假日日期按该时刻的 Asia/Shanghai 日历日期查表。
• 中国午夜边界由该时区经 Intl 推导（对 Asia/Shanghai 而言即 16:00 UTC）——是计算得出的，

而非硬编码。

• bundle 保留了基于 IANA 的夏令时安全辅助函数，并以 Asia/Kabul 作为默认显示时区

（[client.js](client.js) 中的 DISPLAY_TIME_ZONE）；当前的极简弹出层有意只显示时长，因此

时区处理不影响显示内容，只影响正确性。

---

定价时段

依据官方 DeepSeek 定价文档：

时段 · 时间（UTC） · 价格

峰时 · 周一至周五，01:00–04:00 与 06:00–10:00——不含中国法定节假日 · 完整峰时价格

谷时 · 其他所有小时、周末，以及中国法定节假日全天 · 峰时价格的一半

对应北京时间：09:00–12:00 与 14:00–18:00。根据官方变更日志，峰谷定价自 **2026-08-16

16:00 UTC** 起引入；请始终在官方定价页面确认当前数值。

官方来源：DeepSeek 定价 ·

中文定价页面 ·

变更日志。

---

中国法定节假日

节假日日期保存在可编辑的 [holidays.json](holidays.json) 中，并由

[tools/sync-holidays.mjs](tools/sync-holidays.mjs) 内联进浏览器 bundle（浏览器 bundle 在运行时

无法读取同级文件）。

• 2025 与 2026 已依据国务院公告核实

（2025 年、

2026 年）。

• 仅当存在 verified: true、非空的官方 source，且包含格式良好、真实的日历日期时，该年才计为

已核实。

• 2027 被有意设为未核实——本版本准备时，年度节假日安排尚未公布。因此 2027 年的工作日峰时窗口会

显示 UNKNOWN；周末和谷时小时仍然确定。

• 没有已核实数据的年份绝不会产生错误的 PEAK。

要新增年份：编辑 holidays.json，运行 node tools/sync-holidays.mjs，然后运行测试。

---

隐私与架构

• 无 API 密钥。 插件从不请求、存储或使用 API 密钥。
• 无后端、无数据库、无存储。 没有服务器组件，也没有账户访问。
• 无网络请求、无轮询、无遥测。 client.js 中不含 fetch、XMLHttpRequest、WebSocket、

EventSource 或动态 import()；它只读取本地时钟和内置的节假日表。

• 仓库中无密文。 不含密钥、令牌、个人路径或机器相关状态。
• 插件通用提示。 与所有 DSH 插件一样，插件代码以 Harness 应用的本地权限运行。安装前请审阅

源代码；详情与问题报告见 [SECURITY.md](SECURITY.md)。

该插件是一个 DSH bundle，Host 一半为空，浏览器侧为 Client 一半：

1. package.json 声明 dsh.bundle（插入 Loader 行的 Cordis patch）与 dsh.client（浏览器入口）。

2. cordis.patch.yml 插入该插件行；[index.js](index.js) 是一个有意为空的 apply()。

3. client.js 注册惰性模块工厂，添加语言词典，并通过 ctx.slots 把指示器注册进

sidebar.footer.action。

4. 一个墙钟状态、一个 60 秒间隔和一个精确切换定时器驱动 UI；它们都在插槽条目卸载时被清理。

完整设计、状态算法、切换搜索和清理规则见 [docs/architecture.md](docs/architecture.md)。

---

兼容性与已知限制

• 已在 DeepSeek Harness Desktop v0.2.1-rc.5（Windows）上验证。 engines.dsh 允许此版本及

所有更高版本（包括未来预发布版本）；更高版本尚未在本仓库中验证，可能引入不兼容变更。不声明兼容其他

客户端或平台。

• Windows 折叠侧边栏。 在 Windows 标题栏布局下，随附的侧边栏外壳在侧边栏折叠时会隐藏其整个

页脚（包括随附

…(truncated)