前言¶
在 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.bundle和dsh.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