在 DeepSeek Harness (DSH) 中進行智能體開發或調試時，實時掌握 API 調用的成本和官方賬戶餘額有助於控制預算。dsh-usage-meter 是一個插件，旨在提供簡單直接的用量和餘額監控功能。
該插件是一個簡單的用量計費工具，用於顯示 API 消耗的金額。它支持峯谷定價。作者爲 HunterCHCL，類別爲 admin-security，許可證爲 MIT。
核心功能¶
- 顯示餘額與花費：顯示 DeepSeek 官方 API 餘額和當前會話花費。
- 界面交互：在界面右上角顯示金額，懸停查看詳情。
- 配置選項：支持在設置頁面配置價格表和峯谷定價。
- 語言跟隨：UI 語言跟隨 DSH 語言設置。
- 官方接口：通過 Session header indicator 調用官方 DeepSeek API 獲取餘額。
安裝與啓用¶
使用官方安裝命令安裝：
dsh plugin --profile web add @hunterchcl/dsh-usage-meter
典型用法¶
- 切換語言：在 DSH 設置 -> 通用 -> 語言中切換界面語言，插件 UI 會隨之更新。
- 查看詳情：懸停在界面右上角的金額上，查看當前會話的詳細花費。
- 配置定價：在設置中啓用峯谷定價，根據請求發生的時間窗口計算費用。
適用場景與注意¶
- 估算參考：用量數據是本地估算值，基於 DSH 持久化的會話事件日誌（
assistant/chunk和assistant/message），僅供參考，並非平臺賬單，請以 DeepSeek 官方爲準。 - 歷史計算：打開會話時會計算完整歷史使用量，包括插件安裝前的記錄。
- 兼容性：僅支持官方 DeepSeek API，非官方 API、缺少密鑰或查詢失敗時餘額顯示爲隱藏。
- 許可證：MIT 許可證。
- 維護提示：手動運行
pnpm install可能會清理本地插件目錄，建議使用提供的安裝腳本。
該插件爲 DSH 用戶提供了輕量級的成本控制手段。相關文檔與源碼可在下方目錄頁與 GitHub 倉庫查看。
