Deepseek-Harness-EAC

---

目录

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

---

为什么选择 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 分支源码可自行构建

首次使用

1. 双击运行，显示启动动画，随后自动加载 DeepSeek Harness Web UI（原生窗口，仅本机回环访问）。
2. 如尚未配置 API Key，在界面「设置」内完成配置即可开始使用（与命令行 dsh 完全一致）。
3. 常用入口：设置 → 皮肤（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-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。

---

社区与支持

交流群

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）	大肥鱼桌面伴侣
dsh-deep-whale（提供者：Small-tailqwq）	深海女仆工坊 maid-atelier 皮肤来源
dsh-dock-settings	Skills 与 MCP 设置管理
@deepseek-ai/dsh-easy-setup	快速配置：视觉模型、soul.md、迁移
@deepseek-ai/dsh-file-changes	会话文件更改投影
dsh-file-drop-eac	拖放文件/文件夹到对话
@deepseek-ai/dsh-float-window	会话弹出独立窗口
dsh-font-custom	字体与文字/代码颜色自定义
dsh-image-paste	剪贴板图片粘贴发送
dsh-message-rewind	消息改写并从此处重新生成
@vlln/dsh-navbar（提供者：vlln）	对话节点导航条：user 消息快速跳转
dsh-offpeak（提供者：christophersmith2737-commits）	DeepSeek 峰谷价格拦截提醒
@deepseek-ai/dsh-openclaw-bridge	微信 ClawBot / OpenClaw 桥接
dsh-pet（提供者：PC2005-cloud）	页面悬浮桌宠
dsh-pet-settings	桌宠设置分区
dsh-plugin-guard（提供者：lxzy-7）	插件安装前快照、回滚与启动守护
dsh-plugin-healthcheck（提供者：chenw2759-wq）	插件静态体检与风险检查
@deepseek-ai/dsh-plugin-manager	插件管理：列出/启停内置插件
dsh-plugin-shield	插件保护：快照/回滚/体检
dsh-plugin-wizard	插件选择向导
@deepseek-ai/dsh-prompt-custom	自定义内核提示词
dsh-session-manager	会话删除与归档管理
dsh-settings-groups	设置页高级选项折叠
dsh-settings-nav-custom	设置页左侧边栏自定义
@dsh-external/dsh-side-session（提供者：dsh-external）	临时会话：不污染主会话的独立追问
@deepseek-ai/dsh-skin-switch	内置皮肤切换
dsh-soul-md（提供者：Scorp1o117）	soul.md 人设卡注入
@deepseek-ai/dsh-terminal	会话内交互式命令行
@deepseek-ai/dsh-third-party-thinking	第三方模型思考强度控件
dsh-tool-vision（提供者：Scorp1o117）	OpenAI 兼容视觉模型图片分析
dsh-undo-savepoint	配置快照与撤销/回滚
dsh-unified-market	统一插件市场：聚合三源
dsh-web-plugin-manager（提供者：LX2000WASD）	插件安装守卫与健康检查入口
dsh-web-mobile-fix（提供者：AcidGr）	移动端布局修复
dsh-web-ui（提供者：zhu1090093659）	9 款内置 Web UI 皮肤来源
dsh-webui-market（提供者：Sanqi-normal）	社区插件目录与一键安装/卸载
picturereader	统一图片理解插件
computer-user	读屏 + 鼠标键盘自动化（Codex-style computer use；配 picturereader，纯文本模型可用）

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

皮肤来源与许可

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

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

皮肤	出处	许可
xp（Windows XP 风格）	dsh-web-ui	BSD-3-Clause
qq98（QQ 经典 98 风格）	同上	BSD-3-Clause
ths（同花顺风格）	同上	BSD-3-Clause
blue-fantasy（蓝幻）	同上	BSD-3-Clause
dragon-heir（龙裔）	同上	BSD-3-Clause
minecraft（我的世界）	同上	BSD-3-Clause
trading（交易风格）	同上	BSD-3-Clause
whale-song（鲸歌）	同上	BSD-3-Clause
miku（初音未来）	同上	BSD-3-Clause
maid-atelier（深海女仆工坊）	dsh-deep-whale	CC BY-NC-SA 4.0（禁止商用）

贡献者

感谢每一位贡献者：

---

Star 趋势

---

许可证

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