orxz/deepseek-harness-pets
A whale that swims in the corner of DSH Web and reacts to what the agent is doing, with Petdex-compatible skins.
Runs a three-layer contract — DSH event signal, plugin semantic state, overlay CSS animation plus bubble — so the whale is a readout of the session rather than a decoration: 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. The mapping is machine-readable in mappings/harness-states.json rather than buried in code, which is what makes a new skin or a new state possible without reverse-engineering the component. Click, hover and drag all do something, and a dragged position persists.
Install
dsh plugin --profile web add deepseek-harness-petsThe npm line; the README's screenshots are live captures from a real dsh web session on dsh 0.1.0-rc.5 with zero console errors, which is a more useful compatibility statement than a badge. Choose a pet in ~/.dsh/settings.yaml or the profile patch layer with pet: deepseek-whale, deepseek-octo, or random (deterministic per turn id). Custom skins go in ~/.dsh/pets, which always wins over the community and bundled directories. One README note worth repeating: the npm package @deepseek-ai/dsh is the official harness, while the PyPI deepseek-harness is an unrelated third-party Python library — do not install the Python one looking for this.
Compatibility
A DSH Web profile. The pet renders in the shell.overlay slot, so it never touches the chat stream or the composer. Skins follow the Petdex standard — a pet.json plus an 8x9 spritesheet at 192x208 per frame — which means assets interoperate with the Petdex desktop overlay and the community gallery rather than being a private format. Skin discovery scans three sources in priority order: ~/.dsh/pets, then ~/.petdex/pets, then the bundled assets/pets. Host static serving for custom and Petdex skins is still open on the roadmap, so the bundled path is the limitation to expect today.
Details
- Repo: orxz/deepseek-harness-pets
- Category: Just for Fun
- Stars: 1
- Version: 0.2.3 (npm)
Alternatives
BorisXiao/dsh-cyber-pet · wyx135230/DeepSeek-Office · vortioxetine213/dsh-coo-pet