dsh-token-price:为 DeepSeek Harness Web 聊天界面显示 Token 花费与账户余额

前言

在 DeepSeek Harness(DSH)的 Web 聊天界面里,请求已经产生 Token 用量,但花费金额和账户余额不一定直接可见。对于在 DSH 上做智能体开发的同行,dsh-token-price 插件主要解决这件事:把每轮回复的花费、会话总花费和账户余额显示在 Web UI 中。

DSH 的理念是「一切皆插件」。这里的插件目录页是独立站点,不是官方应用商店。

插件定位

dsh-token-price 是 DSH 客户端插件,由 spoon-man569 维护,许可证为 MIT。它为 DeepSeek Harness Web 聊天界面提供准确的 Token 花费与账户余额显示。

核心功能

  • 显示每轮 assistant 回复的 token 花费,以 ¥ 展示,并在统计行悬停时可见。
  • 显示会话总花费,包含已取消但产生 usage 的请求步骤。
  • 显示基于 USD/CNY 市场汇率的估算人民币金额;USD 不在 UI 中渲染。
  • 显示官方 GET /user/balance 返回的账户余额,优先使用返回的 CNY 余额。
  • 通过 dsh.bundledsh.client 同时激活宿主服务与浏览器展示。
  • 未知 provider/model 路由显示为“未定价”,不显示为零成本。

安装与启用

安装命令需要 pnpm。执行:

dsh plugin --profile web add dsh-token-price

上面的命令用于给 DSH Web profile 添加 dsh-token-price。插件会同时激活宿主服务与浏览器展示。

配置示例

token-price 插件可以配置以下项:

- id: token-price
  name: dsh-token-price
  config:
    balanceBaseURL: <余额接口地址>
    balanceApiKeyEnv: <保存 DeepSeek API 密钥的环境变量名>
    balanceRefreshIntervalMs: <余额刷新间隔,毫秒>
    referenceRateRefreshIntervalMs: <参考汇率刷新间隔,毫秒>
    requestTimeoutMs: <请求超时,毫秒>

其中 balanceApiKeyEnv 指定保存 DeepSeek API 密钥的环境变量,密钥保留在宿主端。余额刷新失败时,保留最后一次余额样本。

估算口径

这里的 ¥ 金额是基于 USD/CNY 市场汇率的估算值,不是账户扣款,也不是官方 per-request 收费。未知 provider/model 路由会显示为“未定价”,不会作为零成本金额展示。

开发与构建

开发时运行:

npm install
npm test

npm test 会构建 lib/、生成类型声明并运行会计测试。重新构建后,需要重启 DSH Web 进程以加载新产物。运行环境要求 Node >=18

适用场景与注意

适合在 DSH Web 聊天界面查看 Token 花费和账户余额的开发者或使用者。插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。

链接

  • 插件目录页:https://www.skillhub.cn/plugins/spoon-man569/dsh-token-price
  • GitHub:https://github.com/spoon-man569/dsh-token-price
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye