Preface

The DSH ecosystem emphasizes “everything is a plugin,” and the community directory is an independent site with no official affiliation with DeepSeek/Fanghu. For users who need to run DSH tasks for extended periods, staring at the terminal is inconvenient. seekmaid-pet connects the DSH session state to a Windows 11 desktop pet. It provides bubble notifications for task start, completion, new messages, tool calls, and task list changes, and also supports sending messages to the current DSH session.

What is this

The package is named seekmaid-pet, maintained by DoloresCaritasAngelus, and is licensed under MIT. It serves as both a Windows native desktop pet and a DSH plugin: the pet stays on the desktop/system tray and connects to the local DSH terminal; it is automatically launched when DSH starts and automatically closed when DSH stops.

Core Features

  • Windows 11 native desktop pet, resident on the desktop/system tray and connects to the local DSH terminal
  • Monitors DSH session status: provides bubble notifications for task start, completion, new messages, tool calls, and task list changes
  • Two-way communication: double-click the pet or use the right-click menu to send messages to the current DSH session, with DSH replies displayed in the pet’s bubble
  • Long-running: no console window (pythonw), single instance, closing the window hides it to the tray, and supports auto-start
  • DSH Plugin Mode: automatically launches the pet when DSH starts and automatically closes it when DSH stops
  • Plugin Auto-Detection/Copy: automatically detects and copies Windows projects and initializes (zero-config mode)
  • Provides self-heal.mjs for restoring plugin registration after DSH upgrade/reinstall

Installation & Enablement

Runtime Environment

The environments listed below are from the plugin documentation. Please confirm if your machine meets them before installing:

  • Windows 11 (10 is also supported)
  • Python 3.10+
  • PySide6 ≥ 6.6
  • DSH ≥ 0.1.0-rc.6 (rc.8+ recommended)
  • @deepseek-ai/cordis ^4.0.1
  • Node.js LTS
  • Windows side needs access to http://localhost:3080

If DSH is running on WSL/remote Linux but the pet needs to be displayed on the Windows desktop, the plugin must be installed on the Windows-side DSH; the Linux side cannot directly launch a Windows GUI.

Install Plugin

The documentation provides two installation methods: local directory and GitHub. The following explains using command examples.

If you already have the project directory on the Windows side and are in that directory:

dsh plugin --profile web add "file:$(pwd)"

This command installs the current directory as the seekmaid-pet plugin package to the web profile.

If you do not want to clone it locally first, you can use the GitHub install command:

dsh plugin --profile web add "git+https://github.com/DoloresCaritasAngelus/SeekMaid-pet.git"

After completing the above steps, the pet will be automatically launched when you start DSH.

Initialization & Manual Launch

After cloning to Windows, it is not immediately usable. The repository does not include local environments such as .venv, wslg-xcb-libs, logs, or cache, so initialization is required first.

First, run the initialization script, which creates .venv and installs PySide6:

setup_windows.bat

Then, run the startup script to manually launch the pet:

run_pet.bat

You can also manually invoke Python to start it:

.venv\Scripts\pythonw.exe deepseek_pet.py

Typical Usage

Connect to DSH

The pet connects to the local DSH terminal and requires the Windows side to have access to http://localhost:3080. If the DSH address is different, you can edit config.json to modify it via dsh_url.

The config.json file allows you to configure the following monitoring parameters:

  • dsh_url
  • session_id
  • poll_interval

Plugin Configuration

The following fields can be configured in the plugin configuration:

  • windowsProject
  • python
  • script
  • startupTimeoutMinutes

The python field is used to specify a path when Python is not in the system PATH. The plugin defaults to using pythonw (Windows) or python3 (other platforms) to launch the pet.

Auto-start

You can enable auto-start by checking the option in the system tray’s right-click menu; you can also manually use reg add to write a registry entry:

HKCU\Software\Microsoft\Windows\CurrentVersion\Run

Upgrade Self-Heal

When DSH upgrades or reinstalls node_modules, it may remove locally installed plugins, potentially causing profile bundle parsing failures. In this case, you need to restore the plugin registration.

The repository provides self-heal.mjs for restoring plugin registration after DSH upgrade/reinstall. You can execute it automatically in your DSH startup script to prevent the pet from failing to launch after an upgrade.

Applicable Scenarios & Notes

Suitable for users who use DSH on a Windows desktop and wish to view statuses such as task start, completion, new messages, tool calls, and task list changes on the desktop pet. It is also suitable for scenarios where you need to temporarily send messages to the current DSH session without switching back to the terminal.

Note: The DSH plugin runs within your local DSH environment and executes with the permissions of the current dsh process. You should check the source code, dependencies, and the MIT license before installing.

Conclusion

The value of seekmaid-pet is concrete: it connects the DSH session state to a Windows desktop pet and allows the DSH lifecycle to manage the pet’s launch and closure. If you wish to view DSH task status and send messages quickly on your Windows desktop, you can first check the source code and then follow the steps above to install.

  • Directory: https://www.skillhub.cn/plugins/DoloresCaritasAngelus/SeekMaid-pet
  • GitHub: https://github.com/DoloresCaritasAngelus/SeekMaid-pet