x2802490130-prog/dsh-balance-float
DSH 悬浮余额/一键退出插件
Listed
4
Usage
Bundle verified
Preview
What it does
A floating balance widget for the Web UI: live DeepSeek account balance with manual refresh and a Y/N-confirmed graceful exit.
Best for
- DSH Web users who want account balance, bonus, and topped-up balance visible without leaving the UI.
- Local operators who want manual balance refresh and a keyboard-confirmed graceful shutdown control.
Not ideal for
- Users without a configured DeepSeek API key who need balance monitoring; balance retrieval will show as failed.
- Remote or multi-user deployments where a Web UI control capable of stopping the local DSH service is undesirable.
- Users who do not need persistent balance visibility or shutdown controls in the Web UI.
README
dsh-balance-float
DeepSeek Harness（DSH）Web 插件：在网页右上角显示一个悬浮窗，实时显示 DeepSeek 模型账户余额，支持手动刷新与一键优雅退出（Y/N 快捷键确认）。
环境要求
- 已安装 DeepSeek Harness CLI：
npm install -g @deepseek-ai/dsh - 已配置 DeepSeek API Key（用于余额查询；未配置时悬浮窗显示「获取失败」红点，不影响其他功能，Key 配置方式见下文）
功能
- 实时余额：悬浮窗每 60 秒自动刷新，展示总余额 / 赠送 / 充值明细
- 手动刷新：点击 ↻ 按钮立即刷新
- 一键退出：点击 ⏻ 弹出确认框，按键盘 Y 确认退出（关闭本地服务与网页），N / Esc 取消
- 退出即关闭：退出后本地 DSH 服务与 http://127.0.0.1:3080 网页一并关闭
安装
方式一：npm（推荐）
dsh plugin --profile web add dsh-balance-float
方式二：GitHub 直装
dsh plugin --profile web add github:x2802490130-prog/dsh-balance-float
本插件为纯 JavaScript 发布（无构建步骤），git 直装即可使用，无需 pnpm 构建许可（见官方 publish.md）。
方式三：本地链接（开发 / 尝鲜）
dsh plugin --profile web add link:/path/to/dsh-balance-float
安装后重启 dsh（或硬刷新网页 Ctrl+F5），右上角即出现悬浮窗。
使用
| 操作 | 效果 |
|---|---|
| 点击悬浮窗主体 | 展开余额明细（总 / 赠送 / 充值 / 更新时间） |
| 点击 ↻ | 立即刷新余额 |
| 点击 ⏻ | 弹出退出确认框 |
| 键盘 Y | 确认退出（本地服务与网页一并关闭） |
| 键盘 N / Esc | 取消退出 |
| 再点 ⏻ | 关闭确认框 |
配置
插件读取 DeepSeek API Key，查找顺序：
- 环境变量
DEEPSEEK_API_KEY $DSH_HOME/.credentials.yaml-
%USERPROFILE%/.dsh/.credentials.yaml（Windows） $HOME/.dsh/.credentials.yaml
credentials 文件格式：
DEEPSEEK_API_KEY: sk-xxxx
API Key 仅用于服务端请求，永远不会出现在网页响应中。
HTTP 接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/dsh-balance |
余额查询（60 秒缓存） |
| POST | /api/dsh-exit |
优雅退出：SIGINT 关闭 dsh，6 秒兜底强杀 |
两个接口都只挂在本地 dsh 服务上，不对外暴露。
开发与测试
npm i -D jsdom # 可选：测试依赖
node test.mjs # 回归测试（宿主路由 + jsdom 客户端交互，离线可跑）
目录结构
lib/index.js 宿主（HTTP 路由：余额 / 退出）
client/client.js 客户端（悬浮窗 UI 与交互）
cordis.patch.yml bundle 补丁
test.mjs 回归测试
windows/ 可选：Windows 隐藏窗口启动 / 停止脚本 + 默认图标（覆盖 icon/dsh.ico 即可替换）
License
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:x2802490130-prog/dsh-balance-float in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.