前言¶
DeepSeek Harness（DSH）採用插件化架構，但在日常使用中，監控 API 餘額和 Token 消耗並不直觀。現有方案往往需要手動切換頁面或依賴第三方監控工具。tugu-dsh-balance-widget 插件在 DSH 側邊欄增加了一個入口，通過居中大卡片實時展示餘額、充值入口及消耗數據，解決了這一痛點。
插件信息¶
名稱: tugu-dsh-balance-widget
作者: jieguanya
許可: MIT
定位: 聯網工具類插件
核心功能¶
該插件通過側邊欄入口與設置按鈕保持同一水平行，提供以下功能：
-
左下角入口與居中大卡片
入口位於側邊欄左下角，點擊後彈出居中大卡片。卡片支持點擊遮罩、關閉按鈕或 ESC 鍵關閉。面板打開期間，入口保持可見，可隨時切換。 -
實時餘額監控
插件自動讀取 DSH 已配置的DEEPSEEK_API_KEY，調用 DeepSeek 官方接口GET /user/balance。面板打開期間每 60 秒自動刷新余額數據，支持手動刷新。 -
充值入口
面板內提供充值按鈕，點擊後直接在新窗口打開 DeepSeek 官方充值頁面platform.deepseek.com/top_up。 -
今日消耗與模型分組
展示今日調用次數、Token 合計及金額。消耗數據按模型分組展示（模型 / 調用次數 / 金額），新增模型無需修改插件配置即可自動出現。 -
消費趨勢圖
默認顯示近 7 天或近 30 天的每日消耗柱狀圖，支持鼠標懸停查看每日金額與 Token 明細。 -
當前會話 Token
全量回放會話持久化日誌，實時補充進行中消息，覆蓋重啓前的歷史記錄。 -
今日約消費
通過當前餘額與期初餘額的差值進行估算，數據標註“約”字，避免與官方數據混淆。 -
安全機制
API Key 僅在宿主側按請求解析，瀏覽器端只訪問本地路由，Key 不出本機。
安裝與啓用¶
前置條件:
- DeepSeek Harness 0.1.7+
- 已配置 DEEPSEEK_API_KEY（設置頁面或 .credentials.yaml）
安裝命令:
dsh plugin --profile web add <插件目錄路徑>
典型用法¶
重啓 DSH 後，側邊欄左下角會出現「餘額」入口（與設置按鈕同行）。點擊該入口即可查看居中大卡片。
若需驗證接口返回數據，可使用以下命令（將 <端口> 替換爲實際端口）：
curl http://127.0.0.1:<端口>/api/dsh-balance
注意事項¶
- 該插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
- 同事機器上無需配置 Node.js 或 pnpm 環境，一鍵腳本可自動處理。
- 插件基於官方價格表進行計價與展示。
