DeepSeek Harness（DSH）採用模塊化插件架構。在使用 Web 端進行開發或日常操作時，頻繁查看訂閱額度或 API 支出往往需要在不同標籤頁或菜單間切換。dsh-usage-mini 旨在解決這一問題，提供一個懸浮面板，將關鍵的使用數據集中在屏幕一側。
它是什麼¶
這是一個專爲 DeepSeek Harness Web 客戶端設計的輕量級懸浮儀表盤。它不負責數據的採集或賬戶連接，而是作爲 dsh-cost-meter 和 dsh-plugin-subscriptions 的可視化補充，專注於在界面上保留關鍵的使用情況。
核心功能¶
- 訂閱與 API 監控：支持 Claude 和 Codex 訂閱，顯示可用使用窗口、已用/剩餘百分比、重置時間及倒計時。同時顯示 DeepSeek API 的本地記錄支出/調用次數以及上游緩存的官方餘額。
- 語言跟隨：界面語言自動跟隨 DSH 的全局語言設置（中文/英文），無需獨立切換。
- 交互與位置記憶：窗口可拖動、可摺疊，並自動記憶其在瀏覽器中的位置。
- 數據輪詢：僅在窗口展開且頁面可見時，每 60 秒輪詢一次數據；摺疊或隱藏時停止輪詢以節省資源。
- 內置反饋：底部提供反饋欄，可直接向 GitHub 提交 Issue。
安裝與啓用¶
- 安裝插件
執行以下命令將其添加到 Web 配置文件：
dsh plugin --profile web add dsh-usage-mini
-
啓用小窗
安裝完成後重啓 DeepSeek Harness Web，在 Settings（設置）中找到“用量小窗”選項並開啓。 -
前置依賴
該插件依賴dsh-plugin-subscriptions和dsh-cost-meter插件才能正常獲取 Claude 訂閱和 DeepSeek API 的數據。
注意事項¶
- 平臺限制：僅支持 DeepSeek Harness Web 客戶端，不支持 TUI 或 Headless 模式。
- 運行環境：經驗證的 Node.js 版本爲 22.23.2。
- 數據隱私：不持久化使用數據，僅持久化 UI 位置和摺疊狀態；不處理憑據或文件訪問。
- 權限範圍：插件運行在 DSH 進程權限內，不包含生命週期腳本或外部網絡請求。
總結¶
對於需要在 Web 端持續監控 API 支出和訂閱額度的用戶，dsh-usage-mini 提供了一個低干擾、即開即用的解決方案。
