前言¶
在使用 DeepSeek Harness 進行開發或日常交互時，實時掌握 Token 消耗與賬戶餘額有助於控制成本和監控運行狀態。下面介紹一個側邊欄插件，用於在 Web 界面中直接展示這些關鍵數據。
插件簡介¶
該插件由 zdjmrq 維護，屬於客戶端插件。它通過在側邊欄底部增加一行標籤，提供用量和餘額的概覽與詳情查詢功能，無需離開當前頁面即可獲取數據。
核心功能¶
-
用量/餘額標籤行
在側邊欄底部「設置」按鈕上方，顯示一條簡潔的「用量 | 餘額」標籤行。標籤與設置、Cordis 面板同一排位，與 Cordis 面板縱向堆疊、互不衝突。 -
玻璃擬態詳情卡
鼠標懸停標籤行時，在右側展開玻璃擬態詳情卡。卡片包含四項數據：- 運行時長（xxmxxs，每秒跳動）
- Token 數量（輸入/輸出）
- 估算金額（基於內置價格表計算）
- 官方賬戶餘額（真實接口數據）
-
滑桿開關控制
詳情卡底部提供橢圓滑桿開關，用於在「懸停顯示」和「固定常駐」兩種顯示模式間切換。 -
自適應佈局
詳情卡寬度自適應桌面環境。右側空間不足時，卡片會自動翻轉到左側展開。當側邊欄摺疊爲豎條時，僅顯示 ¥ 徽標。 -
主題跟隨
整體樣式使用 DSH 主題變量（--dsw-*），支持亮/暗主題自動切換。
安裝與配置¶
前置條件：
* Node.js ≥ 20
* DeepSeek Harness（需包含 dsh plugin 命令）
安裝命令：
dsh plugin --profile web add github:zdjmrq/dsh-usage-balance
安裝後，重啓 dsh web 即可生效。
使用說明¶
- 查看概覽：側邊欄底部會出現「用量 | 餘額」標籤行。
- 查看詳情：鼠標懸停標籤行，展開玻璃擬態詳情卡。
- 切換模式：拖動卡片底部的滑桿，可將詳情卡片固定在側邊欄中顯示。
注意事項¶
- 金額估算：卡片中顯示的金額爲估算值，實際賬單以 DeepSeek 官方爲準。
- 網絡與權限：餘額查詢功能需要可訪問
api.deepseek.com的網絡環境，並複用llm-deepseek設置中的 API Key。若網絡不通或 Key 無效，餘額項可能無法顯示。
結尾¶
該插件通過側邊欄集成，簡化了用量與餘額的查看流程。相關源碼與目錄頁可查看下方鏈接。
