dsh-balance-monitor：DSH 左側欄實時 API 餘額與消耗監控

DSH（DeepSeek Harness）插件生態強調“一切皆插件”。在開發智能體或調用 API 時，最常見的問題之一是消耗不可見：賬號餘額剩多少、今日用了多少、會不會突然超額。現有的做法要麼依賴網頁端手動刷新，要麼缺乏對消耗上限的主動攔截。dsh-balance-monitor 將這些數據直接接入 DSH 左側工作欄，提供整頁面板與側邊欄小組件。

插件概況¶

這是一個 DS H 插件，目標是在左側任務欄實時顯示 API 賬戶餘額。它支持多平臺餘額檢測、峯谷計價、會話與每日消耗統計，並提供可配置的消耗上限。插件適配 Web 端與桌面端，代碼運行在同一份邏輯上。作者爲 ConTr0L0，類別爲聯網工具，採用 MIT 許可證。

核心能力¶

左側欄整頁面板與小組件
- 插件會在左側欄新增“餘額監控”入口（排在插件/使用統計之間）。
- 點擊該入口，會在主區整頁渲染完整面板，包含餘額、統計圖表、上限設置等。
- 側邊欄底部小組件實時顯示賬戶餘額、今日消耗、上限進度與峯谷狀態。
多平臺餘額檢測
- 支持的平臺包括 DeepSeek 官方（賬號登錄或 API Key）、智譜 GLM、OpenRouter 和 Tavily。
- DeepSeek 官方支持通過已登錄賬號讀取（Platform 錢包：充值 + 贈金），無需 API Key。
- 設置中可選擇餘額來源優先級：自動（賬號優先，未登錄回退 API Key）、僅賬號登錄、僅 API Key。
峯谷計價與自動同步
- 插件內置 DeepSeek 官方規則：北京時間週一至週五 9:00-12:00、14:00-18:00 爲高峯；週末及中國法定節假日全天爲谷時（谷時半價）。
- 價目表由插件自動從 DeepSeek 官方文檔同步並每日驗證，無需手動配置。
- 請求按實際發生時間計算價格，同步失敗時回退到內置默認價目。
消耗統計與圖表
- 支持近 7 天消耗柱狀圖、每日 Token 堆疊圖（7/14/30 天，可按模型篩選）。
- 提供消耗熱力圖（30 天/90 天/一年），按計價金額着色，懸停查看金額與 Token。
- 展示全部會話消耗列表，按最近排序。
消耗上限與攔截
- 支持三類消耗上限：每日金額、累計金額、LLM 請求次數。
- 可配置超限行爲：僅提醒或提醒並終止。
- 選擇“提醒並終止”時，服務端會在後續 LLM 請求發生時進行攔截並返回明確報錯。

安裝與啓用¶

安裝前需確認 DSH 版本不低於 0.2.0-rc.2。安裝後必須完全退出並重啓 DSH（桌面端需從托盤 Quit，瀏覽器版需刷新頁面）。

安裝命令¶

dsh plugin --profile web add github:ConTr0L0/dsh-balance-monitor

桌面端注意事項¶

桌面端使用保留的 desktop profile，CLI 命令無法直接管理。請通過 DSH 應用內的 插件頁 → Add plugin → 填寫本地目錄路徑 進行安裝。

典型用法¶

打開面板：在左側欄點擊“餘額監控”打開完整面板。
配置 Key：在面板中填寫各平臺的 API Key（支持掩碼顯示，值不經過客戶端）。
調整刷新：選擇刷新頻率（5s / 30s / 60s）。
設置上限：進入設置頁，配置三類消耗上限及超限行爲。
查看詳情：點擊側邊欄小組件或面板中的餘額數字，可切換平臺並查看詳細的消耗圖表與列表。

計費與數據說明¶

數據來源：DSH 會話日誌（session.l.zstd 等）。插件按 assistant/message 的唯一 message.id 去重後再計費。
計算邏輯：每次 LLM 請求根據輸入/輸出/緩存命中分別計價。價格根據請求時間判斷是否爲高峯，高峯按原價，谷時（週末/節假日）乘以 0.5。
模型與供應商：收錄 DSH 日誌中所有供應商的 usage。DeepSeek 官方按官方價目計費，其他供應商僅統計 Token。
價目同步：插件每日自動驗證並更新價目表（源：DeepSeek 官方文檔頁）。

技術與架構¶

服務端：位於 lib/index.js，負責會話日誌解析、餘額輪詢、上限攔截。
RPC 通道：位於 lib/rpc.js，通過 POST /dsh-balance-monitor/<endpoint> 前綴路由提供服務，帶 Host/Origin 校驗。
客戶端：位於 lib/client.js，註冊了 sidebar.panellist、main 和 sidebar.footer.action 三個插槽。
存儲：狀態存儲於 $DSH_HOME/storages/dsh-balance-monitor/state.json，偏好存儲於 prefs.json，均爲原子寫入。

生態背景¶

DSH 理念爲“一切皆插件”。本插件收錄於社區目錄，與 DeepSeek 官方無從屬關係。安裝前建議檢查源碼與許可證。

參考鏈接¶

GitHub 倉庫：https://github.com/ConTr0L0/dsh-balance-monitor
社區目錄：https://www.skillhub.cn/plugins/ConTr0L0/dsh-balance-monitor