deepseekplugins

DeepSeek Harness plugin

deepseek-harness-pets

DeepSeek Harness 桌宠插件：像素鲸鱼/机械章鱼随评测与回合状态在 DSH Web UI 中动起来；宠物资产兼容 Petdex 格式。

Just for Fun
Jump to install

Source facts

Repository
orxz/deepseek-harness-pets
Latest update
Aug 15, 2026
Category
Just for Fun
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/orxz/deepseek-harness-pets
Plugin: deepseek-harness-pets
Author: orxz

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

deepseek-harness-pets

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.

See it in action

Live captures from a real dsh web session (dsh 0.1.0-rc.5, zero console errors):

Idle — bobbing doze, zzZHover — "huh?"Click — happy hop + cheerDragged — position persists
![Idle overlay in the bottom-right corner](docs/screenshots/01-idle-overlay.png)![Hover reaction bubble](docs/screenshots/02-hover.png)![Click reaction bubble](docs/screenshots/03-click.png)![Pet dragged to a custom position](docs/screenshots/04-dragged.png)

Drag it anywhere inside the viewport — the position is clamped and survives reloads (localStorage). Full set: [docs/screenshots/](docs/screenshots/).

Install

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](docs/installation.md).

State mapping

Three-layer contract: dsh event signal → plugin semantic state → overlay CSS animation + bubble. Machine-readable: [mappings/harness-states.json](mappings/harness-states.json).

dsh signalStateOverlay visual / bubble
session idleidlebobbing doze / zzZ
turn/start first preploadingbuoyant anticipation / Loading data…
step/start, tool activityinferringswimming sway / Inferring…
report/scoring toolsscoringleaning review / Scoring…
turn/end completeddonefin waving / Done!
completion with SOTA textsotaleap + splash / SOTA!
turn/end failederrorbelly-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.

Configuration

~/.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](docs/installation.md#configuring-the-pet).

Creating a skin

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](CONTRIBUTING.md) and each pet's spritesheet.README.md.

Release

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](CONTRIBUTING.md). Changelog: [CHANGELOG.md](CHANGELOG.md).

Roadmap

  • [x] Full-pipeline verification against a real dsh checkout (install → composition → boot graph → client bundle → settings, 2026-08-15)
  • [x] Persistent floating overlay form (shell.overlay, v0.2)
  • [x] Overlay live verification (bottom-right residency, interactions, drag persistence, zero console errors, 2026-08-15)
  • [x] Published to npm via CI trusted publishing (v0.2.2, zero token; topics: dsh-plugin/pet/deepseek/petdex)
  • [ ] Settings-panel pet picker row (settings.general.item slot)
  • [ ] Pixel spritesheets (spritesheet.webp × 2, community-owned)
  • [ ] Host static serving for custom/petdex skins (removes the single-SVG limitation)
  • [ ] Host-side event family for precise eval-phase & SOTA detection
  • [ ] npx petdex submit to the community gallery

Contributing & license

  • Guide: [CONTRIBUTING.md](CONTRIBUTING.md) · Architecture evidence: [docs/architecture/](docs/architecture/)
  • Code MIT ([LICENSE](LICENSE)); pixel assets © their contributors, per each pet.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 PyPI deepseek-harness is an unrelated third-party Python library.

Back to searchOpen GitHub repository

More related plugins

View category