前言¶
在 DeepSeek Harness（DSH）裏做對話或開發智能體時，你需要在輸入框下方的狀態行看到兩個關鍵信息：當前賬號的餘額，以及本輪對話已經消耗的 token 數量。如果沒有直觀的展示，要麼要打開設置裏的「賬號」或「性能與用量 → 詳細」頁面，要麼需要自己寫腳本去查，多了一步跨頁面查看的麻煩。dsh-balance-usage-widget 作爲一個輕量的 composer-dock widget，把這兩項信息直接放在輸入框下方，用一行文字展示，懸停可看細分數據。
這是什麼¶
這是一個爲 DeepSeek Harness（DSH）設計的 composer-dock widget，由 XiongBangze 維護。它把 DeepSeek 賬戶餘額和當前會話的 token 用量聚合到一行顯示，幫助用戶在不離開當前對話窗口的情況下掌握資源狀態。它不是官方插件，而是社區項目，僅通過 DSH 客戶端已有的接口讀取餘額和 token 數據，不發起額外網絡請求，也不讀寫文件。
核心功能¶
一行顯示餘額與 token 用量
在 DSH 輸入框下方的狀態行中，左側顯示 DeepSeek 賬號的充值餘額，右側顯示本會話累計 token（未命中輸入 + 緩存命中 + 緩存寫入 + 輸出）。示例格式爲：
¥12.34 · 12.3K tok
懸停查看細分數據
將鼠標懸停在狀態行上，會彈出細分數據，包括：
- 充值餘額
- 贈金餘額
- 本會話 token 分項（未命中輸入、緩存讀取、緩存寫入、輸出）
- 緩存命中率
容錯顯示
如果未登錄或餘額查詢失敗，狀態行左側會顯示 餘額 --，右側的 token 數量仍正常顯示。
安裝與啓用¶
從命令行安裝
從 npm 安裝，安裝時需指定桌面端 profile（desktop profile 由桌面端獨佔管理）：
dsh plugin --profile desktop add dsh-balance-usage-widget
安裝完成後重啓 DSH，狀態行即可出現餘額與 token 顯示。
從界面安裝
在 DSH 側欄中依次進入「插件 → 添加插件」，填寫包名 dsh-balance-usage-widget，安裝後重啓 DSH。
本地開發安裝
本地開發時，可在安裝對話框中粘貼插件目錄的絕對路徑，通過命令行安裝到臨時 profile 進行測試：
dsh plugin --profile <profile> add /absolute/path/to/dsh-balance-usage-widget
典型用法¶
安裝並重啓 DSH 後，輸入框下方會自動出現狀態行，顯示當前會話的餘額和 token 用量。懸停可查看細分數據，幫助判斷緩存命中率、輸出 token 佔比等。餘額每 60 秒刷新一次，頁面重新可見時也會刷新。
適用場景與注意¶
這個插件適合需要在對話過程中持續監控資源狀態的 DSH 用戶，尤其是使用充值餘額而非純 API key 的場景。餘額需要 DeepSeek 賬號登錄，API-key-only 的環境會因爲內置賬號服務不暴露餘額而顯示 餘額 --。
插件以當前 DSH 進程的權限運行，讀取數據來自 DSH 客戶端已有的接口，不發起額外網絡請求，也不讀取會話正文或寫文件。使用前建議檢查源碼與許可證（MIT），確認隱私與邊界行爲符合預期。
結語¶
dsh-balance-usage-widget 把餘額與 token 用量從設置頁面拉到輸入框下方，用一行文字和懸停展開的方式，減少跨頁面查看的次數。如果你在 DSH 中需要頻繁查看資源狀態，可以嘗試安裝這個輕量 widget。
- 目錄頁：https://www.skillhub.cn/plugins/XiongBangze/dsh-balance-usage-widget
- GitHub：https://github.com/XiongBangze/dsh-balance-usage-widget
