Introduction¶
DeepSeek Harness (DSH) uses a plugin architecture. During Agent runtime, developers often need more intuitive status feedback. The existing in-browser UI is feature-rich, but when running in the background it is often hard to notice or may be obscured.
The dsh-ronaldo-pet plugin provides a solution: it not only resides in the bottom-right corner of the Web interface, but also persists on the desktop through a native Windows window and senses Agent runtime state in real time. Through sprite animation and interactive feedback, it visualizes the Agent workflow (working, thinking, waiting, error, completed).
Basic Information¶
- Plugin Name: dsh-ronaldo-pet
- Maintainer: Stellum-Waq
- Category: Fun Dress-Up
- License: MIT
- Stars: 5
Core Features¶
Native Desktop Window¶
The plugin is built with WPF technology and creates a borderless, transparent, always-on-top desktop window.
* Independence: It does not rely on a browser engine; the window remains even if the terminal is closed or the browser is minimized (as long as the terminal process is running).
* Lifecycle: It starts automatically when the plugin is loaded and exits automatically when the host process is unresponsive for more than 15 seconds or when the process ends.
* Interaction:
* Hover: show the current workspace, conversation title, and Agent state.
* Single click: show a speech bubble and play a click sound effect.
* Quickly click three times: trigger a falling animation.
* Double click: open the Harness web page in Microsoft Edge.
* Drag/scroll wheel: change position and window size (32–1024 DIP).
* Context menu: provide options such as switching pet, resizing, hiding, setting as default, and toggling system sound.
Agent State Detection¶
The plugin polls the agents service and monitors API endpoints such as tools/execute and approval/request, deriving and switching Agent state in real time, corresponding to different animation frames:
* Working: focused state.
* Thinking: thinking within a turn.
* Waiting: awaiting approval.
* Error: dramatic fall.
* Idle: standby.
* Completed: SIU celebratory jump + system-wide alert sound.
Sprite Animation and Resolution¶
- Animation Specification: supports an 8-column × 11-row sprite sheet.
- Resolution: no limit on individual tile size. Whether pixel art, detailed character art, or realistic assets, the plugin supports them and scales them proportionally when displaying.
Generate a Pet with One Sentence¶
With the dsh-pet-forge skill, you can generate a new pet by describing it in natural language. This workflow integrates an image generation model, Blender 3D modeling, and action/audio design.
* Generation Flow: environment self-check -> generate -> validate -> install.
* Registration: After generation and installation, the pet appears immediately in the bottom-right corner.
Generate from Video (New in v2.2)¶
Supports converting video footage (especially greenscreen or solid-color backdrop recordings) into desktop pet actions.
* Flow: frame extraction -> backdrop removal -> segment actions by time range/motion -> compile sprite sheet.
* Parameters: supports adjusting keying parameters (key, similarity, blend, spill, erode).
* Decoding Engine: prefers ffmpeg, then OpenCV, and finally supports direct import of pre-extracted PNG frames.
Pet Community (New in v2.1)¶
Based on the DPSL-1.0 Open Sharing License, it supports publishing generated pets to GitHub and listing them in the plugin’s built-in Pet Community.
* Sharing Flow: After finishing pet generation, the plugin asks whether to publish under DPSL-1.0. If you agree, the plugin generates a share package, but it does not upload automatically (the user must manually run the script or perform the action), and it does not execute scripts in the repository.
* Permissions: The plugin is only authorized to list, display, download, and install locally; it may not be sold commercially or used to train models.
Installation and Activation¶
Install the Plugin¶
Install via DSH CLI:
# 从 GitHub 安装
dsh plugin --profile web add github:Stellum-Waq/dsh-pet-ronaldo
# 本地开发安装
dsh plugin --profile web add D:\代码\桌宠\dsh-ronaldo-pet
Install the Companion Skill¶
Install the dsh-pet-forge skill used to generate new pets:
Copy-Item -Recurse -Force .\skill\dsh-pet-forge $env:USERPROFILE\.agents\skills\
Uninstall¶
dsh plugin --profile web remove dsh-ronaldo-pet
Notes¶
- Permission Scope: The plugin runs with the permissions of the current DSH process. Please review the source code and license before installing.
- Default Behavior: By default, only one pet is enabled (the built-in C. Ronaldo). Newly generated pets automatically take over the default slot, while other pets are hidden automatically. To display multiple pets side by side, you need to enable them manually in settings.
- Privacy and Security: The plugin does not upload anything on your behalf, does not execute scripts in the repository, and does not read your GitHub credentials.
Summary¶
dsh-ronaldo-pet solves the visual feedback problem during Agent runtime through native windows and state detection. Combined with video generation and community sharing features, it provides developers with an extensible desktop pet ecosystem, improving the user experience and enriching Agent presentation.