codex-pets
适用于 DSH Web 客户端的通用 Codex 兼容动画宠物宿主
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Skylarking/dsh-plugin-codex-pets#22e93f403d8795627042e0df8bc5855d35047f89Codex Pets 以 codex-pets 发布，当前版本为 2.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Runs animated pets in DSH Web using the Codex pet.json protocol. The plugin scans ~/.codex/pets/*/pet.json by default and includes Jiaran as a fallback asset.
cd /path/to/deepseek-harness-desktop
pnpm dsh plugin --profile web add ./plugins/codex-pets
pnpm dsh web
Clicking waves, hovering jumps, and horizontal dragging runs in the matching direction. Double-clicking jumps and returns the pet to the bottom-right corner. Right-click the pet to cycle through discovered pets.
A pet directory contains at least:
my-pet/
├── pet.json
└── spritesheet.webp
pet.json uses the Codex format:
{
"id": "my-pet",
"displayName": "My pet",
"spriteVersionNumber": 2,
"spritesheetPath": "spritesheet.webp"
}
Place the complete directory at ~/.codex/pets/<pet-name>/ and restart DSH. Desktop and plugin source do not need modification. This is the same installation directory and manifest format used by Codex. The plugin supports v1 (8×9) and v2 (8×11) atlases. Standard rows are idle, running-right, running-left, waving, jumping, failed, waiting, running, and review.
Open Settings -> Plugins -> Plugin configuration to manage this plugin. The
card can show or hide the desktop pet, choose any discovered Codex pet, and
resize it from 50% to 200%. These values belong to codex-pets and are stored
under that namespace in the profile settings document.
Override plugin configuration in the profile's cordis.patch.yml:
- id: codex-pets
config:
activePet: my-pet
codexPetsRoot: /path/to/codex/pets
petDirectories:
- /path/to/another-pet
activePet: initially selected pet id.codexPetsRoot: automatically scanned root, defaulting to ~/.codex/pets.petDirectories: additional individual pet directories.The configuration card is removed with the plugin. Removing codex-pets also
removes its codex-pets settings section; other plugin and product settings
remain untouched.
The number badge beside the pet shows active session count. Clicking it opens a list containing the current or background running sessions, sessions awaiting input or plan review, and unread completed sessions. Clicking a row opens that session in DSH.
Frame counts, per-frame timing, return to slow idle after three action loops, activity priority, and drag thresholds follow the Codex state machine.
cd /path/to/deepseek-harness-desktop
pnpm dsh plugin --profile web remove codex-pets
Desktop destroys the plugin-declared transparent window after removal. The main interface, settings, and pet directory retain no plugin-injected state. User-installed assets under ~/.codex/pets are not deleted.