DSH API Balance · API 余额悬浮徽章

一枚为 DeepSeek Harness（DSH）Web GUI 打造的小巧悬浮徽章：实时显示你的大模型 API 平台账户余额，可自由拖动、自由缩放、半透明亚克力质感，文字颜色随下方内容明暗自动切换。

English

📸 效果图

效果图为徽章本身的展示图，不包含任何真实界面与会话内容。

✨ 功能特性

• 全局悬浮：浮于所有界面之上，点击穿透，不遮挡任何操作
• 自由拖动：按住徽章拖到屏幕任意位置，松手即定位
• 自由缩放：拖拽右下角手柄，70% – 250% 无级缩放
• 亚克力质感：半透明中性灰 + 毛玻璃虚化 + 细描边，深浅色皮肤都自然
• 文字明暗自适应：实时采样徽章下方内容的背景亮度，深色内容上自动变浅色文字、浅色内容上自动变深色文字
• 点击刷新 + 自动刷新：轻点徽章立即刷新，每 10 分钟自动刷新一次
• 多平台支持：DeepSeek、Moonshot (Kimi)、OpenAI、任意自定义接口
• 密钥安全：密钥保存在 Harness 凭据库（~/.dsh/.credentials.yaml），绝不回传页面；请求经 curl 以环境变量传递密钥，不出现在命令行
• 设置面板：在 设置 › API 余额 中配置平台与密钥、查看余额明细（总余额/赠送/充值/可用/已用）、控制徽章显示/大小/重置

📦 正式安装（一键）

一条命令即可把插件装进你的 DSH web profile 并自动注册（dsh plugin 会自动同步 dsh.profile.bundles）：

dsh plugin --profile web add github:GPIOX/dsh-api-balance

然后重启 DSH（关闭 dsh 进程后重新运行，例如 dsh web），刷新页面，打开 设置 › API 余额 保存密钥——悬浮徽章即刻显示余额。

卸载 / 回滚：

dsh plugin --profile web remove dsh-api-balance

也可以等插件收录进 awesome-dsh-plugin 目录后，在应用内插件市场一键安装；本地开发调试可用 。