前言¶

在 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 上找到。