前言¶

在 DeepSeek Harness (DSH) Web UI 中開發智能體時，追蹤每次交互、子代理和整個會話樹的實際成本是成本控制的關鍵。現有的方法往往缺乏這種細粒度的透明度。dsh-chat-cost 插件解決了這個問題，通過實時追蹤並提供基於內置目錄的細分數據，以及一個本地的 JSONL 成本日誌，讓你對代幣使用情況一目瞭然。

核心功能¶

• 多提供商定價：使用內置目錄對 DeepSeek、Moonshot、OpenAI、Anthropic、Google、xAI 和 Mistral 進行定價。
• 會話樹成本細分：顯示單個聊天、子代理和整個會話樹的成本。
• 實時答案成本：在每個回答下方顯示該特定輪次的成本，而不是從會話總數中切片。
• 成本日誌：在項目文件夾中創建一個追加式的 JSONL 成本日誌（.dsh-cost/cost.l），記錄每個會話的位置、代幣桶、累計和增量成本以及定價來源。
• 預算規劃工具：提供一系列命令如 cost_price、cost_history、cost_estimate、cost_plan、cost_mark 和 cost_scenarios 用於預算規劃。
• 多語言支持：支持英語、中文和俄語。

安裝與啓用¶

使用官方命令安裝插件：

dsh plugin --profile web add dsh-chat-cost

安裝後，重啓主機以使插件生效。

典型用法¶

安裝完成後，你需要配置插件設置以寫入日誌並指定語言。

- id: dsh-chat-cost
  name: dsh-chat-cost
  config:
    writeLog: true        # 將 JSONL 成本日誌追加寫入項目文件夾
    logDir: .dsh-cost      # 項目文件夾內的目錄名
    language: zh          # 語言選項：en | zh | ru
    ledgerTailBytes: 2097152  # 每次摘要讀取的成本日誌尾部字節數（默認 2 MiB）

價格目錄是捆綁的，但你可以通過運行以下命令來刷新它以獲取最新價格：

npm run prices

適用場景與注意¶

• 平臺賬單差異：由於服務器端工具調用（如搜索）在會話令牌使用之外計費，平臺的開發票金額可能會高於插件統計的會話金額。插件會列出這些調用，但不會計入內部令牌定價。
• 會話缺失：如果主機在會話中途被殺死，會話的最終幾分鐘可能會丟失，插件將從最新的檢查點進行定價。
• 檢查點定價：從檢查點讀取的令牌使用量按讀取時的費率計費。
• 長上下文層級定價：某些 Gemini 和 Grok 模型的長上下文層級價格尚未應用。
• 許可證：該插件使用 MIT 許可證。在安裝前檢查源代碼和許可證。

結尾¶

dsh-chat-cost 提供了智能體開發中成本透明度的基礎設施。通過將成本細分爲會話樹和子代理，開發者可以做出更好的資源規劃決策。更多信息和源代碼可在 GitHub 上找到。