dsh-plugin-desktop-shortcut

English | 中文

A DeepSeek Harness (dsh) plugin that creates a Windows desktop shortcut to launch dsh web with a single double-click — no terminal needed.

✨ Zero runtime dependencies (Node builtins only). Windows-only. 🐳 Bundled cute DeepSeek whale-girl icon (CC BY-NC-SA 4.0, see assets/NOTICE.md).

Features

1. On plugin load, writes a small .cmd launcher next to your dsh checkout (<dshDir>/start-dsh-web.cmd) and creates <Desktop>\DSH Web.lnk pointing at it (handles OneDrive desktop redirection).
2. Double-click the shortcut → a console window opens → pnpm dsh web runs → open http://127.0.0.1:3080. Closing the window stops the service.
3. Duplicate-run guard: if dsh is already listening on the port, the launcher skips starting a second instance and just opens the browser.
4. Auto-open browser: opens the web UI a few seconds after the server boots (configurable delay).
5. In the TUI, registers a /shortcut command:

Install

Windows only. The plugin is not published to npm yet — install it straight from this GitHub repo.

1. Install the package into your dsh profile

dsh ships a plugin manager that runs pnpm inside the profile directory:

# web profile (this plugin's main target):
pnpm dsh plugin --profile web add git+https://github.com/DXF1024/dsh-plugin-desktop-shortcut.git
# or the TUI profile (for the /shortcut command):
pnpm dsh plugin --profile tui add git+https://github.com/DXF1024/dsh-plugin-desktop-shortcut.git

2. Declare it in the profile's patch layer

Append to ~/.dsh/profiles/web/cordis.patch.yml (it is an empty list by default):

- insert:
    - id: desktop-shortcut
      name: 'dsh-plugin-desktop-shortcut'
      config:
        autoInstall: true
        # dshDir: 'C:\path\to\your\dsh-checkout'   # default: process.cwd()
        # desktopName: 'DSH Web'
        # iconPath: 'C:\path\to\custom.ico'

3. Restart dsh

pnpm dsh web

From now on every start creates/refreshes a "DSH Web" desktop shortcut (whale-girl icon included). TUI users get the /shortcut command instead.

Troubleshooting for other machines:

• The loader resolves plugin packages from the profile directory (~/.dsh/profiles/web/), so the package must be installed there via dsh plugin --profile web add — installing it into the dsh checkout's own node_modules does NOT work.
• On machines with a system proxy (e.g. Clash), dsh plugin add may fail with Unsupported proxy syntax because the CLI forwards the raw Windows proxy (127.0.0.1:7897, no scheme) to git. Workaround — run pnpm directly in the profile directory:

  cd ~/.dsh/profiles/web && pnpm add git+https://github.com/DXF1024/dsh-plugin-desktop-shortcut.git

Configuration

All fields are optional.

Example:

- insert:
    - id: desktop-shortcut
      name: 'dsh-plugin-desktop-shortcut'
      config:
        dshDir: 'C:\AAADXF\DSH\deepseek-harness-master'
        port: 3080
        desktopName: 'DSH Web'
        iconPath: 'C:\path\to\my-icon.ico'
        openBrowser: true
        preventDuplicate: true
        browserDelaySec: 4

Development

# syntax / export smoke test (16 checks)
node tests/smoke.mjs

Credits

• Icon: fornarwhal/deepseek-whale-girl-icon (CC BY-NC-SA 4.0)

License

Plugin code: MIT ｜ Bundled icon: CC BY-NC-SA 4.0 (see assets/NOTICE.md)