前言¶

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