dsh-pet-indesktop: A Draggable Whale Desktop Pet for the DeepSeek Harness Web GUI

What Does It Do?

It is a DSH plugin for DeepSeek Harness that places a desktop pet whale in the bottom-right corner of the DSH web GUI. It solves the lack of personality and companionship in the interface by rendering one inline-SVG whale that breathes, blinks and sways, can be dragged anywhere, and remembers where it was left. The plugin is maintained by Gjs9178U, written in JavaScript, created on 2026-10-16, and is still early-stage.

Core Features

• Desktop pet: overlays a small whale on the web interface, cycling through a 3.2-second breathing animation and a 5.2-second tail sway whose periods are not multiples of each other, with occasional blinks so it reads as alive rather than as a loop.
• Drag and position memory: mouse and touch share one Pointer Events path, and after release the position is written back to the host with a 600ms debounce, stored as viewport percentages (integers from 2 to 98) so it survives monitor changes and window resizing.
• Click to speak: a click shows one bilingual line (Chinese and English) that disappears after 2600ms; movement beyond 4px counts as a drag and does not trigger speech.
• Toggle button: a "pet on / off" action at the bottom of the sidebar hides or recalls the whale, and the visibility state is persisted too.
• No external assets: everything is drawn with inline SVG and CSS, with no images, fonts, video or network requests, and no localStorage — state lives only on the host side.
• Accessibility: when prefers-reduced-motion: reduce is detected, it switches to a still frame instead of slowing the animation down.

How to Use This Plugin?

Once enabled under the DSH web profile, the pet appears in the bottom-right corner of the web GUI; hold and drag it anywhere and the position is remembered on release. Click it to show a bilingual line that fades on its own, or use the "pet on / off" button at the bottom of the sidebar to hide and recall it. After enabling, restart the DSH service and force-refresh the browser, otherwise you will still see an interface without the pet — the most common cause of "installed but nothing happened". The pet state is stored in pet-indesktop/state.json under the DSH home directory, recording visibility, percentage coordinates and the pet's name, written atomically with strict validation.

How to Troubleshoot This Plugin?

If the pet does not appear after enabling, the host-side routes were likely not loaded by the running process, or the browser is still using a cached startup script; restart the service and force-refresh as described in the official instructions. If it still does not show, check the host-side liveness probe to confirm the plugin loaded, then inspect the issues field returned by the state endpoint to locate the problem. When the state file is corrupted the plugin repairs it itself and sets a healed flag, so no manual intervention is needed.