Introduction

DSH’s extension approach leans towards “everything is a plugin”; the community directory belongs to an independent site with no official affiliation to DeepSeek/QuantStudio. For DSH users who frequently use the Web UI, dsh-whale-pet provides a floating interactive whale desktop pet: it swims, tracks the mouse, responds to dragging and clicking, and can persist across sessions and reboots in the web profile.

What is it

lglglglgy/dsh-whale-pet is a DSH plugin maintained by lglglglgy with an MIT license. Its purpose is to add a floating interactive whale desktop pet to the DeepSeek Harness Web UI. The prerequisite is that the profile must have a Web runtime. The web profile comes with @deepseek-ai/dsh-web-app. If installed in a headless / TUI profile, it will not display.

Core Features

Below are the verified interactive capabilities:

  • Free swimming: The plugin automatically swims across the interface.
  • Eye tracking: The eyes follow the mouse position.
  • Drag: Hold the whale to move its position.
  • Click to spout water: A single click triggers a water-spraying effect.
  • Dizziness: Rapidly shaking back and forth will induce a dizzy state.
  • Repeated taps to wake up: Repeatedly tapping 5 times after dizziness can restore it.
  • Water waves: Displays a flowing water wave effect.
  • Tail flukes swing: The tail flukes swing while swimming.

After installing and restarting in the web profile, this state can persist across sessions and reboots.

Installation and Usage

First, confirm the current profile is web and has a Web runtime. Execute:

dsh plugin --profile web add github:lglglglgy/dsh-whale-pet

This command installs the plugin from the GitHub repository. Since client.js is already a built artifact, no additional build authorization is required to install from GitHub.

After installation, restart the Web UI:

dsh web

Plugin changes require a restart to take effect.

You can check the configuration:

dsh --profile web --dump-config

Confirm that dsh-whale-pet related items can be seen in the output. This plugin’s peerDependencies require react ^18.2.0, so the installation environment must meet this dependency requirement.

Typical Usage

After installing and restarting, you can operate as follows:

  1. Observe it swimming freely.
  2. Drag the whale by holding it; after releasing, it will rest for 20 seconds before swimming again.
  3. Click to spout water, accompanied by random bubble dialogue and a ring of bubbles.
  4. When using the keyboard, after using Tab to focus on the whale, pressing Enter or Spacebar is equivalent to clicking.
  5. Trigger dizziness: Shake back and forth rapidly.
  6. Wake up: Repeatedly tap 5 times after becoming dizzy.

Applicable Scenarios and Notes

It is suitable for users who want to add lightweight interactive elements to the DSH Web UI and are familiar with the plugin installation process. Please note the following:

  • Only applicable to profiles with a Web runtime; headless / TUI profiles will not display it.
  • Plugin changes require restarting the Web UI to take effect.
  • License is MIT.
  • The plugin runs with the current dsh process permissions; you should check the source code and license before installation.

To remove it, execute:

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

Conclusion

The value of dsh-whale-pet is quite specific: it adds a draggable, clickable, dizzy-able whale desktop pet to the DSH Web UI, persisting after a reboot in the web profile. The GitHub repository address is:

https://github.com/lglglglgy/dsh-whale-pet