DeepSeek Harness（DSH）是用於智能體開發的客戶端工具，但在實際使用中，開發者往往難以實時掌握賬戶餘額的精確變動以及每一步請求的消耗細節。官方賬單通常存在滯後，且無法提供逐條請求的明細分析。
dsh-balance-stats 是一個爲 DSH 提供的客戶端插件。它通過讀取本地會話日誌，結合內置的官方定價規則，實時計算並展示餘額、續航時間以及詳細的消耗明細。插件基於 MIT 協議開源，API 密鑰僅存儲於本地，瀏覽器無法接觸，確保了使用安全。
功能¶
該插件主要提供以下能力：
- KPI 盤頭：在右上角懸浮膠囊和設置頁頂部展示餘額、續航、今日/本月/本會話的消耗情況。
- 預算制動：支持設置每日預算上限，當今日消耗超過閾值時，通過顏色變化（黃/紅）進行提示。
- 緩存命中率健康提示：當緩存命中率低於 50% 時，自動彈窗警告，提示用戶優化緩存策略。
- 計算步驟明細：逐條列出每一筆費用的計算過程，與官方賬單對賬，包含輸入、輸出、緩存命中/未命中的分項統計。
- 官方定價與扣費規則：內置官方價格表，包含峯谷計價規則，並提供直達官方定價頁的鏈接。
- 會話明細：支持按工作區、時間（全部/今天/昨天/本週/本月）以及標題或 ID 進行篩選。
- 歷史會話完整統計：磁盤上持久化的舊會話也會納入統計，而非僅限於最近打開的會話。
- 差額說明：解釋本地統計與官方賬單之間幾毛錢差值的來源（主要是標題生成和網頁搜索）。
- 六項進階能力：包括錯峯省錢建議、最貴請求排行、工作區成本排行、對賬閉環、定價快照自檢以及本會話實時花費。
安裝¶
確保已安裝 DSH 並配置好環境變量。在終端中執行以下命令安裝插件：
dsh plugin --profile web add "C:\dsh-plugins\dsh-balance-stats"
安裝完成後，重啓 dsh web 並刷新瀏覽器即可使用。
典型用法¶
- 查看核心指標：在設置頁的“餘額與消耗”頂部查看四個大數字卡片，或點擊右上角懸浮膠囊查看續航、今日、本月及本會話花費。
- 設置預算：在設置中配置每日預算上限，查看進度條變化。
- 篩選會話：使用工作區下拉菜單、時間篩選器以及標題或 ID 搜索功能，快速定位特定會話的消耗情況。
注意事項¶
- 數據差異：由於插件無法統計“標題生成”和“網頁搜索”這兩類本地日誌不記錄的調用，本地統計與官方賬單通常存在幾毛錢的差值。
- 啓動耗時：首次打開面板時，需要等待幾秒鐘掃描歷史會話。
- 時間判斷：峯谷時段的歸屬依據本地記錄的事件時間判斷，可能與官方歸賬存在極少數秒級偏差。
結語¶
dsh-balance-stats 通過本地化計算和實時監控，幫助開發者更精確地控制 DeepSeek 賬戶的消耗。插件維護者提供了 GitHub 倉庫和 SkillHub 目錄頁供查閱。
