前言¶

DeepSeek Harness (DSH) 采用插件化架构。在调用 API 时，计费策略（高峰价或空闲价）往往在请求发出那一刻才生效。开发者若想提前知晓当前时段的费率，通常需要手动对照官方定价页。dsh-peak-badge 插件通过本地时钟计算，在 DSH 对话输入框左侧提供可视化的状态胶囊，直观展示当前计费方式，避免在高峰期发起长耗时请求。

插件定位¶

dsh-peak-badge 是一个运行在 DSH 桌面端（desktop profile）的客户端插件。
* 功能：实时显示当前是高峰价还是空闲价。
* 维护者：tuoLuoSuan。
* 协议：MIT。

核心功能¶

1. 状态胶囊
   在 DSH 输入框工具行最左侧显示一个状态胶囊。胶囊左侧有一个小圆点，颜色随状态变化：高峰时段为琥珀色，空闲时段为中性色。

2. 详细信息卡片
   点击胶囊可展开卡片。卡片内包含：
   * 当前状态（高峰/空闲）。
   * 计费方式说明。
   * 下次切换时间及倒计时。
   * 状态切换的详细理由。

3. 切换前提醒
   支持在切换到新时段前进行提醒，防止在高峰期发起长耗时请求。
   * 可配置提前量：关闭、1、2、5、10、15、30 分钟（默认 2 分钟）。
   * 每个切换点仅播报一次，基于边界时间判定，避免重复提示。

4. 系统通知
   支持浏览器系统级通知。
   * 需要用户授权。
   * 处理权限被拒、不支持通知接口等四种状态。
   * 勾选状态会与浏览器权限实时对账。

5. 本地计算与主题
   * 基于本地时钟计算，不依赖网络请求。
   * 支持中英文界面切换。
   * 支持深色/浅色主题适配。

安装与启用¶

安装前请确保 DeepSeek Harness (DSH) 版本 >= 0.2.0-rc.2，且已安装依赖包 @deepseek-ai/dsh-client-ui-conversation。

1. 从仓库安装（推荐）
   使用以下命令将插件添加到 desktop profile：

   dsh plugin --profile desktop add github:tuoLuoSuan/dsh-peak-badge

2. 本地开发安装
   如果你在本地开发环境，可以使用 plugin_manager 指定路径：

   plugin_manager action: install_bundle target: D:\path\to\dsh-peak-badge

本地验证¶

插件逻辑完全在本地计算。可以通过仓库提供的验证脚本确认计费策略逻辑是否正确：

node verify-policy.mjs

注意事项¶

• 行为边界：插件仅作状态展示与提醒，不改变任何计费行为，也不拦截任何请求。
• 退出码：
• 0：验证通过。
• 1：断言失败（逻辑错误）。
• 2：运行时错误（如找不到 DSH）。
• 时钟机制：时钟绑定在插件实例上而非胶囊组件上，确保在切换会话或页面时仍能正常播报提醒。

参考链接¶

• GitHub: https://github.com/tuoLuoSuan/dsh-peak-badge
• 生态目录: https://www.skillhub.cn/plugins/tuoLuoSuan/dsh-peak-badge