📦 v5.4 起：唯一的桌面发行版，安装时选「完整版 / 精简版」
同一个安装包、同一套 5.x 内核：完整版带全部内置插件；精简版只默认停用外围插件（桌宠 / 手机桥 / 多智能体等），设置里可随时一键启用，无需重装。
原 Lite（Electron 精简版）退役、AIO 整合版收编为精简版形态、EAC-IDE 进入维护模式——数据统一 ~/.dsh。迁移说明见 docs/SINGLE-EDITION-MIGRATION.md。
🚀 官方配套启动器：DSH EAC Launcher
多实例隔离 · 本地实例导入 · 版本一键升级/回退 · 插件安全体系（崩溃守卫 crash-guard · 插件快照回滚 · 隔离区 · 健康体检）
为本项目的多实例与插件玩法而生：每个实例独立程序目录与 DSH_HOME，从上游 Release 一键安装任意版本，装插件崩了也能一键回滚。
👉 zouyuxuan122/DSH-EAC-Launcher ｜ ⬇ 下载最新版 v1.1.0
目录
为什么选择 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 下载。
更多版本见 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 一同发布）。
- 安装包尚未 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 一同发布。
- 桌面配置目录：
~/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）。
- 依赖：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；缺失时对应能力自动降级为「外部依赖」，不伪装成功。
首次使用
- 双击运行，显示启动动画，随后自动加载 DeepSeek Harness Web UI（原生窗口，仅本机回环访问）。
- 如尚未配置 API Key，在界面「设置」内完成配置即可开始使用（与命令行 dsh 完全一致）。
- 常用入口：设置 → 皮肤（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。
社区与支持
交流群
|
|
QQ 交流群 3
群号：1083832019 |
微信交流群 |
Bug 与功能反馈
遇到 Bug，或有希望我们增加的功能，请前往 https://eac.dtyg123.dpdns.org/。
开发者文档
从源码构建（Tauri 壳，v5.0 默认）
cd dsh-desktop
npm install -g [email protected] # 内核构建依赖（版本由上游 packageManager 钉定）
node scripts/fetch-kernel.js # 首次必须：自上游源码构建内核 tarball（vendor/ 不入库；网络受限环境需自行配置代理）
npm install # 内核 tarball 就位后依赖才能安装
npm run fetch-runtime # 内置 node.exe + npm CLI
node ../tauri-shell/stage-resources.mjs # 装配打包资源（sidecar + dsh-desktop 运行树）
cd ../tauri-shell
npx -y @tauri-apps/cli@2 build # release 构建 + NSIS 安装包
node make-portable.mjs # 便携 zip（可选）→ target/release/portable/
# 开发态（热迭代）：cargo run（Rust 工具链需 RUSTUP_HOME/CARGO_HOME）
Rust 工具链：rustup + MSVC；NSIS 打包由 Tauri 自动下载（%LOCALAPPDATA%\tauri\NSIS）。
偶发 makensis mmap error（杀软放大触发）——重跑即可。
打包链（Tauri 三段链，从源码出安装包/便携包）
cd dsh-desktop
npm install -g [email protected]
node scripts/fetch-kernel.js # 网络受限环境需自行配置代理
npm install
npm run fetch-runtime
# 打包（Tauri 三段链，产出入 tauri-shell/target/release/）
node ../tauri-shell/stage-resources.mjs # 装配 staged-resources
cd ../tauri-shell
npx -y @tauri-apps/cli@2 build # → bundle/nsis/*-setup.exe（含 sidecar 运行树）
node make-portable.mjs # → portable/*-portable.zip + SHA256SUMS.txt
运行测试：
cd dsh-desktop
npm test # node --test test/*.test.ts（pretest 含 tsc 全量类型检查）
node ../gui-smoke.js # Tauri 壳 GUI 冒烟（18 项，需先 cargo build）
node ../update-smoke.js # 自更新链路冒烟（mock 发布源 + 目录树交换）
架构（v5.0：三层壳边界，ADR 0002）
┌──────────────────────────────────────────────────────────┐
│ L1 Rust 壳 (tauri-shell/src/main.rs) │
│ · 单实例锁 / 主窗+浮窗 / 托盘 / 退出策略 │
│ · 壳层 WS 方法本地拦截（win.* / menu 壳动作 / 日志） │
│ · 壳页 HTTP 路由（/loading /exit /died /update /about /wizard）│
│ · spawn sidecar（stdio JSON-RPC）+ WS 中继 127.0.0.1:19873│
└──────────────┬───────────────────────────────────────────┘
│ stdio JSON-RPC（L1 ↔ L2）
▼
┌──────────────────────────────────────────────────────────┐
│ L2 Node sidecar (tauri-shell/sidecar/server.ts) │
│ · 挂载 lib/desktop/* 全部模块 + boot-server 服务编排 │
│ · 桥方法面（chrome.init / balance / plugins / rescue / │
│ client-update / onboard.* / menu.action …） │
└──────────────┬───────────────────────────────────────────┘
│ spawn vendor/node + dsh web --port 0
▼
L3 dsh 内核（@deepseek-ai/dsh，零改动）
输出 "dsh web: http://127.0.0.1:<port>"
│ webUrl 经通知回传 L1
▼
主窗导航真实 Web UI（仅本机回环访问）
目录结构
dsh-desktop/ # Node/TS 后端 + 数据面（Tauri 壳的后端运行时）
├── updater.js # 官方 dsh agent 更新引擎
├── client-updater.js # 客户端本体自更新引擎
├── balance.js # DeepSeek 余额查询
├── session-watcher.js # 会话完成监听
├── plugin-guard.js # 插件保护中心引擎（快照/回滚/体检/修复/守护启动/事故报告）
├── profile-module-heal.js # profile 模块遮蔽自愈（真实目录 + pnpm 链接）
├── assets/
EAC-Desktop 是 DeepSeek Harness（dsh）的原生桌面封装：它内置了捆绑 Node.js 的官方 CLI/智能体，并在此基础上添加了原生窗口、系统托盘、插件市场、皮肤、记忆/角色卡等社区扩展。