前言¶
用 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 里用表格写得很清楚，摘要点如下。
会做：
- 按北京时间对照 DeepSeek 官方价目表 的 off-peak 说明，判断此刻是高峰还是半价。
- 距下次档位切换严格小于 30 分钟时显示倒计时（例如
08:30:00整点不算，08:30:01起才显示）。 - 法定节假日与周末全天按半价；周末跨期时，「下一次切换」会跳到下周一 09:00，周五 18:00 之后到周一早上中间没有切换点。
- 每秒用浏览器本机时钟重算，无 Host 请求、无缓存。
- 节假日数据来自仓库内
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 分钟内看到倒计时、以便自行安排调用节奏的人（插件不会替你做决策）。
务必注意：
- 本机时钟是唯一依据；系统时间错误，标签结论跟着错，插件不做校时。
- 节假日表是静态数据；
coveredYears外的年份会显示⚠，工作日里的法定假日若未收录可能被当成高峰——但会有可见警告，不是无声算错。 - 官方价目表可能调整；插件只反映 README 所述两档逻辑，不展示单价。
- 调休上班的周六在实现上不单独处理：官方口径周末一律半价，这些日本来就按半价显示。
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
