brianwang2007xjtu/dsh-nailong-pet

README 摘要

dsh-nailong-pet 🐉 给 DeepSeek Harness (DSH) 的 Web 界面装一只会动的 奶龙桌宠 ：它常驻在页面右下角，会根据 Agent 的实时工作状态切换动画，任务完成时还会蹦起来喊一句「我是奶龙～」。 目录 - 它能做什么 - 效果预览 - 状态 → 动作映射 - 工作原理 - 安装 - 配置 - 交互 - 项目结构 - 素材来源与版权 - 技术备忘：帧动画为什么不会闪 - 常见问题 - License 它能做什么 - 常驻 Web 界面右下角 （ shell.overlay 等价位置），不遮挡对话内容。 - 依据 Agent 状态实时切换 9 组精灵动画中的相应动作。 - 任务完成（Agent 由 running → idle）时： 跳跃庆祝 + 气泡「我是奶龙～」+ 播放语音 。 - Agent 出错时显示难过表情 + 气泡「哎呀…出错了」。 - 可 拖动 摆位、 单击 打招呼（重放语音）、 静音 、 隐藏 （隐藏后留一个 🐉 按钮恢复）。 效果预览 四种状态的真实精灵帧 （截取自 sprite.webp ）： 「工作中」动画循环演示 （GIF，取自精灵图第 7 行原地跑）： 状态 → 动作映射 Agent 状态 触发条件 奶龙动作（精灵图行） idle 无 Agent 运行 呼吸眨眼循环（row 0） running 任一 Agent 正在工作 原地跑 ↔ 思考检查交替（row 7 / row 8） 完成 Agent 由 running 转 idle 跳跃庆祝 + 语音「我是奶龙～」（row 4） 出错 捕获到 agent/error 难过 + 「哎呀…出错了」（row 5） 打招呼 用户单击桌宠 挥手 + 重放语音（row 3） 状态切换由 Host 侧的 agent/status 事件驱动，浏览器端每 pollMs 轮询一次 /nailong/state （默认 600ms）。「完成」判定为：某个 Agent 从 running 变为 idle 且此时没有任何 Agent 仍在运行。 工作原理 这是一个 零构建步骤的静态 Host 插件 （与 dsh-agent-teams / dsh-memory-evolve 同构），全部逻辑收敛在单个 index.js 里，浏览器端是一段纯 DOM 脚本 assets/pet.js 。它不需要 React 客户端打包、不需要 dsh.client 扫描，也不依赖动态插件运行时。 关键点： - 状态聚合 ：Host 插件挂在宿主根作用域，能收到所有 Agent 的 agent/status 事件；用 Map 聚合，只要还有任一 Agent 在运行就显示「工作中」，全部空闲才算「完成」。 - 兜底读取 ：若插件从未收到过 agent/status 事件（极端情况下）， /na…

分类