前言¶
在使用 DeepSeek Harness (DSH) 進行開發或日常交互時，實時掌握賬戶餘額和模型調用消耗至關重要。本插件旨在提供這些信息，通過顯示餘額、模型消耗量及官方高峯/空閒定價，幫助用戶控制成本。
它是什麼¶
dsh-balance-and-cost 是 DeepSeek Harness (DSH) 的一個標準客戶端插件。
- 維護者：boooooooer
- 類別：客戶端
- 許可證：MIT
- 核心價值：顯示 DeepSeek 賬戶餘額、模型消耗量及官方分時段定價。
核心功能¶
該插件具備以下功能：
-
餘額查詢
通過api.deepseek.com/user/balance接口查詢餘額，顯示總餘額 / 充值 / 贈送 / 可用狀態。接口端返回 60 秒緩存。 -
消耗量統計
監聽llm/stream事件，實時累計 DeepSeek 模型調用。按官方三檔口徑統計（輸入·緩存未命中 / 緩存命中 / 輸出），區分總計與當前會話，數字按 M/K 縮略。 -
按模型計價
根據實際調用的模型匹配官方價格表（支持版本後綴如deepseek-v4-pro-0813前綴匹配）；未收錄模型按deepseek-v4-flash估算。 -
分時段計價
區分高峯時段與空閒時段定價。高峯時段爲北京時間 9:00-12:00、14:00-18:00，其餘爲空閒時段（價格約爲高峯一半）。 -
會話明細
在插件中心查看按模型和按會話的統計，每個會話顯示真實標題、總計行與分模型行。 -
三檔懸停
在主頁摘要條懸停 token 數字，查看三檔明細（含各檔費用）；懸停模型名查看兩個主要模型（flash/pro）的實際消耗對比。 -
導出明細
支持一鍵導出 CSV 文件（按模型 + 按會話，三檔口徑，帶 BOM 可直接用 Excel 打開）。 -
重置記錄
一鍵清空全部統計、餘額基線與緩存，支持持久化落盤。 -
持久化
統計數據保存在$DSH_HOME/dsh-balance-and-cost.json，進程重啓後自動恢復。 -
實時更新
通過 SSE 實時推送用量變化，瀏覽器立即刷新；15 秒輪詢作爲斷連兜底。
安裝與啓用¶
通過命令行安裝插件：
dsh plugin --profile web add github:boooooooer/dsh-balance-and-cost
安裝後需要重啓 dsh 以加載插件。
使用示例¶
- 主頁摘要條：在輸入框下方顯示
DeepSeek 餘額 ¥xx.xx CNY · 本會話（模型） xx.xM tok ≈¥x.xxx · 總計 xx.xM tok ≈¥x.xxx · [高峯/空閒]。模型名跟隨會話最近調用，費用從安裝或重置記錄起計算。 - 懸停查看：鼠標懸停在 token 數字上，顯示輸入·緩存未命中 / 緩存命中 / 輸出的三檔明細。
- 插件中心：進入「設置 → 插件」的「DeepSeek 用量」標籤頁，查看餘額明細、按模型/會話統計、導出 CSV。
注意事項¶
- 統計範圍：插件只統計 provider 含
deepseek的模型調用（例如deepseek-official路由）。 - 費用估算：顯示的費用爲估算值（官方單價 × token 用量），實際扣費以 DeepSeek 賬單爲準。
- 重放調用：重放（replay）的模型調用可能重複計入。
- 會話模型顯示：會話顯示的是最近調用模型的名稱，而非當前選中但未調用的模型。
生態背景¶
DeepSeek Harness (DSH) 採用「一切皆插件」的理念。本插件由社區開發者維護，與 DeepSeek / 幻方無官方從屬關係。
