Preface¶

In the DSH plugin ecosystem, the status of local agents still relies on terminals, logs, or web pages for confirmation. dsh-desk-pet brings this directly to the desktop: it is a DeepSeek Harness desktop pet for macOS that uses real windows to follow the status changes of local DSH agents, and it also supports generating custom skins from a single image.

Below is an introduction to its features, installation commands, and common parameters.

What This Is¶

anneheartrecord/dsh-desk-pet is maintained by anneheartrecord and is licensed under MIT.

Its role is a macOS desktop pet plugin: it provides real macOS windows that can float above full-screen applications, used to display the current status of DSH agents.

Core Features¶

Status Display¶

The plugin follows the status changes of local DSH agents, with statuses including:

• Idle
• Working
• Waiting for you
• Error
• Happy
• Sleeping

Skins¶

Five built-in skins are included, each covering six statuses, with three frames per status.

You can also provide a single image to the plugin’s built-in skill to generate custom skins. The generation process uses the user’s own image generation tools and quotas; the plugin does not upload materials.

Custom skins are saved in:

~/.dsh-desk-pet/skins/

This directory is located outside the installation package, so upgrading the plugin will not delete it.

Window and Menu¶

The window is a real macOS window that can float above full-screen applications.

The right-click menu provides:

• Session list
• Do Not Disturb
• Skins
• Pet position
• Project homepage
• Check for updates
• Quit

Runtime Requirements¶

The plugin has zero dependencies and uses the system’s built-in Python.

Only macOS is supported; Windows and Linux have not been tested and are not planned in the short term.

Installation and Activation¶

If DSH is already installed, first add the plugin, then start dsh web:

dsh plugin --profile web add deepseek-desk-pet
dsh web

When upgrading from an older version, you must include @latest:

dsh plugin --profile web add deepseek-desk-pet@latest

Without @latest, the caret version range may lock the minor version.

If you want to use the main branch from GitHub, you can run:

dsh plugin --profile web add github:anneheartrecord/dsh-desk-pet#main

Note that the package name is deepseek-desk-pet while the repository name is dsh-desk-pet; they are inconsistent.

The plugin runs with the permissions of the current dsh process; it is recommended to review the source code and MIT license before installation.

Typical Usage¶

Startup and Shutdown¶

You can also run the executable entry point directly:

./bin/dsh-desk-pet

To stop the current pet:

./bin/dsh-desk-pet --stop

Startup Parameters¶

Specify the skin to use at startup:

./bin/dsh-desk-pet --skin jellyfish

Adjust the size:

./bin/dsh-desk-pet --scale 0.5

Perform a reset:

./bin/dsh-desk-pet --reset

Run in the foreground:

./bin/dsh-desk-pet --foreground

Self-check:

./bin/dsh-desk-pet --probe

View the skin frame inventory:

./bin/dsh-desk-pet --inventory

Use --skin-sheet to generate a skin sheet and pass the skin ID:

./bin/dsh-desk-pet --skin-sheet <your-skin-id>

Applicable Scenarios and Notes¶

Suitable for scenarios where DSH is used locally on macOS.

Points to note when using:

• Clicks on the transparent margins around the pet will not pass through to the window behind.
• There is currently no window setting, nor a dock-to-edge mini mode.
• When generating skins, the plugin side does not show progress; you can only check the agent output.
• Generating custom skins uses the user’s own image generation tools and quotas; the plugin does not upload materials.
• When upgrading from an older version, you must include @latest; otherwise, the caret version range may lock the minor version.
• The package name is deepseek-desk-pet while the repository name is dsh-desk-pet; they are inconsistent.
• The plugin runs with the permissions of the current dsh process; you should review the source code and license before installation.

Conclusion¶

The value of dsh-desk-pet is straightforward: it displays DSH agent status in real windows on the macOS desktop and supports generating custom skins from a single image.

Community directory page: https://www.skillhub.cn/plugins/anneheartrecord/dsh-desk-pet

GitHub: https://github.com/anneheartrecord/dsh-desk-pet