前言¶
DSH 的输入框底栏已经显示上下文用量和 token 速度，但不看计费页面就不知道当前账号还剩多少钱。想确认余额，只能切到充值页面或者另开一个网页。h2fe1/dsh-deepseek-account-balance 就是针对这个动作的插件：把当前登录 DeepSeek 账号的余额，作为一枚很小的标签放在输入框下方、上下文用量的右边。插件不注册路由，不读取密钥，不发起推理请求，属于客户端插件。
这是什么¶
插件由 h2fe1 维护，仓库地址 h2fe1/dsh-deepseek-account-balance，许可为 MIT，版本 0.1.1。解决的问题是：在会话界面里用最小代价看到余额，而不必离开当前对话。
效果是一行底栏的末尾多出一段：
[1 轮 114 步 · 216 tok/s] [12M tok · 缓存命中 99%] ◔ 19% 余额 ¥61.48
实现思路¶
插件不自己拿 token，也不请求第三方接口。它直接走 DSH 的 deepseek-account 服务已经暴露的客户端只读方法：
| 方法 | 用途 |
|---|---|
account.getState() |
判断是否已登录（credential-stored / signed-out） |
account.getBalance(client) |
取 normal_wallets（充值余额）与 bonus_wallets（赠送余额） |
请求由 Host 携带登录凭证发往 Platform，页面拿不到 token，也没有新增任何 Host 路由。整个过程只读：不发起推理请求，不改动账号、额度或订阅。
安装与启用¶
在 DSH Web GUI 里打开 Plugins → 添加插件 → 安装第三方插件，填仓库地址：
https://github.com/h2fe1/dsh-deepseek-account-balance
或者用 Agent 或 CLI 安装：
dsh plugin --profile <你的 profile> add github:h2fe1/dsh-deepseek-account-balance
装好后进入任意会话，输入框下方上下文用量的右侧就会出现余额标签。页面可见时每 60 秒自动刷新一次，切回页面也会刷新。需要 Node ^22.19.0 || >=24.0.0，DSH >=0.2.0-rc.2。
本地开发¶
git clone https://github.com/h2fe1/dsh-deepseek-account-balance.git
dsh plugin --profile <你的 profile> add link:$PWD/dsh-deepseek-account-balance
源码结构比较直白：
index.js是宿主半，只保留 Loader 行，不注册路由。client.js是浏览器半，负责在conversation.composer.dock里渲染余额标签、读取账号 Remote 和格式化显示。locale/*.json是插件列表里的标题和描述。
显示规则与刷新¶
- 已登录：显示
余额 ¥61.48；有赠送额度时只在悬停提示里显示赠送 ¥x.xx。 - 未登录：显示
余额 —，悬停提示引导去「设置 → 账号」登录。 - 查询失败：保留上一次金额并标红，悬停看具体错误，点击标签重试。
- 点击整枚标签立即刷新。账号切换或退出登录会在下一次刷新时反映。
- 金额按 Platform 的两小数规则显示；不足一分钱显示
<¥0.01（负数显示-¥0.01），多币种用+连接。 - 字号、颜色与该行其他项一致（12px、tertiary、正常字重）。
- 语言跟随 DSH 的界面语言（中文 / English）。
- 只在有会话、显示上下文用量时出现；欢迎页不占用空间。
配置与适用场景¶
插件没有配置项，不读取任何密钥，也不要求填写账号信息。它依赖 DSH 里已经登录的 DeepSeek 账号，所以适合日常使用 DSH 对话、希望顺手看到余额的用户；对需要多账号切换或精确计费的场景，仍然要去计费页面核对。
插件以当前 dsh 进程的权限运行，安装前建议先读一遍源码并确认许可证。仓库提供 CI（test workflow），本地也可用以下命令自检：
node --test test/*.test.mjs
node --check index.js && node --check client.js
结尾¶
这个插件的价值在于把「看余额」从一次跳转变成底栏上的余光，侵入性低，更新逻辑也简单。它属于社区插件目录里的客户端分类，与 DeepSeek / 幻方没有官方从属关系。
目录页：https://www.skillhub.cn/plugins/h2fe1/dsh-deepseek-account-balance
GitHub：https://github.com/h2fe1/dsh-deepseek-account-balance
