🐤 kunpet-dsh
Kun Like 桌宠 · DeepSeek Harness (DSH) 桌面宠物插件 —— 一只住在 Web 界面右下角的小坤宠。
它盯着 Agent 干活：你搓代码它努力搬砖，你思考它托腮，等你回复它翘首以盼，任务完成时它挥手跳跃、大喊 「你干嘛~哎哟」 🏀
A Kun-Like desktop pet for DeepSeek Harness: lives in the bottom-right corner of the Web UI, reacts to agent activity, and plays a voice line when a task completes.
🙏 This package is a derivative of liyupi/dsh-kun-like-pet (original author liyupi, MIT). It repackages the pet as a self-contained DSH profile plugin and fixes Windows MP3 playback. Source: github.com/Yang-wudi/dsh-kun-like-pet.
✨ Features
- 9 种状态动画：完全沿用 Codex 桌宠精灵图契约（8 列 × 9 行、每格 192×208），素材零重绘
- 所有会话共享：作为 profile 插件挂载到宿主组合，每个会话页面右下角都有桌宠
- 重启仍在：随 DSH 启动自动装载，无需 cordis 会话、无需授权
- 任务完成全机可闻：宿主进程用系统命令播放「你干嘛~哎哟」（Windows/Mac/Linux 自动选择播放命令）
- 可互动：拖动桌宠满屏跑（跑步动画跟方向），点击它挥手打招呼
- 调试工具：每个会话都有
kun_pet_debug，随时查看状态机内部计数
📦 Install
dsh plugin --profile web add kunpet-dsh
Then restart DSH. The pet appears in the bottom-right corner of every session page.
Local install from source:
git clone https://github.com/Yang-wudi/dsh-kun-like-pet.git
dsh plugin --profile web add -w <clone-path>/packages/kunpet-dsh
# restart DSH
On Windows, pass the plain directory path (no file: prefix) when the target is on another drive.
🔧 Config
The plugin is self-contained (assets embedded). To override assets or behavior, add config to the loader entry in your profile's cordis.patch.yml:
- id: kun-pet
config:
spritePath: /your/path/spritesheet.webp
voicePath: /your/path/voice.mp3
All options live in lib/index.js DEFAULTS (pollMs, celebrateMs, failedMs, playCommand…).
🔍 Verify
curl http://127.0.0.1:3080/kun-pet/state
Should return JSON like {"mode":"idle","seq":…,"spriteUrl":"/kun-pet/spritesheet.webp",…}. /kun-pet/spritesheet.webp should return image/webp.
⚠️ Assets copyright
assets/voice.mp3 is a meme voice clip (contains a public figure's voice) and assets/spritesheet.webp is fan-made pixel art — personal study use only. Replace the files under assets/ with your own if you plan commercial use or redistribution.
📄 License
Code: MIT. Assets: personal study use only, per the notice above.
