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 成本的开发者，这条额外的状态行能提供比默认统计更直观的反馈。它将成本、余额与当前模型信息聚合在一条线上，方便快速判断会话开销和账户状态。