🐳 dsh-balance-panel — DeepSeek 余额面板

给 DeepSeek Harness (DSH) 的余额面板插件:页面右下角一个可爱的悬浮面板, 输入 DeepSeek API Key 就能看到账户余额,鲸鱼娘头像 base64 内嵌在客户端。

和商店(插件市场)下载的插件完全一样:刷新不丢、重启不丢。 按 dsh-market 插件规范 打包(dsh.bundle.patch + dsh.client + __ModuleLoader__ 客户端 bundle), 用官方 dsh plugin add 安装进 profile 的 bundles 层。

✨ 功能

• 悬浮面板(shell.overlay),粉蓝渐变可爱风格
• 调官方接口 GET https://api.deepseek.com/user/balance 查余额
• 显示总余额 / 充值余额 / 赠送余额,币种符号自动映射(¥ / $ / € …)
• 鲸鱼娘圆形头像:base64 内嵌客户端
• 右上角 －/＋ 收起/展开

📦 环境要求

• DSH(web profile)
• 宿主机有 node(宿主用 node 子进程请求余额接口)
• 每个使用者自己的 DeepSeek API Key

✅ 已安装(本机,与商店插件同方式)

1. 用官方 CLI 安装(依赖 link: + 自动加进 dsh.profile.bundles):

   dsh plugin --profile web add C:/Users/singleMelon/Desktop/测试/dsh-balance-panel/package
   

2. cordis.patch.yml 保持空(纯 bundles,无手写行)。
3. 重启 DSH 使 bundle 条目生效。

验证结果(全部通过):宿主路由 POST /dsh-balance/query(空 Key→400、假 Key→ DeepSeek 502),客户端 bundle /plugins/dsh-balance-panel/client.js 200。 刷新即显示,重启自动加载。

🚀 使用

刷新页面 → 右下角出现「鲸鱼娘的小金库」→ 粘贴你的 API Key → 「🔍 查询」。

📁 目录结构

dsh-balance-panel/
├── package/                  # ★ 可安装的持久插件包(商店同款,当前安装即链接到此)
│   ├── package.json          #   dsh.bundle.patch + dsh.client 声明
│   ├── cordis.patch.yml      #   宿主行 insert(bundle 层启动时应用)
│   ├── lib/index.js          #   宿主:POST /dsh-balance/query(node 子进程查余额)
│   └── client/client.js      #   客户端模块(__ModuleLoader__ 工厂,头像内嵌)
├── dsh-balance-panel-1.0.0.tgz   # 打包产物(可分发/装到别的机器)
├── src/                      # 动态插件版(旧,进程内临时;已停用)
├── .profile-backup/          # 安装前 profile 的 package.json/cordis.patch.yml/lockfile 备份
├── README.md / LICENSE / package.json

🔁 在别的 DSH 上安装

# 1. 把 package/ 目录(或 tgz)放到目标机器
# 2. 用官方 CLI 安装(推荐,和商店插件一致):
dsh plugin --profile web add <dsh-balance-panel/package 的路径>

# 3. 重启 DSH 使 bundle 条目生效

(备用手动方式:在 profile 目录 pnpm add <tgz> + 在 cordis.patch.yml 写 - insert: {id: dsh-balance-panel, name: 'dsh-balance-panel'} + 刷新;详见 skill dsh-store-plugin-packaging。)

⚠️ 说明

• 持久原理:真实包装在 profile 的 node_modules,宿主行在包自带的 cordis.patch.yml,由 bundle 层在每次启动时应用;客户端模块由 client-modules 伺服,刷新页面自动渲染。与商店下载的插件同一机制。
• Key 不落盘:只存在页面内存,刷新后重填。
• 卸载:dsh plugin --profile web remove dsh-balance-panel(或 pnpm remove + 确认 bundles 里没有它)。
• 改代码:直接改 package/ 里的文件(bundle 层链接到它),改完重启生效。

📄 许可

MIT,详见 LICENSE。 #� �d�s�h�-�b�a�l�a�n�c�e�-�p�a�n�e�l� � �