鲸鱼娘桌宠 Aibie07/whale-girl-desktop-pet

DSH 桌宠（dsh-pet）

一个 DeepSeek Harness Desktop (DSH) 的桌面宠物插件。桌宠会根据模型状态自动切换动画，支持拖拽、缩放、换肤、右键菜单、随机动作，还能一键查询 DeepSeek API 余额。

功能

- 状态同步：模型思考 / 输出 / 完成 / 待机时，桌宠自动切换对应动画。
- 交互：
- 左键拖拽移动、滚轮缩放、双击复位大小；
- 左键单击随机播放一个动作；
- 右键弹出菜单：调大小 / 换肤 / 动作 / 轮番播放 / 查余额 / 复位位置 / 隐藏。
- 皮肤：素材/ 根目录 5 张 =「默认」皮肤（鲸鱼娘）；在 素材/ 下加子目录（每套 5 张 GIF）即自动识别为新皮肤，右键「换肤」切换。
- 查询余额：点击「查余额」显示 DeepSeek API 余额。
- API 密钥由宿主端运行时读取（DEEPSEEK_API_KEY），不会写入浏览器。

依赖

- 已安装 DeepSeek Harness Desktop。
- 在 DSH 中配置好 DeepSeek API 密钥（DEEPSEEK_API_KEY）。自行在deepseek开放平台获取密钥（https://platform.deepseek.com/usage）
- 已配置Node.js 18+（安装脚本用 fetch 下载素材包）。
- 已安装Git 两个安装方式选一个即可，国外或有梯子推荐安装方式1，中国国内用户推荐安装方式2 安装1（国外用户或者有梯子） tip:本插件目前只通过 git clone 安装
git clone https://github.com/Aibie07/whale-girl-desktop-pet dsh-pet
cd dsh-pet
node install-pet.cjs
tip:用方式一装桌宠时，如果脚本报「下载素材失败（网络错误）」，先把梯子的TUN模式打开再重跑

然后重启 DSH 应用，打开页面（必要时刷新 F5），右下角即可看到桌宠。

安装脚本会自动：下载素材包（若本地缺失，从 GitHub Release 拉取 assets.tar.gz 并解压）→ 把皮肤和表情包写入 DSH 插件目录 → 把表情包拷进插件目录（自包含）→ 把插件登记到 web / desktop 两个 profile。
安装2（国内用户没有梯子的情况）
1. 先在终端执行这两步：
git clone https://github.com/Aibie07/whale-girl-desktop-pet dsh-pet
cd dsh-pet
再从网盘下载 鲸鱼娘gif素材：

2. 解压到项目根目录（即和 install-pet.cjs 同级），解压后应该得到两个文件夹：
- 素材/
- 蓝色大肥鱼表情包/

3. 再运行安装脚本（脚本检测到素材已存在，会跳过下载）：
node install-pet.cjs
素材包（Release）

皮肤和表情包体积较大（约 471MB），不放在 git 仓库里，而是打包成 assets.tar.gz 上传到 GitHub Release。安装脚本会在素材目录缺失时自动下载解压。

- 下载地址默认为 https://github.com/Aibie07/whale-girl-desktop-pet/releases/download/v1.0.0/assets.tar.gz；
- 也可以手动下载 assets.tar.gz，解压到项目根目录（得到 素材/ 和 蓝色大肥鱼表情包/）后再运行安装脚本。
- 国内用户推荐网盘下载，网盘链接：https://pan.quark.cn/s/2dfd8329e5df，提取码 vCmc（提供方：B 站 UP 主 「赤风RED」）素材目录结构

这些目录由安装脚本从 Release 下载解压而来（已被 .gitignore 忽略，不在仓库里）。

素材/ # 皮肤：根目录 5 张 =「默认」皮肤（鲸鱼娘） ├── 1.gif ... 5.gif # 待机A / 思考 / 待机B / 输出 / 完成

蓝色大肥鱼表情包/ # 动作 / 轮番播放 用到的 GIF（157 张） └── .gif

