dsh-pet-live2d

dsh-pet-live2d

给 DSH（DeepSeek Harness）Web GUI 用的 Live2D 桌宠插件 —— 一只可以拖动、跟着鼠标看、点她会害羞、 还会跟着会话状态换动作与表情的桌宠。自带 DS鲸鱼娘（8 组动作 + 44 个表情/道具），装完即用。

拖动定位 · 视线跟随 · 摸头互动 · 会话相位 · 右键换装 · 事件穿透 20 个互斥槽位 · 摸鱼随机演出 · 双半区插件，装完即用

是什么 · 快速上手 · 怎么玩 · 跟着会话走 · 设置 · 加一只宠物 · 目录结构 · 开发与验证 · 常见问题 · 交流群 · 许可

是什么

DSH 的 Web GUI 负责对话，而 dsh-pet-live2d 是挂在这块界面上的一只桌宠：她住在页面右下角，能拖、能缩、 跟着鼠标看，点她会有反应。更有意思的是她订阅 DSH 的真实事件（工具调用、审批请求、子代理、轮次结束……）， 于是「在想」「在跑工具」「在等你批准」「出错了」这些状态会变成她的动作、表情和台词 —— 不用盯着日志看进度。 另有桌面端（dsh-live2d-pet-desktop/，Tauri 壳）： 把同一份宠物代码放进透明置顶窗口、逐像素穿透到壁纸。Windows x64 的单文件 exe 随插件包分发（装完在设置里选「桌面」）；macOS（Apple Silicon）的构建由 CI 产出， 尚未在真机验证 —— 平台支持与已知限制见它的 README。 快速上手

在 DSH 里点几下就装好了（不用命令行）：

1. 侧栏点「插件」→「添加插件」； 2. 包名框里输入 dsh-pet-live2d，回车或点「安装」； 3. 装完点「立即启用」—— 只关掉对话框的话，它会是"已安装但关闭"，插件不会被加载； 4. 重启一次 dsh web，她就站在那儿了（启用了 HMR 的 profile 会自己重组，重启最稳妥）。 官方插件页目前不支持自动更新：升级要在这里先卸载、再按上面装一次。

习惯命令行的话，等价的几条： 仓库根目录没有 package.json：可安装的包在子目录 dsh-live2d-pet/ 里，所以从 Git 装必须带 #path:/dsh-live2d-pet。从 npm 装不用管这些。

装完之后会发生什么：