Introduction

The philosophy of DSH is “Everything is a plugin.” The DSH community directory is an independent site with no official affiliation with DeepSeek / 幻方. For developers who frequently use DSH Web, the current practice is usually to open the terminal, run dsh web, wait for the service to be ready, and then manually open the browser.

Below is an introduction to cheng249hx/dsh-one-click-launcher: a DSH plugin that generates a one-click launcher shortcut for the local Harness Web service on the Windows desktop.

What is it

dsh-one-click-launcher is a DSH plugin for Windows 10/11, located in the repository cheng249hx/dsh-one-click-launcher, licensed under MIT, with package.json version 0.1.0.

It solves the repetitive startup process: after installation and activation, it writes a startup script ~/.dsh/launch-dsh.bat at startup and creates a shortcut on the desktop pointing to this script (.lnk). The desktop shortcut is named DSH Web by default.

Runtime environment requirements:

  • Windows 10/11
  • dsh CLI installed
  • pnpm installed

Core Features

  • Writes ~/.dsh/launch-dsh.bat on startup
  • Creates a desktop shortcut pointing to the startup script (.lnk)
  • Uses the default black whale icon by default, with a blue #4176e6 variant available
  • Supports using a custom .ico icon
  • The startup script polls the port once per second and opens the browser when the service is ready
  • Counts down by the second when waiting fails, prompting after 120 seconds
  • Zero dependencies, no build required, uses pure ESM JavaScript
  • Closing the minimized DSH Server window will stop the service

Installation and Activation

After confirming that the Windows 10/11 environment, dsh CLI, and pnpm are available, execute the following installation command:

dsh plugin --profile web add github:cheng249hx/dsh-one-click-launcher

This command uses --profile web to install the plugin from GitHub. Restart dsh web below to allow the plugin to generate files during the startup phase:

dsh web

Once enabled, the plugin will write ~/.dsh/launch-dsh.bat at startup, with default icons and the startup script located in ~/.dsh, and generate a shortcut on the desktop with the default name DSH Web.

Typical Usage

  1. Restart dsh web after installation:
dsh web

  1. Double-click the DSH Web shortcut on the desktop to start the service.

  2. After the service starts, the script waits for the port to be ready and opens the browser; if the wait fails, it counts down by the second and prompts after 120 seconds.

  3. Closing the minimized DSH Server window stops the service.

Custom Icons

There are three ways to set this.

Method 1: Switch to the built-in blue icon. Set in the plugin configuration:

icon: blue

icon is used to select the built-in whale icon; blue corresponds to the blue #4176e6 variant.

Method 2: Use a custom .ico. Set in the plugin configuration:

iconPath: 'D:\icons\my-whale.ico'

iconPath points to a custom .ico file.

Method 3: Change the icon directly on the desktop shortcut. Right-click the desktop shortcut, open “Properties → Shortcut → Change Icon”, select any .ico file, and click OK.

Note: After modifying icon or iconPath in the configuration, you need to delete the shortcut from the desktop first, then restart dsh web to regenerate it:

dsh web

Scenarios and Notes

Suitable for developers who use DSH Web long-term on Windows 10/11 and wish to launch directly from the desktop.

Pre-use notes:

  • The plugin runs with the permissions of the current dsh process. Please check the source code and license before installing.
  • The dsh web process needs to be restarted after modifying the configuration for the shortcut to be regenerated.
  • The generated .bat uses pure ASCII and CRLF line endings for compatibility with Windows multilingual environments.
  • The DSH community directory is an independent site with no official affiliation with DeepSeek / 幻方.

References

Directory page (from plugin metadata):

https://www.skillhub.cn/plugins/cheng249hx/dsh-one-click-launcher

GitHub:

https://github.com/cheng249hx/dsh-one-click-launcher