前言¶

在 DSH 网页版里跑模型任务时，经常会需要确认两件事：DeepSeek 账户还剩多少余额，当前会话大概花了多少钱。如果每次都要打开后台、翻日志或手动查账单，会打断正常开发流程。

dsh-deepseek-billing 是一个 DSH WebUI 插件，把 DeepSeek 账户余额和当前会话费用估算放在左侧边栏，方便在对话过程中直接查看。它是社区插件，仓库地址为 https://github.com/Jolly-J/dsh-deepseek-billing，许可证为 MIT。

这是什么¶

dsh-deepseek-billing 的定位是：DSH WebUI 插件，用于在侧边栏显示 DeepSeek 账户余额，并按当前会话估算费用。

当前仓库 package.json 版本为 0.1.0-rc.8。依赖要求如下：

• Node：^22.19.0 或 >=24.0.0
• React peer dependency：^18.2.0

用户安装直接使用仓库内提交的 lib/ 产物，无需本地构建。

核心功能¶

余额显示¶

插件会在 DSH 网页版左侧边栏底部常驻显示 DeepSeek 账户余额。

余额数据直接调用 DeepSeek 官方余额接口，并使用当前模型正在用的同一把 API Key，不需要另外配置一套余额查询密钥。

刷新方式：

• 每 60 秒自动刷新一次
• 也可以手动点击刷新按钮

会话费用估算¶

插件会显示当前会话的费用估算值。

费用统计方式是：按每条成功的助手回复逐条计价，然后累加为会话总额。它不是把所有 token 合成一个总数后再统一乘以某个费率。

展开卡片后，可以看到：

• 充值余额
• 赠送余额
• token 明细
• 缓存命中率
• 输入费用小计
• 输出费用小计
• 当前费率说明

界面行为包括：

• 数字变化时有滚动动画
• 切换会话时自动更新
• 侧边栏收起时自动隐藏

需要特别说明：卡片上的会话费用是估算值，不是账单。余额是唯一真值，卡片费用仅作归因参考。

安装与启用¶

方式一：通过 DSH 插件市场安装¶

在 DSH 网页版插件市场 dsh-market 中搜索 dsh-deepseek-billing，点安装。

装完后重启：

dsh web

方式二：通过命令安装¶

执行：

dsh plugin --profile web add https://github.com/Jolly-J/dsh-deepseek-billing.git

装完后重启：

dsh web

方式三：通过 DSH 智能体安装¶

把仓库地址发给 DSH 智能体，让其执行上面的 dsh plugin --profile web add ... 安装命令，并提示你重启 dsh web。

更新插件¶

执行：

dsh plugin --profile web update dsh-deepseek-billing

更新后重启：

dsh web

典型用法¶

安装完成并重启 dsh web 后，可以按下面方式使用：

1、打开 DSH 网页版，在左侧边栏底部查看 DeepSeek 账户余额和当前会话费用估算。

2、点击卡片展开详情，查看充值/赠送余额、token 明细、缓存命中率、输入/输出费用小计和当前费率说明。

3、切换会话时，卡片会跟随当前会话自动更新费用估算。

4、需要立即查看最新余额时，手动点击刷新按钮。

如果要做开发验证，可以把 deepseek-harness 和 dsh-deepseek-billing 克隆到 DSH monorepo 的扩展目录：

packages/extensions/dsh-deepseek-billing

然后执行：

pnpm install
pnpm run build:lib:host
pnpm --filter dsh-deepseek-billing verify

适用场景与注意¶

这个插件适合以下场景：

• 长期使用 DSH 网页版
• 需要频繁查看 DeepSeek 账户余额
• 希望在当前会话中粗略了解费用变化
• 希望减少打开后台或查询账单的操作

使用前请注意：

• 插件会以当前 dsh 进程权限运行，安装前应检查源码和许可证。
• 会话费用是估算值，不是账单。
• 余额是唯一真值，卡片费用仅作归因参考。
• 卡片不计入失败重试。
• 卡片不计入后台模型调用，例如会话标题生成、联网搜索查询等。
• 卡片不计入 reasoning token。
• 卡片不计入子代理会话用量。
• 费用只统计当前会话，子代理会话暂未汇总。
• 不保存按模型 × 时段的分组明细。
• 界面只显示会话总额与输入/输出小计。
• reasoning token 目前只统计、不计价。
• 价格表内置在代码里，官方调价后需要更新插件版本。
• 官方没有价格查询接口。
• 文案目前是中文。

密钥安全¶

插件不存储、不偷、不外传 API Key。

它只临时使用 DEEPSEEK_API_KEY 调用 DeepSeek 官方余额接口，用完即弃。

密钥的处理范围如下：

• 只在本机插件进程内存里存在一瞬间
• 只放进发往 DeepSeek 官方的请求头 Authorization
• 不进命令行参数
• 不进环境变量
• 不进日志
• 不进入网页接口返回
• 不落盘

已知通用风险包括：

• 同机器、同权限的进程理论上能读取宿主进程内存
• 局域网内能访问 DSH 网页端口的人可以看到余额数字，但看不到密钥

如果对此介意，建议在部署层给 /billing/status 加访问限制。

结尾¶

dsh-deepseek-billing 的价值很具体：在 DSH 网页版侧边栏常驻显示 DeepSeek 账户余额，并给出当前会话费用估算。它不替代账单，只帮助在任务执行过程中快速核对余额和费用归因。

仓库地址：

https://github.com/Jolly-J/dsh-deepseek-billing