A lightweight desktop shell for DeepSeek Harness (DSH): start the service with one click and keep it in your system tray — no terminal needed.
DSH Desktop is an unofficial, third-party desktop client built with Tauri 2 + Vue 3. It launches the DSH web service locally and embeds the web UI in a native window, so you can use DeepSeek Harness like a local app.
- One-click start: Launches the DSH service automatically and polls until it is ready — no manual
npxcommands. - One-click stop: Locates and terminates the DSH process listening on port 3080.
- System tray: Closing the window minimizes it to the tray; the app keeps running in the background and lets you toggle the service from the tray menu.
- Health monitoring: A status dot reflects the service state in real time, and unexpected crashes are detected.
- System locale: Follows your system language to switch between Chinese and English UI.
- Frameless window: Ships with its own minimize / maximize / close buttons for a cleaner look.
- Cross-platform: Runs on Windows, macOS, and Linux.
- Windows, macOS, or Linux
- Node.js (
npxmust be available on PATH; on first start the app pulls@deepseek-ai/dshvianpx, so a network connection is required) - macOS / Linux:
lsofis required to locate the DSH process (preinstalled on macOS; on Debian/Ubuntu install it withsudo apt install lsof) - Ensure
127.0.0.1:3080is free
Download the latest installer from Releases and double-click to install.
# 1. Install frontend dependencies
npm install
# 2. Run in development mode (Tauri window + HMR)
npm run tauri dev
# 3. Build the installer (output: src-tauri/target/release/bundle)
npm run tauri build- Open the app and click Start: it launches the local DSH service and embeds
http://127.0.0.1:3080into the window. - Click Stop to terminate the DSH service.
- Click the close button to hide the window to the system tray (the app does not exit).
- Right-click the tray icon to Show / Start·Stop service / Quit. Choosing Quit also cleans up the DSH process.
- Start: checks whether
127.0.0.1:3080is free → silently runsnpx --yes @deepseek-ai/dsh web(no console window on Windows) → polls until the port is ready. - Stop: finds the process listening on port 3080 (
netstat -anoon Windows,lsofon macOS/Linux) and terminates it (taskkillon Windows,killon macOS/Linux). - Status: the UI calls
is_dsh_service_runningevery 3 seconds to drive the status dot and tray menu text.
Q: Port 3080 is already in use? A DSH service (or another process) is already running. Free the port first, or click Stop and then Start again.
Q: Nothing happens / start fails?
Make sure Node.js is installed and npx works (verify with npx --version), and stay online so @deepseek-ai/dsh can be fetched.
Q: Does it support macOS / Linux?
Yes — DSH Desktop runs on Windows, macOS, and Linux. On macOS/Linux, make sure lsof is installed.
Q: Is this an official app? No. DSH Desktop is a third-party community project and is not affiliated with DeepSeek.
| Layer | Technology |
|---|---|
| Desktop | Tauri 2 (Rust) |
| Frontend | Vue 3 + Vite |
| i18n | rust-i18n + Vue frontend strings |
| Process | Rust std::process + netstat/taskkill (Windows) · lsof/kill (macOS/Linux) |
Issues and pull requests are welcome. Read the build steps above and verify npm run tauri dev works locally before submitting.
Good first issues: automated release CI, in-app auto-update, installer icon & metadata polish.