前言¶
DeepSeek API 按北京时间划分高峰（全价）与空闲（半价）时段。开发者在 DeepSeek Harness（dsh）里频繁发消息时，若不清楚当前属于哪一档，容易在高峰窗口内无意按全价计费。官方定价说明在文档里，但不会常驻在对话界面旁。
下面介绍社区插件 dsh-deepseek-billing-period（维护者 zi7tian，分类：联网工具）：在 Web 版 dsh 的输入框（composer）下方常驻显示当前计费时段、下一档切换倒计时，并可选在高峰时段发送前二次确认。插件托管于 SkillHub 目录，源码见 GitHub。
这是什么¶
一句话：dsh 的 Web 客户端插件，按北京时间与中国法定节假日规则判定高峰/空闲，在输入框下方以「药丸」形式展示状态与倒计时。
- 包名：
dsh-deepseek-billing-period（npm / dsh 插件名） - 当前版本（package.json）：1.2.1
- 许可证：MIT
- 验证环境（README）：
dsh 0.2.0-rc.2、Node v26
DeepSeek Harness 生态采用「一切皆插件」思路；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
时段展示与倒计时¶
输入框下方常驻一条可点击的「药丸」，实时刷新；倒计时精确到分，每秒更新。典型文案形如：
● 空闲时段 · 半价 · 距高峰 12 小时 42 分
点击药丸会在其正上方弹出规则说明卡片，不挤压输入区布局（展开前后输入区尺寸不变）。点击卡片外或按 Esc 关闭。卡片视觉与宿主 composer 浮层一致：半透明底、发丝描边、柔和投影、--dsw-radius-lg 圆角；浅色/深色主题通过宿主 --dsw-* 令牌自适应，不写死颜色。
计费规则（判定逻辑）¶
判定恒按北京时间（UTC+8），与浏览器本地时区无关；界面中英文及节假日名称随宿主语言切换。
| 时段 | 判定 | 价格 |
|---|---|---|
| 高峰 | 北京时间周一至周五 09:00–12:00、14:00–18:00，且当天不是中国法定节假日 |
全价 |
| 空闲 | 其余时间，含周末与法定节假日全天 | 高峰价格的一半 |
- 时间窗口为左闭右开：
09:00起为高峰，12:00/18:00起离开高峰；12:00–14:00为空闲。 - 内置国务院办公厅年度放假安排：2025 年（国办发明电〔2024〕12 号）、2026 年（国办发明电〔2025〕7 号）。仅收录落在工作日的节假日；调休上班的周末仍按周末全天空闲处理。
- 未收录年份（如尚未公布安排的 2027 年）回退为「仅按周一至周五判断」，并在卡片中明示，避免静默误判为高峰。
高峰时段发送前确认¶
高峰（全价）时段内，按 Enter 或点击发送会先弹出确认框（取消 / 确认发送），复用宿主 Modal / Button / Checkbox（不可用时用同套令牌自绘）。
- 取消（或
Esc/ 点遮罩）：不发送，草稿保留，焦点回到输入框。 - 确认发送：走宿主原有发送逻辑。
- 弹窗内可勾选「以后不再询问」；偏好写入浏览器
localStorage键dsh-deepseek-billing-period.prefs。需在规则卡片底部打开「高峰时段发送前确认」开关可恢复每次确认。 - 不拦截：空闲时段、
/斜杠命令、Shift+Enter换行。
安装与启用¶
前置：已安装 dsh 并启用 web profile。
方式一：从 npm 安装（推荐）¶
dsh plugin --profile web add dsh-deepseek-billing-period
方式二：从 GitHub 安装¶
dsh plugin --profile web add github:zi7tian/dsh-deepseek-billing-period
安装会把声明了 bundle 的包追加到 dsh.profile.bundles。完成后重启 dsh web 并刷新页面。
方式三：本地 link（改代码用）¶
git clone https://github.com/zi7tian/dsh-deepseek-billing-period.git
dsh plugin --profile web add link:/path/to/dsh-deepseek-billing-period
link: 方式下直接改 checkout 中的 client.js，浏览器刷新即可，无需重装或重启 dsh web。
卸载¶
dsh plugin --profile web remove dsh-deepseek-billing-period
安装成功的标志¶
在已有会话中打开页面（空白首页无输入框，不会渲染该 slot）。输入框下方出现计费时段药丸；点击可展开规则卡片。截图见仓库 screenshots/（浅色/深色规则卡片与高峰确认弹窗）。
典型用法¶
- 安装并重启
dsh web，进入任意带 composer 的会话。 - 看药丸文案判断当前是高峰还是空闲，以及距下一切换还有多久。
- 需要核对细则时点击药丸，查看表格化规则与节假日说明。
- 若希望在高峰全价窗口每次发送前提醒，保持「高峰时段发送前确认」开启；若已勾选「以后不再询问」，在规则卡片底部重新打开该开关即可。
插件无额外配置文件；行为由内置时段表、localStorage 中的发送确认偏好决定。
适用场景与注意¶
适合谁：长期在 dsh Web 里调用 DeepSeek API、希望界面侧随时看到 peak/off-peak 与倒计时的开发者；在意高峰全价窗口误触发送、需要可选二次确认的用户。
运行方式：与其它 dsh 插件一样，在已启用的 web profile 中加载客户端 bundle（cordis.patch.yml），注入 conversation / slots 等宿主模块。安装前建议浏览 源码仓库 与 MIT 许可证，确认符合你的安全与合规要求；插件在 dsh 进程及浏览器侧执行，权限边界以当前 dsh 与浏览器为准。
局限：节假日数据仅覆盖 README 所列年份；未来年份需等待作者更新或接受「仅工作日窗口」回退逻辑。计费结论仅供对照官方定价文档，最终以 DeepSeek 账单与官方说明为准。
结尾¶
dsh-deepseek-billing-period 把 DeepSeek API 的高峰/空闲规则搬到 composer 下方：状态、倒计时、规则卡片与可选高峰发送确认，均按北京时间与内置放假安排计算，并贴合 dsh Web 主题令牌。
- 目录页：https://www.skillhub.cn/plugins/zi7tian/dsh-deepseek-billing-period
- GitHub：https://github.com/zi7tian/dsh-deepseek-billing-period
