桌面小宠 XJYzhengshuai/dsh-desktop-pet

桌宠 · dsh-desktop-pet

给 DeepSeek Harness Web 界面加一只住在右下角的小宠物：它跟着智能体的状态换动作，任务完成时叫一声「你干嘛」。

给 DeepSeek Harness Web 界面加一只小桌宠。它平时待机，智能体干活时上下弹跳，任务完成时喊一句语音庆祝。

它什么时候做什么

| 状态 | 触发条件 | 表现 |
| 待机 idle | 没有会话在跑 | 轻轻呼吸起伏，影子同步缩放 |
| 思考中 working | 任意会话 running === true | 上下弹跳 + 轻微摇摆，头顶气泡「思考中…」和跳动的小点 |
| 完成 done | 从运行中变为空闲（当前这次任务结束） | 连跳五下 + 气泡「搞定啦！」，同时播放「你干嘛」语音 |

- 点一下宠物：随时播放语音并冒出「你干嘛！」气泡；如果浏览器拦了自动播放，点一下就会恢复。
- 鼠标移到宠物上：右上角出现 ×，点掉可以收起（刷新页面后回来）。
- 跟随 prefers-reduced-motion：系统开启「减少动态效果」时不动画，只保留状态与声音。
- 不占端口、不开服务、不发额外网络请求：图与语音都内联在浏览器模块里。

安装

需要 DSH Desktop（或带 Web 界面的 dsh 配置档），Node 22+。

1) 直接从 GitHub 安装（本仓库已包含构建产物 client.js，无需本地编译）
dsh plugin --profile desktop add "github:XJYzhengshuai/dsh-desktop-pet"

或者从本地 checkout 安装（开发时用这个，link 会跟随源码改动）
dsh plugin --profile desktop add "link:<本仓库路径>"

2) 重启一次 DSH（bundle 层在启动时组装）

装好后右下角就会出现桌宠；第一次在页面里点一下，之后语音才不会被自动播放策略拦。

卸载：

dsh plugin --profile desktop remove dsh-desktop-pet

结构

dsh-desktop-pet/
├── package.json # dsh.bundle + dsh.client(platform: web)
├── cordis.patch.yml # 插入一行 Host 插件（id: desktop-pet） ├── index.js # Host 半边：空实现，不占端口、不开服务 ├── client.js # 浏览器半边（构建产物，图与语音已内联） ├── client.src.js # 可读源码，占位符由 tools/build-client.mjs 替换 ├── locale/{zh,en}.json # 插件管理里显示的名称与描述 ├── icon.png # 插件图标 ├── assets/pet.png # 抠掉白底的角色图（384×566，透明 PNG） ├── assets/voice.mp3 # 「你干嘛」语音 └── tools/ ├── cutout.py # 原图 → 透明 PNG + 图标 ├── build-client.mjs # 把图与语音内联成 client.js └── smoke.mjs # 无浏览器冒烟测试

改完 client.src.js 或换素材后重新构建：

node tools/build-client.mjs
node tools/smoke.mjs

实现要点

- 渲染进 shell.overlay 槽（列表 slot，root 作用域），不往 document.body 追加第二个应用，也不读写宿主 DOM。
- 状态来自 ui-session 提供的标准 useSessions 选择器：遍历 byId，任一 running 即为工作中；running 由真变假的那一次渲染即「任务完成」。
- 图与音频以 base64 内联在 client.js，因此不需要 Host 路由、静态文件服务或额外网络请求，dsh web 与 Desktop 行为一致。
- 所有副作用（计时器、音频）都在 useEffect 内建立并在卸载时清理；模块卸载时插槽贡献自动撤销。

许可与素材

代码以 MIT 许可发布，见 LICENSE。

- assets/pet.png 由仓库作者的原始插图 037e5c03a40ca3b190714faeb5a07c79.jpg 经 tools/cutout.py 自动抠白底生成；
- assets/voice.mp3（「你干嘛」）由仓库作者提供。

两张素材随代码一同以 MIT 发布；如果你要再分发，请保留本节的来源说明。