Preface¶

The philosophy of DSH is “everything is a plugin.” For users of the DeepSeek Harness Web UI, whether the current Session is idle, executing a task, or waiting for interaction usually depends on interface prompts. dsh-deepseek-girl-pet is an open-source Cordis desktop pet plugin that adds an animated character to the bottom-right corner of the interface. It switches animations based on the current Session state and follows the mouse in 16 directions.

It does not modify Session data, conversation history, or DeepSeek Harness core source code, making it suitable for scenarios where you want to add a lightweight status indicator to the Web UI.

What Is This¶

dsh-deepseek-girl-pet is an open-source desktop pet plugin for the DeepSeek Harness Web UI, with the repository path f0909172434/dsh-deepseek-girl-pet, released under the MIT License. It is an unofficial community project and has no affiliation, partnership, or endorsement relationship with DeepSeek, OpenAI, or Codex.

It primarily addresses two things:

• Express the current Harness state through animations: idle, executing tasks, waiting for interaction.
• Provide lightweight interactive feedback through mouse tracking, rather than reading or modifying conversation content.

Core Features¶

The following are the verified capabilities of the plugin.

State Animations¶

The plugin switches animations based on the current Session state:

• Idle: Holds a board with the simplified Chinese character “区” and remains on standby, with the dialog text staying as “凶.”
• When Harness is executing tasks: Switches to the working animation.
• When Session is waiting for interaction: Switches to the waiting animation.

Mouse Tracking and Interaction¶

• Supports full 16-direction mouse tracking, with one step per 22.5 degrees.
• After the mouse stops for 1.1 seconds, it returns to the standby animation holding the board.
• Clicking the desktop pet toggles between normal and enlarged sizes.
• Supports prefers-reduced-motion.

Resources and Integration¶

• Installed as a native Cordis plugin for DeepSeek Harness, using the shell.overlay extension slot.
• Uses the Codex pet v2 sprite sheet: 1536 × 2288 WebP, 8 × 11 grid, each cell 192 × 208.
• Does not modify DeepSeek Harness core files.
• Does not read or write conversation content.
• Does not rely on external CDNs or tracking services.

Installation and Activation¶

One-Line Installation¶

Run the installation command:

dsh plugin --profile web add github:f0909172434/dsh-deepseek-girl-pet

After installation, you need to restart Harness. First, press Ctrl+C in the window where you originally ran dsh web, confirm that port 3080 has stopped, then run:

dsh web

If you see:

EADDRINUSE: address already in use 127.0.0.1:3080

It means the old Harness process is still running. Go back to the original Harness terminal, press Ctrl+C, and then run again:

dsh web

Finally, press Ctrl+F5 in the browser to force a reload.

After installation is complete, open:

http://127.0.0.1:3080/

You can use the following command to confirm the plugin has been added to the web profile:

dsh --profile web --dump-config | Select-String deepseek-girl-pet

Installing from Source¶

You can also package and then install:

git clone https://github.com/f0909172434/dsh-deepseek-girl-pet.git
cd dsh-deepseek-girl-pet
npm pack
dsh plugin --profile web add .\dsh-deepseek-girl-pet-0.2.0.tgz

After installing from source, restart dsh web the same way and force refresh the browser.

Typical Usage¶

After following the steps above, you can use it like this:

1. Open the DeepSeek Harness Web UI; the desktop pet appears by default in the bottom-right corner of the interface.

2. When you move the mouse, it tracks in 16 directions; after the mouse stops for 1.1 seconds, it returns to the standby animation holding the board.

3. When Harness is executing a task, it switches to the working animation; when the Session is waiting for interaction, it switches to the waiting animation.

4. Click the desktop pet to toggle between normal and enlarged sizes.

5. If the built-in DSH Web desktop pet @linxin666/dsh-pet is also displayed in the bottom-right corner, the two may visually overlap. They do not conflict at the API level; you can choose to display only one or drag the built-in pet away.

Compatibility¶

Use Cases and Notes¶

• Suitable for adding a status-visible, clickable, non-intrusive desktop pet to the DeepSeek Harness Web UI.
• It does not read or write conversation content, and does not modify Session data, conversation history, or core source code.
• It is an unofficial community project released under the MIT License; it is recommended to review the source code and license before installation.
• The plugin runs with the permissions of the current dsh process; you should verify the plugin source is trustworthy before installation.
• The DSH community directory is an independent site and is not equivalent to an official app store; the current documentation does not confirm a fixed directory page URL, so it is recommended to search for dsh-deepseek-girl-pet in the community directory.

Conclusion¶

dsh-deepseek-girl-pet turns the Session state into an animated indicator in the bottom-right corner: holding a board on standby when idle, switching to the working animation when executing tasks, switching to the waiting animation when waiting for interaction, and supporting 16-direction mouse tracking and click-to-zoom. For those who want to make the Web UI feedback more intuitive without having the plugin touch conversation content, it is a lightweight choice based on the DSH plugin mechanism.

GitHub: https://github.com/f0909172434/dsh-deepseek-girl-pet
Directory page: Search for dsh-deepseek-girl-pet in the DSH community directory.