Introduction

DSH’s plugin ecosystem emphasizes “everything is a plugin.” The community directory is an independent site with no official affiliation to DeepSeek / Huafan. dsh-BFF-pet is one of the desktop pet plugins: it uses a transparent floating window and WebM animations to display real Agent status. It is automatically launched by DSH, reusing DSH’s own 127.0.0.1:3080. It has no independent application entry point and does not require an additional port.

What is it

dsh-BFF-pet is maintained by anyuinlara-bit and is licensed under the MIT license. It solves a specific problem: when DSH’s Agent executes tasks in the background, developers want a low-disturbance status indicator on the desktop rather than repeatedly switching windows to check.

One-sentence positioning: DSH desktop pet plugin, transparent floating window + WebM animation, driven by real Agent status.

Core Capabilities

Below are the verified types of capabilities.

Transparent Floating Desktop Pet

The desktop only displays the pet itself, without a background block. The window is always on top and can be dragged arbitrarily.

Agent Status Driven

The plugin switches animations and bubbles in real-time based on DSH’s Agent status, covering the following states:

  • Idle
  • Thinking
  • Working (distinguishing Search, Edit, Test, Command)
  • Awaiting Confirmation
  • Completed
  • Error

Status Bubble & Easter Eggs

The status bubble displays current status text above the pet.

Easter egg scheduling includes:

  • Random idle easter eggs
  • Breakfast/Midday/Dinner time easter eggs
  • Token consumption during extended work periods

Interaction & Tray Control

Clicking triggers interaction animations, and dragging triggers a floating animation.

System tray and right-click menu support:

  • Trigger Easter egg
  • Show/Hide
  • Bubble toggle
  • Transparency
  • Size scaling
  • Reset position
  • Exit

Robustness

Verified capabilities include:

  • Connection detection
  • Error visualization
  • Status fallback

Runtime Environment

Node

Node requirements are:

>=22.19

Electron

Running requires the Electron runtime. The program is not packaged, nor is the installation method forced.

Runtime Mode

Supported:

  • Pure Windows
  • WSL2

Installation and Enablement

Official installation commands are not provided in the documentation; this article does not concatenate specific commands. Before enabling, you can verify the environment:

  1. Node version meets >=22.19.
  2. The local machine has a runnable Electron.
  3. Prepare the Electron path according to the runtime mode.

After enabling, the plugin is automatically launched by DSH, requiring no additional port, and reusing DSH’s 127.0.0.1:3080.

Typical Usage

Pure Windows

Pure Windows users can first execute:

npm install electron

This step obtains a Windows-compatible Electron locally. When the program starts, it locates the Electron in the following order:

ELECTRON_PATH
node_modules/electron/dist/electron.exe
bin/win32-x64/electron.exe

The program is only responsible for finding and matching the path, not packaging, and does not force an installation method.

Note: Running npm install electron in WSL obtains the Linux version, which cannot drive the Windows desktop pet.

WSL2

In the WSL2 scenario, the Windows version of Electron needs to be placed in:

bin/win32-x64/

The helper will synchronize the runtime and bin/ to:

C:\Users\<user>\AppData\Local\dsh-BFF-pet\

Then start the desktop pet.

Tray Menu

You can perform the following via the system tray or right-click menu:

  • Trigger Easter egg
  • Show/Hide
  • Bubble toggle
  • Transparency
  • Size scaling
  • Reset position
  • Exit

Testing

The following commands can be used:

npm test
npm test:helper
npm run smoke

Assets and License

Animation assets come from dsh-pet, and the project references dsh-dafeiyu.

Documentation notes:

  • The architecture and code of this project are independently implemented.
  • Animation assets are reused from dsh-pet.
  • dsh-pet and dsh-dafeiyu are both MIT License.
  • When using, you must comply with their respective license terms and retain copyright notices.

Applicable Scenarios and Notes

Suitable for developers who want to observe DSH Agent status on the Windows desktop and wish to minimize interface usage.

Notes to consider:

  • This plugin requires the Electron runtime; the program itself is not packaged.
  • Under WSL2, you cannot use the Linux version of Electron to drive the Windows desktop pet.
  • The plugin is launched by DSH, runs with the permissions of the current DSH process, and reuses DSH’s local port; you should check the source code and license before installing.
  • The documentation has not confirmed DSH compatible versions, star counts, categories, and directory page addresses; this article does not include this information.

Conclusion

The value of dsh-BFF-pet lies in mapping DSH’s Agent status to the desktop, using a transparent floating window and low-disturbance animations to indicate current progress, without introducing additional ports.

The documentation has not confirmed the directory page address; the verified GitHub repository address is as follows:

  • https://github.com/anyuinlara-bit/dsh-BFF-pet