Introduction

When running agent tasks with DeepSeek Harness (DSH), task status usually comes from session/event. If you want to see “Thinking / Working / Waiting / Finished / Error” directly on the desktop, you can make it a DSH plugin instead of maintaining a separate desktop application.

dsh-BigfishPet is a generic desktop pet plugin for DeepSeek Harness. The repository belongs to s17179XTY and is licensed under MIT. It can run in any DSH environment, displaying the Whale Girl (Bigfish) through the DSH settings page and a PySide6 desktop Helper.

What is this

dsh-BigfishPet is a DSH plugin that provides two types of capabilities:

  • DSH Settings side: Provides a desktop pet configuration card with instant save on changes.
  • Desktop Pet display side: Drives a PySide6 transparent desktop Helper via the JSONL protocol to display the Whale Girl.

Status is persisted to ~/.dsh/pet.json. If the target environment is missing Python/PySide6, the Helper/Pet window will not appear, but the settings page can still be used normally.

Core Features

Real-time Status Driven

The plugin includes a built-in state machine that reduces session/event to the following states:

  • Thinking
  • Working
  • Waiting
  • Finished
  • Error

When running multiple tasks, display them with the following priority:

Waiting > Error > Working > Thinking

Animations

Animations switch based on status:

  • Thinking: eat
  • Working: eat
  • Success: eat
  • Waiting: sleep
  • Idle: idle

Interaction

  • Left-click triggers a random quote.
  • Self-talk every 45–90 seconds when idle.
  • Automatically falls asleep after 3 minutes of idle without tasks; click the pet to wake it up.
  • Right-click to open or minimize the host; opens WebUI if the host is not found.

The process names involved in host detection are:

Bigfish.exe
DSH Desktop.exe

The WebUI address opened when the host is not found is:

http://127.0.0.1:3080/

Configuration and Files

The DSH settings provide a desktop pet configuration card with instant save. The plugin will create/read the following files:

~/.dsh/pet.json
~/.dsh/bigfish-completions.jsonl

Installation and Enablement

The following command is used to install to the web profile:

dsh plugin --profile web add github:s17179XTY/dsh-BigfishPet

After the command executes, restart the corresponding Harness client to load the plugin.

Note: If the plugin is already mounted via bundle, do not manually append to the profile’s cordis.patch.yml:

- insert: id: bigfish-pet

This may cause the same entry to be applied twice, resulting in:

duplicate loader entry id: bigfish-pet

Typical Usage

Adjusting Idle Auto-Sleep

The environment variable is used to adjust the milliseconds for idle auto-sleep:

DSH_DAFEIYU_IDLE_SLEEP_MS

This configuration accepts a millisecond value; set the specific value according to the needs of the target environment.

Packaging Helper when Python/PySide6 is Missing

When the target environment is missing Python/PySide6, you can use the script in the repository to package an exe:

scripts/build-helper.ps1

The packaged exe can be distributed with the plugin to avoid requiring Python/PySide6 in the target environment.

Troubleshooting Pet Not Displaying

Check in order:

  1. Restart DSH.
  2. Check the field in ~/.dsh/pet.json:
display.visible

Whether this field is true.
3. Check if PySide6 is available:

py -3 -c "import PySide6"
  1. Manually run the Helper:
py -3 runtime/helper.py

After changing animations/status, the Helper only reads the manifest at startup; changes take effect only after restarting the Helper.

Applicable Scenarios and Notes

Suitable for:

  • Displaying desktop pet status in any DSH environment.
  • Using real session/event to drive desktop pet animations and status.
  • Adjusting desktop pet configuration via the DSH settings page.

Notes:

  • The plugin runs with the privileges of the current dsh process.
  • It is recommended to check the GitHub repository source code and MIT license before installing.
  • When the target environment is missing Python/PySide6, the pet window will not appear, but the settings page remains usable.
  • Restarting the Helper is required after changing animations/status because the Helper only reads the manifest at startup.

Links

  • GitHub Repository: https://github.com/s17179XTY/dsh-BigfishPet
  • Directory Page: The verified information does not provide a URL, so no link is added here.