前言¶

DeepSeek Harness（DSH）在單次對話裏能給出當輪的 token 用量，但日常開發更常遇到三類問題：賬戶裏還剩多少餘額、今天在本 Harness 裏實際消耗了多少 token、是否接近自己設定的預算或餘額下限。這三類數字來源不同——官方賬戶、流式響應裏的 usage chunk、以及由余額快照推導的消費——若混在同一口徑裏展示，很容易誤判。

下面介紹社區插件 dsh-deepseek-usage-monitor（維護者 MinaMiKune，分類：模型推理）。它在 DSH 左側欄提供面板，用官方接口展示賬戶餘額，用本 Harness 對 llm/stream 的觀測展示真實 token 計數，並支持可配置閾值告警與本地歷史；界面上各塊數字均標註數據來源，且官方餘額、本地觀測、估算費用、餘額差值四類指標互不相加。

第三方社區插件，與 DeepSeek 官方無關；僅調用公開 API 與 DSH 自身服務，不抓取控制台、不模擬登錄。

這是什麼¶

DeepSeek Usage Monitor 是面向 DSH 0.2.x 的純 ESM 插件（package.json 版本 1.0.0，MIT 許可）。它解決的是「餘額、本進程用量、賬戶級消費推導、按模型估算費用」分開展示與告警的問題，並提供 Agent 工具 deepseek_usage 與已鑑權 HTTP 快照接口，供面板與自動化共用同一套服務邏輯。

• 目錄頁：skillhub.cn/plugins/MinaMiKune/dsh-deepseek-usage-monitor
• 源碼與文檔：github.com/MinaMiKune/dsh-deepseek-usage-monitor

核心功能¶

數據來源與口徑¶

插件在 README 中用表格固定了界面元素與字段標記，核心約定如下：

失敗時可能保留舊值，但會顯式標爲「緩存值」；新鮮度有 實時 / 緩存值 / 未知 等分類。

左欄面板¶

安裝並刷新頁面後，左側欄出現儀表盤圖標，點擊進入「DeepSeek 用量監控」面板。主要區塊包括：賬戶餘額（含通道 API Key / 已登錄賬戶）、今日調用與 token 及估算費用、賬戶消費推導、可切換時間範圍的 Token 用量與按模型明細、活動告警與閾值、以及固定的「數據來源」說明。面板約每 30 秒拉取快照；「刷新」可觸發即時餘額刷新。

Agent 工具與 HTTP¶

工具名 deepseek_usage，常用 action 包括：status、balance、usage（範圍 1h/24h/7d/30d/custom）、refresh、alerts、set_thresholds / reset_thresholds、clear_history（需 confirm: true）。

HTTP（DSH 已鑑權 /api）：

• GET /api/deepseek-usage/snapshot?range=24h
• POST /api/deepseek-usage/refresh，body 如 { "scope": "all" }

告警與本地持久化¶

可配置低餘額、當日估算費用、當日觀測 token、連續失敗次數等閾值；支持告警冷卻與分類型開關。本地狀態默認在 ~/.dsh/deepseek-usage-monitor/（或由 data_dir 指定），含調用記錄與歷史保留策略（默認 history_retention_days: 30）。

環境要求¶

安裝與啓用¶

官方 README 給出的獲取方式有兩種：克隆倉庫，或下載 v1.0.0 Release 中的 dsh-deepseek-usage-monitor-v1.0.0.zip 並解壓。

在 DSH 中安裝該目錄（Plugin Manager → 添加插件 → 本地目錄，或 Agent 工具）：

plugin_manager install_bundle  target = <插件目錄>

安裝會登記 profile、讀取 cordis.patch.yml 註冊 Loader、Host 側註冊工具與 /api 並掛載流式觀測、瀏覽器側註冊側欄與主面板。完成後刷新頁面即可看到側欄圖標。

啓用 / 停用 / 卸載（摘自 README）：

plugin_manager set_plugin  target=include:deepseek-usage-monitor  enabled=false
plugin_manager set_plugin  target=include:deepseek-usage-monitor  enabled=true
plugin_manager remove_bundle  target=@local/dsh-deepseek-usage-monitor

清理數據可刪除 ~/.dsh/deepseek-usage-monitor/（或配置的 data_dir）。修改源碼後 Host 半不參與 HMR，需停用再啓用或重啓 DSH。

快速開始與配置¶

經過上面的安裝步驟後：

1. 點擊側欄圖標進入面板。
2. 若餘額顯示「未配置」：balance_source: auto 下，已登錄 DSH 賬戶可走賬戶錢包；或設置環境變量 DEEPSEEK_API_KEY / DSH credentials。
3. 正常對話即可累積用量——插件在 llm/stream 處被動記錄，不爲此額外發請求。

配置寫在 profile 的 cordis.patch.yml（用戶層覆蓋 bundle 默認），示例：

- id: deepseek-usage-monitor
  name: '@local/dsh-deepseek-usage-monitor'
  config:
    balance_source: auto
    low_balance_threshold: 20
    timezone: Asia/Shanghai

balance_source 取 auto（默認）、api-key 或 account；密鑰優先經 DSH 憑據解析 api_key_env（默認 DEEPSEEK_API_KEY），其次環境變量，不推薦在配置裏寫明文 api_key。Plugins 頁面無表單配置（插件不導出 Cordis Config schema），非法配置項會回退默認並在 configIssues 中可見。

運行期也可用工具調整閾值，例如：

deepseek_usage { "action": "set_thresholds", "thresholds": { "low_balance_threshold": 20 } }

典型用法¶

只看狀態與餘額（Agent）

deepseek_usage { "action": "status" }
deepseek_usage { "action": "balance" }

拉取近 24 小時用量並刷新余額

deepseek_usage { "action": "usage", "range": "24h" }
deepseek_usage { "action": "refresh", "scope": "all" }

面板等價 HTTP（需在已登錄 DSH 的瀏覽器會話或同等鑑權下調用）：

GET /api/deepseek-usage/snapshot?range=24h
POST /api/deepseek-usage/refresh

適用場景與注意¶

適合長期在 DSH 裏跑 DeepSeek 路由、需要同時盯官方賬戶餘額與本機 Harness 真實 token、並希望閾值告警與本地趨勢的用戶。若 profile 通過 deepseek-account 調用模型且不持有 API Key，balance_source: auto 會落到已登錄賬戶錢包，與常見付費賬戶一致。

安裝前請注意：

• 插件以當前 DSH 進程的權限運行；本地觀測不等於賬戶全量用量，跨進程或其它客戶端的消費不會計入 Harness 觀測。
• 社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係；安裝前應自行閱讀倉庫源碼與 MIT 許可證，確認憑據與 api_base_url 指向是否符合你的安全策略。
• 估算費用來自價格表與本地 token，不是賬單；賬戶消費來自餘額快照差值，無法按模型拆分。

結尾¶

DeepSeek Usage Monitor 把官方餘額、Harness 觀測用量、推導消費與估算費用拆開呈現，並統一到側欄、Agent 工具與快照 API，減少 DSH 日常開發裏「餘額和 token 混在一起看」的口徑問題。

• 目錄頁：https://www.skillhub.cn/plugins/MinaMiKune/dsh-deepseek-usage-monitor
• GitHub：https://github.com/MinaMiKune/dsh-deepseek-usage-monitor