前言¶
在 DeepSeek Harness (DSH) 的開發流程中，官方界面通常只提供總餘額，缺乏對當前會話消費的實時感知。本地估算 token 數量往往不夠準確，且無法直接對賬。dsh-balance-meter 在 DSH Web 界面底部（輸入框下方、官方統計膠囊那一行）常駐一行標註，實時顯示充值餘額和本次會話消費。
是什麼¶
該插件由 Amo-aibiancheng 維護，遵循 MIT 許可證。它是一個客戶端插件，直接讀取官方賬號服務的餘額數據（deepseekAccount.getBalance），通過賬戶餘額差值測量本次會話的消費，而非依賴本地 token 估算。
核心功能¶
-
常駐標註
在 DSH Web 界面底部顯示一行標註，格式爲“餘額 ¥XX · 本次 ¥YY”。 -
實時數據
- 充值餘額：取自官方賬號服務，與官方賬戶卡片一致，贈金餘額不併在一起。
- 本次消費：按賬戶餘額差測量得出，餘額上升（充值/贈送/退款）不計爲消費。
-
明細展開
點擊標註可展開明細麪板，查看充值餘額、贈金餘額、餘額採樣時間、本次消費、觀測窗口、期間充值、係數校驗等信息。點擊同時會立即刷新一次餘額。 -
防重複計費
插件會丟棄重複讀取的餘額，防止同一筆消費被重複計算。 -
配置熱更新
所有配置修改無需重啓 dsh 即可生效。
安裝與啓用¶
使用官方命令安裝插件。將 <profile> 替換爲你實際使用的配置文件名（如 desktop、web），並將 /絕對路徑 替換爲插件的實際目錄路徑。
dsh plugin --profile <profile> add link:/絕對路徑/dsh-balance-meter
安裝完成後，重啓 dsh 並刷新頁面即可看到底部標註。
配置項¶
配置位於 profile 的 cordis.patch.yml 文件中對應插件的 config: 字段。全部參數均有默認值：
pollIntervalMs：餘額採樣間隔（5000 – 1800000）。requestTimeoutMs：單次餘額查詢超時（3000 – 120000）。anomalyRatio：單次跌幅超過餘額的比例時，視爲賬號事件，不計入會話。showTokenCrossCheck：是否在明細裏顯示 token 折算的交叉校驗。price：僅供交叉校驗使用的單價配置。
算法與邏輯¶
本次消費的計算邏輯基於賬戶餘額的觀測序列：
本次消費 = Σ max(0, 上一次觀測餘額 − 這一次觀測餘額)
- 上升處理：餘額上升的那次觀測不計爲消費，記爲“期間充值”，並抬升基準。
- 亂序處理：觀測亂序到達時，插入時間線正確位置；“當前餘額”始終取最新觀測。
- 異常處理：單次跌幅超過餘額 50% 時，視爲賬號事件（如贈送到期），重新取基準。
- 失敗處理：餘額讀取失敗時記爲不可讀，絕不當成 0。
注意事項¶
- 採樣合併：採樣是輪詢的，兩次採樣之間的賬會被合併。
- 多端共享：多窗口或多臺機器使用同一賬號時，“本次消費”會偏大，因爲使用了共享累加器。
- Token 折算：Token 折算僅用於交叉校驗，不是主數字。
- 贈金顯示：贈金與充值餘額分開顯示，不併在一起。
鏈接¶
- GitHub: https://github.com/Amo-aibiancheng/dsh-balance-meter
- 生態目錄: https://www.skillhub.cn/plugins/Amo-aibiancheng/dsh-balance-meter
