Introduction

When running DeepSeek Harness’s dsh web on Windows, starting, stopping, and opening the interface usually requires terminal commands. @gzmuldyxx/dsh-windows-tray centralizes these operations onto a system tray icon in the notification area, reducing the steps of typing commands back and forth.

What is this

This is a DeepSeek Harness plugin with the package name @gzmuldyxx/dsh-windows-tray and maintainer GZMULDY. It provides a permanent whale icon in the tray to control dsh web: open the web interface, start service, stop service, restart service, and exit the tray. The license is MIT.

Core Features

Tray Icon and Status

  • Keeps a whale icon resident in the Windows system notification area.
  • Displays the current status on hover: Running or Stopped.

Common Operations

  • Left-click tray icon: Start service and open web interface.
  • Right-click menu provides the following options:
    1. Open Interface: Start and open browser.
    2. Start Service: Launch dsh web in the background, only if not already running.
    3. Stop Service: Terminate DSH service process on port 3080.
    4. Restart Service: Stop first, then launch.
    5. Exit Tray: Remove tray icon.

Single Instance Protection

Prevents multiple tray icons from appearing on double-click or repeated installation.

Installation and Enablement

Requires Windows and that DeepSeek Harness (dsh) is already installed.

First execute:

dsh plugin --profile web add @gzmuldyxx/dsh-windows-tray

This step adds the plugin to the web profile.

After installation, restart dsh web, and the tray icon will automatically appear in the system notification area.

If there is no published npm package currently, you can also install from source locally within the repository directory:

dsh plugin --profile web add .

package.json declares engines.node >=18 and peerDependencies as @deepseek-ai/cordis ^4.0.1.

Typical Usage

After completing the installation steps above, you can use the tray as follows:

  • Left-click tray icon: Start service + open Web interface.
  • Right-click “Open Interface”: Start and open browser.
  • Right-click “Start Service”: Launch dsh web in the background, only if not running.
  • Right-click “Stop Service”: Terminate DSH service process, targeting port 3080.
  • Right-click “Restart Service”: Stop then launch.
  • Right-click “Exit Tray”: Remove tray icon.

If you need to override default behaviors, you can set environment variables.

Override the web address opened by the tray:

DSH_WEB_URL=http://127.0.0.1:3080

Default is http://127.0.0.1:3080.

Do not automatically open browser when starting the tray:

DSH_TRAY_NOOPEN=1

Set to any value.

Specify source code checkout directory:

DSH_CHECKOUT=<source code checkout directory>

Default is process.cwd().

Use Cases and Notes

Suitable for people who want to run dsh web on the Windows desktop for a long time and want to quickly control the service from the tray.

Notes:

  • Stopping the service relies on port 3080 to locate the DSH service process; if the actual service port is not 3080, the stop behavior may not meet expectations.
  • The plugin will start/stop dsh web processes and runs with the current dsh process permissions; you should check the source code and license before installing.
  • dsh web needs to be restarted after installation.

Get it

GitHub:

https://github.com/GZMULDY/dsh-windows-tray.git

Directory page address in plugin links (not confirmed as verified information):

https://www.skillhub.cn/plugins/GZMULDY/dsh-windows-tray