feiyang-dev/DeepSeek-Harness-Desktop
一个 Electron 桌面壳，内嵌官方 DeepSeek Harness Web UI。启动时让用户选择安装模式，自动完成环境检测、安装、服务拉起，以百分比进度条展示各阶段，服务就绪后打开主界面。
安装Install
dsh plugin --profile web add github:feiyang-dev/DeepSeek-Harness-Desktop把 feiyang-dev/DeepSeek-Harness-Desktop 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeepSeek Harness Desktop
English · 简体中文
A Windows desktop client for the official DeepSeek Harness Web UI — automatically detects your environment, installs dependencies, and starts the service. Works out of the box.
Overview
An Electron desktop shell that embeds the official DeepSeek Harness Web UI. On startup it lets you pick an installation mode, then automatically handles environment detection, installation, and service startup — with a percentage progress bar for every stage. When the service is ready, the main UI opens automatically.
No command-line memorization, no manual service startup — just double-click and go.
Features
Installation Modes
Choose an install method when the app launches:
| Mode | Description | Best For |
|---|---|---|
| Instant Start | Local fixed-directory runtime, second-level launch, auto-checks official updates with one-click update (replaces Quick Start) | Most users, recommended |
| Full Source Build | git clone + pnpm install + pnpm run build |
Developers who want to modify/debug the source |
| Local Repair | Uninstall global @deepseek-ai/dsh, clean residue, reinstall |
Fix broken installs, version issues, or koffi load failures |
Friendly Startup Guide
- Large percentage progress bar + stage hints, fully replacing log spam
- Expandable command-line log panel: one click to view real output (install/build process), auto-expands on errors
- Stage text adapts intelligently: detecting environment → downloading → extracting → installing → building → starting
Plugin Management (Dedicated Page + Custom Install)
The home screen has a "Plugin Management" entry (left navigation) that opens a dedicated plugin page:
- Recommended plugins — one-click install/uninstall of community-built plugins (install progress shows in the "Custom Install" card's command log; click "Restart Service Now" after finishing):
- Usage & Cost Tracker (dsh-usage-plugin): per-call token/cache-hit stats, peak/off-peak billing, a usage calendar heatmap, balance query, and CSV/JSON/PNG export.
- Data Vault (dsh-vault): auto-backups
~/.dshdata to~/.dsh-backups, detects data wipe, and restores chat history and workspace data with one click. - Mobile Remote Control (dsh-mobile-remote): control DeepSeek Harness on your PC from your phone over LAN / the internet via QR code — remote-access password gate, external tunnel status monitoring, and real-time device / runtime status.
- Custom install — enter any npm package name or install command (e.g.
@scope/plugin-nameornpm install @scope/plugin-name); the client installs it and registers it in the runtime profile. Command-line output is shown live in the custom-install card. - Installed list — shows all installed plugins (version / registration status) with per-plugin uninstall.
- The install logic is equivalent to the official
dsh plugin add(npm into profile + registerdsh.profile.bundles); restart the service to take effect.
Prefer the command line? The equivalent commands work too:
dsh plugin --profile web add @feiyang666/dsh-usage-plugin dsh plugin --profile web add @feiyang666/dsh-vault dsh plugin --profile web add @feiyang666/dsh-mobile-remote
Plugin Market (Scan GitHub Community Plugins)
A "Plugin Market" entry in the left navigation scans GitHub public repos tagged with dsh-plugin (the officially recommended way to discover community plugins):
- List view: each plugin shows name, author, description, star count, primary language, and license; official recommended plugins are pinned and marked "Official".
- Search / pagination: keyword search across plugin name / description / author, with paginated results.
- One-click install: once the repo's npm package name is detected from its
package.json, you can install it with one click (reuses the custom-install flow with automatic mirror switching); repos without a detectable npm package are marked "Not an npm package" for reference. - Installed status: already-installed plugins are marked "Installed" with their version directly in the market.
- The scan uses the public GitHub API and is subject to GitHub rate limits without login (~60 requests/hour); the market page shows failure hints and a retry entry.
Settings & Online Updates
The "Settings" entry (left navigation) opens the settings page:
- About: app version, changelog
- Appearance: interface theme with three options — Dark / Light / Follow System (persisted, takes effect immediately, synced across the desktop client and the official Web UI — change it on either side and the other follows)
- Notifications: toggle for new-version system notifications (persisted)
- Developer options: toggle "Developer options mode" (persisted, applies on next launch)
- Check for updates: auto-checks when entering settings; supports manual check, one-click download & install, live progress display, and SHA256 verification on completion
Developer Options Mode (for frontend development)
After enabling "Developer options mode", choosing "Quick Start" no longer runs a single-process npx; instead it splits startup into two processes for easier iteration on the DSH browser side:
| Process | Description |
|---|---|
| Service backend | Starts dsh web from the source repo (%APPDATA%/dsh-desktop/deepseek-harness), serves the API and hosts the frontend at the same address |
| Browser-side hot-reload watcher | pnpm run dev:web, watches all dsh.client plugin sources; rebuilds the bundle automatically on changes, hot-reloads in the browser without refresh |
- Requires a completed "Full Source Build" first (a hint is shown if not ready)
- The WebUI window still opens
http://127.0.0.1:3080; the home console shows a "Developer Mode" badge, and stop/restart manages both processes - Choosing "Full Source Build" while the mode is on also starts the hot-reload watcher after the build
- Turning the switch off returns to the original single-process npx Quick Start
Other Features
- No terminal windows: all subprocesses run directly via
node, no console popups - Automatic environment detection: guides you when Node.js/git/pnpm are missing (download button for Node, download hint for git, auto-install for pnpm)
- Automatic service startup: reuses an existing service on port 3080 when available; otherwise starts
dsh web - System tray: closing the window minimizes to tray while the service keeps running; exit from tray menu
- Clean exit: automatically
taskkills the dsh process tree on quit - Packaging:
electron-buildergenerates a Windows installer
System Requirements
| Dependency | Notes |
|---|---|
| Windows 10 / 11 (x64) | Runtime platform |
| Node.js ≥ 18 | Required for Instant Start mode; the client guides installation if missing |
| git | Only needed for source mode (pnpm auto-installs if missing) |
| Network | First install downloads dependencies (~hundreds of MB) |
The client guides you through installing anything missing — no manual setup required.
Getting Started
Development
start.bat
Or manually:
npm install
npm start
Custom port: npm start -- --port 8090 (default 3080; reuses an existing dsh web service on that port if present).
Project Structure
dsh-desktop/
├── main.js # Main process (mode selection/progress state machine/install/start/window/tray/cleanup/update service/plugin market IPC)
├── preload.js # Secure bridge (mode/progress/log/status/settings/update/plugin market IPC)
├── plugin-manager.js # Plugin manager (install/uninstall/status, pure Node logic)
├── plugin-market.js # Plugin market (scans GitHub topic:dsh-plugin, pure Node logic)
├── boot/ # Bootstrap page (home + left nav + plugin management + plugin market + settings + progress bar + log panel)
│ ├── boot.html
│ ├── boot.css
│ └── boot.js
├── assets/ # Packaging resources (icons, etc.)
├── pack.js # Interactive packaging script
├── start.bat # Dev startup script
└── package.json # Dependencies & build config
Startup Flow (State Machine)
[Home: Mode Selection] --user chooses (no auto-enter)-->
Quick: detect node → npx downloads deps → start service
Quick + Developer mode: detect node → check source repo → start service backend + browser hot-reload watcher (two processes)
Source: detect git/pnpm → clone → pnpm install --ignore-scripts → pnpm run build → start service (with dev mode on, also starts the watcher)
Repair: stop service → force-clear local data → official quick-start launch
│
▼
[Progress] 8% detect env → 25-90% install/build/repair → 60-95% start service → 100% ready
│
▼
[Home: Running] --opens WebUI in a separate window (http://127.0.0.1:3080)-->
[Stop] → home shows "Stopped"; re-run or switch mode
[Restart] → re-runs the startup flow with the last chosen mode
[Plugin Management] left nav → recommended one-click install / custom package install / uninstall from installed list
[Plugin Market] left nav → scans GitHub topic:dsh-plugin → search / browse / one-click install
[Settings] home → About / Notifications / Developer options / Check for updates (auto-check + download & install)
Key implementation details:
How Instant Start works (why it is second-level and offline-capable)
Why was the old "Quick Start" slow? Quick Start ran npm exec --yes -- @deepseek-ai/dsh web (npx). The official dsh package is split into 150+ interdependent sub-packages (@deepseek-ai/dsh-*), and npm exec does the following on every startup:
- Resolves
latestfrom the registry (one HTTP round-trip); - Sends an HTTP request for each sub-package to revalidate its version (
cache revalidated), even when the local cache already exists; - Unpacks each tarball into a fresh npx sandbox directory.
Serializing the validation + unpacking of those 150+ packages takes 100~200 seconds even with a fully warm cache (especially on domestic networks) — that is the root cause of a 200+ second service startup. It is not a slow network; npm is re-resolving the whole dependency tree every time.
What Instant Start does: it fully separates "install" from "launch" — install once, launch many times:
- First run (needs network once): runs
npm install @deepseek-ai/dsh --prefix <userData>/dsh-local --ignore-scripts, fully unpacking dsh and all 150+ dependencies into a local fixed directory (%APPDATA%\dsh-desktop\dsh-local\node_modules), forming a "ready" dependency tree on disk. Uses the domestic mirror (npmmirror) with automatic fallback. - Every subsequent launch (fully offline):
spawn(node, [<dsh-local>/node_modules/@deepseek-ai/dsh/lib/bin.js, 'web', ...])— the Node.js process loads the locally unpackedbin.jsentry directly. No npm involved: nolatestresolution, no HTTP requests, no tarball validation, no unpacking. Node'srequirehits the localnode_modulesdirectly, and the service is ready within seconds. - The working directory matches Quick/Repair modes (
resolveWorkspaceDir()), so session-history ownership is unchanged.
How do updates work? Instead of forcing "latest on every start", Instant Start silently checks in the background: about 8 seconds after startup (avoiding first-load bandwidth contention), it runs npm view @deepseek-ai/dsh version to query the latest official version. When a new version is found, the home status bar shows a "Update Now" banner — click to auto "stop service → reinstall the local runtime to the latest → auto restart", all through the domestic mirror with automatic fallback. When offline the check is skipped and startup is unaffected.
Mirror speed-test skip when local runtime is ready: ensureRegistrySelected() (concurrent mirror speed test) in run() only executes for Instant Start when the local runtime is not yet installed — once installed it starts directly, so fully-offline scenarios need no network probing.
- Source mode: repo cloned to
%APPDATA%/dsh-desktop/deepseek-harness(keeps the workspace clean);pnpm install --ignore-scriptsthenpnpm run build; starts vianode --import tsx/esm apps/cli/src/bin.ts web - All services start without going through
cmd.exe— no terminal popups
FAQ
Q: Installation stuck at a percentage? A: Click the "command-line log" panel to see the real output. Usually it's just slow network downloads — be patient. If it makes no progress for a long time, use "Local Repair" mode to reinstall.
Q: koffi load failure / version issues? A: Pick "Local Repair" mode on the startup page. The client uninstalls the global package, cleans residue, and reinstalls the latest version automatically.
Q: Port 3080 is already in use?
A: The client reuses a running dsh web service first; alternatively use npm start -- --port <port> to specify another port.
Q: Want to debug or modify the source?
A: Choose "Full Source Build" mode. The source is cloned to %APPDATA%/dsh-desktop/deepseek-harness and starts automatically after building.
Q: How do I use Developer Options mode?
A: Enable "Developer options mode" in Settings (a "Full Source Build" must be done first), then choose "Quick Start". The client runs the "service backend" and the "browser-side hot-reload watcher (pnpm dev:web)" as two processes; the browser still opens on 3080. Changes to dsh.client plugin sources rebuild automatically and hot-reload without a refresh.
Q: How does the desktop app update when DeepSeek releases a new official version? A: Instant Start auto-checks for updates in the background: after startup it silently queries the latest official version, and when a new version is found the home status bar shows a "Update Now" banner — click to auto "stop service → reinstall the local runtime to the latest → auto restart", all through the domestic mirror with automatic fallback. The home screen shows the current dsh version; Settings → "Runtime (dsh)" can compare "current version vs latest version" with one click. When offline the check is skipped and startup is unaffected.
Q: Is "Local Repair" still available in Developer Options mode?
A: Yes. "Local Repair" always runs the official quick-start single process (via pnpm dlx) and is unaffected by Developer Options (repair also cleans up any leftover watcher processes).
Tech Stack
- Electron 31 — desktop shell
- electron-builder — packaging (NSIS)
- Native Web APIs — bootstrap page (no frontend framework dependencies)
License
MIT © dsh-desktop
Related Projects
| Project | Description | Installation |
|---|---|---|
| Usage & Cost Tracker (dsh-usage-plugin) | Per-call token/cache-hit stats, peak/off-peak billing, balance query, CSV/JSON/PNG export | One-click from the desktop app's recommended plugins, or dsh plugin add @feiyang666/dsh-usage-plugin |
| Data Vault (dsh-vault) | Auto backup / wipe detection / one-click restore — protects chat history and workspace data | One-click from the desktop app's recommended plugins, or dsh plugin add @feiyang666/dsh-vault |
| Mobile Remote Control (dsh-mobile-remote) | Control your PC's DeepSeek Harness from your phone via QR / LAN / internet — password gate, tunnel status, real-time device & runtime stats | One-click from the desktop app's recommended plugins, or dsh plugin add @feiyang666/dsh-mobile-remote |
| DeepSeek-Harness | Official CLI / Web service | — |
If you find this helpful, feel free to Star ⭐
相关推荐Related
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
Tencent/WeKnora
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-m…
- Nagi-ovo/voyager Enhancement suite for Gemini, AI Studio, Claude & ChatGPT — plus a prompt manager for any web UI, DeepSeek Harness inclu…
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
EverMind-AI/EverOS
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, t…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中