DeepSeekHarnessGreen

English | 中文

A one-click local launcher that wraps DeepSeek Harness (dsh) into a double-click-to-run experience: no CLI, no manual Python/Node installs, no browser setup — copy the folder, double-click, go.

Download: GitHub Release ｜ Gitee Release (faster in China) ｜ GitHub Repo ｜ Gitee Repo

Feature Highlights

• ⚡ Double-click & Go: Use DSH_Launcher.exe (no Python install needed) or start.bat. Click Install Environment once — everything auto-downloads and sets up.
• 🖥️ Desktop App Experience: Opens as a standalone desktop window by default (embedded WebView2 — feels like a native app, fully independent from your browser). One click switches back to the original WebUI in your system browser. Toggle between desktop window and browser window anytime; default can be changed in Settings.
• 🌱 Truly Portable: Node, dsh, npm/pnpm caches, session data, temp files — everything lives under runtime/ in this folder. No writes to ~/.npm, no system installs, no registry changes. Built-in portable Node and Python. Mirrors default to China; auto-falls back to official sources. Copy the entire folder to any machine — keep using it immediately.
• 📦 13 Built-in Plugins: Session rewind/import, usage stats, file browser, archive cleanup, sidebar, background media, Ollama local LLM integration, Zuzong Memory Bank (cross-session auto-memory, default OFF since v3), user rules injection (similar to TRAE rules, editable in WebUI since v4), Skill Center (left sidebar entry + grouped official/personal skill management + composer skill picker), LAN visibility (per-workspace/conversation local-only access), and more. See Built-in Plugins.
• 🔁 Two Independent Update Channels: The official dsh core and the green-portable shell update independently — each checks its own source. Core upgrades auto-back up by default (can be disabled in General Settings), and never touch your settings or sessions.
• 🏠 LAN Remote Access: One click to bind to 0.0.0.0 and auto-create Windows Firewall rule — open the WebUI from your phone or other computers on the same LAN.
• 🌐 Chinese / English Interface: One-click toggle in the top-right corner. All buttons, dropdowns, dialogs and status text refresh in real time — no restart needed. Language preference auto-saves to config.json.

Quick Start (First Time)

1. Extract the zip, double-click DSH_Launcher.exe (or start.bat).
2. Click Install Environment: auto-downloads portable Node → installs dsh → deploys built-in Python (requires internet, a few minutes; npm progress is shown line-by-line).
3. Click Start Service — auto-opens a standalone desktop window (you can switch to browser window anytime).
4. In the WebUI: Settings → Models → enter your DeepSeek API Key, then select a workspace (the folder AI works on).
5. Every time after: double-click the launcher → click Start Service.

Then just chat with DeepSeek in the WebUI — let AI read/write workspace files and call tools.

Main Buttons

Headless mode (optional): python launcher.py --start / --stop / --purge-archived / --purge-session <ID> / --restore-session <ID> / --install-plugin <folder-or-name>.

Green Portability & Data

• Everything local: Portable Node, dsh package, npm cache, pnpm store, sessions, temp files — all under runtime/. No ~/.npm, no ~/.pnpm-store, no user-directory leftovers.
• Zero system pollution: No global npm packages, no PATH changes, no registry writes.
• Folder-level migration: Stop service → copy the entire folder to a new machine → double-click to run. Sessions travel with it. If workspace paths differ, re-select the workspace in the WebUI.
• Clean uninstall: Just delete the folder. Nothing left behind.

Lightweight distribution zip: The release zip does not include runtime/ (no pre-downloaded environment) — it's small. On a new machine: launch → click Install → click Start — three steps and you're live.

Built-in Plugins

All plugins are pure plugins (zero modifications to official dsh files), Apache License 2.0, same as the launcher. Install via Plugin Manager → Install Local Plugin… → pick plugins\<name>. Restart the service after install.

Detailed usage in plugins/<name>/README.md.

Data Maintenance (Restore / Permanently Delete Archived Sessions)

Official dsh has no "permanently delete session" or "un-archive" — the "archive" button only hides sessions (logs are fully retained). This launcher directly operates local data while the service is stopped:

• Restore (Un-archive): Session reappears in the list; logs and content untouched.
• Permanently Delete: Irrecoverable. Logs + workspace registry entries + both old and new projection-cache formats wiped.
• Cache orphans (phantom sessions): after dsh upgrades, some already-deleted sessions leave title caches behind in the projection cache (storages/session_projcache/sessions/session-*.json) — they have no logs, belong to no workspace, and never appear in the WebUI. Session Management marks them as Cache orphan and the footer shows "N sessions total, M cache orphans"; tick them and click Delete Selected to clear them all (fixed 2026-10-27: only the old cache format used to be cleaned, so these rows could never be deleted).

Entry: main window → Data Maintenance → Session Management → check sessions → click Restore Selected / Delete Selected.

Two Independent Update Channels

Completely independent, non-interfering:

Core updates only touch runtime/dsh/. Shell updates only touch the program root directory and skip config.json and runtime/ (your settings and sessions are safe). Before overwriting, old files are auto-backed up to runtime/update/backup/ — if the new version breaks something, manually copy back.

Built-in plugins are re-synced automatically once after an update: on the first launch of the new version the launcher installs any newly bundled plugins and updates installed ones to the shipped sources; the result is written to the launcher log (no need to remember to open Plugin Manager). The trigger is the version recorded in runtime/last_run_version.txt, so a manual zip overwrite triggers it too; a failed sync keeps its marker and retries on the next launch.

LAN Remote Access

Main window → Network Settings → service bind → pick LAN (0.0.0.0) → save and start. Ready log will show LAN address: http://<local-ip>:3080. Open it from any other computer or phone on the same LAN. Trusted Hosts blank = auto-trust all LAN IPs; filled = only trust listed addresses. Privileged operations (API Key changes) still require localhost only — that's an official dsh security measure. Localhost mode (default 127.0.0.1) is unchanged from before.

Also configurable in config.json: mirror (auto/cn/official), dsh_port, dsh_host, trusted_hosts.

FAQ

License

This launcher as a whole (launcher.py, green-portable shell, built-in plugins) is licensed under Apache License 2.0: Copyright (c) 2026 LiuJunheng. See LICENSE. The green-portable zip includes a copy. Runtime dependencies (@deepseek-ai/dsh, Node.js, portable Python, etc.) keep their own licenses and are only installed locally inside the runtime directory — not distributed with source.

DSH Experience Skill

Deployment / maintenance / plugin development experience has been distilled into a TRAE Skill called dsh-deploy-maintain (source at skills/dsh-deploy-maintain/, contains 51 pitfalls reference). Installed globally in TRAE — available in new sessions.