前言¶
使用 DeepSeek Harness Web 跑会话时，常见的需求是把几类信息放在一起看：当前 DeepSeek 账户还有多少余额、本次会话大约花了多少、近期累计花了多少、不同模型消耗了多少 token。这些信息分散在 DeepSeek 平台、Harness 本地日志和手动统计中，不方便直接查看。
下面介绍 dsh-balance-stats。它是 DeepSeek Harness Web 的一个社区插件，由 pangzi499 维护，采用 MIT 许可证。它会在 Harness Web 中提供余额、当前会话成本估算、用量明细，以及可选的发票摘要导入。
这是什么¶
dsh-balance-stats 的定位是：DeepSeek Harness Web 的余额和用量统计插件。
它解决的核心问题是：在 Harness Web 界面里集中查看 DeepSeek 余额、当前会话成本、历史花费、模型消耗和 token 用量，并支持通过导入发票信息计算更贴近账本口径的总花费。
需要注意：这是社区插件，不是官方 @deepseek-ai 插件。
核心功能¶
余额展示¶
插件会读取官方 DeepSeek balance API，并展示可用余额、充值余额和赠送余额。
当前会话成本估算¶
插件会通过 balanceStatsSessionCost 投影，实时估算当前活跃会话的成本。这里的 scope 绑定在 composer 上。
总花费展示¶
导入发票后，插件会使用基于账本的百分比展示总花费。没有导入发票时，会回退到 Harness 本地估算。
明细卡片¶
点击状态栏可以打开明细卡片。卡片中会展示：
- 今日花费
- 最近 7 天 / 30 天花费
- 按模型划分的花费
- token 用量
- 更新时间
- 发票导入入口
发票导入¶
插件支持两种发票导入方式：
- 自动导入：在明细卡片中保存平台
userToken后，插件会按计划重新获取发票。 - 一次性 JSON 导入：手动粘贴
get_all_invoice响应 JSON，作为回退方式。
自动导入支持凭据持久化，也支持一键清除。
容错与刷新¶
当请求失败时，插件会保留最近一次成功获取的余额或发票信息。插件也支持按可配置间隔刷新数据。
安装与启用¶
安装前，先确认 Node.js 和 pnpm 可用：
node -v
pnpm --version
要求 Node.js >=22.19.0，并且 pnpm 在 PATH 中可用。
确认环境后，执行下面的命令安装插件：
npx @deepseek-ai/dsh plugin --profile web add https://github.com/pangzi499/dsh-balance-stats.git
安装完成后，启动或重启 Harness Web：
npx @deepseek-ai/dsh web
启动后，在浏览器中做一次硬刷新，再查看 Harness Web 中的插件入口。
如果要更新插件，执行：
npx @deepseek-ai/dsh plugin --profile web update dsh-balance-stats
典型用法¶
打开明细卡片¶
安装并刷新页面后，点击插件提供的状态栏，即可打开明细卡片。
卡片中可以看到余额构成、账单摘要、按模型花费、token 用量，以及发票导入相关配置。
使用自动发票导入¶
如果使用自动导入，按下面步骤操作：
- 打开明细卡片。
- 粘贴平台
userToken。 - 点击 Save。
保存后，插件会按计划重新获取发票。凭据会写入本地 Harness credentials 文件：
~/.dsh/.credentials.yaml
写入权限为 0600。
在明细卡片中也可以一键清除已保存的凭据。
使用手动 JSON 导入¶
如果不想保存 userToken，可以使用一次性 JSON 导入：
- 在明细卡片中展开 Advanced。
- 粘贴完整的
get_all_invoiceJSON 响应。 - 执行导入。
手动粘贴的 JSON 只在内存中解析。浏览器端 localStorage 回退摘要只保存聚合信息，不保存订单明细。
通过凭据配置 token¶
除了手动粘贴，也可以通过 Harness 凭据或配置项提供 token：
DEEPSEEK_PLATFORM_TOKEN
也可以在：
cordis.patch.yml
中配置：
platformToken
或者使用同名环境变量。
适用场景与注意¶
适合谁¶
如果你已经在用 DeepSeek Harness Web，并且希望在同一个界面里查看：
- DeepSeek 余额
- 当前会话成本估算
- 最近 7 天 / 30 天花费
- 按模型花费
- token 用量
- 发票导入后的总花费
那么 dsh-balance-stats 比较适合。
注意事项¶
- 这是社区插件，不是官方
@deepseek-ai插件。 - 插件要求 Node.js
>=22.19.0，并且pnpm在PATH中可用。 - 该插件在 DeepSeek Harness
0.1.0-rc.6到0.1.1-rc.1范围内测试过。 - DeepSeek Harness 目前处于 developer preview，插件使用的 client API 或挂载点可能在后续版本中变化。
- 默认情况下，插件不会请求
get_all_invoice，也不会保存 DeepSeek Platform 凭据。 - 只有显式保存
userToken后，插件才会写入本地凭据文件：
~/.dsh/.credentials.yaml
文件权限为 0600。
- 插件不接受或保存 DeepSeek Platform cookies。token 只会发送到：
platform.deepseek.com
get_all_invoice是私有、需认证的 DeepSeek Platform 接口，响应格式可能变化。- 只有
payment_order_status为SUCCESS的充值订单会被计入；有效赠送订单会单独累计。 - DSH 插件会随当前
dsh进程运行，安装前应先检查源码与许可证。该插件为 MIT 许可证。
小结¶
dsh-balance-stats 把 DeepSeek 余额、当前会话成本、模型用量和发票导入集中到 DeepSeek Harness Web 中，适合希望在 Harness 界面里做日常成本查看的人使用。
GitHub 仓库：
https://github.com/pangzi499/dsh-balance-stats
