dsh-pet 🐾

一只住在 DeepSeek Harness 里的桌面宠物：待机呼吸、随机动作（打瞌睡、玩魔方、吃火锅……）、左右转向、屏幕漫游、点击 Q 弹、拖拽甩抛反弹、右键菜单点播——一百余个透明动画随时无缝衔接；还能跟随 DSH 会话事件切换工作状态动画、按档位播放余额动画 + 头顶气泡、碎碎念与对话聊天、窗口失焦时弹系统通知。可多开同屏，能脱离浏览器住上桌面（透明置顶小窗），也能自己添加全新宠物种类（pet pack）。

这不是一个普通插件，而是完整的三件套项目：

① 提示词（配方）    →  ② 素材生成链（引擎）  →  ③ 插件（成品）
AI 生成动画的配方     源视频 → 透明动画的管线    运行在 DSH 里的宠物

任何人 clone 本仓库，都可以从零生成自己的桌面宠物——换角色、换动作、换风格，全流程可复现。

---

快速开始（安装插件）

装法取决于你在用哪个 DSH：

🪟 桌面应用（Electron 版）

直接在应用内「插件管理」页的安装框里填 dsh-pet，不用开终端；需要在终端里操作插件时，用桌面应用自带的那份 CLI。

🌐 dsh web

以下命令都在你的命令行终端（PowerShell / CMD 等）中运行。前提是 DSH 环境已就绪：

# ① 前置要求：确认 Node.js 已安装
node -v

# ② 安装 DSH 启动器与 pnpm（已装可跳过；装完请重新打开终端）
npm install -g @deepseek-ai/dsh pnpm
dsh --version   # 验证 dsh 命令可用

# ③ 安装本插件（web 模式用 --profile web）
dsh plugin --profile web add dsh-pet

装完重开桌面应用（dsh web 用户则重启 dsh web）才生效——运行中的进程持有内存里的旧插件。宠物出现在界面右上角（默认配置角落，可在设置页修改）。

兼容性：本插件当前在 dsh 0.2.1-rc.2 下开发并测试（dsh --version 可查看你的版本）。建议使用相同版本；其他版本如遇问题欢迎反馈。

从源码安装（clone 本仓库后）

lib/ 构建产物不入库，clone 后需要先构建再安装：

# ① clone 本仓库，进入插件目录
git clone https://github.com/PC2005-cloud/dsh-pet.git
cd dsh-pet/dsh-pet

# ② 安装依赖
npm install

# ③ 构建（完整 lib：tsdown → lib + 桌面共享核心 + 类型声明）
npm run build       # 必须手动跑一次（克隆后 npm install 不再自动构建）

# ④ 安装到 DSH（file: 指向**插件目录**——上面 cd 进去的那一层，用构建好的 lib）
#    --profile 填实际在用的那个：dsh web → web；
#    桌面应用（Electron 版）改用应用内「插件管理」安装，见上方快速开始
dsh plugin --profile web add file:D:/path/to/dsh-pet/dsh-pet

注：npm run build（即 scripts/prepare.js）才产出完整可安装的 lib——除 tsdown 构建外还构建桌面共享核心（shared-core.js）、生成类型声明并收敛发布 files 清单；裸 tsdown 构建会缺桌面运行时与类型。发布与打包（npm publish / npm pack）时由 prepack 自动调用它，克隆仓库后需手动跑一次。

安装后你会看到什么

默认配置是 display: "both"（浏览器与桌面都显示），所以重开 DSH 之后会依次出现两处，不必手动开：

1. 浏览器端先出现。 宠物落在界面右上角（默认角落，设置页可改），此时桌面上还是空的。

2. 宿主自动补桌面运行时。 本机没有 Electron 时，插件会自己下载一份（落在 ~/.dsh/electron，同一版本只下一次；默认走 npmmirror 镜像）。进度直接打在 DSH 的控制台里，形如：

   [dsh-pet] Electron not found, downloading to <用户目录>/.dsh/electron/electron.exe ...
   [dsh-pet] Electron not found, downloading v43.3.0 (win32-x64) ...
   [dsh-pet] downloading 42.3MB / 104.1MB
   [dsh-pet] download complete (37.5s), extracting to <用户目录>/.dsh/electron ...
   

   这一步在后台进行，浏览器里的宠物照常可用；要等多久取决于网速（几十秒到几分钟），期间不用管它。

3. 桌面端随后出现。 解压完自动拉起桌面 Helper，同一只宠物以透明窗形式落到桌面上——此时屏幕上一共两只：浏览器里一只、桌面上那只，共用同一份配置与同一套动画。

4. 想只留一只。 两条路都行，改完即时生效：

   • 设置页：选中该宠物 →「显示位置」下拉框 → 仅浏览器 / 仅桌面 / 两者都显示 / 都不显示；
   • 宠物右键：菜单里的「显示位置」子菜单 → 仅网页 / 仅桌面 / 两者 / 都不（不用回设置页）。

已经装过 Electron（或设了 DSH_PET_ELECTRON_PATH 指向现成可执行文件）时，第 2 步会跳过，桌面端几乎立刻出现。下载失败只影响桌面模式：控制台会给出提示，浏览器里的宠物不受影响；网络受限时可以设 DSH_PET_ELECTRON_MIRROR 换镜像、DSH_PET_ELECTRON_VERSION 指定版本，重启后再试。

插件功能

…