MIT-licensed DSH desktop pet that renders 9 state animations in the corner of the Web UI and plays a system-wide completion sound — installed as a dynamic plugin via `cordis_define` and tuned through the CONFIG at the top of `src/host.js`.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-27
License
MIT
01What can it help you accomplish?
Put a desktop pet in the bottom-right corner of the DeepSeek Harness Web UI that reacts to Agent work states
A pet that toggles 9 state animations (Codex sprite contract, 8×9 grid) and plays the 「你干嘛~哎哟」 completion sound system-wide when any task finishes
DeepSeek Harness (DSH) users and developers who want a fun, visual companion that mirrors what the Agent is doing
Surface the Agent's live state (working / thinking / waiting / error / idle) as pet animations
Five derived modes mapped to dedicated sprite rows and bubble captions, based on polling the agents service plus tools/execute, approval/request and agent/request-error events
DSH users who want at-a-glance feedback on whether the Agent is running, blocked, or finished
Preview all animations without installing into DSH
A standalone demo page (demo/index.html) showing all 9 animations with drag interaction, served by a static server
Users who want to see the pet's look and feel before deciding to install it in DSH
02How to install into DeepSeek Harness
Prerequisites
- A DeepSeek Harness (DSH) session with the dynamic-plugin tools — the pet is installed via `cordis_define` and activated via `cordis_run`
- A local clone containing src/host.js, src/client.js and the assets/ sprite + voice files (paths are edited in CONFIG)
- A platform-appropriate play command — macOS defaults to `afplay`; Windows / Linux need a different one
Installation steps
- 01
Clone the repository: `git clone https://github.com/liyupi/dsh-kun-like-pet.git`
$ git clone https://github.com/liyupi/dsh-kun-like-pet.git
- 02
Edit the asset paths in CONFIG at the top of `src/host.js` (spritePath / voicePath / playCommand)
- 03
Generate the one-click install payload: `node scripts/build-kunpet-package.mjs -`
- 04
Paste the generated JSON payload into the `cordis_define` tool (kind "new" creates a fresh plugin; later updates use kind "existing" + pluginId)
- 05
Activate it with `cordis_run` — the pet appears in the bottom-right corner of the Web interface
Verify the integration
- Run the repo-integrity check: `node scripts/validate.mjs`
03DSH integration and capability boundaries
Installed as a DSH dynamic plugin inside a DeepSeek Harness session: the host half runs the state machine, asset routing and system audio while the client half renders via shell.overlay; activated through the cordis_define / cordis_run tools
9-state sprite animation rendering
Agent work state (running / thinking / waiting / error / idle, plus drag / click / task-complete)→9 state animations mapped to sprite rows (Codex pet sprite contract, 8 columns × 9 rows, each cell 192×208)
System-wide task-completion sound
task-completion event in any window or session→host process plays 「你干嘛~哎哟」 via a system command — audible on the machine regardless of browser mute
plays audio through the host process using the configured system commandDrag and click interaction
mouse drag or click on the pet→running animation that follows the drag direction; a wave on click (2.4s reaction)
Built-in debug tool
kun_pet_debug tool invocation→state-machine internal counters and polling health, on demand
Live Agent-state polling
agents service polled every pollMs (default 500) plus tools/execute, approval/request and agent/request-error events→five derived modes (working / thinking / waiting / error / idle) driving the pet animation
polls the agents service at the configured interval (default 500ms)
04Who is it for? When not to use it?
Good for
- DeepSeek Harness (DSH) users and developers who want a fun, visual companion that mirrors what the Agent is doing
- DSH users who want at-a-glance feedback on whether the Agent is running, blocked, or finished
- Users who want to see the pet's look and feel before deciding to install it in DSH
Not for
- As a dynamic plugin it is session-bound: the pet UI is only injected into the page of the session that activated it. To show the pet in every window, the plugin must be upgraded to a host-composed package.
- The bundled voice clip is a publicly shared meme audio and the sprite is a fan-made pixel character: both are limited to personal learning and communication — no commercial use; replace with copyright-free assets for commercial purposes.
05Compatibility, maintenance and safety notes
- The completion sound uses a system play command that differs by OS: macOS defaults to `afplay`, while Windows and Linux must be changed to their own commands (e.g. SoundPlayer / ffplay) in CONFIG.
- As a dynamic plugin it is session-bound: the pet UI is only injected into the page of the session that activated it. To show the pet in every window, the plugin must be upgraded to a host-composed package.
- The bundled voice clip is a publicly shared meme audio and the sprite is a fan-made pixel character: both are limited to personal learning and communication — no commercial use; replace with copyright-free assets for commercial purposes.
- Event listening cannot be relied on: in some deployments agent/status and agent/turn-stopping events never cross the dynamic-plugin bus (0 status events in 831 observations), so the pet polls the agents service as the most portable approach.
MIT · no release yet (repo created 2026-08-14)
06Frequently asked questions
How do I install this pet into DeepSeek Harness?
It is developed and verified as a DSH dynamic plugin (`cordis_define`). Clone the repo, edit the spritePath / voicePath / playCommand in CONFIG at the top of `src/host.js`, generate the payload with `node scripts/build-kunpet-package.mjs -`, paste the JSON into the `cordis_define` tool, then activate it with `cordis_run` — the pet appears in the bottom-right corner of the Web interface. You can also let the Agent run the whole flow inside a DSH session.
Why does the pet only show up in one window?
A dynamic plugin is session-bound: the pet UI is only injected into the page of the session that activated it. However, since v5 the completion sound is played system-wide by the host process, so any window and any session that finishes a task will sound on your machine. To show the pet in every window you would need to upgrade it to a host-composed plugin package.
Where do I adjust the polling interval or the sound?
All tunables are centralized in CONFIG at the top of `src/host.js`: spritePath, voicePath, playCommand, plus pollMs (default 500), celebrateMs (4800) and failedMs (2600).
Can I preview the animations before installing anything?
Yes — open `demo/index.html` (serve it statically, e.g. `npx serve .` or `python3 -m http.server`) to view all 9 animations and try the drag interaction, no DSH needed.
Can I use the bundled audio and sprites commercially?
No. `assets/voice.mp3` is a publicly shared meme voice clip (including a public figure's voice) and is for personal learning only — do not use it commercially; replace it with copyright-free assets if needed. The spritesheet is also a fan-made pixel character.
07Related DSH workflows
dsh-pet
by pc2005-cloud
DSH Web 界面桌面宠物：51 个透明 webm 动画随机链播、屏幕漫游、点击/拖拽；附提示词配方+AI 视频素材生成链可自造宠物
dsh-tavern
by flizzywine
SillyTavern 类文字游戏 Agent：候选项生成、对话式人物卡编辑、剧本模板。
dsh-dafeiyu
by qcytsn
Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.
whale-girl
by vlln
DSH Web 桌面宠物（可拖拽/投喂/玩耍，积累型资历成长）
08Data and sources
桌宠以 **DSH 动态插件** 形式开发并运行验证（`cordis_define`）。在 DSH 会话里让 Agent 执行，或手动调用 `cordis_define` 工具：
4. 用 `cordis_run` 激活，Web 界面右下角即出现桌宠。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-27. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.