前言¶
在 DeepSeek Harness（DSH）裏跑推理和 Agent，難免會關心平臺側的錢包餘額、累計消費和按 API Key 的用量。常規做法是離開 Harness，打開 platform.deepseek.com/usage，重新登錄後再對賬。步驟分散，且本地日誌估算與平臺計費口徑也不一定一致。
下面介紹的插件 dsh-deepseek-usage-overview（維護者 user654name，倉庫 GitHub）是面向 DSH Web GUI 的客戶端類插件：在 Harness 內部註冊爲 shell.overlay 內頁，用 DSH 已登錄的 DeepSeek 平臺賬號拉取與官方用量頁同源的聚合數據，而不是要求複製 Platform userToken，也不從本地會話估算費用。
這是什麼¶
一句話定位：DeepSeek Harness Web 界面裏的內嵌用量面板，展示充值餘額、累計消費、按時間與 API Key 的篩選彙總，以及消費柱狀圖。
- 分類：客戶端（瀏覽器半區 + 宿主半區 bundle）
- 許可證：MIT（見倉庫
LICENSE） - 當前版本（
package.json）：0.1.0 - 前置：
@deepseek-ai/dsh >= 0.2.2，Node.js >= 20；須在「設置 → 賬號與餘額」登錄 DeepSeek 賬號。僅配置推理用DEEPSEEK_API_KEY不足以讓本插件工作。
核心功能¶
打開方式¶
- 側邊欄底部「用量」按鈕（設置按鈕旁；側邊欄收起時僅圖標）
- 設置面板標題欄「用量」按鈕（關閉按鈕旁）
- 窗口右下角約 200 px 區域內雙擊（若安裝了右下角小鯨魚掛件，雙擊鯨魚身體同樣生效）
頁面內容¶
| 區塊 | 說明 |
|---|---|
| 餘額 | 充值餘額、贈送餘額（有則顯示）、餘額預警、「去充值」 |
| 累計消費 | 賬戶幣種的平臺累計消費 |
| 篩選 | 今天 / 昨天 / 近 7 天 / 近 30 天 / 本月；按 API Key 過濾；清除篩選；CSV 導出 |
| 彙總 | 所選時間與 Key 的消費金額、API 請求次數、Tokens |
| 圖表 | 消費柱狀圖（今天按小時、更長區間按天）；可在「調用類型（模型 / 工具）」與「按 API Key」分組間切換 |
UI 跟隨 Harness 明暗主題與語言（中英）；瀏覽器半區爲手寫 window.__ModuleLoader__ bundle，無需單獨構建。
工作原理（簡要）¶
瀏覽器內頁通過 GET /api/deepseek-usage/overview 向本機 DSH Host 取數。宿主半區用 deepseekAccount.getPlatformSession() 取得已登錄憑據，再請求平臺用量頁使用的私有接口（如 get_user_summary、usage/by_api_key/amount 與 cost 等），聚合並緩存 30 秒。響應中不包含賬號 token 或平臺原始敏感載荷，僅聚合數字與 Key 顯示名；路由僅接受本機迴環 GET，非本機返回 403。
安裝與啓用¶
安裝前請自行查看倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，會代表已登錄賬號訪問 platform.deepseek.com 相關接口。
前置：Web GUI 可用，且已在 DSH 中登錄 DeepSeek 平臺賬號。
從 GitHub 安裝（資料原文命令）：
dsh plugin --profile <profile> add github:user654name/dsh-deepseek-usage-overview
從本地目錄安裝：
dsh plugin --profile <profile> add /絕對路徑/dsh-deepseek-usage-overview
常見 profile：桌面端用 desktop，dsh web 用 web。安裝後強制刷新 Web 頁面（Ctrl+F5），避免瀏覽器緩存舊客戶端 bundle。
插件以 bundle 掛載：cordis.patch.yml 掛宿主半區，package.json 的 dsh.client 聲明瀏覽器半區；不需要額外配置項（空 config: {} 即可）。
典型用法¶
- 完成安裝並刷新頁面後，用上述任一入口打開用量內頁。
- 在頂部選擇時間維度，必要時在 API Key 下拉框中只查看某一個 Key。
- 查看餘額、累計消費與彙總卡片；在圖表區切換分組方式閱讀消費趨勢。
- 需要離線對賬時，使用 CSV 導出當前篩選下的明細。
- 若數字與平臺頁略有差異：平臺數據最多延遲約 5 分鐘，頁面另有 30 秒內存緩存，可點刷新；加
refresh=1可繞過緩存（宿主 API 參數，見 README）。
未登錄時頁面顯示本地化「未登錄」；某個私有接口失敗時可能提示「用量明細暫時不可用」，餘額與累計消費仍可能可見。
適用場景與注意¶
適合誰
- 日常在 DSH Web 中開發、調試 Agent，希望不離開界面就對齊 平臺真實計費口徑 的用量與餘額。
- 多 API Key 場景下需要按 Key 看金額、請求次數與 Tokens，並導出 CSV。
務必注意
- 依賴 DeepSeek 賬號登錄，純 API Key、未登錄平臺的場景不支持。
- 上游爲平臺未公開的私有接口，平臺變更可能導致明細降級（餘額 + 累計消費仍可顯示）。
- 僅展示平臺暴露的 CNY / USD 等錢包邏輯；多幣種按 README 說明選取。
- 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立生態信息源，與 DeepSeek / 幻方無官方應用商店從屬關係。
結尾¶
經過上面的步驟，你可以在 DSH 側邊欄或右下角雙擊直接進入用量面板，減少跳轉瀏覽器和二次登錄。進一步細節、FAQ 與已知限制見倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/user654name/dsh-deepseek-usage-overview
- GitHub：https://github.com/user654name/dsh-deepseek-usage-overview
