前言¶
在 DSH 的 Web UI 里做会话或智能体调试时，花费、余额、缓存命中和 Token 用量通常分散在不同位置。dsh-cost-balance 把这类统计放在输入框下方：默认是一条居中的小黑条，点击后展开半透明多行面板。DSH 插件体系强调“一切皆插件”，该插件可作为 web profile 的统计入口接入。
下面介绍它的定位、功能、安装方式和注意事项。
这是什么¶
dsh-cost-balance 是一个 DeepSeek Harness（DSH）Web UI 插件，维护者为 zoumutou，许可证为 MIT。
它注册在 conversation.composer.dock 槽位，接管 shipped 的 stats 单元格，在输入框下方展示统计。
插件分为客户端与 Host 两部分：客户端负责折叠/展开 UI，并通过同源接口读取数据；Host 负责注册路由、计算花费、获取余额。
核心功能¶
展示内容¶
默认折叠为一条居中的小黑条，类似 iOS 底部横条。点击后可展开毛玻璃面板，查看：
- 轮次 / 步数
- LLM 耗时 / 工具调用
- 首 token 平均 / 吞吐
- 缓存命中
- Token 输入 / 输出
- 会话花费
- 账户余额
余额显示为 DeepSeek 账户实时余额，60s 自动刷新。
数据来源与刷新¶
客户端通过同源 GET /api/cost-balance 读取数据，每 60 秒自动刷新；当 token 用量变化时即时重算。
Host 半经 webServer 注册 /api/cost-balance 路由。花费按会话累计 token 乘以模型单价计算。余额经 credentials 服务解析 DEEPSEEK_API_KEY 后调用 DeepSeek 官方 GET /user/balance，有 60s 缓存，失败后有 30s 抑制。
余额取自用户自己的 API Key 账户，无需额外配置；未配置或抓取失败时面板显示：
余额 --
内置 DeepSeek 官方定价，覆盖 deepseek-v4-flash 与 deepseek-v4-pro 的缓存命中、缓存未命中、输出价格。
README 提到 DeepSeek 自 2026-08-16 16:00 UTC 起切换峰谷计费，off-peak 为 peak 的一半。
安装与启用¶
npm 发布版¶
先执行安装命令，把插件加入 web profile：
dsh plugin --profile web add dsh-cost-balance
该命令从 npm registry 拉取已发布的 dsh-cost-balance（dsh.bundle），并加入 profile 的 bundle 层。
然后重启（或刷新）DSH Web UI。经过上面的步骤，输入框下方会出现默认折叠的小黑条，点击可展开统计面板。
卸载命令如下：
dsh plugin --profile web remove dsh-cost-balance
源码安装¶
如果是开发或本地调试，先克隆仓库，再进入目录，最后把当前目录作为插件加入 web profile：
git clone https://github.com/zoumutou/dsh-cost-balance.git
cd dsh-cost-balance
dsh plugin --profile web add .
仓库 package.json 中当前 version 为 0.1.0。
发布新版本时，先修改 package.json 的 version，再执行 npm publish；账号需要 2FA 绕过 token，见 npm 文档。
定价覆盖¶
当 DeepSeek 计费调整时，可以在 profile 的 cordis.patch.yml 中覆盖 prices 配置，而不必等待插件更新。
覆盖项需要保留插件 ID，并在 config.prices 下配置目标模型的价格字段：
- id: cost-balance
config:
prices:
deepseek-v4-flash:
# 按需填写 cacheHit / cacheMiss / output
deepseek-v4-pro:
# 按需填写 cacheHit / cacheMiss / output
覆盖是整行替换，务必保留 id: cost-balance。
适用场景与注意¶
适合在 DSH Web UI 中快速查看会话花费、账户余额、缓存命中与 Token 用量的使用者。
使用前注意：
- 插件以当前 dsh 进程权限运行，Host 半会注册路由并调用接口，安装前应检查源码与 MIT 许可证。
- 余额依赖
DEEPSEEK_API_KEY；未配置或抓取失败时显示余额 --。 - 定价覆盖为整行替换，修改配置时务必保留
id: cost-balance。
相关链接¶
该插件把花费、余额、缓存命中与 Token 用量集中到输入框下方，适合作为 DSH web profile 的轻量统计入口。
GitHub：
- https://github.com/zoumutou/dsh-cost-balance
目录页线索：
- https://www.skillhub.cn/plugins/zoumutou/dsh-cost-balance
目录页为独立站点线索，不代表 DeepSeek 或幻方官方应用商店。
