前言¶
在 DSH Web 中使用 DeepSeek 时，账户余额、当前会话模型、token 用量通常需要离开当前会话另行查看。下面介绍一个社区插件：它在会话头部增加余额按钮，点击下拉查看账户余额、当前会话模型、实时 token 用量，并按 DeepSeek 官方价目表估算费用。
DSH 的理念是「一切皆插件」。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。这个插件适合已经在使用 DSH Web 和 DeepSeek API 的开发者。
这是什么¶
lmmzss-jk/dsh-plugin-balance 是 DeepSeek Harness（DSH）的 Web 插件，由 lmmzss-jk 维护，许可证为 MIT。
安装名为：
@lmmzss/dsh-plugin-balance
仓库地址为：
https://github.com/lmmzss-jk/dsh-plugin-balance
它复用 DSH 已配置的 DEEPSEEK_API_KEY，属于零配置。插件把账户余额、当前会话的模型与 token 用量放进会话头部，减少在会话过程中反复切出去查账的步骤。
核心功能¶
会话头部余额按钮¶
- 按钮位于原生
Session log按钮左侧。 - 客户端注册到
conversation.session.header.utilities槽位，order: -10。 - 打开「设置」页面时按钮自动隐藏，关闭设置后恢复。
下拉面板¶
点击按钮后，下拉面板展示：
- 账户余额。
- 当前会话模型。
- 实时 token 用量。
- 按 DeepSeek 官方价目表计算的费用估算。
实时 token 用量¶
- token 用量订阅
token-meter的 session projection。 - 在模型回答流式过程中，token 数字实时更新。
价格同步与峰谷适配¶
- 宿主端每 6 小时以 ETag 条件请求同步官方定价页。
- 自动提取峰谷价与生效日期。
- 未联网时回退内置价目表。
- 客户端打开面板时拉取最新价并本地缓存 12 小时。
- 按北京时间自动判断高峰/空闲时段。
- 随官方调价公告的生效日期切换新旧价目。
状态提示与多语言¶
- 余额较低、余额耗尽、API Key 无效或未配置、网络错误时给出状态提示。
- 中英文自适应，跟随浏览器语言自动切换文案。
请求代理¶
- 宿主端代理请求
/user/balance。 API Key不会暴露到浏览器。
安装与启用¶
先确认 DSH 环境满足：
Node.js >= 18
@deepseek-ai/cordis ^4.0.1 为可选 peer dependency
再确认 DeepSeek API Key 已配置。可位于：
设置 → 模型
~/.dsh/.credentials.yaml
安装插件：
dsh plugin --profile web add @lmmzss/dsh-plugin-balance
安装后重启 dsh web 使插件生效。
启用后，进入 DSH Web 会话头部，查看 Session log 左侧的余额按钮；点击按钮，查看账户余额、当前会话模型、实时 token 用量与费用估算。
卸载插件：
dsh plugin --profile web remove dsh-plugin-balance
典型用法与本地开发¶
如果只是使用插件，完成上面的安装和启用即可。
如果要查看源码或本地修改，可以先按本地路径加载：
dsh plugin --profile web add /path/to/dsh-plugin-balance
修改 lib/client.js 后刷新页面即可生效；修改宿主端或配置需重启 dsh。
开发时可以运行：
npm test
node scripts/prepublish-check.mjs
适用场景与注意¶
适合以下场景：
- 在 DSH Web 中频繁调用 DeepSeek。
- 希望在会话头部直接查看余额与当前会话 token 用量。
- 需要按 DeepSeek 官方价目表做粗略费用估算。
注意：
- 费用估算按 DeepSeek 官方价目表实时计算，仅供参考。
- 实际账单以
platform.deepseek.com/usage为准。 - 价格每 6 小时从官方页面同步，无法覆盖官方页面未及时更新的情况。
- 「缓存写入」恒为 0，是因为 DeepSeek API 不报告该字段，属正常现象。
- 插件以当前
dsh进程权限运行，安装前应检查源码、许可证与依赖。 - 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
- 本次资料中未出现具体目录页 URL。
链接¶
- GitHub：
https://github.com/lmmzss-jk/dsh-plugin-balance - 社区目录页：当前资料未给出具体 URL，请以实际目录站点入口为准。
