前言¶

使用 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 倉庫。