前言¶
DSH 生态强调“一切皆插件”；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。对使用 DeepSeek Harness（DSH）的人来说，一个常见需求是在会话或 Web GUI 里直接查看 DeepSeek 账户余额，而不是离开当前工作环境去平台查询。
dsh-balance 是 DeepSeek Harness 插件，提供 /balance 斜杠命令，并在 Web GUI 的 composer-dock 显示实时 DeepSeek 账户余额。本文只根据已核实资料介绍它的功能、安装方式、典型用法和注意事项。
这是什么¶
dsh-balance 由 deepforce 维护，许可证为 MIT。插件仓库名为 deepforce/dsh-balance。
它调用 DeepSeek 官方 Get User Balance 端点，返回按币种的 total、topped-up、granted 余额。
核心功能¶
下面介绍已核实的能力。
/balance斜杠命令：在会话中打印完整余额明细。- Web GUI 显示：在 conversation stats area 显示
Balance: ¥…行，悬停显示topped-up/granted明细。 Top up链接：指向 DeepSeek 平台 top-up 页面。- 手动刷新按钮。
Session ≈ ¥…：显示估算的会话花费，悬停显示token buckets × unit prices。Last {days}d ≈ ¥…：悬停显示最近usageDays天的 SVG 柱状图。- 双语显示：跟随活动 dsh 语言，支持中文 / 英文。
- 浏览器通过宿主
/dsh-balance路由获取公开余额数据，API key 不进入浏览器。
安装与启用¶
先安装插件：
dsh plugin --profile web add github:deepforce/dsh-balance
安装后重启 dsh web，使 client plugin table 加载新条目：
dsh web
经过上面的步骤，插件的宿主侧命令和浏览器侧显示都会进入可用状态。
典型用法¶
在会话 composer 中输入：
/balance
示例输出如下：
Balance (CNY): 110.00
Topped up: 100.00
Granted: 10.00
在 Web GUI 中，composer 下方 stats area 会显示：
Balance: ¥110.00 ⟳
悬停可看到 topped-up / granted 明细，使用 ⟳ 按钮刷新。
配置与估算¶
Session ≈ ¥… 是估算，不是账单记录。它使用配置的 estimateModel 价格，并且 cache-write tokens 不计价。
价格可通过以下配置字段调整：
offpeakPricespeakMultiplierpeakWindows
资料列出的配置项包括：
apiKeyEnv
baseURL
timeoutMs
estimateModel
offpeakPrices
peakMultiplier
peakWindows
topUpUrl
usageDays
其中，usageDays 与 daily-spend chart 的历史天数窗口相关。
安全与权限¶
API key 通过 credential seam 或环境在每次调用时解析，不写入配置、返回文本或浏览器。
资料称插件只调用：
GET https://api.deepseek.com/user/balance
并且没有其他数据离开进程。浏览器通过宿主 /dsh-balance 路由获取公开余额数据。
安装前仍建议检查源码与许可证。插件以当前 dsh 进程权限运行，安装命令执行时等同于在该 DSH 环境中引入新代码。
兼容与构建¶
兼容测试基于 DeepSeek Harness 0.1.0-rc.6（web profile, Windows 11），并于 2026-08-14 验证。
资料称 @deepseek-ai/dsh-* npm 包为 pre-release，无兼容保证；若 dsh 更新影响 conversation.composer.dock slot 或 webServer service，需要重新检查。
本地构建使用 pnpm，并依赖 pnpm-workspace.yaml overrides 解决上游 npm 缺失依赖。
适用场景与注意¶
dsh-balance 适合需要在 DSH 会话或 Web GUI 中查看 DeepSeek 账户余额、Top up 入口和会话花费估算的场景。
不适合把 Session ≈ ¥… 当作账单记录；它只是估算。
如果你从社区目录安装，目录是独立站点，与 DeepSeek / 幻方无官方从属关系。安装前请确认来源，并检查 MIT 许可证是否满足你的使用要求。
小结¶
dsh-balance 的价值在于把 DeepSeek 余额、Top up 入口和会话花费估算放进 DSH 工作流里。
仓库地址为：
https://github.com/deepforce/dsh-balance
当前已核实资料未提供目录页 URL；如需从社区目录检索，请自行确认入口。
