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

前言¶

DeepSeek Harness (DSH) 採用插件化架構，爲開發者提供了擴展能力。在使用多供應商模型進行開發或測試時，監控 API 餘額是常見需求。dsh-balance-mini 專爲解決“隨時看一眼餘額”這一痛點而生，提供常駐顯示與狀態提示，不佔用額外界面空間。

插件介紹¶

dsh-balance-mini 是 DeepSeek Harness 的一個客戶端插件，由 DaYanQAQ 開發，遵循 MIT 許可證。它通過常駐左下角的徽章和紅綠燈配色，實時展示餘額狀態，並支持多供應商與高峯/空閒時段識別。

核心功能¶

• 常駐餘額徽章：在 DSH Web 界面左下角顯示餘額（格式：餘額：￥xx.xx · 更新於 HH:MM）。徽章隨側邊欄寬度平滑自適應。
• 紅綠燈圓燈：當側邊欄收起時，徽章收縮爲圓燈。顏色與金額文字顏色同步：紅色（<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。

1. 在終端執行安裝命令：

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

2. 重啓 dsh web 進程，並在瀏覽器中硬刷新頁面（通常爲 Ctrl+Shift+R）。
3. 左下角出現餘額徽章即安裝成功。

配置¶

該插件爲零配置。它通過讀取 DSH 的憑據文件來獲取 API Key：

• 路徑：~/.dsh/.credentials.yaml
• 邏輯：在 Harness 的「設置-模型」中配置了哪家的 Key，插件就自動可用。

配置示例：

refs:
  DEEPSEEK_API_KEY: sk-xxxxxxxx      # DeepSeek
  MOONSHOT_API_KEY: sk-xxxxxxxx      # Kimi
  OPENROUTER_API_KEY: sk-or-xxxx     # OpenRouter

添加或刪除 Key 後，重新打開餘額面板即可生效。

典型用法¶

• 查看詳情：點擊左下角的餘額徽章，展開詳情面板。
• 處理未配置供應商：若在面板中選擇了未配置 API Key 的供應商，會顯示提示，餘額顯示爲 ￥0.00。

注意事項¶

• 插件基於當前 dsh 進程權限運行，API Key 僅在內存中處理。
• 目前支持的供應商爲 DeepSeek、Kimi、OpenRouter。Z.ai（智譜）等因無公開餘額查詢接口或接口語義不符，暫未接入。

結語¶

dsh-balance-mini 以極簡的方式解決了 DSH 用戶監控餘額的日常需求。適合需要頻繁切換供應商並關注計費時段的開發者。

• 項目目錄頁
• GitHub 倉庫