better-dsh-pet 🐾

A desktop-native pet bubble driven by DeepSeek Harness session events. 一只住在 Windows 桌面上的透明置顶大肥鱼：由 DSH 真实工作状态驱动，思考/工作/等待/完成/出错时自动切换动画并显示状态气泡。

📌 二创声明：本项目是基于 PC2005-cloud/dsh-pet 的二创修改版，感谢原作者的桌宠动画与设计。

dsh plugin --profile web add better-dsh-pet

重启 dsh web，桌面会出现独立置顶气泡窗口——51 个透明动画开箱即用。网页内不再显示浮动大肥鱼；设置入口在 设置 → 插件 → 插件配置 → 大肥鱼桌面伴侣。

💡 想自己造一只专属宠物？克隆 ysppwn721/better-dsh-pet 仓库，用内置素材链（AI 提示词 → 绿幕视频 → 透明动画，素材由豆包生成）从零生成，全流程可复现。

DSH 状态联动：监听 DSH 会话事件，按思考 / 工作 / 等待 / 完成 / 错误切换动画和气泡文案
独立桌面气泡：不再占用网页界面；透明、无边框、始终置顶的 Electron 窗口
51 个手绘风透明动画：待机呼吸、打瞌睡、玩魔方、哼歌、炸毛、吐泡泡、玩水枪、小提琴演奏、蓝鲸现世、吃白饭、照镜子、三支舞、写代码、四季动作（放风筝、堆雪人、吃冰淇淋、放烟花……）全部无缝衔接
永不停止的动画链：空闲时每段动画播完立即按概率选下一个（30% 待机 / 10% 转向 / 40% 动作 / 20% 移动）
点击 / 拖拽：点击有随机回应动画（开心 / 害羞 / 傲娇），可拖到任意位置
喂食互动：右键菜单可喂食，播放吃饭动画并显示感谢气泡
余额 / 进度汇报：气泡中显示当前任务进度和 DeepSeek 账户余额
完成反馈：任务完成时播放提示音并抖动宠物
对话吐槽：根据本次对话生成俏皮吐槽（会消耗 Token，可开关；也可右键手动触发）
番茄钟：右键菜单可开始 25 分钟专注 / 5 分钟短休息，气泡显示倒计时，结束时提示音 + 抖动
左右朝向：所有动画 CSS 镜像，人物可朝左 / 朝右
落地对齐：动画统一脚底线，宠物始终站在"地面"上
流畅切换：双缓冲 video 交叉淡入，切换零空白帧
无障碍友好：支持 prefers-reduced-motion

配置项	说明	当前状态
`enabled`	是否启用桌面大肥鱼	默认 true，可在 DSH 设置页切换
`scale`	角色大小（70%～140%）	默认 100%，设置页实时生效
`bubbleScale`	气泡大小（80%～120%）	默认 100%，设置页实时生效
`activityLevel`	空闲微动作频率：quiet / normal / lively	默认 normal
`reducedMotion`	减少动态效果	默认关闭
`bubbleMode`	气泡显示：always / hidden / custom	默认 always
`bubbleStates`	自定义模式下显示气泡的状态	默认 SUCCESS / ERROR / WAITING
`includeSubagents`	是否让子 Agent 参与状态选择	默认关闭
`helper.electronPath`	自定义 Electron 可执行文件路径	缺省自动探测 `DSH_PET_ELECTRON_PATH` / `require('electron')` / 本地 dsh-desktop-electron

dsh plugin --profile web remove better-dsh-pet

动画为透明背景；GIF 预览中透明部分显示为页面底色，实际播放为透明。

待机呼吸休闲东张西望原地漂浮踏步原地小憩沉眠点击回应 - 开心跃动被鼠标拖拽悬空反馈

全部 51 个动画见仓库：assets/thumb/。

这是完整的三件套项目，任何人 clone 仓库都可以从零生成自己的桌面宠物：

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

better-dsh-pet