DeepSeek 余额浮窗 for DeepSeek Harness web GUI：左下角悬浮窗，实时显示官方 API 账户余额，支持三种窗口形态、一键折叠、自动刷新、多 Key 快捷切换。
A DeepSeek account balance floating widget for the DeepSeek Harness web GUI: a bottom-left overlay showing the official API balance in three window shapes, collapse chip, auto refresh, and multi-key quick switching.
| 大窗口 | 长条窗口 | 小窗口 |
|---|---|---|
 |
 |
 |
| 填写多个 Key | 余额多 Key 显示与快捷切换 |
|---|---|
 |
 |
- 三种窗口形态：大窗口（完整信息）、长条窗口（精简横条）、小窗口（紧凑胶囊），点击切换
- 一键折叠：折叠成小胶囊，悬停展开，不遮挡对话区
- 实时余额：查询 DeepSeek 官方 API 账户余额（
GET /user/balance），单位随数值自适应 - 自动刷新：每 5 分钟自动查询，也可手动刷新
- 多 Key 管理：设置面板右上角「+ 新增Key」可同时保存多个 API Key；悬浮列表显示全部已填 Key，点击即可快捷切换当前查询所用 Key
- 分开设置：DeepSeek 余额与 OpenCode Go 用量的 Key 各自独立保存（
DSH_BALANCE_KEYS/OPENCODE_KEYS），互不影响 - Key 持久化：输入即自动保存 + 关闭设置时强制落盘；多 Key 列表经 DSH 凭证服务持久化，重启不丢失
- 环境变量兼容：本机已配
DEEPSEEK_API_KEY环境变量时自动识别并使用（来源标识 env） - 悬浮浮层：独立浮窗（不嵌入侧边栏），实时跟随侧边栏宽度，侧边栏收起自动隐藏，过窄时标题自动省略号
- 毛玻璃外观：16px 背景模糊 + 25% 半透明背景（浅色 25% 白 / 暗色 60% 深灰），明暗主题自适应
- 状态提示：未配置 Key / 查询失败等状态清晰展示，引导配置
包已发布到 npm（@magiczerowxy/dsh-balance），用官方 dsh plugin 命令安装：
dsh plugin --profile <profile> add @magiczerowxy/dsh-balance
<profile>换成你自己的 profile 名：桌面版用desktop，Web 版用web，不带--profile操作默认 profile。 命令会自动把包写入 profile 依赖，并因声明了dsh.bundle自动加入 layer stack。
- 环境变量：设置
DEEPSEEK_API_KEY=sk-xxx后重启 DSH - 浮窗内保存：点击浮窗 → 填入 Key → 保存（写入
~/.dsh/.credentials.yaml）
若 dsh 已接入 DeepSeek API（环境变量或凭据文件），设置对话框会自动探测并显示"已使用本机配置"，无需填写。
- 点击窗口右上角「···」→ 打开设置面板 → 右上角「+ 新增Key」逐条添加
- 「···」旁悬浮层列出所有已填 Key，点击任意一条即可快捷切换当前查询所用 Key
- 多个 Key 以列表持久化在凭证引用
DSH_BALANCE_KEYS，重启后仍然保留
分开保存：余额窗口的 Key 存在
DSH_BALANCE_KEYS，用量窗口的 Key 存在OPENCODE_KEYS，两者互不覆盖、互不影响。
dsh plugin --profile <profile> remove @magiczerowxy/dsh-balancedsh-balance/
├── lib/
│ ├── index.js # Host 半区：/api/dsh-balance/* 路由（余额查询、Key 列表/保存/清除）
│ └── client.js # Client 半区：浮窗 UI + 三形态切换 + 折叠 + 多Key + 自动刷新 + 毛玻璃
├── screenshots/ # 界面截图
├── cordis.patch.yml # bundle patch（entry id: ds-balance-widget）
└── package.json
- 多 Key 支持：可填写多个 API Key（右上角「+新增Key」），悬浮层快捷切换查看；余额与 OpenCode Go 用量的 Key 分开设置、分开持久化
- 持久化修复：此前只在点"保存"时落盘、重启后 Key 丢失 → 改为输入即自动保存 + 关闭设置强制落盘，多 Key 列表写入凭证服务，重启不丢失
- 悬浮浮层：窗口为独立浮层（非嵌入侧边栏），通过侧边栏网格宽度实时跟随宽度，侧边栏收起自动隐藏
- 毛玻璃外观：16px
backdrop-filter模糊 + 25% 半透明背景（浅色rgba(255, 255, 255, 0.25)/ 暗色rgba(16, 16, 22, 0.60)），明暗主题各自配边框与阴影 - 排版细节：窗口（大窗/长条/胶囊）标题在宽度不足时自动显示省略号；胶囊折叠动画、堆叠布局微调
MIT