dsh-llm-balance：DeepSeek Harness 用量監控插件

在 DeepSeek Harness (DSH) 的使用過程中，頻繁切換頁面查看賬號餘額或配額會打斷工作流。下面介紹 dsh-llm-balance，這是一個能將餘額監控集成到界面右下角的插件。

插件簡介¶

該插件是 DeepSeek Harness 的聯網工具組件，由 L.H 維護（MIT 許可證）。它的核心價值在於解決多賬號管理中“餘額不足”和“配額耗盡”的突發問題，通過一張常駐卡片，讓開發者無需離開當前界面即可掌握接入 AI 賬號的剩餘情況。

核心功能¶

插件支持 DeepSeek、Moonshot、Kimi For Coding 和 OpenCode Go 四種服務。它具備以下能力：

自動讀取數據：自動查找並讀取配置文件中已填寫的 API Key 對應的剩餘餘額或訂閱配額，無需額外配置憑據。
多維度展示：
- 充值賬號（如 DeepSeek、Moonshot）：顯示剩餘金額。
- 訂閱賬號（如 Kimi For Coding、OpenCode Go）：顯示已用百分比和重置時間。
狀態可視化：
- 顏色預警：剩餘不足 20% 變紅，不足 40% 變黃，其餘爲藍色。
- 當前狀態：當前正在使用的提供商旁顯示綠點。
交互功能：
- 支持拖動和磁吸貼邊。
- 支持摺疊顯示（氣泡模式）。
- 支持調整刷新頻率（60秒/5分鐘/30分鐘/1小時）。
- 支持半透明模式。
- 記住視圖、位置、摺疊狀態和刷新頻率。

安裝與啓用¶

在終端中執行官方安裝命令：

dsh plugin --profile web add dsh-llm-balance

安裝完成後刷新網頁即可生效。插件會自動查找已填寫的 API Key，無需額外配置。

使用方法¶

切換視圖：點擊卡片標題右側的圖標，在“當前模型”、“整體彙總”、“全部來源”之間循環切換。
移動與磁吸：按住標題行拖動，靠近左右邊緣會自動磁吸貼邊；雙擊標題可復位到右下角。
摺疊/展開：貼邊後卡片角上會出現 ‹ 或 ›，點擊氣泡可摺疊（顯示首字母+關鍵數字）或恢復。
刷新頻率：點擊刷新頻率芯片（如 60s）切換間隔。
透明度：點擊半透明圖標調整底色。

配置說明¶

插件默認配置即可使用，但支持深度定製。修改 cordis.patch.yml 中的 config 配置項並重啓 dsh web 生效：

config:
  thresholds: { warn: 40, error: 20 }                    # 剩餘低於 40% 黃、低於 20% 紅
  balanceThresholds:
    'deepseek-balance:CNY': { warnBelow: 40, errorBelow: 20 }   # DeepSeek 餘額閾值設置
  percentMode: used                                      # 顯示已用%（改成 left 顯示剩餘%）
  refreshMs: 60000                                       # 默認 60 秒刷新一次

注意事項：
* 訂閱窗口顯示的是已用百分比，但顏色判斷基於剩餘百分比。
* 餘額沒有總量分母，不硬湊百分比，需在配置中設置金額閾值。
* 修改配置後必須重啓服務。

隱私與安全¶

插件遵循隱私保護原則：
* 密鑰隔離：API Key 僅保留在宿主進程，不會在瀏覽器端持久化。
* 接口限制：瀏覽器端僅收到金額、幣種、窗口時長和錯誤碼，接口爲只讀且不緩存數據。

適用場景¶

適合需要在 DSH 界面中實時監控多賬號餘額或配額使用情況的開發者。安裝前請確認源碼與許可證。