dsh-whale-balance-widget

DeepSeek Harness EAC 桌面端适配版

本项目地址： https://github.com/liangbai250/DSH-Whale-Balance-Widget

原项目地址： https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget

原项目说明： DeepSeek Harness（DSH）一只住在 DSH 界面右下角的小鲸鱼娘，帮你盯着 DeepSeek 账户余额。QQ 弹弹，支持拖拽吸附、左吸附翻转、数字滚动动画，随界面自动启用，建议直接喊来你的 DSH 安装。

本项目保留原项目的小鲸鱼挂件体验，重点适配 DeepSeek Harness EAC 桌面客户端的插件机制，并增加 Sub2API 余额支持。

DeepSeek Harness EAC 桌面端右下角的常驻余额挂件：小鲸鱼气泡图、DeepSeek 或 Sub2API 余额、今日已用和每轮对话消耗统计。插件由 EAC 桌面端加载，不需要单独启动 Web 服务器。

本项目是非官方社区适配版，不代表 DeepSeek、DeepSeek Harness 或原项目作者。

特性

• 🐋 EAC 桌面端适配：适配 DeepSeek Harness EAC 桌面客户端的插件机制。
• 💰 余额来源：支持 DeepSeek 和 Sub2API。
• 🔄 即时切换：保存后立即切换余额来源，不需要重启 EAC。
• 🧪 测试连接：两种余额来源都支持测试当前输入内容。
• 💾 统一保存：DeepSeek 与 Sub2API 两套配置同时保存。
• 📊 独立今日已用：两种余额来源分别记录今日用量。
• 💬 每轮消耗：DeepSeek 使用 DSH usage；Sub2API 使用实际余额差。
• 🖱️ 拖拽吸附：支持拖拽、四边吸附和左侧镜像翻转。
• 🔢 数字动画：余额变化时使用滚动动画。
• 📐 自适应显示：长数字自动缩小，避免超出气泡。
• 🔊 音效与台词：保留原项目音效、动画和随机台词。

目录结构

DSH-Whale-Balance-Widget/
├── package.json          # EAC 插件元数据、入口和依赖声明
├── README.md             # 项目介绍、安装、配置和验证说明
├── LICENSE               # MIT 许可证和版权声明
├── cordis.patch.yml      # EAC 插件挂载声明
├── client.js             # EAC 设置面板、保存和测试连接逻辑
├── lib/
│   └── index.js          # 宿主插件、余额接口和小鲸鱼运行逻辑
└── assets/
    ├── DSH2.png          # README 展示图和主界面素材
    ├── DSniang1.png      # 小鲸鱼透明素材
    ├── DSniang02.png     # 小鲸鱼备用素材
    ├── rua.gif           # 随机台词动画
    ├── Ya1.mp3           # 小黄鸭按压音效
    ├── Ya2.mp3           # 小黄鸭松开音效
    ├── D1.mp3            # 音效 1 按压音效
    └── D2.mp3            # 音效 1 松开音效

安装

方式 A：GitHub 安装（推荐）

EAC 默认跑 web-desktop。安装时用 dsh-whale-widget@... 别名，才能挂到 dsh-whale-widget 槽位；装完默认启用。

dsh plugin --profile web-desktop add dsh-whale-widget@github:liangbai250/DSH-Whale-Balance-Widget

如果 GitHub shorthand 失败，改用仓库 URL：

dsh plugin --profile web-desktop add dsh-whale-widget@https://github.com/liangbai250/DSH-Whale-Balance-Widget.git

仅当 EAC 设置了共享 web profile（shareWebProfile = true）时，才改用 --profile web。

安装完成后请重启 EAC 桌面端，使插件重新加载。

方式 B：本地开发安装

在仓库根目录，也就是 package.json 所在目录执行：

dsh plugin --profile web-desktop add dsh-whale-widget@link:.

也可以使用自己的源码目录：

dsh plugin --profile web-desktop add dsh-whale-widget@link:"<仓库目录>"

修改源码后请重启 EAC 桌面端，使插件重新加载。

给 AI Agent 的安装提示词

请在当前 DeepSeek Harness EAC 安装并默认启用：
https://github.com/liangbai250/DSH-Whale-Balance-Widget

这是 EAC 桌面插件，不是独立 Web 应用。禁止启动新服务器、手改 cordis.patch.yml、读取或回显密钥。改配置前先做 undo 快照。装完不要自行重启，只提示用户重启 EAC 桌面端。

