💰 DeepSeek 充值余额悬浮面板

极简 · 可视化 · 动态动画 | 一眼看清你的 DeepSeek 充值余额

一个运行在 DeepSeek Harness Web GUI 中的轻量悬浮面板插件：悬浮展示你的 DeepSeek 充值余额，带可视化进度条、水位变色与动态按钮动画，可拖动、可折叠、自动刷新，让余额状态一目了然。

🔥 功能特性

• 充值余额查询：官方余额接口实时查询，无需打开平台页面
• 可视化进度条：余额占比一目了然，按水位自动变色（🟢 ≥60% / 🟡 ≥30% / 🔴 <30%）
• 动态动画：按钮悬停上浮发光、按下缩放、刷新旋转指示、余额刷新闪烁
• 自动刷新：每 60 秒自动同步，头部「刷新」按钮可手动立即刷新
• 可拖动折叠：按住头部随意拖动，位置自动记忆；一键收起为精简条
• 数据持久化：API Key、参考额度、折叠状态、位置均存于浏览器 localStorage

📸 效果图

进度条填充比例 = 充值余额 ÷ 参考额度（默认 ¥100，可在设置中修改）

✅ 环境要求

• DeepSeek Harness（Web 模式，dsh web）——插件随 web profile 加载
• 无需额外依赖；Host 半面使用 Node 内置全局 fetch 直连官方接口

🚀 快速开始

1. 获取代码：克隆本仓库或下载源码包

git clone https://github.com/linfengyu94/dsh-balance-panel.git

2. 安装插件包到 DSH：把克隆下来的 dsh-balance-panel 目录（即插件包本体）安装到 DSH profiles 的回退目录 （$DSH_HOME/profiles/node_modules，Windows 下 $DSH_HOME 默认为 C:\Users\<用户名>\.dsh）。 以下任选其一：

   • 软链接（推荐，改代码即生效）：

   # Windows（junction 无需管理员权限）
   New-Item -ItemType Junction -Path "$env:DSH_HOME\profiles\node_modules\dsh-balance-panel" -Target "D:\你的路径\dsh-balance-panel"
   

   # macOS / Linux
   ln -s /你的路径/dsh-balance-panel ~/.dsh/profiles/node_modules/dsh-balance-panel
   

   • 或直接复制目录：cp -r dsh-balance-panel ~/.dsh/profiles/node_modules/dsh-balance-panel

3. 注册插件行：在 web profile 的补丁层（$DSH_HOME/profiles/web/cordis.patch.yml）追加：

- insert:
    - id: dsh-balance-panel
      name: dsh-balance-panel

4. 重启 dsh web（dsh web）后生效：Host 半面随进程挂载，浏览器半面经 dsh-client-modules 扫描 dsh.client 标记自动加载。

💡 安装并重启后，面板默认出现在页面右上角

📖 使用指南

1. 打开面板「设置」，填入 DeepSeek API Key（登录 platform.deepseek.com → API Keys 创建），点「保存 Key」
2. （可选）修改「参考额度」校准进度条基准（默认 100）
3. 头部「刷新」按钮点击立即刷新；面板每 60 秒自动刷新
4. 按住头部可拖动面板（位置自动记忆），「收起」可折叠为精简条

📂 项目结构

dsh-balance-panel/
├── package.json      # dsh.client 标记 + exports（"." → Host 半面，"./client" → 浏览器半面）
├── lib/
│   ├── index.js      # Host 半面：balance / selftest 接口 + /ds-balance/api 本地路由
│   └── client.js     # 浏览器半面：shell.overlay 悬浮面板（内联样式 + 动画样式注入）
├── preview.svg       # README 效果图
├── LICENSE           # MIT 开源许可
└── README.md

⚙️ 原理说明

模块	说明
数据来源	官方余额接口 GET https://api.deepseek.com/user/balance（topped_up_balance）
通信方式	浏览器半面通过同源 HTTP 路由 /ds-balance/api 与 Host 半面通信
网络通道	部署未挂载 web fetch provider（防 SSRF），Host 半面用 Node 全局 fetch 直连（与官方 Loader 插件同路径）
安全	本地路由仅接受回环地址（127.0.0.1/::1）请求，局域网内他人无法调用

🔄 更新

• 拉取最新代码后重启 dsh web 即可生效（若使用软链接安装，无需重新安装）

git pull

❓ 常见问题

Q：为什么显示「API Key 无效」？ 余额接口返回 HTTP 401，请检查 Key 是否正确、账户是否有余额查询权限。

Q：进度条比例不对？ 进度条基准 = 参考额度，在「设置」中修改即可（例如常充 ¥200 就填 200）。

Q：安装后面板没出现？ 确认 patch 行已添加、插件目录在 profiles\node_modules 下且包名可解析；重启 dsh web 后仍未出现，请查看启动日志中的 dsh-balance-panel 行。

🧹 卸载

• 移除 cordis.patch.yml 中 dsh-balance-panel 的 insert 行
• 删除安装时创建的链接或目录（Windows：Remove-Item "$env:DSH_HOME\profiles\node_modules\dsh-balance-panel"）
• 重启 dsh 即可；浏览器 localStorage 键 dsh.dsbalance.v1 可手动清除（含 API Key、参考额度、位置）

🤝 贡献

• 欢迎提交 Issue 反馈问题或建议，Pull Request 参与改进
• 反馈问题时请附：DSH 版本、面板显示的错误信息、相关日志

📜 版权与声明

• 本项目基于 MIT License 开源，欢迎自由使用与二次开发
• 插件仅查询官方余额接口，不收集、不上传任何数据；API Key 仅保存在本机浏览器 localStorage
• 界面样式使用 DSH 主题变量，随深浅色主题自动适配