dsh-niulai-pet

中文 | English

牛来桌宠 —— 在 dsh web 界面角落里养一头《牛来》的小牛。平时呼吸、眨眼、踱步、 打盹、气泡唠叨；agent 任务一完成，它就蹦出来喊一声「妈妈」。

全部能力在浏览器端（client 半）；host 半是空插件（index.js），仅为官方 CLI 安装识别（dsh.bundle manifest）。更新后刷新页面即生效，免重启。

皮肤

行为

动作库：飞行（向上抛物线）/ 摇摆舞 / 转圈 / 连跳 / 翻滚 / 跃出水面 / 奶牛摇， 任意皮肤可绑任意动作，「签名动作」= 跟随当前皮肤，「随机」= 现场抽。

任务完成信号来自 client runtime 的 sessions.list 快照订阅： running true→false（当前会话跑完）或 completed 新置位（后台会话完成）。 宿主太旧没有 sessions 服务时降级为仅手动交互。

安装

dsh plugin --profile web add github:whitefirer/dsh-niulai-pet

lib/ 构建产物已入库，安装零脚本；首次安装重启一次 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。