Introduction

When using DSH web, starting the local service and opening the browser are typically two separate steps: first, start the service, wait for the port to become available, and finally open the page. Ho11ow8/deepseek-harness-shortcut is a DSH plugin for Windows. It provides the /desktop-shortcut command within the chat to generate desktop shortcuts and launchers. Upon double-clicking the shortcut, it determines whether the DSH service is already running: if it is, it opens the browser directly; if not, it starts the service and waits for the port to become ready.

What is this

Ho11ow8/deepseek-harness-shortcut is maintained by Ho11ow8, categorized as a client, and is licensed under MIT. It is used to create one-click launch or open desktop shortcuts for the local DSH web UI on Windows. The plugin is released as a DSH bundle and is automatically activated to the profile upon installation. package.json requires Node >=18.0.0 and has peerDependency @deepseek-ai/cordis ^4.0.1.

Core Features

  • Provides the /desktop-shortcut command to generate desktop shortcuts and launchers.
  • The intelligent launcher determines if the DSH service is running: if running, it opens the browser directly; if not, it starts the service and waits for the port to be ready.
  • Default startup command is npx --yes @deepseek-ai/dsh web, defaulting to waiting for port 3080 for up to 30 seconds.
  • Supports configuration for shortcutName, url, port, iconPath, launcherDir, workdir, command, and waitSeconds.
  • Zero runtime dependencies, using only Node >=18 built-in capabilities.

Installation and Activation

The installation command is as follows:

dsh plugin --profile web add github:Ho11ow8/deepseek-harness-shortcut

After installation, restart dsh web and run in chat:

/desktop-shortcut

The plugin will generate start-dsh.bat in the workspace and DeepSeek Harness.lnk on the desktop.

Typical Usage

The following outlines typical usage scenarios.

Generate Default Shortcuts

After running /desktop-shortcut, DeepSeek Harness.lnk appears on the desktop and start-dsh.bat is generated in the workspace. When double-clicking the desktop shortcut, the plugin selects to open the browser or start the service based on the current service status.

Override Configuration

Configuration can be overridden via the cordis.patch.yml in the profile. For example:

- id: desktop-shortcut
  config:
    shortcutName: My Harness
    url: 'http://127.0.0.1:8080'
    port: 8080
    iconPath: 'C:\icons\my.ico'
    launcherDir: 'D:\launchers'
    workdir: 'D:\DeepseekHarness'
    command: 'npx --yes @deepseek-ai/dsh web'
    waitSeconds: 45

Common configuration options include:

  • shortcutName: Filename of the shortcut;
  • url: Address opened by the launcher;
  • port: Port used to determine if the service is already running;
  • iconPath: Path to the shortcut icon;
  • launcherDir: Directory where start-dsh.bat is generated;
  • workdir: Working directory of the launcher;
  • command: Command to start the DSH service;
  • waitSeconds: Number of seconds to wait for the service to be ready.

Change Icon

Place .ico or .png files in the workspace, or specify iconPath in the configuration, then run again:

/desktop-shortcut

After modifying the icon, the Windows desktop may cache the old icon and may require refreshing the desktop.

Slow npm Access

If npm access is slow, you can execute first:

npm config set registry https://registry.npmmirror.com

Then run /desktop-shortcut or the startup process.

Suitable Scenarios and Notes

This plugin is suitable for scenarios where the local DSH web UI is used long-term on Windows and a desktop entry is needed. The plugin runs with the permissions of the current dsh process; it is recommended to review the GitHub source code and license before installation.

Other notes:

  • README is limited to the Windows scenario.
  • License is MIT.
  • package.json requires Node >=18.0.0 and has peerDependency @deepseek-ai/cordis ^4.0.1.

Links