@fenzhenhua123/dsh-balance-meter：DeepSeek Harness 餘額與費用統計

在 DeepSeek Harness 的開發調試中，API 賬戶餘額與單次會話的費用消耗是高頻關注點。缺乏直觀的統計會導致超支風險或對計費細節不清晰。下面介紹 @fenzhenhua123/dsh-balance-meter 插件，它能在會話頁面底部統計條中直接展示餘額與本次費用。

插件定位¶

這是一個 DeepSeek Harness 插件，由 FenZhenHua 維護。它通過在會話統計條追加膠囊組件，解決了 DSH 原生界面缺乏 API 餘額實時監控和精細化費用統計的問題。

核心功能¶

1. 餘額與本次費用膠囊：在「會話統計」條目旁追加顯示。
2. API 餘額顯示：展示 DeepSeek 開放平臺充值餘額（含贈金），左鍵單擊可查看明細。
3. 本次使用金額：按官方計費方式逐請求精確累計。
4. 本次 Tokens 統計：顯示輸入未緩存 / 緩存讀 / 緩存寫 / 輸出 四桶數據，左鍵單擊可見。
5. 精細化計費：
   • 分模型：支持 deepseek-v4-pro / deepseek-flash。
   • 分緩存：輸入緩存命中 / 緩存未命中+寫入 / 輸出 三檔計費。
   • 分時段：按北京時間峯谷計費，高峯時段價格 = 空閒 × 2。
6. 價格自動刷新：Host 側每 6 小時抓取官方價格頁並解析最新單價。

安裝與啓用¶

1. 執行安裝命令：

   dsh plugin add @fenzhenhua123/dsh-balance-meter

2. 進入「插件」頁，找到「餘額與本次費用」卡片，點擊開關即可啓用/禁用（即時生效，瀏覽器端可能需刷新一次）。

典型用法¶

若官方價格抓取失敗或需調整兜底價格，可編輯 lib/index.js 頂部的 EMBEDDED_PRICING 配置項。配置單位爲人民幣/百萬 tokens（空閒時段），高峯時段會自動乘以 2。

適用場景與注意¶

• 適用場景：需要精確控制 API 預算、監控不同模型（Pro/Flash）及緩存命中率的開發者。
• 注意：
  1. 費用爲基於官方計費規則的估算值，實際扣費以平臺爲準。
  2. 計算在 Host 側逐請求重放會話日誌進行。
  3. 插件以 Host 進程權限運行，安裝前建議查看源碼與許可證（MIT）。
  4. 跨年後需在 lib/index.js 的 CN_WEEKDAY_HOLIDAYS_2026 中更新下一年度日期。

總結¶

該插件通過可視化的膠囊形式，將餘額與計費信息聚合在會話統計條中，便於進行成本控制。更多細節請參考 GitHub 倉庫 或 社區目錄。