dsh-balance：DeepSeek API 餘額常駐小部件與峯谷定價提示

前言¶

在使用 DeepSeek Harness (DSH) 進行開發時，監控 API 餘額和了解當前的定價時段（高峯與閒時）是日常操作的一部分。dsh-balance 插件解決了這兩個問題，通過在 Web 界面提供一個常駐小部件，讓你無需切換頁面即可掌握餘額狀態和定價檔期。

這是什麼¶

dsh-balance 是一個由 qianmoyishu 維護的 DSH 插件。它爲 DSH Web 界面提供了一個常駐小部件，用於實時顯示 DeepSeek API 的餘額，並根據北京時間的高峯與閒時定價規則提供視覺提示。

核心功能¶

1. 常駐可拖動小部件
   小部件默認顯示在界面右上角。你可以按住頭部將其拖動到任意位置，位置會自動保存到瀏覽器的 localStorage 中，刷新或重啓服務後依然存在。它掛在 shell.overlay 根級插槽，不會佔用側邊欄插槽，也不會與其他插件（如寵物）的位置衝突。
2. 收起與展開
   點擊小部件頭部的「–」可以將其收起，此時顯示爲一個圓點，僅展示總餘額和高峯檔期符號；點擊「▸」則展開顯示完整信息。
3. 餘額顯示
   小部件展開後，會顯示總餘額、充值餘額、贈送餘額以及最後更新時間。
4. 自動刷新與倒計時
   小部件每 60 秒自動刷新余額數據。對於高峯時段，會顯示距離切換到閒時或下一個高峯時段的倒計時，鼠標懸停可查看完整的時段說明。
5. 高峯時段提示
   根據配置的 PEAK_WINDOWS（默認爲北京時間 09:00-12:00 和 14:00-18:00），實時顯示當前檔期：
   - 紅色：高峯時段
   - 綠色：閒時半價時段
6. 服務端代理
   餘額查詢通過服務端代理接口 /api/balance 進行。DEEPSEEK_API_KEY 僅在服務器進程內解析，不會下發到瀏覽器端，保證了密鑰安全。

安裝與啓用¶

1. 安裝插件
   在終端中執行以下命令進行安裝：

   dsh plugin --profile web add "https://github.com/qianmoyishu/dsh-balance/releases/latest/download/dsh-balance-0.2.1.tgz"

2. 配置 API 密鑰
   在 DSH 的 Web 界面中，前往“設置” → “模型”頁面，或者在環境變量中配置 DEEPSEEK_API_KEY。未配置時，小部件會提示但不會報錯。
3. 重啓服務
   安裝或更新插件後，必須重啓 dsh web 服務並刷新頁面，插件纔會生效。

典型用法¶

1. 拖動位置
   按住小部件頭部，將其拖動到屏幕上你認爲最方便查看的位置。
2. 收起查看
   點擊頭部「–」收起小部件，快速查看當前總餘額和是否處於高峯時段。
3. 展開查看
   點擊頭部「▸」展開小部件，查看詳細的餘額明細和剩餘時間。

適用場景與注意¶

• 適用場景：需要在開發過程中持續監控 DeepSeek API 餘額，並希望直觀瞭解當前是否處於高定價時段的開發者。
• 時區依賴：高峯時段的計算基於 Asia/Shanghai 時區，不依賴本機系統時區。
• 自定義配置：如需修改高峯時段的定義，需編輯源碼 lib/client.js 頂部的 PEAK_WINDOWS 常量。
• 開發環境：在本地源碼開發模式下，修改代碼後需要重啓 dsh web 才能生效。

結語¶

dsh-balance 提供了直觀的餘額監控和定價提示，減少了手動查詢和切換頁面的開銷。插件由社區開發者維護，遵循 MIT 許可證。更多細節可參考插件目錄或源碼倉庫。