dsh-desktop-shell

A desktop launcher shell for DeepSeek Harness (dsh): a thin Electron wrapper that gives the dsh web profile a native window and a system-tray home.

中文说明

What it does

Double-click the app → it checks whether the dsh web server is already listening (default http://127.0.0.1:3080); if not, it starts it for you; then it opens the web UI in a native window.

• Tray-resident — closing the window hides it to the system tray instead of quitting; tray menu: open main window / quit.
• Single instance — launching again focuses the existing window.
• Ownership-aware — a web server the shell started is stopped when the shell quits; a pre-existing one (your own terminal, another tool) is left untouched.
• Configurable — the dsh command, working directory, extra environment variables, port, and window title all live in config.json; no hardcoded machine paths, no bundled API endpoints.

Install the dsh side (the bundle)

This repository is a dsh profile bundle: its package.json declares dsh.bundle.patch, so installing it into the web profile activates a patch layer that pins the web server to loopback 127.0.0.1:3080 and mounts a small glue plugin (prints a ready line, warns if the server ever binds beyond loopback).

From a git checkout:

dsh plugin --profile web add github:ikashana/dsh-desktop-shell

From npm (once published):

dsh plugin --profile web add dsh-desktop-shell

Then start dsh web as usual (dsh --profile web) — or let the shell below start it for you.

Install the shell (the desktop app)

Requirements: Node.js ≥ 18 (Electron downloads at install time).

git clone https://github.com/ikashana/dsh-desktop-shell.git
cd dsh-desktop-shell
npm install
cp config.json.example config.json   # then edit to match your environment
npm start

The only required edit is dshCommand (and cwd if dsh lives elsewhere): point it at your dsh CLI, or at your checkout's node + source entry for a from-source install, e.g.

{
  "dshCommand": ["C:/path/to/node.exe", "--import", "tsx/esm", "apps/cli/src/bin.ts", "--profile", "web"],
  "cwd": "C:/path/to/deepseek-harness"
}

On Windows, prefer an absolute path to node.exe; a bare dsh resolves through its .cmd shim, which child_process refuses to spawn without a shell (CVE-2024-27980 hardening) — the shell handles that case too, but an explicit executable is most reliable.

config.json

Desktop shortcut (Windows)

$WshShell = New-Object -ComObject WScript.Shell
$lnk = $WshShell.CreateShortcut("$HOME\Desktop\dsh Desktop.lnk")
$lnk.TargetPath = "C:\path\to\dsh-desktop-shell\node_modules\electron\dist\electron.exe"
$lnk.Arguments = "`"C:\path\to\dsh-desktop-shell`""
$lnk.WorkingDirectory = "C:\path\to\dsh-desktop-shell"
$lnk.IconLocation = "C:\path\to\dsh-desktop-shell\assets\icon.ico"
$lnk.Description = "dsh Desktop · DeepSeek Harness launcher shell"
$lnk.Save()

Logs

The shell writes shell.log and web.log into Electron's userData directory (Windows: %APPDATA%\dsh-desktop-shell\) — the first place to look when the web server fails to come up.

Platform notes

Developed and tested on Windows. The tray behavior is cross-platform; process-tree teardown uses taskkill on Windows and falls back to kill() elsewhere. The window icons are rendered from the dsh favicon (assets/favicon.svg, MIT) — re-render with node_modules\electron\dist\electron.exe make-icon.js if you want a custom look.

Layout

├── main.js            # Electron main process: window / tray / single instance / web lifecycle
├── lib/index.js       # dsh bundle glue plugin (loopback check + ready line)
├── cordis.patch.yml   # dsh profile patch layer (loopback-pinned webserver + glue row)
├── config.json.example
├── make-icon.js       # icon renderer (favicon.svg → PNG)
└── assets/            # icons + favicon source

License

MIT. assets/favicon.svg is copied from the MIT-licensed deepseek-harness repository.