deepseek-harness-pets
DeepSeek Harness 桌宠插件：像素鲸鱼/机械章鱼随评测与回合状态在 DSH Web UI 中动起来；宠物资产兼容 Petdex 格式。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add deepseek-harness-pets@0.2.3
Deepseek Harness Pets 以 deepseek-harness-pets 发布，当前版本为 0.2.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
A desktop pet for DeepSeek Harness (dsh) — a whale that swims in the corner of your Web UI and reacts to your agent's turns.
A persistent little whale floats in the bottom-right corner of the DSH Web UI (shell.overlay slot — never touches your chat stream). It bobs while idle, braces while loading, swims hard while inferring, reviews while scoring, waves when a turn completes, leaps on SOTA, and floats belly-up on failure. Click it, hover it, drag it — it's a real pet.
Pet skins follow the Petdex standard (pet.json + 8×9 spritesheet), so assets interop with the Petdex desktop overlay and the petdex.dev community gallery.
Two commands (v0.2.2+ on npm):
dsh plugin --profile web add deepseek-harness-pets
dsh web
Open http://localhost:3080 — the whale is already there. Full guide (prerequisites, source checkout, hand-written patch row, troubleshooting): docs/installation.md.
Three-layer contract: dsh event signal → plugin semantic state → overlay CSS animation + bubble. Machine-readable: mappings/harness-states.json.
| dsh signal | State | Overlay visual / bubble |
|---|---|---|
| session idle | idle | bobbing doze / zzZ |
turn/start first prep | loading | buoyant anticipation / Loading data… |
step/start, tool activity | inferring | swimming sway / Inferring… |
| report/scoring tools | scoring | leaning review / Scoring… |
turn/end completed | done | fin waving / Done! |
| completion with SOTA text | sota | leap + splash / SOTA! |
turn/end failed | error | belly-up grayscale / [ERROR] check logs |
Animations are driven by the OVERLAY_ANIMATIONS table in src/pet-art.js (CSS transform keyframes over the official DeepSeek whale SVG). The Petdex 9-row set remains the asset contract for the future spritesheet switch point.
~/.dsh/settings.yaml (user layer) or the profile patch layer:
deepseek-harness-pets:
pet: random # deepseek-whale (default) | deepseek-octo | random (deterministic per turn id)
Skin discovery scans three sources, highest priority first: ~/.dsh/pets (custom) > ~/.petdex/pets (community) > bundled assets/pets. Details: docs/installation.md.
Each pet is a standard Petdex package under assets/pets/<slug>/ — contribute one via PR (pet/<slug> branch), or keep it local in ~/.dsh/pets/ where it always wins. Frame spec: 8×9 grid, 192×208 per frame, magenta #FF00FF background, row order idle→review. See CONTRIBUTING.md and each pet's spritesheet.README.md.
Published to npm by GitHub Actions via trusted publishing (OIDC, zero tokens): push a v* tag → CI verifies (tests, build, artifact-drift gate) → publishes with provenance. Maintainer runbook: CONTRIBUTING.md. Changelog: CHANGELOG.md.
shell.overlay, v0.2)settings.general.item slot)spritesheet.webp × 2, community-owned)npx petdex submit to the community gallerypet.json.Disclaimer: community-driven, unofficial, not affiliated with DeepSeek. "DeepSeek" is a registered trademark of DeepSeek AI, used here as thematic homage.
Package disambiguation: the official harness is the npm package
@deepseek-ai/dsh(Node.js). The PyPIdeepseek-harnessis an unrelated third-party Python library.