目录
为什么选择 EAC
维度 官方 DeepSeek Harness 默认体验 Deepseek Harness 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）
-
Linux x86_64（Arch / Ubuntu / Debian / Fedora，或任意支持 AppImage 的发行版）
-
无需预装 Node.js 或任何其他运行时
Windows
GitHub 无单文件大小限制，可直接下载完整安装包。
文件 说明 大小
便携版 exe 免安装，双击即用，可放 U 盘 ~226 MB
安装版 exe 安装到系统，创建桌面/开始菜单快捷方式 ~241 MB
更多版本见 Releases 页面。
⚠️ 务必安装/放置到纯英文路径（默认 C:\Users\<你>\AppData\Local\Programs\ 即可）：中文路径（如 D:\迅雷下载\）会触发 Chromium 渲染进程原生崩溃，窗口弹出数十秒后自动退出。
Linux（x64）
Linux 打包由社区开发者 @Luoye-hb 贡献（PR #12），随 v4.4.0-linux 发布，支持 Arch / Ubuntu / Debian / Fedora 与通用 AppImage：
发行版 包 安装
Arch Linux
.pacman
sudo pacman -U ./Deepseek-Harness-EAC-4.4.0-x64.pacman
Ubuntu / Debian
.deb
sudo apt install ./Deepseek-Harness-EAC-4.4.0-amd64.deb
Fedora
.rpm
sudo dnf install ./Deepseek-Harness-EAC-4.4.0.x86_64.rpm
通用
.AppImage
chmod +x 后直接运行
-
卸载：
pacman -Rns dsh-desktop/apt remove dsh-desktop/dnf remove dsh-desktop -
与 Windows 版一致：内置 Node.js 与 npm CLI，目标机器无需预装 Node.js；数据目录沿用
~/.dsh（DSH_HOME） -
Linux 版由系统包管理器管理升级，不走应用内自更新；安装到仓库根
linux分支源码可自行构建
首次使用
-
双击运行，显示启动动画，随后自动加载 DeepSeek Harness Web UI（原生窗口，仅本机回环访问）。
-
如尚未配置 API Key，在界面「设置」内完成配置即可开始使用（与命令行 dsh 完全一致）。
-
常用入口：设置 → 皮肤（10 款内置皮肤切换）/ 插件市场 / 模型一键选择；对话区 → 终端 / 文件标签页。
数据目录
便携版数据目录在 exe 旁的 data\；安装版在 %APPDATA%\Deepseek Harness EAC\。
想强制指定 DSH 配置目录？启动前设置环境变量 DSH_HOME 即可（与 dsh CLI 行为一致）。
升级方式
-
客户端本体：启动后自动检查上游新版本（GitHub Releases 双源回退），经你同意后下载安装；便携版原地替换自动重启，安装版引导新安装包。失败自动保留当前版本。
-
官方 agent（dsh）：自动检测
@deepseek-ai/dsh新版本，同意后安装到数据目录 overlay，原子切换，新版启动失败可一键回退内置版本。 -
也可直接下载上方最新安装包覆盖安装，数据不会丢失；v2.0 起安装器在卸载旧版前自动结束运行中的新旧进程，覆盖安装不再报 "Failed to uninstall old application files"。
功能一览
开箱即用与桌面体验
-
内置运行环境：完整打包 Node.js、npm CLI、
@deepseek-ai/dsh及官方插件，无需额外安装运行时。 -
安装版与便携版：双击启动并自动选择可用端口；便携版数据跟随程序目录，可直接迁移。
-
桌面集成：提供原生窗口、系统托盘、快捷方式维护、进程清理和任务完成通知。
-
CLI 共存：共享
DSH_HOME中的会话与 API Key，桌面端使用独立web-desktopprofile，插件互不干扰。 -
自动更新：分别更新 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。
社区与支持
交流群
Bug 与功能反馈
遇到 Bug，或有希望我们增加的功能，请前往 https://eac.dtyg123.dpdns.org/。
开发者文档
从源码构建
cd dsh-desktop
npm install
npm run fetch-runtime # 内置 node.exe + npm CLI
npm run dist # 构建 portable + NSIS 安装包 → dist/
网络受限时：Electron 镜像 $env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'；打包工具链镜像 $env:ELECTRON_BUILDER_BINARIES_MIRROR='https://npmmirror.com/mirrors/electron-builder-binaries/'。
运行测试：
npm test # node --test test/*.test.mjs
架构
┌──────────────────────────────────────────────────────────┐
│ Electron 壳 (main.js) │
│ · 单实例锁 / 窗口 / 菜单 / 生命周期 │
│ · 会话完成监听 (session-watcher.js) → 系统通知 │
│ · 官方更新 (updater.js) → 用户同意后安装 overlay │
│ · 客户端自更新 (client-updater.js) → 下载/替换/重启 │
│ · spawn vendor|resources 里的 node.exe │
└──────────────┬───────────────────────────────────────────┘
│ dsh web --host 127.0.0.1 --port 0
▼
内置 node.exe + @deepseek-ai/dsh
路径解析：用户目录 overlay > 内置包
输出 "dsh web: http://127.0.0.1:<port>"
│ 解析 URL，轮询 HTTP 200
▼
原生窗口加载 Web UI（仅本机回环访问）
目录结构
dsh-desktop/ # Electron 桌面端
├── main.js # Electron 主进程
├── updater.js # 官方 dsh agent 更新引擎
├── client-updater.js # 客户端本体自更新引擎
├── balance.js # DeepSeek 余额查询
├── session-watcher.js # 会话完成监听
├── plugin-guard.js # 插件保护中心引擎（快照/回滚/体检/修复/守护启动/事故报告）
├── profile-module-heal.js # profile 模块遮蔽自愈（真实目录 + pnpm 链接）
├── preload.js # 沙箱预加载
├── assets/ # 加载页、更新进度页、图标、皮肤、配套插件
│ ├── 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 与自包含运行时依赖，随仓库分发）
├── scripts/ # 构建与开发辅助脚本
├── build/icon.png # electron-builder 图标
├── vendor/ # 内置 node.exe / npm CLI（不入库）
├── electron-builder.yml # 打包配置
└── dist/ # 构建产物（不入库，发布到 Releases）
openclaw-dsh-bridge/ # 微信桥接插件（可选，研究性质）
research/ # 第三方微信/桥接协议调研资料
致谢
插件致谢
插件名 插件说明
dsh-auto-compact 自动压缩：接近上下文上限时自动发送 /compact
@deepseek-ai/dsh-balance 账户余额、费用估算与价格设置
dsh-better-sidebar（提供者：omdsh-dev） VSCode 风格右侧栏，支持资源管理器/编辑器/终端/Git/浏览器
dsh-change-review AI 变更审核：自动复查文件改动
@deepseek-ai/dsh-client-file-changes 文件视图：会话文件更改追踪与一键还原
dsh-compact 请求路径上下文压缩与溢出恢复
@deepseek-ai/dsh-conversation-tweaks 隐藏长篇输出 + 会话右侧导航滑轨
dsh-dafeiyu（提供者：QCYTSN） 大肥鱼桌面伴侣
ds