前言¶

DSH 强调「一切皆插件」。在 DSH Web 界面使用 DeepSeek 模型时，查看账户余额和退出本地服务可以不必离开页面。dsh-balance-float 是一个 Web 插件，在右上角增加一个悬浮窗，用于显示 DeepSeek 模型账户余额、手动刷新余额，并在确认後关闭本地 DSH 服务。

这是什么¶

下面介绍这个插件的定位和边界。

• 插件名：dsh-balance-float
• 类型：DSH Web 插件
• 维护者：x2802490130-prog
• 许可证：MIT
• GitHub 仓库：https://github.com/x2802490130-prog/dsh-balance-float

它属于 DSH 社区插件生态中的 Web 插件。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解为官方应用商店应用。

核心功能¶

先说它能做什么：

• 右上角悬浮窗显示 DeepSeek 模型账户余额
• 悬浮窗每 60 秒自动刷新，展示 总余额 / 赠送 / 充值 明细
• 点击 ↻ 按钮手动刷新余额
• 点击 ⏻ 按钮触发优雅退出，按 Y 确认，按 N 或 Esc 取消
• 退出后关闭本地 DSH 服务与 http://127.0.0.1:3080 网页
• 提供本地 HTTP 接口：GET /api/dsh-balance 与 POST /api/dsh-exit

环境要求¶

安装前先确认环境：

1、已安装 DeepSeek Harness CLI：

npm install -g @deepseek-ai/dsh

2、Node.js 版本满足：

Node.js >=18

3、已配置 DeepSeek API Key。未配置时，悬浮窗会显示「获取失败」红点。

安装与启用¶

安装命令如下：

dsh plugin --profile web add dsh-balance-float

安装后重启 dsh，或硬刷新网页：

Ctrl+F5

经过上面的步骤，DSH Web 页面右上角会出现余额悬浮窗。

典型用法¶

下面是可复现的操作路径：

1、点击悬浮窗主体，展开余额明细，包括 总 / 赠送 / 充值 / 更新时间。
2、点击 ↻，立即刷新余额。
3、点击 ⏻，弹出退出确认框。
4、按 Y，确认退出；本地 DSH 服务与 http://127.0.0.1:3080 网页会被关闭。
5、按 N 或 Esc，取消退出。
6、再次点击 ⏻，关闭确认框。

配置余额查询¶

余额查询依赖 DeepSeek API Key。可以配置环境变量，或配置 credentials 文件中的 DEEPSEEK_API_KEY。

配置项：

DEEPSEEK_API_KEY

credentials 文件示例：

DEEPSEEK_API_KEY: <你的 Key>

API Key 仅用于服务端请求，不会出现在网页响应中。

本地 HTTP 接口¶

两个接口只挂在本地 dsh 服务上，不对外暴露：

GET /api/dsh-balance
POST /api/dsh-exit

GET /api/dsh-balance 用于余额查询。
POST /api/dsh-exit 用于优雅退出：执行 SIGINT 关闭 dsh，并有 6 秒兜底强杀。

适用场景与注意¶

适合已经使用 DSH Web 界面、希望直接在页面内查看 DeepSeek 余额并退出本地服务的场景。

注意以下几点：

• 插件以当前 dsh 进程权限运行；安装前应检查源码与 MIT 许可证。
• 未配置 API Key 时，余额区域会显示「获取失败」红点。
• 退出接口会关闭本地服务和网页，适合明确要结束当前 DSH Web 会话时使用。
• 本地接口不对外暴露，但不代表可以随意调用退出接口，因为它会终止当前 dsh 服务。

结尾¶

dsh-balance-float 把 DeepSeek 余额查看、手动刷新和本地 DSH 服务退出收进 Web 界面。如果你已经在用 DSH Web，它可以作为右上角的一个轻量入口。

GitHub 仓库：

https://github.com/x2802490130-prog/dsh-balance-float