前言¶
DeepSeek Harness (DSH) 的插件生態允許用戶根據需求擴展功能。在使用多供應商配置時，快速查看當前模型對應的餘額狀態是高頻需求。dsh-balance-chip 旨在解決這一問題，通過在輸入框工具欄提供可視化的餘額圓環，讓開發者無需切換頁面或手動查詢即可掌握額度情況。
是什麼¶
dsh-balance-chip 是一個面向 DeepSeek Harness 的客戶端插件，由開發者 O1dZ 維護，採用 MIT 許可證。它通過圓環、懸浮提示和實色詳情面板展示餘額，圓環位置位於模型選擇器左側。該插件隨當前會話的模型選擇自動刷新，每 60 秒更新一次數據，無需手動輸入憑證即可讀取餘額。
核心功能¶
- 持久加載與狀態管理：作爲普通持久插件包，使用 bundle patch 在啓動時加載。重啓 Harness 無需重新創建動態腳本，模型切換後自動清除上一選擇，避免數據混淆。
- 餘額展示與刷新：顯示當前供應商、模型、接口返回的餘額明細、更新時間及手動刷新按鈕。晚到的查詢請求不會覆蓋新的供應商數據，刷新失敗時保留上次餘額並標明過期。
- 主題適配與交互：圓環、懸浮提示和詳情面板自動跟隨深淺主題。詳情面板可通過按
Esc鍵或點擊外部區域關閉。 - 容錯處理：將金額、幣種與原始額度分開顯示。插件不會將缺少憑證、權限不足、超時、不支持或異常回復當作零餘額處理，確保數據準確性。
- 自動配置解析：自動使用所選供應商的已啓用配置，無需用戶再次手動輸入 Key。
安裝與啓用¶
本項目尚未發佈到 npm，需通過源碼包安裝。以下以 Windows 的 desktop profile 爲例，其他系統請替換相應路徑。安裝前請確保已關閉 Harness，並準備好 Git 和 pnpm。
- 克隆倉庫
在任意工作目錄執行：
git clone https://github.com/O1dZ/dsh-balance-chip.git
- 添加到 Profile
保持在該目錄，執行安裝命令（不執行依賴安裝腳本）：
pnpm --dir "$env:USERPROFILE\.dsh\profiles\desktop" add --ignore-scripts ("file:" + (Resolve-Path '.\dsh-balance-chip').Path.Replace('\', '/'))
-
配置 Bundle
打開該 profile 目錄下的package.json，將dsh-balance-chip追加到dsh.profile.bundles數組中，並保留原有 bundle。 -
啓動 Harness
完整啓動 Harness 後打開會話並選擇已配置的供應商模型。首次安裝或宿主代碼更新後，必須完整重啓 Harness，網頁刷新無法替換已加載的模塊。
典型用法¶
- 查看餘額：將鼠標懸停在輸入框工具欄左側的圓環上，查看簡略餘額；點擊圓環或圓環可展開實色詳情面板。
- 自動刷新：切換模型時，圓環會立即刷新顯示新模型的餘額；非切換狀態下，每 60 秒自動更新一次。
- 手動刷新：點擊詳情面板中的刷新按鈕可強制更新數據。
適用場景與注意事項¶
- 兼容版本：面向 Harness 0.2.0-rc.2。其他版本及操作系統尚未驗證。
- 支持範圍：支持 DeepSeek API（含自定義路由名）、DeepSeek Account、Moonshot（中國/國際）、SiliconFlow（中國/國際）、OpenRouter 以及自定義兼容網關。普通 OpenAI、Anthropic、Google 模型密鑰及 OAuth 訂閱配額未適配。
- 安全與隱私：餘額請求只在宿主側執行，Key 從 Harness 憑證服務解析，端點、憑證值和原始錯誤文本不進入客戶端。請求只使用 GET，同源且禁止重定向，非本機明文 HTTP 不查詢。
- 顯示說明：CNY 圓環以 ¥50 爲顯示參考，USD 以 $10 爲顯示參考，不代表賬戶額度上限。
- 隱私保護：請勿在 Issue、PR、截圖或日誌中提交 Key、會話 Cookie、OAuth token、真實 profile 或賬號信息。
總結¶
dsh-balance-chip 通過本地化插件的方式，在 DeepSeek Harness 中提供了直觀的多供應商餘額管理功能。它遵循 DSH 的插件化理念，利用宿主側權限安全獲取數據，適合需要頻繁切換模型並監控額度的高級用戶。更多細節可參考插件目錄或源碼倉庫。
