前言¶

DeepSeek Harness (DSH) 的插件化设计允许开发者按需扩展功能。在本地运行智能体或进行长时间会话开发时，追踪单次会话成本和官方账户余额是常见需求。dsh-elegent-balance-tracker 旨在解决这一问题，在输入框统计行下方与侧边栏设置区域，实时展示这两个核心指标。

插件介绍¶

名称：dsh-elegent-balance-tracker
定位：DeepSeek Harness 计费插件：当前会话成本 + 官方账户余额
作者：X-avier-W
许可：MIT
核心价值：提供与官方计价/接口口径一致的本地成本与余额追踪。

核心功能¶

1. 显示当前会话成本：在输入框统计行下方显示费用。根据消息发生时刻（北京时间）选择官方高峰或空闲价格计算，包含未命中输入、缓存命中、输出 token，模型回复完毕即刷新。
2. 显示官方账户余额：在侧边栏底部显示余额。启动时获取准确余额，之后每分钟自动对齐官方接口，两次对齐之间按本机所有会话新增成本实时扣减生成预估余额。
3. 按高峰/空闲价格计算：支持根据时间自动切换计价档位。
4. 官方价格自动同步：默认开启，支持自动抓取官方定价页，识别新模型与峰谷规则变化。
5. 纯本机运行：余额只请求官方接口（API Key 不出服务器），会话日志只在本地解析，不上报任何外部服务。
6. 子代理独立统计：子代理是独立会话，各自单独统计。

安装与启用¶

通过 npm 渠道安装插件。安装后必须重启 dsh web 才能生效。

dsh plugin --profile web add dsh-elegent-balance-tracker

安装完成后，刷新浏览器页面即可看到费用与余额显示。

配置¶

所有配置均为可选，在 web profile 的 cordis.patch.yml 中覆盖（路径 $DSH_HOME/profiles/web/cordis.patch.yml）。

配置项说明：
- apiKeyRef：余额查询用的凭据引用，默认使用 DEEPSEEK_API_KEY。
- priceSync：控制官方计价自动同步的开关与参数。
- priceSchedule：自定义峰谷价表，优先级高于官方同步价。
- prices：手动覆盖特定模型的单价，优先级高于官方同步价。

配置示例：

- patch:
    - id: dsh-elegent-balance-tracker
      config:
        apiKeyRef: DEEPSEEK_API_KEY
        priceSync:
          enabled: true
          url: "https://api-docs.deepseek.com/zh-cn/quick_start/pricing/"
          intervalMs: 43200000
        priceSchedule:
          - from: "2026-08-17"
            peak:
              deepseek-v4-flash: { input: 3, cacheRead: 0.1, output: 9 }
            idle:
              deepseek-v4-flash: { input: 1.5, cacheRead: 0.05, output: 4.5 }

注意事项¶

1. 累计数据不展示：官方 API 不提供累计充值或累计消费数据，因此插件不展示这些信息，仅展示当前余额构成。
2. 纯本机运行：数据仅存储于本地，不会向外部服务上报。
3. 子代理统计：子代理是独立会话，各自单独统计成本。
4. 重试计入成本：会话日志中的失败重试计入成本。
5. 价格优先级：用户显式配置 > 官方自动同步 > 内置默认价。

总结¶

该插件通过本地解析日志和定期同步官方接口，为 DSH 提供了透明化的成本与余额管理能力。适合需要精细控制 DeepSeek 调用成本的开发者。插件源码与目录可访问 GitHub 查看。