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
MIT
