MIT 开源的 DSH 桌面宠物插件：右下角小坤宠随 Agent 工作状态切换 9 种动画，任务完成播放系统级「你干嘛~哎哟」；以 `cordis_define` 动态插件形式接入，配置集中在 `src/host.js` 顶部 CONFIG。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-27
许可证
MIT
01它能帮你完成什么？
在 DeepSeek Harness 的 Web 界面右下角放一只会随 Agent 状态反应的桌面宠物
一只切换 9 种状态动画（沿用 Codex 精灵图契约 8 列 × 9 行）的桌宠，任务完成时在全机范围播放「你干嘛~哎哟」完成音
使用 DeepSeek Harness（DSH）的开发者与用户，想在写代码时有一只可爱的宠物陪着、直观反映 Agent 当前在做什么
把 Agent 的实时状态（工作 / 思考 / 等待 / 出错 / 空闲）变成桌宠动画
基于轮询 agents 服务与 tools/execute、approval/request、agent/request-error 事件推导的五种模式，映射到对应的精灵图行与气泡文案
想一眼看出 Agent 正在运行、卡住等待还是已经完成的 DSH 用户
不安装到 DSH 也能先预览全部动画
独立的 demo/index.html 演示页，可查看全部 9 种动画并拖动互动
想先看看桌宠长什么样、好不好玩，再决定是否装进 DSH 的用户
02如何接入 DeepSeek Harness？
前置条件
- 支持动态插件的 DeepSeek Harness（DSH）会话——桌宠通过 `cordis_define` 安装、`cordis_run` 激活
- 克隆后的仓库目录，包含 src/host.js、src/client.js 与 assets/ 下的精灵图和语音素材（路径需在 CONFIG 中修改）
- 适配当前系统的播放命令——macOS 默认用 afplay；Windows / Linux 需要改成对应命令
安装步骤
- 01
克隆仓库：`git clone https://github.com/liyupi/dsh-kun-like-pet.git`
$ git clone https://github.com/liyupi/dsh-kun-like-pet.git
- 02
修改 `src/host.js` 顶部 CONFIG 中的素材路径（spritePath / voicePath / playCommand）
- 03
生成一键安装载荷：`node scripts/build-kunpet-package.mjs -`
- 04
把生成的 JSON 载荷粘贴给 `cordis_define` 工具（kind 为 new 创建新插件；后续更新用 kind 为 existing 加 pluginId）
- 05
用 `cordis_run` 激活，Web 界面右下角即出现桌宠
验证接入成功
- 运行仓库完整性校验：`node scripts/validate.mjs`
03DSH 适配与能力边界
以 DSH 动态插件形式原生集成：在 DSH 会话中通过 `cordis_define` 安装、`cordis_run` 激活；host 半负责状态机、素材路由与系统音，client 半通过 shell.overlay 注入渲染动画
9 种状态动画渲染
Agent 工作状态（工作 / 思考 / 等待 / 出错 / 空闲，外加拖动、点击、任务完成）→映射到精灵图行的 9 种状态动画（Codex 桌宠精灵图契约，8 列 × 9 行、每格 192×208）
任务完成全机可闻的系统音
任意窗口 / 任意会话的任务完成事件→宿主进程用系统命令播放「你干嘛~哎哟」，本机必响，与浏览器静音无关
通过宿主进程按配置的系统命令播放音频拖动与点击互动
鼠标拖动桌宠或点击桌宠→跑步动画（方向跟随拖动方向）；点击触发挥手（2.4s 反应）
内置调试工具
调用 kun_pet_debug 工具→随时查看状态机内部计数与轮询健康度
实时感知 Agent 状态（轮询 agents 服务）
按 pollMs（默认 500）轮询 agents 服务，配合 tools/execute、approval/request、agent/request-error 事件→推导工作 / 思考 / 等待 / 出错 / 空闲五种模式并驱动桌宠动画
按配置的间隔（默认 500ms）轮询 agents 服务
04适合谁？何时不该用？
适合
- 使用 DeepSeek Harness（DSH）的开发者与用户，想在写代码时有一只可爱的宠物陪着、直观反映 Agent 当前在做什么
- 想一眼看出 Agent 正在运行、卡住等待还是已经完成的 DSH 用户
- 想先看看桌宠长什么样、好不好玩，再决定是否装进 DSH 的用户
不适合
- 动态插件是会话级绑定：桌宠界面只注入到激活它的会话页面；若要让桌宠形象出现在所有窗口，需要升级为宿主组合级插件包。
- 素材版权受限：assets/voice.mp3 为网络公开的二创梗语音片段（含公众人物声音），精灵图为粉丝二创像素形象，均仅供个人学习交流使用，请勿用于商业用途；商用需替换为无版权素材。
05兼容性、维护与安全提示
- 完成音依赖系统播放命令且因平台而异：macOS 默认用 afplay，Windows / Linux 需要在 CONFIG 中改成各自的命令（如 SoundPlayer / ffplay）。
- 动态插件是会话级绑定：桌宠界面只注入到激活它的会话页面；若要让桌宠形象出现在所有窗口，需要升级为宿主组合级插件包。
- 素材版权受限：assets/voice.mp3 为网络公开的二创梗语音片段（含公众人物声音），精灵图为粉丝二创像素形象，均仅供个人学习交流使用，请勿用于商业用途；商用需替换为无版权素材。
- 不能依赖事件监听：部分部署里 agent/status、agent/turn-stopping 等 Agent 状态事件不流经动态插件所在总线（831 次事件观测中 status 类事件为 0），因此桌宠采用轮询 agents 服务这一最可靠的跨部署方案。
MIT · 暂无 Release（仓库创建于 2026-08-14）
06常见问题
怎么把这只桌宠装进 DeepSeek Harness？
它以 DSH 动态插件形式开发并运行验证（`cordis_define`）：克隆仓库后，修改 `src/host.js` 顶部 CONFIG 中的素材路径，运行 `node scripts/build-kunpet-package.mjs -` 生成 JSON 载荷，粘贴给 `cordis_define` 工具，再用 `cordis_run` 激活，Web 界面右下角即出现桌宠；也可以在 DSH 会话里让 Agent 直接执行整个流程。
为什么桌宠只在某一个窗口里？
动态插件是会话级绑定：桌宠界面只注入到激活它的会话页面。不过 v5 起完成音由宿主进程系统级播放，任何窗口、任何会话完成任务本机都会响；若要让桌宠形象出现在所有窗口，需将插件升级为宿主组合级插件包。
想调整轮询间隔或音效，在哪里改？
所有可调项集中在 `src/host.js` 顶部 CONFIG：spritePath、voicePath、playCommand，以及 pollMs（默认 500）、celebrateMs（默认 4800）、failedMs（默认 2600）等。
不装 DSH 能先看效果吗？
可以。打开 `demo/index.html`（建议起个静态服务器，如 `npx serve .` 或 `python3 -m http.server`），即可查看全部 9 种动画并拖动互动，无需 DSH。
语音和精灵图素材能商用吗？
不能。`assets/voice.mp3` 为网络公开的二创梗语音片段（含公众人物声音），版权归原作者所有，仅供个人学习交流使用，请勿用于商业用途；如需商用请自行替换为无版权素材。精灵图同样为粉丝二创像素形象。
07相关的 DSH 工作流
dsh-pet
作者 pc2005-cloud
DSH 桌面宠物：一行命令装好即用的透明动画小桌宠，支持多开、大小位置随心配置；还内置 DIY 素材链，能用 AI 视频自造专属宠物
dsh-tavern
作者 flizzywine
基于DSH的Agent酒馆。类酒馆文字游戏Agent。兼容SillyTavern生态，人物卡直接导入就能玩。更快、更稳、更鲜活。所有模型都能用。手机也能玩。
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飞鱼陪伴插件，实时展示智能体状态，Windows 上置顶显示。
whale-girl
作者 vlln
DSH Web GUI 桌面宠物插件（QQ 宠物形态）：右下角悬浮、可拖拽/投喂/玩耍的积累型伙伴。
08数据与来源
桌宠以 **DSH 动态插件** 形式开发并运行验证（`cordis_define`）。在 DSH 会话里让 Agent 执行，或手动调用 `cordis_define` 工具：
4. 用 `cordis_run` 激活，Web 界面右下角即出现桌宠。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-27。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。