Introduction¶

When doing agent development on DSH, the most common deliverables are a file, a command, or a tool call record. To give the desktop a bit of “presence,” the old way was to look for an official dsh-dafeiyu desktop pet, then figure out how to harmonize windows, ports, and action groups with existing profiles. dsh-dafeiyu-pet breaks this down into a standalone plugin with its own runtime and assets: you install it, and a blue whale girl appears on your desktop; not installing the official pet doesn’t affect usage.

Below is an introduction to this plugin maintained by lilulj and categorized as “Fun Outfits” in the community directory: positioning, installation command, configuration fields, invocation methods, and its relationship with dsh-dafeiyu.

What is this plugin¶

One-sentence positioning: dsh-dafeiyu-pet is a plugin that adds a desktop pet window to DSH’s Windows desktop. It comes with 104 actions, msedge-tts voice, and desktop pet runtime, and does not depend on the official dsh-dafeiyu.

• Maintainer: lilulj
• Latest version: 1.0.4 (see its package.json)
• Dependencies: Only msedge-tts (^2.1.1)
• License: Plugin code MIT; assets from PC2005-cloud/dsh-pet (MIT); runtime based on dsh-dafeiyu (MIT) modification
• Platform: Windows x64

It is categorized as “Fun Outfits” in the community directory. The repo explicitly states: This plugin is an unofficial fan work and has nothing to do with DeepSeek. The community directory itself is an independent site with no official affiliation with DeepSeek or Hypersphere, and is not an official app store.

What it can do¶

According to the README, capabilities are divided into four parts.

1. The Pet itself: Appears on desktop, transparent background, draggable, has a right-click menu and status bubble.
2. Follows DSH status: When DSH thinks, calls tools, completes, or errors, the plugin switches to corresponding animations.
3. Actions: 104 actions covering eating, playing, festivals, emotions, work, special effects, etc. Right-click “Play Action” splits into 11 groups.
4. Voice: msedge-tts synthesis, played locally; with a configured QQ bot, voice can be sent as voice clips.

It doesn’t need a key. According to the README, except for the QQ voice clip part which needs bot config, the rest is out-of-the-box ready.

Prerequisites to note before installation¶

README lists three prerequisites, worth reading before starting.

There is a common pitfall here. README specifically states: The official pet dsh-dafeiyu is not built-in to DSH; it only exists if you installed it before. If installed, you must disable it first, otherwise two will start up and fight for port 7799, appearing as two on screen. If not installed, skip directly to the plugin mounting step.

Installation and enabling¶

Installation is split into three steps: install plugin, (only for those with official pet) disable dsh-dafeiyu, mount reference, restart. Commands and configs are taken from the README.

1. Install plugin¶

Choose any of the three ways. The line below is installing from npm, which is also the recommended way in the README.

dsh plugin --profile desktop add dsh-dafeiyu-pet

You can also go to Settings → Plugins → Add Plugin in DSH and search for dsh-dafeiyu-pet. To pull directly from GitHub, use:

dsh plugin --profile desktop add github:lilulj/dsh-dafeiyu-pet

The manual way is to copy the entire dsh-dafeiyu-pet directory to <DSH Data Directory>\profiles\desktop\node_modules\.

The first launch will automatically download about 580MB of assets (104 actions + pet runtime), with progress shown in the logs, downloading only once. If the download gets stuck: the plugin uses the system curl, which automatically uses the system proxy, so make sure the proxy is turned on first.

2. Disable official pet (only if installed)¶

Skip this step if you haven’t installed dsh-dafeiyu. If installed, edit <DSH Data Directory>\profiles\desktop\cordis.patch.yml, find the dsh-dafeiyu entry, and add a line disabled: true:

- id: dsh-dafeiyu
  name: dsh-dafeiyu
  disabled: true          # ← Add this line
  config:
    ...

3. Mount the plugin¶

Add the reference at the end of the same file:

- insert:
    - id: dafeiyu-pet
      name: dsh-dafeiyu-pet

If installed using dsh plugin add, DSH usually handles this step automatically. After installing, check if this line exists in the file; if not, add it manually.

4. Restart DSH¶

Exit completely and reopen, including the tray process. The first launch will be slow by about ten seconds because it needs to unzip the Qt runtime library into the data directory. Success if you see the desktop pet.

Configuration¶

There are two entry points with the same functionality: “Big Fat Fish Desktop Pet” in the left sidebar of DSH settings, or opening http://127.0.0.1:7811/ in a browser.

There is nothing that must be configured first: nothing. Leaving everything blank, the pet, 104 actions, and local voice work normally.

You only need to fill in three items if you want voice to be sent to QQ voice clips: AppID, AppSecret, and OpenID. Get the AppID from a bot created at q.qq.com. The AppSecret is the string shown only once during creation. The OpenID is the recipient’s openid, not the QQ number, found in the bot logs Processing: scope=c2c peerId=.... The README reminds everyone to use their own bot and not share the AppSecret.

The other options have default values, and the default config generally doesn’t need to be touched:

After saving, voice and actions take effect on the next call; character size and the enable/disable toggle require a DSH restart to take effect.

How to make the pet move¶

According to the README, there are four entry points covering manual, auto, and cross-platform:

Specific syntax for manual calls:

POST http://127.0.0.1:7799/play
{"clip":"ext_cat"}

If you want to list all available actions in PowerShell, you can check its health interface:

Invoke-RestMethod http://127.0.0.1:7799/health | Select-Object -ExpandProperty clips

Applicable scenarios and notes¶

Who is it for: DSH 0.1.7+, want dynamic feedback on the Windows desktop, or want a desktop pet that switches based on tool call status. If you are already using dsh-dafeiyu, or don’t want to download 580MB of assets, this plugin may not be suitable for you.

Checks to do before installation:

• Check source code and license. The plugin code, character assets, and runtime have different licenses (MIT, MIT, MIT-based), while cursor assets come from the Chromium project and are BSD-3-Clause. Confirm you accept these terms before installing.
• Know it runs with the current DSH process permissions. The plugin executes inside the DSH process. The helper is a Windows executable, which creates desktop windows, reads local audio devices, and downloads assets to the data directory. Please read the source code before deciding whether to install.
• Config contains plaintext credentials. <DSH Data Directory>\dafeiyu-pet\config.json saves settings, including the QQ AppSecret in plaintext. Do not distribute.
• Data is all local: The directory also contains layout.json (window position), helper.log (pet log), voice/ (last 10 voice temp files), and tmp/ (Qt unzip directory). Deleting the whole directory restores default settings and positions.

For troubleshooting, first check two logs: if the pet doesn’t appear, check <DSH Data Directory>\dafeiyu-pet\helper.log and logs\desktop-next.log for dafeiyu-pet related lines. If the first launch is slow or the right-click menu is missing actions, also check these two files and whether DSH has been restarted. If the settings page at 7811 won’t open, you can set the environment variable DAFEIYU_PET_SETTINGS_PORT to another port.

Conclusion¶

dsh-dafeiyu-pet makes the desktop pet a standalone plugin with built-in actions, voice, and runtime, saving the step of fighting the official dsh-dafeiyu for ports and assets. If you are using Windows x64 and can accept the initial download of about 580MB of assets, it is basically “install and go”. The directory page is at skillhub.cn, and the source code is at GitHub.