Skip to content
  • Home
  • Plugin manual
  • dsh-whale-pet

lglglglgy/dsh-whale-pet

30Last commit Aug 14, 2026

dsh-whale-pet DSH plugin

dsh-whale-pet adds a cute animated whale to the bottom-right corner of your DeepSeek Harness Web UI. It swims autonomously, tracks your cursor, and responds to clicks and drags. The whale can even be made dizzy by rapid shaking, then revived by clicking 5 times.

ui-productivity

How to install the dsh-whale-pet DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-whale-pet DSH plugin.

dsh-whale-pet DSH plugin data source

dsh-whale-pet DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-whale-pet DSH plugin can do

  • Automatic horizontal swimming with slight vertical drift
  • Eye tracking that follows the mouse cursor
  • Drag-and-drop to any position on the screen
  • Click to trigger water spout, bubble dialogue, and popping bubbles
  • Dizziness effect triggered by rapid back-and-forth shaking, with spiral eyes, star halo, drool, and immobility
  • Wake-up mechanism: click 5 times while dizzy to restore normal state
  • Animated belly wave lines and fin flapping during swimming
  • Keyboard support: Tab focus then Enter/Space to trigger click action

Where the dsh-whale-pet DSH plugin fits

  • Add a fun, interactive mascot to your DSH Web UI for personal enjoyment
  • Demonstrate DSH plugin capabilities for educational or showcase purposes
  • Provide a gentle, non-intrusive visual feedback element during wait times
  • Customize the whale's appearance and behavior by editing client.js for personal projects

Who the dsh-whale-pet DSH plugin is for

  • DSH users who want to personalize their Web UI with a playful pet
  • Developers learning how to build DSH plugins with browser-side functionality

dsh-whale-pet DSH plugin limitations

  • Only works in the `web` profile with a Web runtime (requires `@deepseek-ai/dsh-web-app`); not available in headless or TUI profiles
  • Requires a restart of the Web UI (`dsh web`) after installation to take effect
  • The whale is purely decorative with no functional utility beyond interaction
  • Dizziness trigger requires rapid shaking; normal dragging or single-direction fast shaking will not cause it
  • Behavior and appearance changes require direct editing of `client.js` and re-installation

dsh-whale-pet DSH plugin: from the repository README

Quoted from the lglglglgy/dsh-whale-pet README, the upstream source of the dsh-whale-pet DSH plugin. Copyright remains with the original authors.

一只会自己游来游去、会晕、会喷水、还会盯着你鼠标看的蓝色鲸鱼，住在你的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI 右下角。 > 装在 `web` profile 里，重启后永久生效——跨 session、跨重启都在。 <img width="450" height="116" alt="file-b1580f974e659d5989789758a6030f87" src="https://github.com/user-attachments/assets/5886a71a-de7d-4a20-a4be-12dd59ca06d4" /> --- ## ✨ 它会做什么 | 能力 | 说明 | | --- | --- | | 🏊 自由游动 | 自动在屏幕上以水平为主地游来游去，上下只做小幅漂移 | | 👀 眼神跟踪 | 眼睛始终盯着你的鼠标光标，游到哪看到哪 | | 🖱️ 拖拽 | 按住就能把它拖到任何位置 | | 💦 点击喷水 | 单击（或键盘聚焦后按 Enter / 空格）会喷水柱 + 冒气泡对话 + 炸开泡泡 | | 😵 晕眩 | 快速来回甩动它，会晕过去：螺旋眼、绕头的星星（带拖尾）、流口水、原地静止 | | 🖱️ 连点叫醒 | 晕眩后连续点 5 下就清醒恢复 | | 🌊 水波 | 肚皮下方有会流动的波浪线，一部分藏在身体后面 | | 🐋 腹鳍摆动 | 游动时腹鳍会来回摆动 | --- ## 🎮 玩法详解 **基础交互** - **看它游**：啥也不用做，它会自己在屏幕里水平游动，偶尔自动喷一口水。 - **拖它**：按住鲸鱼拖动即可；松手后它会休息 20 秒再继续游。 - **点它**：单击 → 喷水 + 随机气泡对话（如「噗噜噗噜~」「你好呀！🐳」）+ 一圈泡泡。 - **键盘**：Tab 聚焦到鲸鱼后，按 Enter 或空格等同于点击。 **怎么让它晕 😵** 1. 按住鲸鱼，**快速来回甩动**（左右快速甩几下）； 2. 它就会进入晕眩状态：眼睛变成旋转的蚊香螺旋、头顶出现一圈带拖尾的星星、嘴角流口水、身体完全静止； 3. 晕眩时**连点 5 次**就能叫醒，它会喊「清醒啦！✨」然后继续游。 > 普通拖动、单方向快甩都不会误触发晕眩，只有「快速 + 往返」才算。 --- ## 📦 安装 ```sh # 从 GitHub 安装（推荐） dsh plugin --profile web add github:lglglglgy/dsh-whale-pet # 或从本地目录安装 dsh plugin --profile web add ./dsh-whale-pet # 或从 tarball

Read the full READMEThe repository declares no license. Check with the authors before using it.

dsh-whale-pet DSH plugin questions

I installed the plugin but I don't see the whale. What should I do?

Make sure you installed it on the `web` profile using `dsh plugin --profile web add ...`. Then restart the Web UI with `dsh web`. The whale only appears in the Web UI, not in headless or TUI profiles. If you still don't see it, verify the installation with `dsh --profile web --dump-config` and check for the `whale` entry.

How do I uninstall the whale pet?

Run `dsh plugin --profile web remove dsh-whale-pet` and then restart the Web UI. This will remove the whale from the interface. You can reinstall it later if you want.

Can I change the whale's appearance or behavior?

Yes, you can edit the `client.js` file directly (it's a built bundle, but you can modify coordinates, colors, animation parameters, etc.). After editing, re-add the plugin using `dsh plugin --profile web add ./dsh-whale-pet` to apply changes. Note that the plugin does not provide a configuration UI.

Does the whale affect performance or consume resources?

The whale is a lightweight CSS/JS animation that runs in the browser. It should have minimal impact on performance. However, if you are on a very low-end device or have many other heavy animations, you might notice some lag. You can always remove it if needed.

Can I have multiple whale pets?

The plugin is designed to add a single whale at the bottom-right corner. To have multiple whales, you would need to fork the plugin and change the entry points or create separate instances. There is no built-in support for multiple whales.