桌面宠物助手TaoZhiZhuang/deepseek-desk-pet

DeepSeek 桌面宠物（DSH 动态插件）

在 DSH 网页端右下角显示一只可拖动的桌面宠物，随工作状态切换形态，审批/完成时语音提醒。
所有页面的宠物都会收到全局提醒（任何对话/项目的事件都会广播）。

形态与语音搭配

| 状态 | 触发 | 图片 | 声音 |
| --- | --- | --- | --- |
| 😴 空闲 | 没有任何任务 | 蓝色鲸鱼女仆（用户素材）或 鲸鱼吹泡泡，随机（点一下宠物可手动切换） | 无（泡泡动画） |
| 💦 工作 | 有 agent/任务/工作流在跑 | 鲸鱼喷水图 | 无 |
| ❗ 审批 | 有审批待处理 | 蓝鲸女仆敲门动画（4 帧循环） | 🔊 地精「时间就是金钱，我的朋友」 |
| 🎉 任务完成 | 任何项目/后台任务结束 | 画面保持当前状态 | 🔊 鱼人叫（原始一声） |

- 审批被处理完 → 立即回到工作/空闲状态
- 声音事件广播给所有挂载的宠物实例（每个打开的对话页面都会响）
- 空闲形象只在进入空闲时随机一次，不自动切换；不满意时点一下宠物就在女仆/鲸鱼间切换

效果演示

| 空闲（鲸鱼吹泡泡） | 空闲（葛优躺） | 工作（鲸鱼喷水） | 审批（敲门动画） |
| --- | --- | --- | --- |
| 空闲-吹泡泡 | 空闲-葛优躺 | 工作-喷水 | 审批-敲门 |

以上为基于实际素材合成的演示 GIF；插件运行时为可拖动的实时宠物（网页端右下角）。

素材目录

pet-assets/
├── whale.webp          空闲鲸鱼（蝴蝶结鲸鱼普通版，干净无黑边）
├── whale_spray.webp    鲸鱼喷水（工作，同一只鲸鱼）
├── catgirl_idle.webp   蓝发猫娘葛优躺（空闲之一，用户素材）
├── approval_anim_0..3.webp  敲门动画 4 帧（审批）
├── sounds/goblin_zh.mp3     地精中文台词（审批）
├── sounds/murloc_single.mp3 鱼人原始一声（完成）
├── originals/          原始大图素材库（母本，含素材说明 README；大图默认不提交）
├── reference/          参考素材（个人素材，默认不提交）
├── candidates/         新资源候选区（预览页展示，审批后接入）
└── archive/            废弃/实验素材（不提交）

预览页

插件运行后打开 http://127.0.0.1:3080/pet-preview：
- ① 状态 → 图片 → 声音 搭配表（可一键演示）
- ② 全部素材一览
- ③ 声音试听

配置

- 素材目录通过环境变量 DSH_PET_ASSETS 指定；未设置时使用默认路径（当前机器为 pet-assets 所在目录）。
其他机器请先 export DSH_PET_ASSETS=/你的/素材目录 再加载插件。

安装 / 加载（DSH 动态插件）

1. 准备素材目录（上面的 pet-assets/ 结构）。
2. 在 DSH 中加载插件：把本插件源码（Host 半 + Client 半）通过 DSH 插件机制 define + run。
- 或按项目的 plugin/ 目录里的源码文件手动注册。
3. 每个想看到宠物的对话标签页：设置 → 插件 → DeepSeek 桌面宠物 → 运行。
4. 刷新页面后宠物会消失（页面内存特性），重新点「运行」即可。

兼容性

- 审批检测依赖 DSH 的会话日志事件 approval/asked / approval/decided。
- 不同 DSH 版本事件名可能不同 —— 若不工作，检查 session/event 中审批事件的实际名称并调整。

源码（分享用）

插件源码已从 DSH 会话导出到仓库：

- plugin/host.js —— 插件 Host 半（进程内：状态机、事件监听、RPC、预览页路由）
- plugin/client.js —— 插件 Client 半（浏览器：画面渲染、拖动、音效播放）

加载方式：在 DSH 中通过插件机制 define + run 这两个文件（Host/Client 分别注册）；或参考「安装 / 加载」一节。
素材路径：通过环境变量 DSH_PET_ASSETS 指定（默认相对当前工作目录的 pet-assets/），分享前无需改代码。

音效版权说明（重要）

这个项目是干什么的：在 DSH 网页上养一只桌面宠物，核心用途是提醒用户及时处理审批、并在项目结束后提示去查看后续进展——避免因为漏看而让项目一直卡着。

为什么选这两个音效（也是一种致敬）：

- 🔊 地精「时间就是金钱，我的朋友」—— 审批出现时响起，非常贴合"该去处理了，别耽误"的提醒语境；
- 🔊 鱼人叫声 —— 项目完成时响起，自带喜感，让人会心一笑。

这两个音效来自《魔兽世界》（Blizzard 版权音频），不是本项目自有内容，选用它们既是语境契合，也算是对这款游戏的致敬：

- 仅供个人学习 / 非商业使用；
- 如果版权方（Blizzard）要求删除，请立即移除 pet-assets/sounds/ 下的对应文件；
- 如要公开发布 / 商用，请替换为自有或免版权（CC0）音效。

桌面宠物使用

- 拖动宠物可全屏自由摆放（不限制高度），拖动时朝移动方向转身。
- 首次点击/按住宠物后解锁浏览器音频（自动播放策略）。
- 任务完成/审批时所有页面会响对应声音。