Preface

The start, stop, status check, and GUI opening of DSH are usually scattered across command line and browser entry points. dsh-whale-pet integrates these actions into a Windows desktop pet program: it first detects the DSH service, launches it in the background if not running, and then opens the GUI once ready.

Below is an introduction to its core capabilities, installation methods, typical usage, and dependencies.

What is it

dsh-whale-pet is a Windows desktop pet program maintained by miku00039-01. It integrates the service start, stop, status monitoring, and GUI invocation of DeepSeek Harness (hereinafter referred to as DSH) into a zero-dependency .exe.

Suitable for users who need to perform DSH service start/stop, status check, and GUI opening via mouse on the Windows desktop.

Core Capabilities

  • One-click Start: Detects DSH service; launches it in the background if not running; opens GUI when ready.
  • Humanoid Desktop Pet: Pixel-by-pixel transparent floating window, draggable, remembers position.
  • Double-click to Invoke: Double-clicking the pet opens the GUI, reusing the same PWA window without stacking tabs.
  • Right-click Menu: Open Program, Close Program, View Status, Exit.
  • Close Program: Stops only the DSH service and closes the GUI application window; matches by window title precisely, affecting no other browser pages.
  • Tray Icon: Left-click to invoke, right-click menu as a fallback entry.
  • Status Monitoring: Only Green/Red two states; 5 seconds online, 2 seconds offline adaptive frequency.
  • Status Card: Displays service status, address, PID, uptime, as well as pet memory and GDI handles.
  • Single Instance: Repeated double-clicking will not open a second instance.
  • Crash Log: Uncaught exceptions are automatically written to dsh-whale-pet-crash.log.
  • DSH Plugin: Can be installed as a plugin and launched using /whalepet in DSH.

Installation and Enablement

Can be installed as a DSH plugin. Execute:

dsh plugin --profile web add github:miku00039-01/dsh-whale-pet

After installation, run in DSH:

/whalepet

to start the Whale Girl Pet.

You can also download DSH桌宠.exe from Releases and run it by double-clicking. The first run will generate dsh-whale-pet.conf in the same directory as the exe, which can be modified as needed.

If building from source, run:

pwsh -File build.ps1

To trigger CI automatic Release builds, you can push a v* tag, for example:

git tag v1.0.0
git push origin v1.0.0

Typical Usage

Below are some reproducible steps.

  1. After installing the plugin, enter in DSH:
/whalepet

to start the pet.

  1. Double-click the pet to invoke the GUI. The pet reuses the same PWA window without stacking tabs.

  2. Right-click the pet and select from the menu:

打开程序
关闭程序
查看状态
退出

  1. Right-click the tray icon to use the fallback entry.

  2. If the GUI default opening method does not meet expectations, modify pwaShortcut in dsh-whale-pet.conf to point to another PWA shortcut; leave it empty to always use the default browser.

Dependencies and Runtime

Required Dependencies:

  • Windows 10 / 11
  • .NET Framework 4.x
  • DeepSeek Harness correctly installed, including Node.js, global dsh CLI installation, and configured DEEPSEEK_API_KEY

Optional Dependencies:

  • Chrome, used for PWA standalone window; if not installed or not found, automatically falls back to opening in the default browser.

The pet launches the DSH service via node and listens on:

127.0.0.1:3080

When starting the service, the pet uses:

dsh web --no-open

This avoids the double window caused by DSH automatically opening the browser by default.

“Close Program” only stops the DSH service and closes the GUI application window, affecting no other browser pages.

Notes

  • The code license is MIT.
  • Asset parts must follow the licensing instructions in assets/WHALE_ATTRIBUTION.md; confirm compliance with requirements before use or distribution.
  • The plugin runs with the permissions of the current dsh process. You should check the source code and license before installing.
  • dsh-whale-pet is a third-party project in the DSH plugin ecosystem and should not be considered an official app store or official component.

Links

GitHub:

https://github.com/miku00039-01/dsh-whale-pet

You can visit the repository to view source code, build scripts, and asset attribution instructions.