Preface¶

Under DSH’s “everything is a plugin” philosophy, the Web UI can be extended with lightweight interactive components. For developers who frequently interact with DeepSeek Harness sessions, a non-intrusive status indicator is quite useful: no need to read logs and guess progress, and no need to modify Harness or scrape page text. Below, we introduce dsh-whale-pet.

What Is This¶

dsh-whale-pet is a whale girl desktop pet plugin for the DeepSeek Harness Web UI, maintained by Er1c0v0. It injects into the Web UI through the official shell.overlay slot, without patching Harness or scraping UI text. The code is licensed under the MIT License, and the art assets are licensed under CC BY 4.0.

Core Features¶

• Mirrors five Harness states: idle, working, needs input, complete, and blocked.
• When idle, holds a pillow inspired by the DeepSeek whale and falls asleep after 40 seconds; wakes up when disturbed; plays a friendly three-pose wave on hover or focus.
• Reads privacy-safe activity summaries from Harness presentation metadata and displays them in a speech bubble; the bubble positions itself around the pet to avoid blocking the character.
• Supports dragging, keyboard movement, position reset, collapse/expand, reduced motion, and both English and Simplified Chinese.

Installation and Activation¶

The runtime requires Node.js 22.19+ or 24+, and DeepSeek Harness 0.1.0-rc.6.

Install and verify:

dsh plugin --profile web add dsh-whale-pet@0.1.0
dsh --profile web --dump-config
dsh --profile web

The dump-config output should contain exactly one dsh-whale-pet entry. After starting the Web UI, the pet will appear in the bottom-right corner.

Uninstall:

dsh plugin --profile web remove dsh-whale-pet
dsh --profile web --dump-config

Typical Usage¶

After installation, first start dsh --profile web. The pet will appear in the bottom-right corner of the Web UI. You can drag it with the mouse to reposition it, or use the keyboard to move it, reset its position, or collapse/expand it. When session state changes, the pet switches to the corresponding state; after 40 seconds of idling, it falls asleep, and hovering or focusing triggers a wave.

Use Cases and Notes¶

Suitable for users who want lightweight visual status cues in the DeepSeek Harness Web UI without patching Harness or scraping UI text.

It is recommended to review the source code, dependencies, and licenses before use. The plugin runs with the current DSH process permissions, so you should verify its behavior aligns with expectations before installation. According to the documentation, it only reads the current session state and provider-declared presentation metadata; it does not read tool arguments, prompts, model reasoning, or conversation text, nor does it make analytics requests. Preference settings are stored in browser-local storage.

Getting It¶

• GitHub: https://github.com/Er1c0v0/dsh-whale-pet
• The DSH community directory can be searched for dsh-whale-pet; the community directory is an independent site and does not represent an official app store from DeepSeek or High-Flyer.