前言¶

使用 DeepSeek API 进行开发时，计费分为“空闲”和“高峰”两个时段。如果开发者不注意当前时间对应的计费规则，可能会在高峰期产生不必要的费用。DeepSeek Harness (DSH) 的 Web GUI 默认不提供当前计费状态的直接反馈。我们需要一个直观的方式确认当前计费是处于“空闲”还是“高峰”状态，以优化成本控制。

这是什么¶

dsh-plugin-offpeak-badge 是一个为 DeepSeek Harness (DSH) Web GUI 设计的插件。它由 AK-blank 维护，旨在解决用户无法快速确认当前 API 计费是处于“空闲”还是“高峰”状态的问题。该插件通过在界面显眼位置展示状态徽章，帮助开发者随时掌握计费信息。

核心功能¶

• 状态可视化：在侧边栏品牌行显示一个药丸状徽章，颜色编码区分“空闲”或“高峰”。
• 悬停详情：鼠标悬停时显示计费时段规则、今日日期以及下一次计费时段切换的具体时间。
• 折叠模式适配：在侧边栏折叠后，状态点会显示在折叠按钮上，保持可见。
• 无障碍支持：支持屏幕阅读器，使用 aria-live 区域。
• 节假日日历：内置中国法定节假日数据（支持 2025 和 2026 年），辅助判断是否为法定节假日。

安装与启用¶

• 环境要求：确保已安装 DSH，且 Node.js 版本不低于 18。
• 命令行安装：使用 DSH 的插件管理命令进行安装。

    dsh plugin --profile web add github:AK-blank/dsh-plugin-offpeak-badge

• 图形界面安装：打开 DSH Web GUI，进入“插件”页面，点击“添加插件”，粘贴仓库地址（如 github:AK-blank/dsh-plugin-offpeak-badge），然后点击安装。

典型用法¶

安装完成后，刷新浏览器页面，侧边栏品牌行会出现状态徽章。将鼠标悬停在徽章上，可以查看当前计费规则、今日日期以及下一次计费时段切换的具体时间。根据规则，调休上班的周末仍属于周末时段，因此按空闲时段计费。

适用场景与注意¶

• 适用场景：经常在非工作时段（如周末、夜间）使用 DeepSeek API 的开发者，需要确认是否享受半价优惠。
• 自动更新限制：DSH 目前不支持插件的自动更新，如需升级，需要先卸载再重新安装。
• 手动安装说明：通过 install.mjs 脚本手动安装的配置行不会出现在 GUI 的插件列表中。
• 权限与安全：插件以当前 DSH 进程权限运行。安装前建议查看源码与许可证（MIT）。

该插件通过直观的视觉反馈和丰富的信息展示，帮助开发者避免因计费时段误判而产生的额外成本。如需查看更多细节或提交反馈，可访问其 GitHub 仓库。