前言¶

DeepSeek Harness (DSH) 的插件化設計允許開發者按需擴展功能。在本地運行智能體或進行長時間會話開發時，追蹤單次會話成本和官方賬戶餘額是常見需求。dsh-elegent-balance-tracker 旨在解決這一問題，在輸入框統計行下方與側邊欄設置區域，實時展示這兩個核心指標。

插件介紹¶

名稱：dsh-elegent-balance-tracker
定位：DeepSeek Harness 計費插件：當前會話成本 + 官方賬戶餘額
作者：X-avier-W
許可：MIT
核心價值：提供與官方計價/接口口徑一致的本地成本與餘額追蹤。

核心功能¶

1. 顯示當前會話成本：在輸入框統計行下方顯示費用。根據消息發生時刻（北京時間）選擇官方高峯或空閒價格計算，包含未命中輸入、緩存命中、輸出 token，模型回覆完畢即刷新。
2. 顯示官方賬戶餘額：在側邊欄底部顯示餘額。啓動時獲取準確餘額，之後每分鐘自動對齊官方接口，兩次對齊之間按本機所有會話新增成本實時扣減生成預估餘額。
3. 按高峯/空閒價格計算：支持根據時間自動切換計價檔位。
4. 官方價格自動同步：默認開啓，支持自動抓取官方定價頁，識別新模型與峯谷規則變化。
5. 純本機運行：餘額只請求官方接口（API Key 不出服務器），會話日誌只在本地解析，不上報任何外部服務。
6. 子代理獨立統計：子代理是獨立會話，各自單獨統計。

安裝與啓用¶

通過 npm 渠道安裝插件。安裝後必須重啓 dsh web 才能生效。

dsh plugin --profile web add dsh-elegent-balance-tracker

安裝完成後，刷新瀏覽器頁面即可看到費用與餘額顯示。

配置¶

所有配置均爲可選，在 web profile 的 cordis.patch.yml 中覆蓋（路徑 $DSH_HOME/profiles/web/cordis.patch.yml）。

配置項說明：
- apiKeyRef：餘額查詢用的憑據引用，默認使用 DEEPSEEK_API_KEY。
- priceSync：控制官方計價自動同步的開關與參數。
- priceSchedule：自定義峯谷價表，優先級高於官方同步價。
- prices：手動覆蓋特定模型的單價，優先級高於官方同步價。

配置示例：

- patch:
    - id: dsh-elegent-balance-tracker
      config:
        apiKeyRef: DEEPSEEK_API_KEY
        priceSync:
          enabled: true
          url: "https://api-docs.deepseek.com/zh-cn/quick_start/pricing/"
          intervalMs: 43200000
        priceSchedule:
          - from: "2026-08-17"
            peak:
              deepseek-v4-flash: { input: 3, cacheRead: 0.1, output: 9 }
            idle:
              deepseek-v4-flash: { input: 1.5, cacheRead: 0.05, output: 4.5 }

注意事項¶

1. 累計數據不展示：官方 API 不提供累計充值或累計消費數據，因此插件不展示這些信息，僅展示當前餘額構成。
2. 純本機運行：數據僅存儲於本地，不會向外部服務上報。
3. 子代理統計：子代理是獨立會話，各自單獨統計成本。
4. 重試計入成本：會話日誌中的失敗重試計入成本。
5. 價格優先級：用戶顯式配置 > 官方自動同步 > 內置默認價。

總結¶

該插件通過本地解析日誌和定期同步官方接口，爲 DSH 提供了透明化的成本與餘額管理能力。適合需要精細控制 DeepSeek 調用成本的開發者。插件源碼與目錄可訪問 GitHub 查看。