前言¶
在 DSH Web 里长时间跑对话时，钱包余额和 token 消耗往往要切到别处查看；社区里较早的 Balance Whale 小部件以中文界面为主，对默认使用英文界面的开发者不够友好。下面介绍 Balance Whale Intl（dsh-balance-whale-intl）：在保留「看板娘 + 实时余额 + 会话用量 + 轮次费用提示」的前提下，默认英文，并可在设置里切回简体中文。
这是什么¶
Balance Whale Intl 是面向 DSH Web UI 的客户端插件，维护者为 Biggy1606，在 DSH 插件目录 中归类为客户端。它 fork 自 DeepSeek Balance Whale Widget（上游以中文为主），独立维护，与上游作者无隶属或背书关系。
插件在浏览器里展示可拖拽的角色与钱包卡片；余额查询在 DSH 宿主进程完成，用量来自 DSH 会话日志中的真实 token 计数，费用为按 DeepSeek 标价估算，不含折扣与汇率差异。
核心功能¶
语言与界面¶
- 默认 English，完整 简体中文 可在 Settings → Appearance → Language 切换（标签、提示、日期、余额错误文案等一并切换）。
- 钱包卡片可拖标题栏移动，双击标题栏重新居中；位置会记住。
- 角色可拖动、贴边吸附，靠左时会自动镜像。
余额与用量¶
- 实时钱包：若同时存在 CNY 与 USD 钱包，分别展示。
- 用量统计：今日、当前对话、上一轮、上一条消息，基于 DSH session logs 的 input / cached / output token。
- 费用估算：可按 Auto、CNY 或 USD 显示标价估算；钱包余额展示本身保持自动模式。
- 余额不可用（未配置密钥或未登录）时，用量统计仍可用。
交互与外观¶
- 可选轮次费用气泡、提问/审批提示音、角色旁等待提示。
- 音效预设：Duck、FX1、Minecraft orb、Task-end A、Cost，可调音量与预览。
- 外观项包括角色、尺寸、动画、光晕、次要货币显示、自动关闭等。
- 偏好保存在本机浏览器，不上传。
安装与启用¶
前置条件¶
- 已安装支持第三方 bundle 的 DSH Web（
dsh web）。 - 若要查余额：在 DSH 凭据服务中配置
DEEPSEEK_API_KEY，或登录 DeepSeek 账号。
安装命令¶
从 GitHub 安装：
dsh plugin --profile web add github:Biggy1606/dsh-balance-whale-intl
需要固定版本时，可 pin release 标签（资料中示例为 v1.8.1）：
dsh plugin --profile web add github:Biggy1606/dsh-balance-whale-intl#v1.8.1
npm 包发布后也可：
dsh plugin --profile web add dsh-balance-whale-intl
安装后¶
- 重启
dsh web。 - 浏览器硬刷新（
Ctrl+Shift+R）。 - 若仍看不到小部件，在 Settings → Plugins 中确认 Balance Whale Intl 已启用。
更新或移除示例：
dsh plugin --profile web remove dsh-balance-whale-intl
dsh plugin --profile web add github:Biggy1606/dsh-balance-whale-intl
典型用法¶
- 角色默认在 DSH 窗口右下角；点击打开或关闭钱包卡片。
- 拖动角色移动，靠近边缘松手可吸附。
- 拖动卡片标题栏移动卡片；双击标题栏居中。
- 在 Settings → Appearance → Language 切换 English / 简体中文。
- 用 ×、Esc 或再次点击角色关闭卡片。
数字怎么理解¶
- Token 为真实值，来自 DSH 会话日志。
- 费用为估算，按 DeepSeek 标价计算，可能与账单因混合 CNY/USD、汇率、促销等不一致。
- 双币种展示时，同一轮 token 用量会分别按 CNY 与 USD 计价，并非扣两次。
- 观察到的钱包支出来自插件运行期间余额下降推断，非 retroactive，双币种混在一轮时无法精确归因到某一钱包。
- 余额查询优先使用
DEEPSEEK_API_KEY，否则使用已登录的 DeepSeek 账号。
数据与隐私（简要）¶
- API Key 留在 DSH 凭据服务，不进入小部件前端代码；余额解析在宿主进程执行。
- 无遥测、分析或远程日志。
- 本地账本
$DSH_HOME/.balance-whale.json存 accounting keys、token、费用、模型/轮次名等，不存 prompt、回复、凭据或 API Key。 /balance-whale/state.json与/balance-whale/wait.json只读，并拒绝跨站请求。
适用场景与注意¶
适合：在 DSH Web 上日常对话、希望边聊边看余额与 token、且偏好英文 UI（或需要中英切换）的开发者。
注意：
- 插件以当前 DSH 进程权限运行，并会访问 DeepSeek 余额 API（经宿主）与本地
/balance-whale/*路由；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证；角色图、图标、音效来自上游 as-is 再分发，并非全部由 MIT 覆盖，详见仓库内ASSET_PROVENANCE.md与NOTICE。 - DSH 生态是「一切皆插件」；skillhub.cn 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
- 兼容性：
package.json声明dsh.bundle.patch与dsh.client（web）；dsh.so 上标注为 Declared，需以你本地 DSH Web 实测为准。
常见问题（无声音、余额不可用、费用与账单不符、恢复默认布局等）见仓库 README 的 Troubleshooting 小节。
结尾¶
Balance Whale Intl 把上游 Balance Whale 的能力保留下来，并把默认语言改成英文，同时保留完整简体中文设置，适合在 DSH Web 里做「看得见」的钱包与 token companion。目录页：https://www.skillhub.cn/plugins/Biggy1606/dsh-balance-whale-intl；源码与安装说明：https://github.com/Biggy1606/dsh-balance-whale-intl。
