DeepSeek Harness 插件：實時成本與餘額監控

前言¶

DeepSeek Harness (DSH) 是一個用於開發和測試 DeepSeek 模型的工具。在使用 Web UI 進行對話或構建智能體時，開發者通常需要實時關注 API 的調用成本、餘額以及當前的 Token 使用情況。默認的統計行往往只展示基礎數據，難以直觀反映會話期間的“燒錢速率”或賬戶餘額。

下面介紹的 deepseek-cost-usage-status-plugin 是一個專爲 DSH Web UI 設計的插件，它會在對話輸入區下方增加一條彩色的狀態行，用於展示實時的成本、用量、餘額以及當前模型信息。

插件定位¶

這是一個打包好的 Cordis 插件，由開發者 Zenjibad 維護。它作爲 DeepSeek Harness 生態的一部分，不需要複雜的配置即可在 Web UI 中運行，主要解決在開發過程中缺乏直觀成本監控的問題。

核心功能¶

插件提供以下具體功能：

1. 高峯/空閒時段指示

   • 根據官方的北京時間計費窗口（09:00–12:00, 14:00–18:00）自動判斷當前是否爲高峯期。
   • 空閒/非高峯時段顯示爲綠色，高峯時段顯示爲紅色。
   • 時鐘顯示本地時間，但計費邏輯基於北京時間。

2. 會話成本

   • 實時從 llm/stream 流水線中累積 Token 使用量。
   • 使用官方 CNY 定價表計算費用，並自動應用 50% 的非高峯折扣。
   • 費用會根據賬戶貨幣（通常爲 USD）進行自動轉換，確保成本與餘額單位一致。

3. 燒錢速率

   • 計算當前會話的平均每分鐘成本（Cost / 經過的分鐘數），單位與顯示貨幣一致。

4. 賬戶餘額

   • 每 60 秒輪詢 DeepSeek 的 /user/balance 接口獲取餘額。
   • 如果 API Key 不可用或網絡請求失敗，餘額會顯示爲 —，但其他功能不受影響。

5. 當前模型與推理配置

   • 顯示當前正在使用的模型名稱（如 deepseek-v4-flash）及推理強度配置。

6. 樣式匹配

   • 字體大小、顏色與 DSH 自帶的統計行保持一致，視覺上融合爲同一組件。

安裝與啓用¶

插件需要 DSH 版本 0.1.0-rc.6 或更高，並且必須啓用 Web UI。

1. 使用官方 CLI 安裝插件：

    dsh plugin --profile web add deepseek-cost-usage-status-plugin

或者從本地目錄安裝：

    dsh plugin --profile web add ./deepseek-cost-usage-status-plugin

2. 安裝完成後，重啓 DSH。

3. 重啓後，插件會在 conversation.composer.dock 位置渲染一條新的狀態行，與原有的統計行並列。

配置¶

插件支持通過配置文件進行微調，通常通過 cordis.patch.yml 進行設置：

deepseek-cost-usage-status-plugin:
  config:
    fallbackFxRate: 7.2   # 當實時匯率獲取失敗時，使用的固定匯率（CNY per 1 USD）
    fxRefreshMs: 3600000  # 實時匯率刷新間隔（默認 1 小時，最小 60 秒）

注意事項¶

• 環境依賴：必須已配置 DeepSeek Provider，並且 API Key 必須存儲在 ~/.dsh/.credentials.yaml 文件中，名爲 DEEPSEEK_API_KEY。沒有該 Key 時，餘額無法讀取，但會話成本和燒錢速率依然正常計算。
• 計算邏輯：成本和燒錢速率的基礎單位是 CNY，然後再根據賬戶貨幣進行轉換。
• 權限與安全：插件在調用餘額接口時，會將 API Key 通過 curl 命令行的 Header 傳遞，這是當前讀取方式的技術限制。插件本身不會保存或記錄 Key。
• 許可證：插件採用 MIT 許可證。

結語¶

對於需要精細控制 DeepSeek API 成本的開發者，這條額外的狀態行能提供比默認統計更直觀的反饋。它將成本、餘額與當前模型信息聚合在一條線上，方便快速判斷會話開銷和賬戶狀態。