Preface

When running agents with DeepSeek Harness (DSH), task progress and approval requests typically appear only in the terminal or web interface. After switching windows, it’s hard to tell at a glance whether it’s “still running” or “waiting for you to click approve”. Here we introduce dsh-desktop-pet, which adapts the whale-girl desktop pet based on vlln/whale-girl to Linux and Windows desktops, keeping DSH’s execution status in a corner of your screen.

What is this

dsh-desktop-pet is maintained by xiaoshihou514 and is categorized as “Fun Cosplay” in the SkillHub community directory. The project describes itself as “DeepSeek Harness: Whale-girl Desktop Pet” and is currently at version v0.1.0 (MIT license).

It consists of two cooperating parts, clearly explained in the README:

  1. DSH Plugin Side: Communicates with Harness through the whale-girl plugin.
  2. Desktop App Side: A standalone “Da Fei Yu” client (productName: dafeiyu) responsible for displaying the character and status on the desktop.

The maintainer notes in the README: This is an adaptation of @vlln’s work for Linux/Windows desktop.

Core Features

Based on the README and package.json, the currently verifiable capabilities are:

  • Desktop Pet Display: The character can reside on the desktop, with the README showcasing multiple appearances.
  • Task Status Visualization: Displays “work progress” during runtime.
  • Approval Reminders: Reflects whether user approval is currently required.
  • Cross-platform Desktop Package: Distribution includes Linux AppImage, RPM, as well as Windows installer and portable versions.

The desktop side is built on Electron (npm run start is electron .), with packaging scripts also retaining Tauri-related commands; daily installation primarily uses pre-compiled packages from Releases.

Installation & Activation

Follow the steps below in the order given in the README. Plugins run with the current dsh process permissions, so it’s recommended to browse the repository source code and confirm the MIT license before installation.

1. Install DSH CLI

npm i -g @deepseek-ai/dsh

Globally install @deepseek-ai/dsh, then use dsh plugin to manage plugins.

2. Add the whale-girl plugin

dsh plugin --profile web add "github:vlln/whale-girl#main"

The README uses --profile web, with the plugin source being the main branch of vlln/whale-girl. This is the plugin entry point for communication between the desktop companion and Harness; do not change it to another repository name on your own.

3. Install the Desktop Client

Download the installation package for your platform from the releases page:

https://github.com/xiaoshihou514/dsh-desktop-pet/releases

Linux offers AppImage or RPM; Windows offers NSIS installer or portable version. After installation, launching “Da Fei Yu” will work with your configured DSH environment.

Typical Usage

The complete process can be summarized in three steps:

  1. Globally install dsh and add the whale-girl plugin using the command above.
  2. Start a DSH session in the usual way (the web profile corresponds to --profile web in the installation command).
  3. Open the desktop “Da Fei Yu” client and observe the task progress and approval status changes next to the character.

The README does not provide more detailed CLI subcommand examples; status display relies on normal communication between DSH and the whale-girl plugin, with the desktop side responsible for rendering.

Use Cases & Notes

Who is this for

  • People who run DSH tasks for extended periods and want continuous progress feedback in a corner of their desktop.
  • Developers who need to be prominently aware of “waiting for approval” without repeatedly switching back to the terminal or browser.
  • Users who enjoy desktop pet interactions and accept the “Fun Cosplay” style UI.

Pre-use Notes

  • Plugins and DSH run with current user permissions; before using add, please check the source code and licenses of vlln/whale-girl and xiaoshihou514/dsh-desktop-pet.
  • The desktop client is a standalone application and must be downloaded separately from Releases; you cannot expect a desktop pet window to appear by only installing the CLI plugin.
  • The project version is 0.1.0, and the API and packaging format may change with versions; refer to the GitHub repository for the latest information.
  • SkillHub (Directory Page) is a community plugin directory and has no official affiliation with DeepSeek/High-Flyer; the DSH ecosystem follows “everything is a plugin,” and this repository is one example.

Links