Dsh Kun Like Pet

🐤 Kun Like 桌宠

DeepSeek Harness（DSH）桌面宠物插件 —— 一只住在 Web 界面右下角的小坤宠。 它会盯着 Agent 干活：你搓代码时它努力搬砖，你思考时它托腮，等你回复时它翘首以盼，任务完成时它挥手跳跃、大喊 **「你干嘛~哎哟」** 🏀



✨ 特性

• 9 种状态动画：完全沿用 Codex 桌宠精灵图契约（8 列 × 9 行、每格 192×208），素材零重绘
• 实时感知 Agent 状态：轮询 agents 服务感知每个 Agent 的 running/idle 状态，配合 tools/execute、approval/request、agent/request-error 事件推导工作 / 思考 / 等待 / 出错 / 空闲五种模式
• 任务完成全机可闻：宿主进程用系统命令播放「你干嘛~哎哟」，任何窗口、任何会话完成任务都会响，与浏览器静音无关
• 可互动：拖动桌宠到处跑（跑步动画方向跟随），点击它会挥手打招呼
• 内置调试工具：kun_pet_debug 可随时查看状态机内部计数与轮询健康度

🎮 状态 → 动作映射

Agent 工作状态	桌宠动作	气泡文案
工作中（有工具在执行）	专注干活（第 7 行）	努力工作中…
回合中但空闲	思考循环（第 8 行）	思考中…
等待用户回复 / 审批	期待等待（第 6 行）	在等你回复哦~
出错	难过低落（第 5 行）	呜…出错了 (._.)
空闲	呼吸待机（第 0 行）	休息中~ 有事叫我
任务完成	挥手 + 跳跃庆祝（第 3/4 行交替）＋ 系统音「你干嘛~哎哟」	完成啦！你干嘛~哎哟
拖动	跑步（第 1/2 行，方向跟随）	呜哇~ 别拽我！
点击	挥手（2.4s 反应）	诶嘿~

🚀 安装

方式一：DSH 动态插件（推荐，已实测）

桌宠以 **DSH 动态插件** 形式开发并运行验证（`cordis_define`）。在 DSH 会话里让 Agent 执行，或手动调用 `cordis_define` 工具：

1. 克隆本仓库：

   git clone https://github.com/liyupi/dsh-kun-like-pet.git

2. 修改 `src/host.js` 顶部 `CONFIG` 中的素材路径：

   const CONFIG = {
     spritePath: '/你的/路径/dsh-kun-like-pet/assets/spritesheet.webp',
     voicePath:  '/你的/路径/dsh-kun-like-pet/assets/voice.mp3',
     // macOS 默认用 afplay；Windows / Linux 请改成对应播放命令
     playCommand: (path) => "afplay '" + path.replace(/'/g, "'\\''") + "'",
   }

3. 生成一键安装载荷并粘贴给 `cordis_define` 工具：

   node scripts/build-kunpet-package.mjs -   # 输出 JSON 载荷

   载荷结构（`kind: "new"` 创建新插件；后续更新用 `kind: "existing"` + `pluginId`）：

   {
     "plugin": { "kind": "new", "idPrefix": "kunpet" },
     "name": "Kun Like 桌宠",
     "purpose": "在 Web 界面右下角显示 Kun Like 桌宠，随 Agent 工作状态切换动作，任务完成时播放「你干嘛~哎哟」语音。",
     "code": { "host": "", "client": "" }
   }

4