dsh-plugin-pet

A virtual pet companion for the DeepSeek Harness web GUI: built-in, custom, and Codex-style sprites with mood animations driven by live agent state.

中文

A desktop pet for DeepSeek Harness Web GUI, inspired by the Codex companion and Claude Code Buddy. The pet lives in the bottom-right corner and reacts in real time to the agent state (thinking / tool calls / errors / turn completed / waiting for you), with rename, scale, visibility, and full reskinning support:

• 6 built-in sprites (blob / cat / duck / robot / axolotl / ghost; inline SVG, pure CSS animation)
• Custom image upload (PNG / JPEG / GIF / WebP; animated images play as-is)
• Codex-style multi-frame spritesheets — import a Codex pet pack (pet.json + spritesheet.webp, V1 1536×1872 and V2 1536×2288; see the Codex pet package spec), or configure a generic grid (columns / rows / fps / per-mood state rows)

All state is stored under $DSH_HOME/storages/dsh-plugin-pet/ and survives dsh web restarts.

Structure

File	Purpose
lib/index.js	Host plugin: pet persistence + HTTP routes mounted on the harness webServer service
lib/client.js	Browser bundle (hand-written factory-CJS, no build step): pet overlay and settings panel
test/	node --test suite covering host routes and the zero-dependency image sniffer

This is a dual-face package: the host half is a plain Cordis plugin; the client half is declared through "dsh": { "client": { "platform": "web", "inject": [], "immediately": true } } plus the export, so the harness client-modules system serves it at and loads it immediately at boot.