前言¶
在使用 DeepSeek API 進行開發或構建智能體工作流時，實時監控賬戶餘額以及不同 Provider 的 Token 消耗是控制成本和排查問題的關鍵。現有的儀表盤往往難以在一個界面中聚合所有 Provider 的用量數據，且餘額查詢接口可能分散。這個插件通過一個可拖動、可摺疊的懸浮面板，將 DeepSeek 開放平臺的賬戶餘額與今日所有 Provider、所有模型的 Token 用量彙總展示在 DeepSeek Harness Desktop 的界面中。
插件簡介¶
該插件由開發者 Hades03 維護，採用 MIT 許可證。它基於上游項目 dsh-cost-meter 1.5.38 定製，複用本地賬本以保留歷史數據。插件主要提供兩個維度的統計：一是 DeepSeek 官方平臺的賬戶餘額，二是本地所有 Harness Provider 的 Token 消耗明細。
核心功能¶
- 餘額查詢：只顯示 DeepSeek 開放平臺賬戶餘額，公開運行版僅訪問官方餘額接口。
- Token 彙總：彙總今日所有 Provider、所有模型的 Token 使用情況。
- 明細展示：按 Provider / 模型列出輸入 Token、緩存讀取、緩存寫入、輸出和合計 Token。
- 交互控制：支持“全部 / DeepSeek”篩選和手動刷新；面板支持拖動並自動記憶位置。
- 邊緣錨定：使用屏幕邊緣錨定，展開與收起時位置不會發生漂移。
- 恢復默認：雙擊標題欄或收起後的懸浮條可恢復默認右下角位置。
- 自動刷新：60 秒自動刷新本地統計。
- 歷史複用：複用
~/.dsh/storages/cost-meter/ledger.json，保留已有歷史記錄。 - 推理 Token 處理：推理 Token 單獨顯示在模型詳情中，不計入合計，避免部分 Provider 已將推理 Token 包含在輸出時發生雙計。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add "github:Hades03/dsh-model-quota-usage"
安裝或更新後，需要重啓 DeepSeek Harness Desktop 應用。
使用說明¶
- 啓動應用後，右下角會出現懸浮面板。
- 面板加載完成後，可以看到 DeepSeek 賬戶餘額以及今日總 Token 用量。
- 點擊篩選按鈕，可以在“全部”和僅“DeepSeek”模型之間切換。
- 拖動面板標題欄可調整位置，面板會自動吸附到屏幕邊緣。
- 雙擊標題欄可將面板重置到默認右下角。
- 面板會每 60 秒自動刷新本地統計數據。
適用場景與注意事項¶
- 版本要求：需確保 DeepSeek Harness 版本 >= 0.1.1-rc.2，環境 Node.js >= 20。
- 數據範圍：Token 統計覆蓋 DeepSeek、Kimi、GPT、GLM、Claude 等所有 Harness Provider，但不會查詢這些 Provider 的賬戶餘額（僅查詢 DeepSeek 餘額）。
- 數據隱私：Token 賬本只保存在本機，不包含遙測，不上傳會話標題或 Token 歷史。
- 依賴服務：DeepSeek API Key 由 Harness 憑據服務讀取。
