前言¶
DeepSeek API 按北京时间划分高峰与空闲两档价格，空闲时段约为高峰的一半。费率在请求发出那一刻就定下来，而不是等响应结束。若你在 DSH（DeepSeek Harness）里写长提示词或批量调 API，仅凭记忆很难判断「现在发出去算哪一档」、以及「再过几分钟会不会切档」。
下面介绍社区插件 dsh-peak（维护者 tuoLuoSuan，GitHub tuoLuoSuan/dsh-peak）。它在 DSH 对话输入框工具行最左侧挂一枚小胶囊，用本机时钟换算成北京时间，对照官方规则与内置节假日表，告诉你当前是高峰还是空闲；点开卡片还能看到下次切换时间与说明。判定在浏览器内完成，不向 DeepSeek 发请求。
这是什么¶
dsh-peak 是 DSH 的客户端插件：在 composer 区域（挂载点 conversation.input.left）显示 Peak / off-peak 计费状态徽章。分类上属于客户端侧 UI 增强，与 SkillHub 目录页分类一致。
插件解决的是「此刻按哪档计费、何时切换、切换前要不要提醒」这类问题，而不是改 API 价格或代你选模型。
核心功能¶
状态胶囊与详情卡片¶
胶囊左侧圆点随状态变色：高峰为琥珀色，空闲为中性色。点击后展开卡片，展示当前状态、计费方式、下次切换时间与倒计时，以及为何落在当前档位的一行说明。支持浅色与深色主题；文案支持中文与英文（随 locale）。
计费规则（与官方定价页一致）¶
规则来源为 DeepSeek 官方定价页：
- 北京时间周一至周五（不含中国法定节假日）9:00–12:00、14:00–18:00 为高峰；
- 其余时段，含周末及法定节假日全天，为空闲；
- 空闲价格为高峰的一半。
插件在本机读取时钟，换算为北京时间，并查硬编码的节假日表（如 2026 年 33 天来自国务院通知）。不依赖网络核对 DeepSeek 接口；官方规则变更需以定价页为准，插件只反映其内置策略。
调休日与跨年¶
调休上班日若落在周六或周日，插件按官方条文「周末均为空闲」字面执行，全天按空闲计价；卡片会写明此类情况。节假日表仅覆盖已硬编码年份；表外年份对「是否法定假」会表示未知，但周末仍按空闲处理。
切换前提醒¶
面向「正在写长提示、即将跨过边界」的场景：卡片内可选提前量（关闭 / 1 / 2 / 5 / 10 / 15 / 30 分钟，默认 2 分钟）。临近边界时右下角 toast 提醒「即将进入高峰」或「即将进入空闲」；每个边界只说一次，换会话或重挂载不会重复同一边界。可选浏览器系统通知（需用户勾选且权限允许）；提醒不拦截请求、不改变计费，只提示。
时钟逻辑绑在插件层而非仅胶囊上，以便在离开会话页时仍能按计划提醒。
安装与启用¶
需要已安装 DSH；开发与验证基于 @deepseek-ai/dsh@0.2.0-rc.2。peer 依赖为 @deepseek-ai/dsh >= 0.2.0-rc.2。
从 GitHub 安装（README 推荐，跟随 main）：
dsh plugin --profile desktop add github:tuoLuoSuan/dsh-peak
desktop 对应桌面端侧栏「工作区」的 profile 名，可按你的环境替换。
从 npm 安装固定版本：
dsh plugin --profile desktop add dsh-peak@0.2.1
注意 npm 包名是 dsh-peak，不要装成 dsh-peak-badge（他人包，非本项目）。旧 scoped 名 @tuoluosuan/dsh-peak-badge 在 0.2.0 起已更名为 dsh-peak。
在对话中也可让 DSH 执行：
plugin_manager action: install_bundle target: github:tuoLuoSuan/dsh-peak
装完后刷新页面；替换已装 bundle 需重启 DSH 才能加载新代码。卸载示例：
plugin_manager action: remove_bundle target: dsh-peak
安装后可在 list_plugins 中确认该包且 fiberPhase: active。
典型用法¶
- 安装并刷新 DSH 对话页，在输入框工具行最左侧查看胶囊颜色与标签。
- 点击胶囊，阅读当前档位、下次切换时间与理由；在卡片里调整「切换前提醒」提前量，按需勾选系统通知。
- 在高峰边界前收到 toast（或系统通知）时，自行决定是立即发送请求还是等到空闲档。
仓库提供策略验证脚本，可在克隆后的根目录执行：
node verify-policy.mjs
用于核对节假日、边界时刻与文案等逻辑（README 中描述了覆盖范围与时区无关性测试方式）。
适用场景与注意¶
适合谁： 经常用 DSH 调 DeepSeek API、关心按档计费、希望在本机即时看到「现在算不算高峰」的开发者。
权限与安全： 插件以当前 DSH 进程/浏览器上下文运行；安装前建议阅读 仓库源码 与 MIT 许可证（package.json 中 license: MIT）。客户端注入依赖 @deepseek-ai/dsh-client-ui-conversation，平台为 web。
局限： 节假日与规则以插件内置表与官方定价页描述为准；表外年份的法定假信息可能不完整。npm 发布版不自动跟踪 GitHub main，追新功能宜用 github: 安装方式。
结尾¶
dsh-peak 把 DeepSeek 高峰 / 空闲计费档做成输入框旁一眼可见的状态，并用本机时间完成判定与可选的切档提醒，适合在 DSH 里控成本、卡点发请求的场景。
