中文 | English
Deepseek Harness EAC — Embracing All Creation
EAC = Embracing All Creation (揽尽万象)
A ready-to-use Windows desktop client built around the official deepseek-ai/deepseek-harness (@deepseek-ai/dsh, the everything-is-a-plugin agent harness).
On top of the official foundation, EAC embraces community creations — skins, plugins, tools, memories, and more — all installable with one click.

---
## Table of Contents
- [Why EAC](#why-eac)
- [Quick Start](#quick-start)
- [Features](#features)
- [Community & Support](#community--support)
- [Developer Documentation](#developer-documentation)
- [Acknowledgements](#acknowledgements)
- [Star History](#star-history)
- [License](#license)
---
## Why EAC
| Area | Official DeepSeek Harness default experience | Deepseek Harness EAC enhancements |
| --- | --- | --- |
| Installation and launch | Requires a separately installed Node.js environment and CLI startup | Bundles Node.js, the npm CLI, and dsh; provides setup and portable builds that launch with a double-click |
| Desktop experience | Primarily used from a terminal or browser | Native desktop window, system tray, shortcut maintenance, process cleanup, and task notifications |
| CLI coexistence | CLI and Web normally use the same plugin environment | Uses a separate `web-desktop` profile while sharing sessions and API keys with the CLI, keeping plugins isolated |
| Plugin reliability | Plugins are generally installed through a package manager and troubleshot manually | Takes snapshots before installation and startup, with health checks, repair, retry, rollback, and incident reports |
| Interface customization | Uses the official interface by default | Includes 10 skins plus font, size, color, and mobile layout customization |
| Project tools | Relies on external editors and terminals | Includes a file tree, line-level diffs, one-click restore, persistent terminal, and HTML/local-port previews |
| Context and personas | `/compact` and persona files are managed manually | Supports automatic compaction, persona cards, and hot-reloading for `soul.md` |
| Models and MCP | Primarily managed through configuration files or the CLI | Provides visual configuration for vision models and MCP, plus imports from Claude Code and Codex |
| Plugin ecosystem | Plugins are installed through the CLI or package manager | Includes a plugin marketplace with search, one-click installation, removal, and management |
| Conversation efficiency | Uses the standard conversation workflow | Adds temporary side conversations, conversation-node navigation, and reasoning-effort controls for third-party models |
| Messaging integration | Does not include EAC messaging bridges by default | Connects to WeChat ClawBot / OpenClaw in one click |
| Updates and maintenance | Updated through a package manager or manually | Checks dsh agent and desktop-client updates separately, preserving or rolling back the previous version on failure |
> EAC does not modify the official dsh core, preserving its plugin architecture and official capabilities in full.
> It shares sessions and API keys from `DSH_HOME` by default while isolating the desktop plugin environment.
---
## Quick Start
### Requirements
- Windows 10/11 (x64)
- macOS 13+ (Apple Silicon / arm64; desktop edition)
- No pre-installed Node.js or other runtime required
### Windows
> The current release line is 5.x (Tauri/Rust shell). Since 5.2 the desktop builds share a unified Tauri shell; the earlier v4.4.1 Electron edition is retired (archived in Releases only). Download installers directly from Releases.
| File | Description | Size |
| --- | --- | --- |
| [Setup (v5.3.6)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/v5.3.6/Deepseek-Harness-EAC-5.3.6-Setup-x64.exe) | Tauri shell setup build (NSIS): installs to the system and creates shortcuts; SHA256 checksums are published with the [release](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/tag/v5.3.6) | ~191 MB |
| [Portable zip (v5.3.6)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/v5.3.6/Deepseek-Harness-EAC-5.3.6-portable.zip) | No installation required: unzip anywhere and run; portable data stays next to the program directory for easy migration | ~228 MB |
See the [Releases page](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases) for more versions.
### AIO Edition (Windows x64 · All-in-One)
> **DSHEAC AIO** is an **All-in-One polished personal terminal** maintained on a line separate from the 5.x mainline: a single package bundling the dsh kernel, the plugin marketplace, and the full desktop experience, ready out of the box. It is isolated from the main edition (separate app data and `dsh-home`; it never reads 5.x / v4Lite / legacy EAC or CLI data by default) and can be installed side by side. Current version: **AIO v1.2.0** (source branch `aio-v1`, published together with the [aio-v1.2.0 release](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/tag/aio-v1.2.0)).
| File | Description | Size |
| --- | --- | --- |
| [AIO setup (v1.2.0)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/aio-v1.2.0/DSHEAC-AIO-v1.2.0-Setup-x64.exe) | NSIS setup build that installs to the system and creates shortcuts; the executable is `DSHEAC AIO.exe`, fully isolated from the main edition's updater | ~313 MB |
| [AIO portable (v1.2.0)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/aio-v1.2.0/DSHEAC-AIO-v1.2.0-Portable-x64.zip) | No installation required: unzip and run; data is written to `.dsh-aio-data` next to the EXE and migrates with it | ~147 MB |
| [SHA256SUMS-AIO-v1.2.0.txt](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/aio-v1.2.0/SHA256SUMS-AIO-v1.2.0.txt) | SHA-256 checksums for the AIO assets | — |
- The AIO installer is not yet Authenticode-signed; SmartScreen may warn about an unknown publisher. Verify the SHA-256 checksum before running.
- Client self-update is not offered in the AIO edition and plugin auto-update is off by default; keep the installation path under 120 characters.
- **Highlights of v1.2.0**: kernel aligned with the official desktop `0.1.3-alpha.2`, plugin interfaces migrated to the new kernel APIs, app icon switched to WhaleGirl, and confirmed-retired plugins/skins removed.
- **AIO upgrade note**: when upgrading from an older AIO install, only sessions and provider settings are carried over; plugins from the old install are not inherited (built-in plugins ship with the package).
> 💡 **Upgrading**: just download and run the newest installer above over your existing install.
> Plugins, skins, sessions and settings are preserved: data lives in
> `%APPDATA%\Deepseek Harness EAC\` and `~/.dsh`, untouched by the upgrade.
### macOS (Apple Silicon / arm64)
> The macOS desktop build shares the same version and codebase as Windows/Linux and is published under the same [v5.1.0 Release](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/tag/v5.1.0).
| File | Description | Size |
| --- | --- | --- |
| [Disk image .dmg](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v5.1.0/Deepseek.Harness.EAC_5.1.0_macos-arm64.dmg) | Mount and drag into Applications | ~136 MB |
| [App bundle .app.zip](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v5.1.0/Deepseek.Harness.EAC_5.1.0_macos-arm64.app.zip) | Unzip and run directly | ~157 MB |
| [SHA256SUMS-macos.txt](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v5.1.0/SHA256SUMS-macos.txt) | macOS asset checksums | — |
- Desktop config directory: `~/Library/Application Support/deepseek-harness-eac/`; dsh data stays in `~/.dsh` (shared with the CLI).
- Unsigned and not notarized (personal use): if Gatekeeper blocks the first launch, right-click → Open.
- Client self-update is disabled in the macOS v1 build (no macOS assets upstream yet); dsh agent (kernel) updates are fully retained.
### Linux (x64)
> The Linux desktop build is continuously built and verified by our CI (Ubuntu 22.04). Since v5.3.6, the AppImage and .deb assets ship on the unified release line (currently v5.3.6); .rpm/.pacman remain on the separate line (latest maintained release: v4.4.0).
| File | Description |
| --- | --- |
| [.deb (Debian/Ubuntu, v5.3.6)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/v5.3.6/Deepseek.Harness.EAC_5.3.6_amd64.deb) | Installs and launches from the app menu |
| [AppImage (v5.3.6)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/v5.3.6/Deepseek.Harness.EAC_5.3.6_amd64.AppImage) | No installation: `chmod +x` and run |
| [.rpm (Fedora/openSUSE)](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v4.4.0-linux/Deepseek-Harness-EAC-4.4.0.x86_64.rpm) | — |
| [.pacman (Arch)](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v4.4.0-linux/Deepseek-Harness-EAC-4.4.0-x64.pacman) | — |
- Dependencies: Tauri 2 with webkit2gtk-4.1 (Debian-family build deps such as `libwebkit2gtk-4.1-dev` mirror the repo CI); the AppImage bundles its own runtime, built against an Ubuntu 22.04 baseline.
- Desktop config directory: `~/.config/deepseek-harness-eac` (XDG); dsh data stays in `~/.dsh` (shared with the CLI).
- System integration (clipboard via `wl-copy`/`xclip`/`xsel`, notifications via `notify-send`) depends on your desktop environment; when missing, the capability honestly degrades to "external-dependency" rather than pretending to work.
### First Run
1. Launch the app. After the startup animation, the DeepSeek Harness Web UI loads automatically in a native window and is accessible only through the local loopback interface.
2. If you have not configured an API key, open Settings and complete the setup before starting. The configuration is identical to the dsh CLI.
3. Common entry points: Settings → Skins (10 built-in skins) / Plugin Marketplace / one-click model selection; conversation area → Terminal / Files tabs.
### Data Directories
> Portable data is stored in `data\` next to the exe; the setup build uses `%APPDATA%\Deepseek Harness EAC\`.
> To override the dsh configuration directory, set the `DSH_HOME` environment variable before launch, just as you would with the dsh CLI.
### Updating
- **Desktop client**: checks upstream releases automatically after launch, with fallback release sources. After your approval, it downloads and installs the update. The portable build replaces itself and restarts; the setup build opens the new installer. The current version is preserved if the update fails.
- **Official agent (dsh)**: detects new `@deepseek-ai/dsh` versions and, after approval, installs them into a data-directory overlay with an atomic switch. If the new version fails to start, you can roll back to the bundled version in one click.
- You can also download and run the latest package above without losing data. Since v2.0, the installer closes running old and new instances before uninstalling, preventing the "Failed to uninstall old application files" error during an in-place upgrade.
---
## Features
### Out-of-the-box Desktop Experience
- **Bundled runtime**: includes Node.js, the npm CLI, `@deepseek-ai/dsh`, and official plugins, with no additional runtime installation required.
- **Setup and portable builds**: launch with a double-click and automatically select a free port; portable data stays with the application directory for easy migration.
- **Desktop integration**: provides a native window, system tray, shortcut maintenance, process cleanup, and task-completion notifications.
- **CLI coexistence**: shares sessions and API keys from `DSH_HOME` while using a separate `web-desktop` profile so desktop and CLI plugins do not interfere with each other.
- **Automatic updates**: updates the dsh agent and desktop client separately, preserving or restoring the previous version if installation fails.
### Development Workflow
- **File tree and previews**: browse project files and preview HTML files or local-port services inside the app.
- **Change tracking and restore**: inspect session file changes and line-level diffs, then restore individual files or all changes at once.
- **In-session terminal**: use persistent PowerShell in the project directory with streaming output, command history, and automatic reconnection.
- **Conversation navigation**: jump quickly between user messages.
- **Temporary conversations**: ask follow-up questions from the current context in a separate floating window without affecting the main conversation.
### Conversations & Models
- **Automatic compaction**: runs `/compact` as the context approaches its limit, with a configurable threshold and silent retry on failure.
- **Persona management**: includes six persona cards with save, apply, delete, live editing, and `soul.md` hot-reload support.
- **Image understanding**: uses `picturereader` to analyze local or online images and return the result directly to the conversation.
- **MCP and quick setup**: visually manages MCP and imports skills, MCP configuration, and memory from Claude Code or Codex.
- **Third-party model controls**: adjusts reasoning effort for supported third-party models.
- **DeepSeek balance**: displays the current-turn cost and account balance, with top-up access and automatic refresh.
### Plugins & Reliability
- **Unified plugin marketplace**: `dsh-unified-market` aggregates multiple plugin sources with search, one-click installation, and removal.
- **Plugin Protection Center**: `dsh-plugin-shield`, together with the built-in `plugin-guard` engine, provides snapshots, health checks, repair, retry, rollback, and incident reports.
- **Self-healing reliability**: automatically handles profile-module shadowing, plugin startup failures, and file-lock issues during service restarts.
- **Complete dependency distribution**: bundled plugins and their self-contained dependencies ship with the installer, reducing environment-specific failures.
### Interface & Integrations
- **Interface customization**: includes 10 community skins with mutually exclusive switching, one-click restoration of the native look, and font, size, and color settings.
- **Mobile layout support**: improves settings panels, dialogs, sidebars, and conversations on narrow screens.
- **WeChat ClawBot**: connects to WeChat ClawBot / OpenClaw through the bundled bridge plugin in one click.
---
## Community & Support
### Community Groups