dsh-balance-panel

📖 简介

给 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 自动加载

📦 环境要求

🚀 快速开始

1️⃣ 安装

用官方 CLI 安装(推荐,与商店插件一致,自动写入 dsh.profile.bundles):

dsh plugin --profile web add <本仓库 package 目录的路径>

💡 安装时会通过 link: 链接到 package/ 目录,无需手动修改 cordis.patch.yml(保持为空即可,宿主行由 bundle 层在启动时自动应用)。

2️⃣ 重启 DSH

使 bundle 条目生效。

3️⃣ 使用

刷新页面 → 右下角出现「🐳 鲸鱼娘的小金库」→ 粘贴你的 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 不落盘:API Key 只保存在页面内存中,刷新后需重新填写,不会写入任何文件。

🗑️ 卸载

dsh plugin --profile web remove dsh-balance-panel

(或 pnpm remove 后确认 profile bundles 中不再包含该插件。)

🛠️ 开发调试

直接修改 package/ 目录中的文件(bundle 层链接到该目录),改完重启 DSH 即可生效。

📄 许可

本项目基于 MIT 许可开源。