前言¶

用 DeepSeek API 跑长任务或批量调用时，计价窗口是否处于高峰期，直接影响单次请求成本。官方价目表按 UTC 写出高峰区间，中文页又换算成北京时间；周末、法定节假日全天按半价计，工作日里的法定假日也要从高峰里排除。靠记忆或反复查文档，既慢也容易在边界时刻估错。

DeepSeek Harness（DSH）支持用客户端插件往会话标题栏挂载小组件。下面介绍维护者 nacivageer 发布的 dsh-price-period：一枚零依赖、不联网的标题栏标签，按官方口径判断当前是高峰还是半价，并在临近切换时显示倒计时。

这是什么¶

dsh-price-period 是 DSH 的纯 Client 插件（分类：客户端）。它向 conversation.session.header.utilities 注册一个组件，在有会话标题栏的场景里展示当前 API 计价档位（高峰 / 半价），不显示具体单价，也不估算花费。

当前版本为 0.1.0-alpha.1，MIT 许可。仓库无运行时依赖，交付物就是 client.js，装完无需构建步骤，运行时也不发起网络请求。

核心功能¶

插件做的事与不做的，README 里用表格写得很清楚，摘要点如下。

会做：

1. 按北京时间对照 DeepSeek 官方价目表 的 off-peak 说明，判断此刻是高峰还是半价。
2. 距下次档位切换严格小于 30 分钟时显示倒计时（例如 08:30:00 整点不算，08:30:01 起才显示）。
3. 法定节假日与周末全天按半价；周末跨期时，「下一次切换」会跳到下周一 09:00，周五 18:00 之后到周一早上中间没有切换点。
4. 每秒用浏览器本机时钟重算，无 Host 请求、无缓存。
5. 节假日数据来自仓库内 data/cn-holidays.json（现行表含国务院 2026 年放假安排）；未收录年份会在标签上显示 ⚠，tooltip 说明只按周末判断，避免静默猜日期。

不做：

• 不提醒「该现在跑任务」、不做定时任务。
• 不替代官方价目表变更通知；只表达高峰 / 半价两档。

判定口径（北京时间）：

• 高峰期：周一至周五 09:00–12:00、14:00–18:00，排除中国法定节假日。
• 半价期：其余所有时间，含周末与法定假日全天。

官方英文页写的是 UTC 的 01:00–04:00 与 06:00–10:00；插件固定按 Asia/Shanghai 换算，用户机器系统时区不改变结论。全球共用一套价目表，海外用户同样在 UTC 那两个窗口付高峰价；插件不需要地区设置。

安装与启用¶

前提： DeepSeek Harness 0.2.2-rc.1 或更新（package.json 中 engines.dsh 同为 >=0.2.2-rc.1）。

桌面版与 CLI 通用下面这条命令；profile 名按你的环境改，桌面版默认多为 desktop：

dsh plugin --profile desktop add github:nacivageer/dsh-price-period

若 dsh 不在 PATH（桌面版常见），可用安装目录下的 resources\runtime\cli\bin\dsh.cmd，或用 npx @deepseek-ai/dsh 代替命令开头的 dsh。

本包没有构建步骤：不需要 prepare，也不需要 allowBuilds。安装后重启 DSH 生效（manifest 不热更新）。

插件以当前 DSH 进程权限在客户端运行；安装前建议浏览 GitHub 源码与 MIT 许可证，确认符合你的环境策略。社区目录 skillhub.cn 上的条目 与仓库互为引用，该站点为社区插件目录，与 DeepSeek / 幻方无官方从属关系。

典型用法¶

安装并重启后，打开已有会话即可在标题栏看到时段标签。空白新会话页没有 session 作用域的标题栏，此时标签不会出现——这是 README 里写明的限制。

日常无需配置项：标签每秒刷新。临近切换时出现倒计时 UI（仓库 docs/ 下有标题栏与倒计时截图可参考）。

若你从源码改节假日表或时钟逻辑，可先跑测试再打包安装：

npm test
npm pack
dsh plugin --profile desktop add ./dsh-price-period-0.1.0-alpha.1.tgz

维护者提醒：不要用 dsh plugin add . 做目录 link 分发；tarball 或 git 形态才与 npm 行为一致。维护新年节假日时，更新 data/cn-holidays.json 后执行 npm run sync:holidays，再 npm test 提交——这与普通用户的「装上即用」路径无关，仅供贡献者参考。

适用场景与注意¶

适合谁：

• 经常在 DSH 里调 DeepSeek API、希望在标题栏一眼看到当前是高峰还是半价的人。
• 希望在跨期前 30 分钟内看到倒计时、以便自行安排调用节奏的人（插件不会替你做决策）。

务必注意：

1. 本机时钟是唯一依据；系统时间错误，标签结论跟着错，插件不做校时。
2. 节假日表是静态数据；coveredYears 外的年份会显示 ⚠，工作日里的法定假日若未收录可能被当成高峰——但会有可见警告，不是无声算错。
3. 官方价目表可能调整；插件只反映 README 所述两档逻辑，不展示单价。
4. 调休上班的周六在实现上不单独处理：官方口径周末一律半价，这些日本来就按半价显示。

DSH 生态主张「一切皆插件」；本插件是客户端侧的一枚小芯片，把官方计价时段规则固化到 UI，减少查文档成本。

结尾¶

dsh-price-period 把 DeepSeek API 高峰 / 半价判定和临近切换倒计时放进会话标题栏：零依赖、不联网、无构建，安装命令即 README 原文一条。若要查看说明、提 issue 或核对节假日 JSON，见 GitHub 仓库。

• 目录页：https://www.skillhub.cn/plugins/nacivageer/dsh-price-period
• GitHub：https://github.com/nacivageer/dsh-price-period