@sundusk/dsh-yu-pet
适用于 dsh Web GUI 的 Xiaoyu 浮动网页宠物插件：8x8 精灵图帧动画，支持每帧计时、拖动奔跑、双击挥手，情绪会根据会话活动变化（思考 / 认可 / 提问 / 完成 / 失败）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:sundusk/dsh-yu-pet#90eede6b8b1ffefdc92b0ad9fc6fce9f10257f53Yu Pet 以 @sundusk/dsh-yu-pet 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH Web GUI 的悬浮桌宠插件。小雨会站在页面角落陪你干活： 空闲时平静站立、自然眨眼；agent 工作时思考；等待审批时望向你； 向你提问时做出抉择；任务完成跳起来庆祝；出错时沮丧地蹲下。
| mood | 颜色 | 气泡 | 触发 |
|---|---|---|---|
| idle | 蓝 #60A5FA | 无 | 会话空闲 |
| waiting | 绿 #34D399 | 正在思考中 | agent running |
| authorizing | 黄 #FACC15 | 等待你的授权 | 审批请求等待窗口 |
| questioning | 粉 #EC4899 | 做出你的抉择 | ask_user_question 执行期间 |
| done | 青 #22D3EE | 搞定啦 | 完成后 2.5s transient |
| failed | 红 #F87171 | 出错了 | agent/error（粘滞到下个状态） |
| disconnected | 灰 #9CA3AF | 无 | 兜底 |
image-rendering: pixelated），像素风不糊边。每个状态对应一组专属动作，各取一帧代表姿势：
| 动作 | 姿势 | 触发 |
|---|---|---|
| idle · 平静站立 | 双手插兜站立、循环眨眼 | 会话空闲 |
| waiting · 正在思考中 | 手扶下巴思考 | agent 工作中 |
| authorizing · 等待授权 | 抬头注视你 | 审批请求等待窗口 |
| questioning · 做出你的抉择 | 歪头、胸前摊开手掌询问 | ask_user_question 执行期间 |
| done · 搞定啦 | 跳起双手上举庆祝 | 任务完成后 2.5s transient |
| failed · 出错了 | 蹲坐抱膝沮丧，播一次停末帧 | agent/error |
| wave · 挥手 | 举右手挥两轮 | idle 时双击她 |
| disconnected · 未连接 | 闭眼静止，65% 透明度 | 兜底 |
| drag-right / drag-left · 奔跑 | 左右独立素材行，各 8 帧 | 拖拽水平位移 ≥2px，反向立即换向 |
| 动作 | 图集行 | 帧数 | 帧时长 | 播放策略 | 显示倍率 |
|---|---|---|---|---|---|
| disconnected | 0 | 1 | 1.00s | 静帧循环 | 1.00 |
| idle | 1 | 7 | 0.88 0.88 0.12 0.88 0.88 0.12 0.96 | 循环 | 1.00 |
| waiting | 2 | 6 | 0.20s | 循环 | 0.97 |
| authorizing | 3 | 6 | 0.24s | 循环 | 0.95 |
| questioning | 4 | 6 | 0.20s | 循环 | 1.00 |
| done | 5 | 5 | 0.12s | 循环 | 1.10 |
| failed | 6 | 8 | 0.16s | 播一次停末帧 | 1.02 |
| wave | 7 | 4 | 0.14s | 两轮后回 idle | 0.96 |
| drag-right / left | 拖拽图集 0 / 1 | 8 | 0.08s | 拖拽期间循环 | 1.00 |
# 已全局安装 dsh CLI 的话
dsh plugin --profile web add github:sundusk/dsh-yu-pet
# 或者通过 npx 调用（无需全局安装）
npx @deepseek-ai/dsh plugin --profile web add github:sundusk/dsh-yu-pet
重启 dsh web 后生效，小雨会出现在页面右下角；设置入口在
侧边栏 → 设置 → 「小雨宠物」。仓库已包含可直接加载的 host / browser
两个插件部分，安装时不需要执行任何构建脚本。
插件管理依赖 pnpm（Homebrew 安装：
brew install pnpm）。
dsh-yu-pet/
├── package.json # dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml # 向 web profile 插件表插入 xiaoyu 行
├── lib/
│ ├── index.js # Host 半：活动事件 → mood 状态机 + /api/xiaoyu/* 路由
│ └── client.js # Browser 半：悬浮渲染 + 交互 + 设置页
├── assets/
│ ├── XiaoyuSprites.png # 8×8 状态图集 1536×1664（源格式备份）
│ ├── XiaoyuDragSprites.png # 2×8 拖拽奔跑图集 1536×416（源格式备份）
│ ├── XiaoyuSprites.webp # 无损 WebP（运行时优先，体积约 -30%，像素一致）
│ └── XiaoyuDragSprites.webp
├── docs/poses.png # 动作图鉴预览图（每状态一帧）
├── LICENSE
└── README.md
Host 半从包内 assets/ 目录解析图集（WebP 优先、PNG 回退），无任何绝对路径配置。
想替换角色：保持 PNG 为 RGBA、固定网格（状态图集 8×8、拖拽图集 2×8、每格 192×208）、
未使用格透明；按 lib/client.js 里 ANIMS 的 row / durations / scale / once
协议调整每行动画的帧数与节奏即可，渲染层无需改动。
BSD-3-Clause，见 LICENSE。