15828148/dsh-portable-launcher
One-click portable launcher for DeepSeek Harness (dsh) Web UI on Windows
A one-click Windows launcher for the DeepSeek Harness Web UI aimed at end users with no command-line experience. It runs three stages with live progress — [1/3] Node.js check, [2/3] dsh package check, [3/3] launch — downloads a portable Node.js and the dsh package only when missing (up to three retries per step with concrete manual instructions afterwards), then starts the Web UI at http://127.0.0.1:3080 and opens the browser once it responds. It checks for 64-bit Windows, a writable folder and port conflicts, keeps everything inside the package folder, and reports no telemetry. The README states the launcher only downloads Node.js LTS from npmmirror/nodejs.org and @deepseek-ai/dsh from the npm registry, and that the API key is stored by dsh in %USERPROFILE%\.dsh\.credentials.yaml — never in the launcher folder.
Install
Download dsh-web-ui-portable.zip from github.com/15828148/dsh-portable-launcher/releases and run setup.batREADME usage: download dsh-web-ui-portable.zip from Releases and extract it anywhere (e.g. D:\ or the Desktop — not Program Files), run setup.bat once to create a desktop shortcut, then double-click DSH Web UI (or dsh-web.bat). On first run press Y if asked to download Node.js. Add your own DeepSeek API key in the UI Settings. The launcher writes progress markers next to itself (node/, dsh-ready.txt, dsh-startup.log), which is what makes resume and the zero-download fast path work; the zip also contains 使用说明.txt and README-EN.txt FAQs. Unofficial community project, not affiliated with DeepSeek AI.
Compatibility
Windows 10/11 x64. Node.js is not required — a portable LTS build is downloaded automatically (npmmirror, falling back to nodejs.org) and @deepseek-ai/dsh is installed locally with npm install --prefix into the package folder, so nothing is written to the registry or system PATH.
Details
- Repo: 15828148/dsh-portable-launcher
- Category: Web UI Enhancements
- Stars: 2
- Version: Release bundle (README documents only the zip + setup.bat flow; no npm package is named)
- Last push: 2026-08-14
- First seen: 2026-08-13
Recent updates
README describes the troubleshooting surface shipped in the zip: SmartScreen prompts, WeChat file corruption, a non-writable folder, port 3080 already in use, and slow first runs, each with an answer in 使用说明.txt (Chinese) and README-EN.txt (English). Failures are reported against the [1/3] [2/3] [3/3] stage markers.
FAQ
- Do I need to install Node.js or the dsh CLI first?
- No. The launcher detects a missing or too-old Node.js (it wants v22+) and downloads a portable LTS build automatically, then installs the dsh package locally into its own folder. Nothing is added to the system PATH or registry.
- Where is my API key stored?
- In %USERPROFILE%\.dsh\.credentials.yaml, written by dsh itself — the README states the key is never stored in the launcher folder.
- What if the setup is interrupted?
- Progress state lives in marker files next to the launcher (node/, dsh-ready.txt, dsh-startup.log), so closing the window mid-setup and running again resumes from where it stopped.