> ### 📦 v5.4 起:唯一的桌面发行版,安装时选「完整版 / 精简版」
>
> 同一个安装包、同一套 5.x 内核:**完整版**带全部内置插件;**精简版**只默认停用外围插件(桌宠 / 手机桥 / 多智能体等),设置里可随时一键启用,无需重装。
> 原 **Lite(Electron 精简版)退役**、**AIO 整合版收编为精简版形态**、**EAC-IDE 进入维护模式**——数据统一 `~/.dsh`。迁移说明见 [docs/SINGLE-EDITION-MIGRATION.md](dsh-desktop/docs/SINGLE-EDITION-MIGRATION.md)。
---
> ### 🚀 官方配套启动器:DSH EAC Launcher
>
> **多实例隔离 · 本地实例导入 · 版本一键升级/回退 · 插件安全体系**(崩溃守卫 crash-guard · 插件快照回滚 · 隔离区 · 健康体检)
>
> 为本项目的多实例与插件玩法而生:每个实例独立程序目录与 `DSH_HOME`,从上游 Release 一键安装任意版本,装插件崩了也能一键回滚。
>
> 👉 **[zouyuxuan122/DSH-EAC-Launcher](https://github.com/zouyuxuan122/DSH-EAC-Launcher)** | [⬇ 下载最新版 v1.1.0](https://github.com/zouyuxuan122/DSH-EAC-Launcher/releases/latest)
## 目录
- [为什么选择 EAC](#为什么选择-eac)
- [快速开始(安装)](#快速开始)
- [功能一览](#功能一览)
- [社区与支持](#社区与支持)
- [开发者文档](#开发者文档)
- [致谢](#致谢)
- [Star 趋势](#star-趋势)
- [许可证](#许可证)
---
## 为什么选择 EAC
| 维度 | 官方 DeepSeek Harness 默认体验 | DSH-Desktop-EAC 增强 |
| --- | --- | --- |
| 安装与启动 | 需自行准备 Node.js,并通过 CLI 启动 | 内置 Node.js、npm CLI 和 dsh,提供安装版与便携版,双击即用 |
| 桌面体验 | 主要在终端或浏览器中使用 | 原生桌面窗口、系统托盘、快捷方式维护、进程清理和任务通知 |
| CLI 共存 | CLI 与 Web 通常使用同一插件环境 | 桌面端使用独立 `web-desktop` profile,与 CLI 共享会话和 API Key,插件互不干扰 |
| 插件可靠性 | 主要通过包管理器安装并手动排查问题 | 安装和启动前自动快照,异常时支持体检、修复、重试、回滚和事故报告 |
| 界面定制 | 默认使用官方界面 | 内置 10 款皮肤,支持字体、字号、颜色和移动端布局调整 |
| 项目工具 | 依赖外部编辑器和终端 | 内置文件树、行级 diff、一键还原、持久终端及 HTML/本地端口预览 |
| 上下文与人设 | 手动执行 `/compact`、编辑人设文件 | 自动压缩、人设卡管理和 `soul.md` 热重载 |
| 模型与 MCP | 主要通过配置文件或 CLI 管理 | 可视化配置视觉模型和 MCP,并支持从 Claude Code、Codex 导入配置 |
| 插件生态 | 通过 CLI 或包管理器安装插件 | 内置插件市场,可搜索并一键安装、卸载和管理插件 |
| 会话效率 | 以常规会话流程为主 | 支持临时对话、对话节点导航和第三方模型思考强度调整 |
| 消息接入 | 默认不包含 EAC 消息桥接 | 支持一键接入微信 ClawBot / OpenClaw |
| 更新维护 | 通过包管理器或手动方式更新 | dsh agent 与桌面客户端分别自动检查更新,失败时保留或回退原版本 |
> EAC 不修改官方 dsh 内核,完整保留插件架构和官方能力;默认共享
> `DSH_HOME` 中的会话与 API Key,同时隔离桌面端插件环境。
---
## 快速开始
### 系统要求
- Windows 10/11(x64)
- macOS 13+(Apple Silicon / arm64,桌面版)
- 无需预装 Node.js 或任何其他运行时
### Windows
> 当前发布线为 5.x(Tauri/Rust 壳)。5.2 起桌面版统一为 Tauri 壳;更早的 v4.4.1 Electron 版已退役(仅 Release 存档)。安装包直接从 Release 下载。
| 文件 | 说明 | 大小 |
| --- | --- | --- |
| [安装版 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 壳安装版(NSIS),安装到系统并创建快捷方式;SHA256 校验文件随 [Release](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/tag/v5.3.6) 提供 | ~191 MB |
| [便携版(v5.3.6)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/v5.3.6/Deepseek-Harness-EAC-5.3.6-portable.zip) | 免安装压缩包,解压到任意目录即可运行;数据跟随程序目录,可直接迁移 | ~228 MB |
更多版本见 [Releases 页面](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases)。
### AIO 版(Windows x64 · All-in-One)
> **DSHEAC AIO** 是独立于 5.x 主线的 **All-in-One 精致个人终端**:一个安装包备齐 dsh 内核、插件市场与完整桌面体验,开箱即用;与正式版相互隔离(独立 app data 与 `dsh-home`,默认不读取 5.x / v4Lite / 旧 EAC 或 CLI 数据),可并存安装。当前版本 **AIO v1.2.0**(源码分支 `aio-v1`,随 [aio-v1.2.0 Release](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/tag/aio-v1.2.0) 一同发布)。
| 文件 | 说明 | 大小 |
| --- | --- | --- |
| [AIO 安装版(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 安装版,安装到系统并创建快捷方式;EXE 为 `DSHEAC AIO.exe`,与正式版更新器互相隔离 | ~313 MB |
| [AIO 便携版(v1.2.0)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/aio-v1.2.0/DSHEAC-AIO-v1.2.0-Portable-x64.zip) | 免安装解压即用,数据写入 EXE 同级 `.dsh-aio-data`,可直接迁移 | ~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) | AIO 资产 SHA-256 校验 | — |
- 安装包尚未 Authenticode 签名,SmartScreen 可能提示未知发布者;运行前请先核对 SHA-256。
- 客户端自更新不在 AIO 中提供,插件自动更新默认关闭;安装路径建议不超过 120 个字符。
- **v1.2.0 要点**:内核对齐官方桌面端 `0.1.3-alpha.2`,插件接口随内核迁移修复,应用图标更换为 WhaleGirl,并移除已确认停用的插件与皮肤。
- **AIO 升级说明**:从旧版 AIO 覆盖安装时,仅继承旧版的会话与供应商配置,不继承旧版插件(内置插件随安装包更新)。
> 💡 **升级说明(老用户必读)**:
> - 直接下载上方最新安装包覆盖安装即可;
> - 插件、皮肤、会话与配置全部保留——数据在 `%APPDATA%\DSH-Desktop-EAC\`
> 与 `~/.dsh`,升级过程不触碰。
### macOS(Apple Silicon / arm64)
> macOS 桌面版与 Windows/Linux 同源同版本,随 [v5.1.0 Release](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/tag/v5.1.0) 一同发布。
| 文件 | 说明 | 大小 |
| --- | --- | --- |
| [安装镜像 .dmg](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v5.1.0/Deepseek.Harness.EAC_5.1.0_macos-arm64.dmg) | 双击挂载后拖入 Applications | ~136 MB |
| [应用包 .app.zip](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v5.1.0/Deepseek.Harness.EAC_5.1.0_macos-arm64.app.zip) | 解压后直接运行 | ~157 MB |
| [校验和 SHA256SUMS-macos.txt](https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/download/v5.1.0/SHA256SUMS-macos.txt) | macOS 资产 SHA256 | — |
- 桌面配置目录:`~/Library/Application Support/deepseek-harness-eac/`;dsh 数据仍在 `~/.dsh`(与 CLI 共享,会话互通)。
- 未签名、未公证(个人自用定位):首次打开若被 Gatekeeper 拦截,右键 →「打开」。
- 客户端自更新在 macOS v1 暂不提供(上游 Release 暂无 macOS 资产);dsh agent(内核)更新完整保留。
### Linux(x64)
> Linux 桌面端由 CI(Ubuntu 22.04)持续构建与验证;自 v5.3.6 起 AppImage 与 .deb 已并入统一版本线(当前 v5.3.6),.rpm/.pacman 仍由独立版本线提供(最近维护版 v4.4.0)。
| 文件 | 说明 |
| --- | --- |
| [.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) | 安装后可从应用菜单启动 |
| [AppImage(v5.3.6)](https://github.com/zouyuxuan122/DSH-Desktop-EAC/releases/download/v5.3.6/Deepseek.Harness.EAC_5.3.6_amd64.AppImage) | 免安装:`chmod +x` 后直接运行 |
| [.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) | — |
- 依赖:Tauri 2 + webkit2gtk-4.1(debian 系安装 `libwebkit2gtk-4.1-dev` 等构建依赖见仓库 CI);AppImage 自带运行时,构建基线 Ubuntu 22.04。
- 桌面配置目录:`~/.config/deepseek-harness-eac`(XDG);dsh 数据仍在 `~/.dsh`(与 CLI 共享)。
- 剪贴板等系统集成依赖桌面环境的 `wl-copy`/`xclip`/`xsel`,通知依赖 `notify-send`;缺失时对应能力自动降级为「外部依赖」,不伪装成功。
### 首次使用
1. 双击运行,显示启动动画,随后自动加载 DeepSeek Harness Web UI(原生窗口,仅本机回环访问)。
2. 如尚未配置 API Key,在界面「设置」内完成配置即可开始使用(与命令行 dsh 完全一致)。
3. 常用入口:设置 → 皮肤(10 款内置皮肤切换)/ 插件市场 / 模型一键选择;对话区 → 终端 / 文件标签页。
### 数据目录
> 桌面端配置在 `%APPDATA%\DSH-Desktop-EAC\`(设置/更新缓存),dsh 数据
> 在 `~/.dsh`(`DSH_HOME`,会话与 API Key 与 CLI 共享)。安装版与便携版一致。
> 想强制指定 DSH 配置目录?启动前设置环境变量 `DSH_HOME` 即可(与 dsh CLI 行为一致)。
### 升级方式
- **客户端本体**:启动后自动检查上游新版本(GitHub Releases 双源回退),经你同意后下载安装;
便携版下载整包后自动「目录树交换」并重启,安装版引导新 Setup 静默覆盖。
失败自动保留当前版本。
- **官方 agent(dsh)**:自动检测 `@deepseek-ai/dsh` 新版本,同意后安装到数据目录 overlay,原子切换,新版启动失败可一键回退内置版本。
- 也可直接下载上方最新安装包覆盖安装,数据不会丢失。
---
## 功能一览
### 开箱即用与桌面体验
- **内置运行环境**:完整打包 Node.js、npm CLI、`@deepseek-ai/dsh` 及官方插件,无需额外安装运行时。
- **安装版与便携版**:双击启动并自动选择可用端口;便携版数据跟随程序目录,可直接迁移。
- **桌面集成**:提供原生窗口、系统托盘、快捷方式维护、进程清理和任务完成通知。
- **CLI 共存**:共享 `DSH_HOME` 中的会话与 API Key,桌面端使用独立 `web-desktop` profile,插件互不干扰。
- **自动更新**:分别更新 dsh agent 与桌面客户端,安装失败时保留或回退原版本。
### 开发工作流
- **文件树与预览**:浏览项目文件,并在应用内预览 HTML 和本地端口服务。
- **改动追踪与还原**:查看会话产生的文件变更和行级 diff,支持逐个或全部还原。
- **会话内终端**:在项目目录中使用持久 PowerShell,支持流式输出、命令历史和断线重连。
- **对话导航**:快速跳转到各条用户消息。
- **临时对话**:在独立悬浮窗中基于当前上下文追问,不污染主会话。
### 对话与模型
- **自动压缩**:上下文接近上限时自动执行 `/compact`,阈值可调,失败静默重试。
- **人设管理**:内置 6 张人设卡,支持保存、应用、删除、实时编辑和 `soul.md` 热重载。
- **图片理解**:通过 `picturereader` 分析本地或在线图片,并将结果直接带回对话。
- **MCP 与快速配置**:可视化管理 MCP,并可从 Claude Code、Codex 迁移 skills、MCP 和记忆。
- **第三方模型控制**:支持调整第三方模型的思考强度。
- **DeepSeek 余额**:显示本轮费用和账户余额,支持跳转充值及自动刷新。
### 插件与可靠性
- **统一插件市场**:通过 `dsh-unified-market` 聚合多个插件源,支持搜索、一键安装和卸载。
- **插件保护中心**:由 `dsh-plugin-shield` 配合内置 `plugin-guard` 引擎提供快照、体检、修复、重试、回滚和事故报告。
- **稳定性自愈**:自动处理 profile 模块遮蔽、插件启动异常和服务重启文件锁问题。
- **完整依赖分发**:内置插件及其自包含依赖随安装包分发,减少环境差异造成的故障。
### 界面与集成
- **界面定制**:内置 10 款社区皮肤,支持互斥切换、恢复原生外观以及字体、字号和颜色设置。
- **移动端适配**:优化窄屏下的设置面板、弹窗、侧栏和会话布局。
- **微信 ClawBot**:通过内置桥接插件一键接入微信 ClawBot / OpenClaw。
---
## 社区与支持
### 交流群