dsh-niulai-pet
中文 | [English](README_EN.md)
 
牛来桌宠 —— 在 dsh web 界面角落里养一头《牛来》的小牛。平时呼吸、眨眼、踱步、 打盹、气泡唠叨；agent 任务一完成，它就蹦出来喊一声「妈~~妈~~」。
桌宠本体在浏览器端（client 半）；host 半（index.js）只负责注册 settings 命名空间——dsh rc.7+ 的设置页「插件配置」区因此有一张牛来桌宠设置卡片， 配置由 dsh host 持久化（~/.dsh/settings.yaml）。rc.6 及更早没有该能力， 插件照常工作，配置留在 localStorage，只是没有设置卡片。 更新后刷新页面即生效，免重启。
在线试玩（免安装） —— 同一套代码的 standalone 页面，模拟任务驱动庆祝；想真养在 dsh 里再往下看安装。
皮肤
| 皮肤 | 素材 | 叫声 | 签名动作 |
|---|---|---|---|
| 牛来 | 抠图 + PIL 精修 | 原声（已降噪） | 连跳 |
| 牛来原皮 | AI 生图三视图抠图（无角幼年造型） | 同上 | 连跳 |
| 小黄 | 牛来幼年皮（去角+黄亮） | 同上 | 翻滚 |
| 奶牛 | 手绘扁平风（SVG 源在 tools/drawn/） | WebAudio 合成"哞" | 翻滚 |
| 熊猫 | 手绘 | 合成吱声 | 翻滚 |
| 蓝鲸 | 手绘（DeepSeek 蓝 + 虎鲸眼斑） | 合成鲸鸣 | 跃出水面（弧顶喷水） |
行为
| 交互 | 反应 |
|---|---|
| 待着不动 | 呼吸浮动；随机眨眼 / 小跳 / 踱步 / 趴下打盹 / 扭身子；偶尔气泡吐槽 |
| AI 会话在跑 | 气泡报时「AI 已经跑了 X分X秒…」 |
| 点击（戳） | 喊一声（只张合嘴不跳的是菜单里的「喊一声」）+ 绑定动作 |
| 拖拽 | 拎着走，松手落地回弹；位置记忆（localStorage） |
| 右键 | 菜单：声音 / 完成时喊 / 气泡唠叨（胶囊开关）+ 完成连喊 1-3 声 /<br>完成时动作 / 戳我动作 / 皮肤（循环项）+ 飞一圈 / 喊一声 / 关于 |
| 任务完成 | 喊声（可连喊）+ 气泡 + 嘴型开-合-开保持到尾音结束 + 绑定动作（6s 节流） |
动作库：飞行（向上抛物线）/ 摇摆舞 / 转圈 / 连跳 / 翻滚 / 跃出水面 / 奶牛摇， 任意皮肤可绑任意动作，「签名动作」= 跟随当前皮肤，「随机」= 现场抽。 动作绑定按皮肤记：切换皮肤不清空另一皮肤的绑定，没配过的皮肤用默认 （完成=签名动作，戳一下=连跳）。
任务完成信号来自 client runtime 的 sessions.list 快照订阅： running true→false（当前会话跑完）或 completed 新置位（后台会话完成）。 宿主太旧没有 sessions 服务时降级为仅手动交互。
设置卡片（dsh rc.7+）
rc.7 起，设置 → 插件 → 插件配置里有「牛来桌宠」卡片：声音 / 完成时喊 / 完成连喊（1-3）/ 气泡唠叨 / 皮肤下拉 / 完成时动作与戳我动作下拉（编辑当前 皮肤的绑定）。卡片与桌宠右键菜单读写同一份配置，改一边另一边即时反映； 持久化归 dsh host（~/.dsh/settings.yaml，跨浏览器共享）。旧版 localStorage 配置首次加载自动迁入（不覆盖设置页已改过的值）；位置 x 按设备留 localStorage，不进设置。
安装
# 从 npm 装（推荐）
dsh plugin --profile web add dsh-niulai-pet
# 或从 GitHub 装
dsh plugin --profile web add github:whitefirer/dsh-niulai-petlib/ 构建产物已入库，安装零脚本；首次安装重启一次 dsh web，之后升级刷新页面即可。
素材说明
素材全部入库，开箱即装即玩。 奶牛/熊猫/蓝鲸为手绘原创 （SVG 源文件在 tools/drawn/），可自由取用。
想换形象/声音：覆盖 assets/ 里的文件后 npm run build，刷新页面即生效。 重建全部素材的管线脚本在 tools/（见 AGENTS.md）。
开发
npm install
npm run build # 产物 lib/client.js（CJS 闭包 + __ModuleLoader__ 包装）
npm run typecheck装进 profile 调试：
cd ~/.dsh/profiles/web && pnpm add file:/path/to/dsh-niulai-pet
# 首次安装重启一次 dsh web（市场 shim 在宿主启动时挂载）；之后改代码只需
# npm run build + 刷新页面页面 URL 加 ?petdebug=1 会在 window.__niulai 暴露桌宠句柄 （celebrate/poke/setBusy/destroy），playwright 验证脚本靠它驱动。
实现要点（给后来的维护者）
ctx.effect的回调是立即执行的，清理函数要再包一层返回
（ctx.effect(() => () => cleanup())）——写错会在 apply 时直接把桌宠销毁。
- dsh 首屏 React 挂载会置换
document.body的直挂节点：插件用
MutationObserver 守灵，被清就自动重挂。
- 朝向翻转放在根节点
scaleX，气泡/菜单用scaleX(var(--face))抵消，
否则文字会镜像。
- 更完整的状态机、素材管线与坑清单见 [AGENTS.md](AGENTS.md)。