1. 体检 package.json、cordis.patch.yml、client.js、lib/index.js、assets。仓库包名是 dsh-whale-widget-eac，挂载 id 是 dsh-whale-widget。
2. 按当前 EAC 进程的 --profile 安装（默认 web-desktop，不要默认装 web）。
3. 安装命令必须带挂载名别名：
   dsh plugin --profile <实际profile> add dsh-whale-widget@github:liangbai250/DSH-Whale-Balance-Widget
   shorthand 失败改用仓库 git URL。禁止只 add github:... 或 dsh-whale-widget-eac。
4. 默认启用：若插件管理里是关闭，用官方 pluginManager / togglePluginInPatch 打开。
5. 核对 node_modules/dsh-whale-widget/package.json 和设置文案，确认出现「小鲸鱼余额挂件」、DeepSeek、Sub2API、「测试连接」。
6. 报告结果，并请用户完全退出后重启 EAC 桌面端。

卸载

dsh plugin --profile web-desktop remove dsh-whale-widget

EAC 适配说明

本项目重点适配 DeepSeek Harness EAC 桌面客户端：

• 适配 EAC 桌面端的 Web bundle 插件加载机制。
• 集成 EAC 客户端设置面板。
• 使用 EAC 宿主路由提供余额和测试连接接口。
• 兼容 EAC 的 settingsScope 设置服务。
• 支持保存后立即切换余额来源。
• 不要求用户手工修改 profile patch。
• 不要求用户启动独立 Web 服务器。

配置

在 EAC 桌面端的插件设置中找到“小鲸鱼余额挂件”。

DeepSeek

选择 DeepSeek，填写 DEEPSEEK_API_KEY。

sk-****************

点击“测试连接”验证当前输入的密钥，测试不会保存配置。

Sub2API

选择 Sub2API，填写：

Sub2API 中转网址
Sub2API API 密钥

先在 Sub2API 面板创建 API 密钥，再复制到输入框。

sk-****************

读取返回的 remaining，没有时读取 balance。点击“测试连接”验证当前输入，测试不会保存配置。

保存与切换

点击保存会同时保存两套配置、当前余额来源、启用状态、今日用量模式和挂件大小。成功后显示：

已保存并切换。

用量说明

DeepSeek 与 Sub2API 的今日已用账本相互独立，切换来源不会继承另一来源的记录。

今日用量按余额变化记录：

上次余额 - 当前余额

DeepSeek 的上一轮消耗使用 DSH 会话 usage 与 DeepSeek 价格规则计算。Sub2API 不使用 DeepSeek 价格表，而是使用：

对话开始余额 - 对话结束余额

验证

安装并重启 EAC 后：

1. 确认右下角出现小鲸鱼。
2. 打开插件设置，确认 DeepSeek、Sub2API 和测试连接控件出现。
3. 输入对应配置并点击测试连接。
4. 点击保存，确认显示“已保存并切换”。
5. 分别切换余额来源，确认两套配置和今日用量彼此独立。

常见问题

挂件没有出现

确认 dsh plugin 已装到当前 EAC 实际 profile（默认 web-desktop），完全退出并重启 EAC 桌面端；如果仍未出现，检查插件管理是否关闭、以及安装的是 dsh-whale-widget 槽位而不是孤立的 dsh-whale-widget-eac。

设置服务不可用

完全退出并重启 EAC 桌面端。如果仍然不可用，检查插件入口、当前 profile 的插件版本，以及插件管理中是否已启用。

DeepSeek 测试失败

确认输入的是 DeepSeek API 密钥，并检查余额接口权限。

Sub2API 测试失败

确认中转网址正确、API 密钥已创建，并确认站点支持 /v1/usage。

上一轮消耗没有显示

确认一轮对话正常结束。DeepSeek 需要收到完整 DSH usage 事件；Sub2API 需要在对话开始和结束时成功读取余额。

开发与维护

这是一个 EAC bundle 插件包。修改 lib/index.js、client.js 或资源后，使用本地 dsh-whale-widget@link:. 安装到当前 profile，并完全退出后重启 EAC 桌面端重新加载。

上游项目与适配参考

• 原项目：MeteorNOX/DeepSeek-Balance-Whale-Widget
• 本项目：liangbai250/DSH-Whale-Balance-Widget
• EAC 适配参考：Deepseek-Harness-EAC Issues

感谢原项目作者的开源工作。

许可证

本项目基于 MIT License 开源，详见 LICENSE。

Copyright (c) 2026 MeteorNOX
Copyright (c) 2026 liangbai250

本项目是 DeepSeek Harness EAC 桌面端的非官方社区适配版，不隶属于 DeepSeek、DeepSeek Harness，也不是原项目的官方版本。