前言¶

DeepSeek Harness 本身不具備貨幣計費能力。隨着 DeepSeek 在 2026 年調整價格並引入峯谷定價，開發者需要一個工具來追蹤每次模型調用的真實成本。visol-456/dsh-cost-tracker 監聽模型調用完成事件，按 provider 上報的 token 用量折算費用，並將記錄持久化存儲。

核心功能¶

• 監聽與折算：監聽調用完成事件，根據 provider 返回的 token 用量（輸入、輸出、緩存命中、緩存未命中）與價格表實時折算費用。
• 數據持久化：將每次調用記錄保存到本地文件。
• 統計儀表盤：提供三層 UI 展示。
  • 調用級明細：在對話軌跡統計行中顯示本次調用費用。
  • 會話級彙總：在同一統計帶的“會話彙總”卡片中顯示總費用及緩存命中率。
  • 全局統計頁：提供主指標卡、詳細指標卡、趨勢折線圖及請求日誌/Provider 統計/模型統計 tabs。
• 峯谷定價：支持配置不同時段的價格，適配 DeepSeek 的高峯與半價策略。

安裝與啓用¶

1. 通過 npm 安裝：

npm i @visol-456/dsh-cost-tracker

2. 在 cordis.yml 中掛載插件（裸機 node 部署）：

- name: '@visol-456/dsh-cost-tracker'
  config:
    dataDir: /path/to/cost-records  # 可選，默認爲 <DSH_HOME>/cost-tracker

3. 安裝到 web profile（推薦）：

dsh plugin --profile web add @visol-456/dsh-cost-tracker

典型用法¶

• 配置價格表：在會話頁的“使用統計”中進入“價格配置”，修改價格表以支持峯谷定價，或直接修改 cordis.yml 中的 prices 配置。
• 查看數據：訪問會話頁的“使用統計” tab，查看成本趨勢和詳細日誌。

注意事項¶

• 兼容性：僅兼容 DeepSeek Harness 0.1.5-rc.1。
• 純節點運行：如果沒有 webServer，插件仍可在純 node 模式下運行並記錄數據，只是 UI 不可用。
• 數據存儲：數據文件默認存儲在 <DSH_HOME>/cost-tracker/records.l。
• 插件定位：本插件爲“計量/計費”插件，記錄的是實際服務的 provider/model，與負責“路由/容災”的 dsh-llm-fallbacks 插件互補使用。

結語¶

該插件爲 DSH 開發者提供了成本監控能力，設計參考了 CC Switch 的 Usage Statistics 頁面，通過自繪 SVG 圖表實現輕量級統計。更多詳情與源碼請訪問 GitHub。