- 皮肤命名约定（每个皮肤 5 张）：1.gif 待机A、2.gif 思考、3.gif 待机B、4.gif 输出、5.gif 完成。
- 想加新皮肤：在 素材/ 下新建子目录，放入 5 张 GIF，重新跑 install-pet.cjs，新皮肤会出现在右键「换肤」菜单里。
- 想换动作包：替换 蓝色大肥鱼表情包/ 里的 GIF（保持 .gif 后缀），重新安装。

素材来源与授权

- 表情包素材来自 B 站 UP 主 「赤风RED」，已获授权使用。若用于其它用途，请自行获取up主本人授权。

目录说明

install-pet.cjs # 一键安装脚本（跨平台，Node 即可运行） pet-src/ # 插件源码（宿主端 + 客户端） package.json lib/index.js # 宿主端：余额代理 + 表情包文件路由 lib/client.js # 客户端：桌宠 UI / 动画 / 菜单 / 交互下面两个素材目录不在仓库里，由安装脚本从 Release 下载：素材/ # 皮肤 GIF 蓝色大肥鱼表情包/ # 动作 GIF

常见问题

- 桌宠不出现：确认 DSH 已重启、页面已刷新；检查终端安装脚本输出是否有报错。
- 余额查不到：确认已在 DSH 中配置 DEEPSEEK_API_KEY。
- 动作图加载不出来：确认 蓝色大肥鱼表情包/ 目录存在且含 .gif 文件，并已重新运行安装脚本。
- 端口/路径不同：脚本用 $DSH_HOME（默认 ~/.dsh）定位 DSH 配置，若你的 DSH 装在别处，可 DSH_HOME=/path/to/.dsh node install-pet.cjs。

License
代码采用 MIT。鲸鱼娘gif素材版权归原作者B站up「赤风RED」所有。

DSH 桌面宠物 (dsh-pet)

一个用于 DeepSeek Harness Desktop (DSH) 的桌面宠物插件。宠物会根据模型状态切换动画，并支持拖动、缩放、皮肤、右键菜单、随机动作以及一键查询 DeepSeek API 余额。

功能特性

- 状态同步：当模型处于思考 / 输出 / 完成 / 空闲状态时，宠物会自动切换动画。
- 交互：
- 左键拖动移动，滚轮缩放，双击重置大小；
- 左键单击播放随机动作；
- 右键菜单：缩放 / 切换皮肤 / 动作 / 全部播放 / 查余额 / 重置位置 / 隐藏。
- 皮肤：素材/ 根目录下的 5 个 GIF 为「默认」皮肤（鲸鱼娘）；在 素材/ 下添加子文件夹（每个皮肤 5 个 GIF）会自动识别为新皮肤，可通过右键 → 换肤切换。
- 余额查询：点击查余额可显示你的 DeepSeek API 余额。
- API 密钥由宿主进程在运行时读取（DEEPSEEK_API_KEY），绝不会暴露给浏览器。

环境要求

- 已安装 DeepSeek Harness Desktop。
- 在 DSH 中配置了 DeepSeek API 密钥（DEEPSEEK_API_KEY）。可在 https://platform.deepseek.com/usage 获取
- Node.js 18+（安装脚本使用 fetch 下载素材包）。
- 已安装 Git。

安装

从以下两种方法中任选其一。方法 1 推荐给国际用户或使用 VPN/代理的用户；方法 2 推荐给中国大陆用户。

方法 1（国际用户 / 有 VPN）

注意：此插件目前仅通过 git clone 安装。

git clone https://github.com/Aibie07/whale-girl-desktop-pet dsh-pet
cd dsh-pet
node install-pet.cjs

然后重启 DSH 应用，打开页面（如有需要按 F5 刷新），宠物会出现在右下角。

