DSH-Desktop-EAC — 揽尽万象

• 为什么选择 EAC
• 快速开始（安装）
• 功能一览
• 社区与支持
• 开发者文档
• 致谢
• Star 趋势
• 许可证

EAC 不修改官方 dsh 内核，完整保留插件架构和官方能力；默认共享 DSH_HOME 中的会话与 API Key，同时隔离桌面端插件环境。

• Windows 10/11（x64）
• macOS 13+（Apple Silicon / arm64，桌面版）
• 无需预装 Node.js 或任何其他运行时

当前发布线为 5.x（Tauri/Rust 壳）。5.2 起桌面版统一为 Tauri 壳；更早的 v4.4.1 Electron 版已退役（仅 Release 存档）。安装包直接从 Release 下载。

更多版本见 Releases 页面。

💡 升级说明（老用户必读）：

• 直接下载上方最新安装包覆盖安装即可；
• 插件、皮肤、会话与配置全部保留——数据在 %APPDATA%\DSH-Desktop-EAC\ 与 ~/.dsh，升级过程不触碰。

macOS 桌面版与 Windows/Linux 同源同版本，随 v5.1.0 Release 一同发布。

• 桌面配置目录：~/Library/Application Support/deepseek-harness-eac/；dsh 数据仍在 ~/.dsh（与 CLI 共享，会话互通）。
• 未签名、未公证（个人自用定位）：首次打开若被 Gatekeeper 拦截，右键 →「打开」。
• 客户端自更新在 macOS v1 暂不提供（上游 Release 暂无 macOS 资产）；dsh agent（内核）更新完整保留。

Linux 桌面端由 CI（Ubuntu 22.04）持续构建与验证，以独立版本线发布（最近维护版 v4.4.0）。Windows/macOS 走统一版本线（当前 v5.1.0），Linux 并入统一版本线待发布管线就绪后补发。

• 依赖：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。

QQ 交流群 3 群号：1083832019	微信交流群

遇到 Bug，或有希望我们增加的功能，请前往 https://eac.dtyg123.dpdns.org/。

完整的当前分支开发参考见 docs/DEVELOPMENT.md，包括 Tauri 三层架构、L2 模块边界、开发/测试/打包命令、运行时数据目录、桥接契约和排障清单。

cd dsh-desktop
npm install
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（杀软放大触发）——重跑即可。

cd dsh-desktop
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.mjs（pretest 含 tsc 全量类型检查）
node ../gui-smoke.js     # Tauri 壳 GUI 冒烟（18 项，需先 cargo build）
node ../update-smoke.js  # 自更新链路冒烟（mock 发布源 + 目录树交换）

┌──────────────────────────────────────────────────────────┐
│  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/                   # 恢复中心页、手机桥、单源 WS 客户端、图标、皮肤、配套插件
│   ├── skins/                # 10 款内置 Web UI 皮肤
│   ├── plugins/              # 桌面壳配套：dsh-balance / dsh-file-changes / dsh-terminal
│   │                         # / dsh-easy-setup / dsh-skin-switch
│   │                         # 内置社区插件：dsh-webui-market / dsh-tool-vision
│   │                         # / dsh-soul-md / dsh-web-mobile-fix
│   │                         # （含 vendor 与自包含运行时依赖，随仓库分发）
│   └── ws-jsonrpc-client.js  # 桌面窗 ↔ sidecar 的 WS JSON-RPC 客户端（单源）
├── scripts/                  # 构建与开发辅助脚本
├── vendor/                   # 内置 node.exe / npm CLI（不入库）
└── lib/                      # L2 业务服务层 / 恢复中心 / 扩展宿主（.ts 源，tsc 就地编译）
tauri-shell/                  # Tauri v2 壳：Rust（main.rs）+ sidecar（server/bridge/phone-bridge）
│                             # + stage-resources / make-portable 打包链
openclaw-dsh-bridge/          # 微信桥接插件（可选，研究性质）
research/                     # 第三方微信/桥接协议调研资料

感谢所有插件提供者对本项目与开源社区的奉献；由于插件数量众多，我们很抱歉，未能逐一统计到所有插件与其来源；如有插件的拥有者看到了自己所做的插件，欢迎您告知我们并添加到致谢名单中，也欢迎添加我们的交流群，以便一同交流、共同进步。

设置页内置 10 款 Web UI 皮肤，默认保持原生外观。启用任一皮肤时会自动禁用其他皮肤，也可一键恢复默认；皮肤的来源、作者和许可信息随安装包完整分发。

其中 9 款来自社区 dsh-web-ui（BSD-3-Clause），maid-atelier 来自 dsh-deep-whale 深海女仆工坊（CC BY-NC-SA 4.0，禁止商用）。

感谢每一位贡献者：

特别致谢 @CharlesAQ —— macOS 桌面移植（PR #234）：Tauri 壳 darwin 分支、平台适配层、darwin 资源装配与裁剪、.app/.dmg 打包配置，让 EAC 首次跑上 Apple Silicon。

MIT。基于 deepseek-ai/deepseek-harness（MIT）。内置皮肤版权归原作者所有（见上方皮肤许可表）。