Introduction¶

The philosophy of DSH is “everything is a plugin.” For developers using DSH Web, while the page already has model dialogue and tool calls, there is a lack of a lightweight, visible interactive feedback object. dsh-deepseek-pet puts the DeepSeek blue little whale desktop pet into the DSH Web page, allowing the desktop pet to float in the bottom-right corner of the page and allowing the Agent to trigger lines via the pet_say tool; during the start and end of dialogue, the desktop pet will also perform thinking and celebration states.

Below is an introduction to its features, installation, and typical usage.

What is this¶

dsh-deepseek-pet is an anthropomorphic pet plugin that floats over the DSH Web page. The repository path is txlznbzsdj-collab/dsh-deepseek-pet and the license is MIT.

The core problem it solves is: providing a draggable, clickable, and model-triggerable blue little whale feedback object within the DSH Web page, allowing developers to observe the linkage between the Agent and the page plugin on the web side.

Core Features¶

Model Integration¶

The Agent can call the pet_say tool to make the desktop pet speak.
The model can call the pet_say {text, mood?} command to make the little whale speak on the page.
Dialogue start (thinking) and end (celebration) states are synced to the desktop pet state.

Desktop Interaction¶

Floats in the bottom-right corner with a breathing + swaying animation and is draggable; remembers position, snaps back when released, and complains if dragged too far.
Click to speak character lines; lines include “Master”, “Big Fat Fish”, “Freeloader”, “Slacking off”.
Double-click triggers happy celebration and confetti particles; long-press triggers acting spoiled/cute.
Hover to wave hello; peek while typing; random bubbles (45~90s); squeeze and complain when against the edge; drowse when out of focus (Zzz).
Right-click menu has 8 items: Return to Bottom Right / Change Pose / Tell a Cold Joke / Today’s Fortune / Pat Head / Self-Introduction / Say Something / Hide.
After hiding, the little whale button in the bottom-right corner can recall it.

Installation and Enablement¶

First, confirm the environment: DSH (dsh web) and pnpm are installed.

The following steps will clone the repository, build the browser-side client.js, and install the plugin to the web profile.

git clone https://github.com/txlznbzsdj-collab/dsh-deepseek-pet.git
cd dsh-deepseek-pet
powershell -ExecutionPolicy Bypass -File ./build.ps1

build.ps1 will embed assets/small/*.png as base64 to generate client.js; client.js is the build artifact and is gitignored.

dsh plugin --profile web add <本目录绝对路径>

Here, fill in the absolute path of your locally cloned dsh-deepseek-pet directory for <本目录绝对路径>.

dsh web --port 3173

After the above steps, restart DSH Web and refresh the page, and the little whale should appear in the bottom-right corner.

Typical Usage¶

After enabling, you can interact with the desktop pet directly on the page: click, double-click, long-press, hover, and right-click menu are all available.

If you want to trigger model integration, you can say to the model:

让小鲸鱼说句话

The model-side call format is:

pet_say {text, mood?}

Suitable Scenarios and Notes¶

Suitable for the following situations:

Want a lightweight feedback object in the DSH Web page.
Want the Agent to trigger desktop pet lines via pet_say.
Want to see desktop pet state changes during the start and end of dialogue.

Special attention needed before installation:

The plugin runs with the current dsh process permissions; you should check the source code, build scripts, and license before installing.
The plugin license is MIT.
Character art comes from the DeepSeek anthropomorphic desktop pet assets of YunYueSama/codex-deepseek-pet; character images from that repository are not within its MIT license scope, but reuse is authorized by the original author; see ASSET_LICENSE.md for details.
client.js is a build artifact and is gitignored; after modifying assets or templates, you need to run build.ps1 again to generate it.
DSH (dsh web) and pnpm need to be installed.

Conclusion¶

The value of dsh-deepseek-pet is specific: adding an interactive, model-triggerable DeepSeek blue little whale to the DSH Web page and syncing dialogue start and end states to the desktop pet.

dsh-deepseek-pet: Embedding the DeepSeek Blue Little Whale Desk Pet in DSH Web