安装脚本将会：下载素材包（如果本地缺失，会从 GitHub Release 拉取 assets.tar.gz 并解压）→ 将皮肤和反应写入 DSH 插件文件夹 → 将反应复制到插件文件夹（自包含）→ 将插件注册到 web 和 desktop 两个配置文件中。

方法 2（无 VPN 的中国大陆用户）

1. 先在终端运行以下两步：
git clone https://github.com/Aibie07/whale-girl-desktop-pet dsh-pet
cd dsh-pet

然后从云盘下载鲸鱼娘 GIF 素材：

2. 将压缩包解压到项目根目录（与 install-pet.cjs 同一文件夹）。
解压后你应该有两个文件夹：
- 素材/
- 蓝色大肥鱼表情包/

3. 然后运行安装脚本（它会检测到素材已存在并跳过下载）：
node install-pet.cjs

素材包（Release）皮肤和反应图体积较大（约 471 MB），因此不存储在 git 仓库中——它们被打包进 assets.tar.gz 并上传到 GitHub Release。当资源文件夹缺失时，安装脚本会自动下载并解压它。

- 默认下载地址：https://github.com/Aibie07/whale-girl-desktop-pet/releases/download/v1.0.0/assets.tar.gz
- 如果你 fork 并更改了 Release 地址，可通过环境变量覆盖：DSH_PET_ASSETS_URL= node install-pet.cjs
- 你也可以手动下载 assets.tar.gz，解压到项目根目录（得到 素材/ 和 蓝色大肥鱼表情包/），然后运行安装脚本。
- 中国大陆用户推荐使用网盘链接：https://pan.quark.cn/s/2dfd8329e5df，提取码 vCmc（由 Bilibili UP 主 「赤风RED」 提供）。

资源文件夹结构

这些文件夹由安装脚本从 Release 下载并解压（它们被 .gitignore 忽略，不在仓库中）。

素材/ # 皮肤：根目录下的 5 个 GIF = “默认”皮肤（鲸鱼女孩） ├── 1.gif ... 5.gif # idleA / thinking / idleB / output / done

蓝色大肥鱼表情包/ # 动作 / 连播使用的反应 GIF（157 个 GIF） └── .gif

- 皮肤命名约定（每个皮肤 5 个 GIF）：1.gif idleA，2.gif thinking，3.gif idleB，4.gif output，5.gif done。
- 添加新皮肤：在 素材/ 下创建一个子文件夹，放入 5 个 GIF，然后重新运行 install-pet.cjs。新皮肤随后会出现在右键 换肤（切换皮肤）菜单中。
- 更换动作包：替换 蓝色大肥鱼表情包/ 中的 GIF（保持 .gif 扩展名）并重新安装。

资源来源与许可

- 表情/贴纸资源来自 Bilibili UP 主 「赤风RED」，经许可使用。如需用于其他用途，请自行获得作者的许可。

目录结构

install-pet.cjs # 一键安装脚本（跨平台，仅需 Node） pet-src/ # 插件源码（宿主 + 客户端） package.json lib/index.js # 宿主：余额代理 + 反应文件路由 lib/client.js # 客户端：宠物 UI / 动画 / 菜单 / 交互下面两个资源文件夹不在仓库中；它们由安装脚本下载：素材/ # 皮肤 GIF 蓝色大肥鱼表情包/ # 动作 GIF

常见问题

- 宠物不出现：确保 DSH 已重启且页面已刷新；检查安装脚本输出是否有错误。
- 余额查询失败：确保在 DSH 中配置了 DEEPSEEK_API_KEY。
- 动作 GIF 不加载：确保 蓝色大肥鱼表情包/ 文件夹存在且包含 .gif 文件，并重新运行安装脚本。
- 不同的端口/路径：脚本使用 $DSH_HOME（默认 ~/.dsh）来定位 DSH 配置。如果你的 DSH 安装在别处，请运行 DSH_HOME=/path/to/.dsh node install-pet.cjs。

许可

代码基于 MIT 许可。鲸鱼女孩 GIF 资源归其原作者 Bilibili UP 主「赤风RED」所有。