DSH 鲁迅先生桌宠（全局插件）

DSH Web client plugin：在 Web 界面右下角显示鲁迅先生 GIF 桌宠。四种状态各配一张专属 GIF，外加点击彩蛋交互，素材均来自用户提供的 C:\Users\26294\Desktop\sc\（原样复制，未重新设计）：

状态	素材文件（assets/）	来源
待机中	idle.gif	待机中.gif
正在工作	working.gif	正在工作.gif
任务完成	done.gif + done.mp3	任务完成.gif + 任务完成音频.mp3
点击彩蛋	egg.gif + egg.mp3	鲁迅卡通形象.gif + 鲁迅卡通形象音频.mp3

行为

• 待机中（无活动会话）：idle.gif，气泡灰色「待机中」
• Agent 运行中：working.gif，气泡蓝色「正在工作」
• 等待用户审批或问题回答：沿用 idle.gif，气泡琥珀色「等你决定」
• 任务完成（运行中 → 结束且非等待）：done.gif + 播放 done.mp3，气泡绿色「任务完成」； 完成动图固定展示 30 秒（音频播完即止、不提前退出）——30 秒内用户提问或新任务 开始则立即打断，30 秒无干扰后自动回到待机
• 点击桌宠（未拖动）：触发彩蛋 egg.gif + 播放 egg.mp3，气泡粉色「彩蛋！」； 彩蛋中再点可重新触发；彩蛋展示时长 = GIF 完整一轮 + 2 秒余量（客户端解析帧 延迟总和，等 GIF 解码完成才开始计时，当前素材一轮约 10 秒、展示约 12 秒；音频只 叠加播放、不驱动退出，不会中途截断；解析/解码失败时 12 秒兜底），期间 Agent 状态变化会随时打断特效
• 静音按钮：气泡右侧小圆钮 🔊/🔇，与气泡垂直居中对齐（独立可点击，气泡本身不拦截 鼠标）；点击切换，静音时不播任何音频（完成展示 30 秒照常、彩蛋展示 GIF 完整一轮 无声演出），状态存 localStorage，刷新后保持；静音瞬间会掐掉正在播的音频
• 隐藏/显示：气泡左侧小圆钮 ✕ 点击即整体隐藏宠物（GIF、气泡、按钮全部消失）； 隐藏期间不播任何音频、也不闪现提醒（区别于只关声音的静音），下次任务完成不触发 特效；恢复入口是隐藏后右下角一枚迷你鲁迅头像圆钮（36px，一眼可见），点击即 重新显示（设置页插件卡不可行：宿主只服务 host 半注册过设置命名空间的卡片）。 隐藏状态存 localStorage，刷新后保持
• 按住拖动可移动桌宠位置（Pointer Events，鼠标/触摸通用，拖出界会自动钳制在视口内； 位移超过 4px 判定为拖拽，不会误触发彩蛋）
• 桌宠以命令式 DOM 直接挂到 document.body（z-index: 2147483000，不依赖 react-dom/Portal），不受界面面板/弹层遮挡与容器裁剪，fixed 定位相对整个视口， 可全屏拖拽
• 状态以聊天气泡样式显示：渐变毛玻璃底 + 状态色光晕 + emoji 图标 + 水滴尾巴， 不对称圆角（右下收口）；状态切换 Q 弹入场；工作中带「正在输入」跳动圆点， 完成/彩蛋带弹跳点缀；五种展示色（灰/蓝/琥珀/绿/粉）

素材由 host 半通过 /dsh-luxun-pet/asset/{idle.gif,working.gif,done.gif,egg.gif,done.mp3,egg.mp3} 提供，带与 /api 一致的回环/可信域信任检查；状态来自 DSH 官方 sessions.list 快照， 不修改 DSH 核心。

全局安装（web profile）

插件目录固定在 C:\Users\26294\.dsh\plugins\dsh-luxun-desktop-pet，与任何项目无关。

cd $env:USERPROFILE\.dsh\profiles\web
pnpm install

前提是 package.json 中已登记：

"dependencies": {
  "dsh-luxun-desktop-pet": "link:C:/Users/26294/.dsh/plugins/dsh-luxun-desktop-pet"
}

且 dsh.profile.bundles 列表包含 dsh-luxun-desktop-pet。

用 link: 不用 file:：pnpm 对 file: 是装时拷贝（插件改了 node_modules 里的旧拷贝不跟着变，功能"消失"就是这来的），link: 才是 junction 直连插件目录。

修改插件文件后：host 半变更需重启 dsh web；client 半变更硬刷新浏览器即可。

GitHub：https://github.com/WangRunWei/dsh-luxun-desktop-pet