dsh_desktop

The best of the DSH plugin ecosystem, packaged into one ready-to-use desktop client.

Not just another DSH shell: we pick the plugins, fix compatibility, integrate them, and ship them in one installer. Install and go — no Node.js setup, no plugin hunting, no version-conflict archaeology.

[!IMPORTANT] v1.0.8 — the bundled kernel moves to 0.2.1-rc.4. The official dsh runtime ships with 34 selected companion plugins: DeepSeek-Bot (main bot + long-lived bots + group chats), the Better Sidebar file workbench, Free Search, the plugin shop, Prompt Optimizer, the conversation map, desktop notifications, the MCP toolbox, and more — all working out of the box, with one place to inspect, toggle and update them under Settings → Plugins → Built-in plugins. The shell is still Tauri 2 + a bundled Node runtime: smaller installers, faster startup, and no blank screen even with broken plugins or configs.

Gitee mirror · · Third-party notices

[!TIP] 🧩 Recommended: dsh-hotplug-hub — our recommended dsh launcher manager.

✨ Why a curated plugin bundle

DSH has a great plugin ecosystem, but "great" and "ready to use" are separated by four walls: selection, compatibility, versions and configuration. DSH Desktop does that work for you: curated, integrated, shipped in the box.

Curated, not collected

• 34 companion plugins, each one chosen — we optimise for quality, not count. Every bundled plugin gets a host-compatibility check, a licence review and a real boot test; the roster and evidence live in the inventory.
• One installer, one complete experience — Bot team and group chats (DeepSeek-Bot), the Better Sidebar file workbench, free multi-engine search (Free Search), the plugin shop, prompt optimisation, the conversation map, desktop notifications, the MCP / skills toolbox, balance and cost, session archiving, peak/off-peak price guard — all there after install.
• One place to manage them — Settings → Plugins → Built-in plugins lists every bundled plugin with its version, an on/off switch and an update check. Update sources and exclusions come from one table, so the same plugin cannot show different states in different entry points.
• Traceable upstreams — every bundled plugin records its source repository, version and licence. Third-party licences are in THIRD_PARTY_NOTICES.md; compatibility verdicts and test evidence are in §5 of the inventory.

Ready out of the box

• Zero environment setup — a standalone Node runtime and npm CLI are bundled; the target machine needs no Node.js or pnpm.
• Complete dsh, offline — ships the official @deepseek-ai/dsh package and the full official plugin set; it starts without a network.
• Double-click to run — reuses the last port, then loads a native window once the kernel is ready; installer and portable builds are both available.
• Client-level updates — check and install from the ⋯ menu, with GitHub / Gitee failover and sha256 fail-closed verification; the kernel ships with the client, so there is no second update chain.

Desktop experience

• Tauri 2 native shell — frameless dark glass, custom title bar, Win11 rounded corners; closing hides to the tray by default.
• File workbench — Better Sidebar brings the explorer, editor, diff view and "open locally" into the right pane, with desktop-native collapse/expand and shortcuts.
• Bot team — DeepSeek-Bot puts a main bot, long-lived bots and group chats in the same client: @ handoffs, shared group memory, a capability library and usage pages. It turns DSH into a long-running collaboration workspace.
• Notifications and balance — dsh-notify handles turn-complete / approval / error notifications and click-to-session; the composer footer shows real-time "this turn cost · balance".

Engineering resilience

• Guardian waterfall — the kernel boot chain self-heals level by level: broken plugins auto-repair, corrupt configs rebuild, crash loops restart in place. No incompatible state ever exits the app.
• Crash self-healing — renderer freezes are detected by heartbeat and reloaded; the supervisor probes the kernel and relaunches with backoff.
• History compatibility — the session event vocabulary is patched automatically, so third-party plugin events never break history.
• Your data stays — over-the-top upgrades keep the profile and sessions; plugin toggles only edit the patch, never user data.

📸 App Preview

Vanilla dsh web vs DSH Desktop:

🚀 Get Started

Requirements: Windows 10 / 11 (x64); macOS 12+ (Apple Silicon / Intel). No Node.js needed.

Download and install

Get the latest 1.0.8 build from GitHub Releases:

• Upgrade in place: the installer finds the old directory, keeps your data and reinstalls to the same location; profiles, sessions and plugin settings are preserved.
• Portable build: Windows also ships DSH-Desktop-Portable-1.0.8-win-x64.zip; unzip and run, with data stored in a data\ folder next to the executable.
• First launch: the 34 curated plugins are synced from the bundled assets/plugins into the profile. Afterwards, inspect, toggle and update them under Settings → Plugins → Built-in plugins.
• Data locations: Windows installer %APPDATA%\DSH Desktop\, portable build data\ next to the executable; macOS ~/Library/Application Support/DSH Desktop/. Set DSH_HOME to override the dsh config directory.

Since v1.0.0 the project no longer mirrors code or release assets to Gitee; older Gitee releases remain as an archive only.

💬 Community

Questions, feedback, or just want to chat with other users? Join our QQ group (926561802):

🛠 Build from Source

Prerequisites: Rust toolchain and npm install in dsh-desktop/ (the kernel payload source).

# Tests (current baseline: Rust 607 / sidecar 21 / Node 2253)
cd dsh-tauri
cargo test --workspace
node --test sidecar/cli.test.js
cd ../dsh-desktop && npm test

