🐯 dsh-pet-shura — 修罗小脑斧
An animated desktop pet for the DeepSeek Harness (DSH) web surface. A white
winged-armor guardian tiger with gold light armor, red wing armor, a green
spirit core and tiny fangs — hatching code-guarding, error-warning,
evidence-review and safety-gate instincts.
Built from a hatch-pet
v2 spritesheet (1536×2288, 8 cols × 11 rows, 192×208 cells) with a
zero-dependency host plugin: it taps the served index.html and injects one
self-contained page script, plus serves the spritesheet over a dedicated
route. Nothing touches your model traffic.
Install
dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-pet-shura"
# restart dsh web, then refresh the page — the pet appears bottom-right
Uninstall
dsh plugin --profile web remove dsh-pet-shura
# restart dsh web
Features
| Feature | Detail |
|---|
| Speech bubble | Codex-style bubble above the pet, fed over SSE (/pet/events) |
| Thread overview | Tracks every busy thread (session): "🔧 3 个线程在忙：主线程在跑终端命令，子线程 #1 在写文件" — refreshed every 15 s, only when the picture changes |
| Line bank | Varied Chinese lines per event kind (user/work/done/error/ask/reply/turn-end/workflow/goal) plus idle self-talk every 45–90 s — the pet rarely repeats itself |
| Full animation | All 11 v2 rows: idle breathing, running left/right, waving, jumping, failed, waiting, task-running, review, plus 16-direction look loop |
| Look-at-mouse | Tracks your cursor with 16 direction frames (240px radius) |
| Drag & drop | Position remembered in localStorage['dsh.pet.pos'] |
| Thread status card | Double-click the pet (or right-click → 线程状态) shows a token-styled card listing every busy thread (session) and what tool it is running, fed by GET /pet/status |
| Status symbols | Design-review extras: floating ? while thinking, red shaking ! on error, ✓ flash on success, Zzz rising while idle-waiting |
| Plugin ring | A semi-circular tool ring around the pet (up to 6 nodes, one per busy thread) fed by GET /pet/status: each node shows a tool-type icon, lights up with stagger while threads are busy, and the ring fades out when idle — the design review's plugin-ring concept |
| Core glow | An emerald radial glow behind the pet brightens while working — the "energy core, state visible" idea from the design review |
| Random actions | Waves / jumps / tumbles / paces every 7–16 s; waiting pose after 22 s idle |
| Settings panel | Right-click the pet → ⚙️ 设置: size (60/75/100%), random actions, look-at-mouse, reset position — persisted in localStorage['dsh.pet.settings'] |
| Right-click menu | Pet info · rest (hide, recall via 🐯 button) · thread status · settings |
| Safe failure | Script removes itself when the spritesheet is unavailable; never disturbs the host page |
Development
dsh-pet-shura/
├── package.json dsh.bundle.patch → cordis.patch.yml
├── cordis.patch.yml profile patch: mounts the pet-shura row
├── lib/
│ ├── index.js host plugin: spritesheet route + index tap
│ └── pet-client.js self-contained browser script (IIFE, no deps)
├── assets/
│ └── spritesheet.webp v2 pet atlas (1536×2288)
├── README.md / README.zh.md
└── LICENSE MIT
lib/pet-client.js is the only file you usually edit. It is inlined into
index.html by tapIndex, so a change is a commit away — no build step.
Credits
Pet art: hatched 2026-08-10 with the Codex hatch-pet skill for wx.
DSH pet plugin: dsh-pet-shura.
