前言¶
在 DeepSeek Harness（DSH）的插件生態中，開發者需要直觀地掌握賬戶的餘額與剩餘 token 數量，以便控制調用成本。現有的界面通常不具備實時餘額展示功能。dsh-balance-window 作爲一個懸浮組件，解決了這一痛點。
插件定位¶
該插件由維護者 sixtysevenlf 開發，面向 DSH 桌面端與 Web 端用戶，提供實時餘額顯示與剩餘 token 估算。
功能說明¶
- 懸浮窗口：默認位於左下角，支持按住任意位置拖動到屏幕任何地方。
- 實時餘額：調用 DeepSeek 官方
GET /user/balance接口獲取數據。 - Token 估算：按當前模型與設定單價估算預計剩餘 token。
- 自動刷新：每 60 秒自動刷新一次，支持點擊窗口或 ↻ 按鈕立即刷新。
- 狀態指示：綠色呼吸圓點表示數據正常，失敗時自動重試，不會閃斷。
- 位置記憶：拖動位置會保存在
localStorage中，重啓後恢復到原位。 - 隱私安全：插件不含任何密鑰，API Key 只在使用者自己的環境中讀取。
安裝與配置¶
安裝流程請參考官方文檔。
* 安裝指南：install-guide.md
* 配置示例：cordis.patch.example.yml
自定義調整¶
- 調整單價：修改
lib/index.js中的PRICE_PER_MILLION可調整 token 估算單價。 - 調整刷新與位置：修改
lib/client.js中的刷新間隔（默認 60000ms）與默認位置。 - 熱加載：修改代碼後保存，無需重啓即可生效。
注意事項¶
- 插件不含任何密鑰。
- API Key 只在使用者自己的環境中讀取。
- 使用前需確保已按照安裝指南完成配置。