# Dev run
cd dsh-tauri/src-tauri/src/app && cargo run

# Package the win-x64 NSIS installer + installed-layout smoke test
bash dsh-tauri/scripts/stage-payload.sh
cd dsh-tauri && npx --yes @tauri-apps/cli build \
  --config src-tauri/src/app/tauri.conf.json --target x86_64-pc-windows-msvc
bash dsh-tauri/scripts/smoke-installed.sh

The full flow (including DSH_TAURI_DIAG / DSH_TAURI_DEVTOOLS) is in the development guide.

🤖 Releases

The only release entry point is pushing a v* tag → tauri-release.yml: three-platform builds (Windows NSIS / portable, Linux AppImage / deb, macOS dmg) → version / test / path gates → seven verified assets → GitHub Release. The version is kept in sync in three places (dsh-desktop/package.json, Cargo.toml workspace.package.version, tauri.conf.json); a mismatch fails fast.

Prereleases do not enter GitHub releases/latest, which is what the shell updater polls — so prereleases are never auto-pushed to stable users by design. See the release runbook for promotion and rollback.

📦 Installer formats

🧩 Bundled Plugin Ecosystem

34 companion plugins are registered in total. Under the v1.0.0 bundled line (user decision, 2026-10-08) their sources ship inside the installer: the delivery gate mirrors assets/plugins as a whole, and the first boot syncs it into the profile, so everything below works out of the box (on 2026-10-22 the side session side-session was removed and DeepSeek-Bot (bot) was added, keeping the roster at 34; see §4 of THIRD_PARTY_NOTICES.md for the delivery gates and the full third-party list). The table below follows the registration order of scripts/lib/companion-plugins.js; package names and versions are read from each plugin's package.json. The "Source / license" column only reports what each package says about itself — per-plugin upstream reachability and licence text are audited in the inventory §3, and the 0.2.1-rc.4 host compatibility verdicts in §5.

[!NOTE] Trimmed in v1.0.0: bundled plugins went from 39 down to 28 (the 11 were named for removal by a user on 2026-10-07). No longer bundled: the visual plugin marketplace (dsh-community-market) and its desktop service bridge (dsh-market-desktop-bridge), the plugin hub (dsh-hub), knowledge-graph memory (graph-memory), the knowledge centre (dsh-cardian), the desktop pet (harness-pet), built-in image understanding via a VLM restatement (dsh-vision), drag-in files (dsh-file-drop), paste-image-to-send (dsh-image-paste), the in-session terminal tab (@deepseek-ai/dsh-terminal-tab) and one-click file-change revert (@deepseek-ai/dsh-client-file-changes). The last two overlap the kernel's own official packages of the same/similar name, and their mirrored copies under profiles/web/node_modules shadow the official ones — hence the recall. Similar capabilities still ship: phone mirroring = dsh-pocket, file-change tracking = dsh-file-changes (only its revert half depended on the shell-side file_revert, which is also gone).

Earlier removals, also outside the 34 registered plugins: dsh-navbar (navbar replacement, dropped from the list and its sources deleted in v0.6.3-beta.3, commit ff421ac2), zat-dsh-engine (the previous built-in marketplace, retired even earlier) and dsh-reasoning-effort (reasoning-effort selector, retired 2026-10-17 with the 0.2.1 kernel generation — the official Settings page can now declare a custom model's effort levels itself).

🏗 Architecture

From v0.5.0 the app runs on the Tauri 2 (Rust) architecture — the Electron shell has been retired; its full set of responsibilities (windows / IPC / updates / packaging) is re-implemented crate by crate on the Rust side, contract-first (dsh-tauri/contracts/ — five hard contracts are the single source of truth for interfaces):

┌──────────────────────────────────────────────────────────┐
│  Tauri 2 shell (Rust · 7 one-way-dependency crates)      │
│  · supervisor: boot guardian waterfall → spawn kernel    │
│    → readiness swap → liveness probe → crash-loop        │
│      in-place restart (never a blank window)             │
│  · shell-core        paths / settings (self-heal) /      │
│                     single instance                      │
│  · kernel-process    spawn spec / ready line / Job       │
│                     Object tree-kill                     │
│  · bridge            Electron IPC 43 channels → Tauri    │
│                     commands, full mapping + shim JS     │
│                     (window.dshDesktop)                  │
│  · fence / preview-server / session-watcher /            │
│    sidecar-orchestrator (boot sequencing + Node sidecar  │
│    reusing dsh-desktop/scripts kernel logic, zero        │
│    rewrite)                                              │
└──────────────────────┬───────────────────────────────────┘
                       │  dsh web --host 127.0.0.1 --port <reused port>
                       ▼
            Bundled node + @deepseek-ai/dsh
            Path resolution: user overlay > bundled package
                       │  ready-line detection
                       ▼
            Native window loads Web UI (localhost only)

Layering rules: crates never depend on the tauri runtime and are independently unit-tested (177 Rust tests green; plus 16 sidecar Node tests across 71 shared-script unit files); the assembly root only wires things up; kernel-side Node logic lives in dsh-desktop/scripts/. See the development manual.

📄 License

MIT. Based on @deepseek-ai/dsh (MIT).

⭐ If DSH Desktop is helpful to you, consider starring the repo; for any issues or feedback, please open an issue.