在 DeepSeek Harness(DSH)中开发或使用智能体时,监控 API 消耗是控制成本的关键。现有工具往往缺乏精细的会话级或回合级计费视图。该插件直接在 Web 界面中提供了这些数据,无需切换到外部仪表盘。
插件定位¶
这是一个类原生的计费插件,由 rayadesune 维护。它将 DeepSeek 账户的实时余额与估算的会话、回合及今日花费数据集成到 DSH 的界面中,解决了开发者无法在对话上下文中直观了解成本的问题。
核心功能¶
该插件在 DSH 的多个界面位置提供计费信息:
- 会话头部徽章
- 显示账户剩余余额。
- 显示今日跨会话总花费。
- Composer 下方
- 显示本次会话的计费花费。
- 消息操作行
- 在已完成的回合末尾显示静态花费金额。
- 详情面板
- 显示今日 Token 计数和缓存命中率。
- 显示今日会话花费排名。
- 显示未缓存输入、缓存读取、输出的计费桶详情。
安装与配置¶
安装该插件需要满足以下环境依赖:
Node.js ^22.19 || >=24
pnpm@11.7.0
许可证为 MIT。
使用说明¶
- 查看余额与总花费:进入任意会话,会话头部会显示账户余额和今日总花费。余额数据直接来源于
GET /user/balance接口。 - 查看本次会话花费:在 Composer 输入框下方,可以看到本次会话的计费花费。
- 查看回合花费:完成一次对话后,消息操作行末尾会显示该回合的静态花费金额。
- 查看详细统计:打开会话详情面板,查看今日 Token 统计、缓存命中率、花费排名以及具体的输入/缓存/输出计费桶详情。
- 手动刷新:如果需要获取最新的余额数据,可以手动刷新页面。
注意事项¶
- 数据性质:余额是真实的账户数据,但会话、回合和今日花费是基于官方峰/谷费率的估算值,并非账单承诺。
- 空状态与错误:当没有使用记录时,显示 “no usage recorded”;当 API key 无余额或出现错误时,显示 “Balance unavailable”。
- 环境依赖:该插件依赖 Node.js 和 pnpm 的特定版本,安装前请确保环境兼容。