dsh-balance-mini：DeepSeek Harness 極簡餘額監視器

前言¶

在使用 DeepSeek Harness（DSH）進行智能體開發或任務調度時，API 消耗是一個核心關注點。手動刷新網頁查看餘額不僅效率低，還容易錯過計費變動的關鍵信息。針對這一場景，下面介紹 dsh-balance-mini 插件，它爲 DSH Web 界面提供了一個輕量級的餘額監控方案。

定位¶

dsh-balance-mini 是 DeepSeek Harness 的極簡餘額監視器：常駐餘額徽章、紅綠燈配色、多供應商支持、高峯/空閒時段提示。該插件由 DaYanQAQ 維護，採用 MIT 許可證。

核心功能¶

常駐餘額徽章與紅綠燈¶

插件在左下角提供一個常駐的餘額徽章，實時顯示當前餘額與最後更新時間，且會隨側邊欄寬度自適應。當側邊欄收起時，徽章會收縮爲紅/黃/綠三個小圓燈，用於快速識別餘額狀態：
* 紅色：餘額低於 10 元
* 黃色：餘額在 10 至 20 元之間
* 綠色：餘額高於 20 元
金額文字顏色遵循相同規則。

自動刷新與手動控制¶

插件每 60 秒自動查詢一次餘額。若需立即獲取最新數據，可在面板右上角進行手動刷新。

多供應商支持¶

插件支持 DeepSeek、Kimi（月之暗面）和 OpenRouter 三家供應商。它通過讀取 DSH 的憑據文件來識別已配置的 API Key，無需額外配置。

高峯/空閒時段提示¶

插件依據 DeepSeek 官方定價顯示當前計費時段：
* 高峯時段：北京時間週一至週五 9:00–12:00、14:00–18:00
* 空閒時段：其餘時間（包括晚間、凌晨、午休及週末全天）。空閒時段價格爲高峯時段的一半。
面板會顯示距下一時段切換的倒計時。

安全與語言¶

本機安全邊界：接口僅接受迴環地址（127.0.0.1）訪問，API Key 僅發往官方接口，不落盤、不轉發任何第三方。
中英文自動切換：界面語言跟隨瀏覽器設置。

安裝與啓用¶

前置條件：DeepSeek Harness (@deepseek-ai/dsh >= 0.1.0-rc.6)。

執行安裝命令：

dsh plugin --profile web add dsh-balance-mini

重啓 dsh web 服務。
在瀏覽器中硬刷新頁面（Ctrl+Shift+R），左下角出現餘額徽章即表示安裝成功。

配置與使用¶

插件零配置開箱即用，只需在本地憑據文件中配置相應的 API Key。

在 ~/.dsh/.credentials.yaml 中添加以下內容（根據實際需求選擇）：

refs:
  DEEPSEEK_API_KEY: sk-xxxxxxxx      # DeepSeek：platform.deepseek.com
  MOONSHOT_API_KEY: sk-xxxxxxxx      # Kimi：platform.moonshot.cn
  OPENROUTER_API_KEY: sk-or-xxxx     # OpenRouter：openrouter.ai

添加或刪除 Key 後重新打開面板即可生效，無需重啓服務。

注意事項¶

插件以當前 DSH 進程的權限運行，接口訪問範圍嚴格限制在本地。
首次打開面板時會彈出使用說明，點擊“知道了”後將不再重複顯示。