把 DeepSeek Harness 装进 Windows 桌面(EAC-Desktop)
EAC-Desktop 是 DeepSeek Harness 的桌面客户端,随包内置 Node.js、npm 与 dsh 运行资源,免去命令行环境搭建。这篇文章讲清它的三层架构、预装插件清单、各平台版本差异,以及用户实际踩过的更新失败、插件无法关闭等坑,帮 Windows 用户判断它是否值得替换现有的 dsh 命令行用法。
DeepSeek Harness 是 DeepSeek 官方的 Agent 运行框架,日常以命令行与本地 Web UI 的形态出现。想用它,先得有 Node.js、npm 和一套能跑起来的 dsh 环境,这一步把不少不写代码的人挡在门外。EAC 做的事情是把这套运行环境连同依赖一起塞进安装包,你下载下来双击就行。
EAC-Desktop 是 DeepSeek Harness 的 Windows 桌面客户端,随包内置 Node.js、npm 与 dsh 运行资源,双击安装后配置模型即可开始对话与执行工具。
输入是一个安装包加一份模型提供商的配置,输出是一个带原生窗口、托盘与单实例控制的桌面工作台。你在里面发起任务、查看会话产生的文件变更、按需安装社区插件。典型的用法是把它当作日常写代码和跑 Agent 任务的主入口,不用再开终端敲命令。仓库地址在 https://github.com/DSH-EAC/EAC-Desktop ,采用 MIT 许可证,主要语言是 TypeScript,另有约 11% 的 Rust 代码负责原生外壳,仓库体积约 260 MB。

它不做什么
模型不由它提供。README 写明模型调用由配置的提供商完成,V6.0.1 新集成的 Our Free Model 提供免登录、免注册、免 API Key 的通道,其余模型都需要你自己填配置。
DPX 收容默认路径与环境变量,但不提供文件系统沙箱隔离。进程对显式绝对路径的访问仍由操作系统权限控制,这不是一个把 Agent 关在笼子里的方案。
宿主目录 ~/.dsh 只做检测与提示,不自动迁移、删除或覆盖。你原有的命令行环境不会被它接管。
各平台的版本并不同步。README 的下载表显示 Windows 最新稳定版为 v6.0.0,Linux 停在 v5.3.6,macOS arm64 停在 v5.1.0。macOS 用户拿到的是落后两个大版本的产物。
用之前先准备好什么
普通使用只需要一台 Windows x64 机器和一个模型提供商的配置。安装包已经把 Node.js 和 dsh 运行资源带上了,无需另行安装。
要从源码构建才需要完整工具链:Git、Node.js 24、pnpm 11.7.0 与 Rust stable。Windows 侧要装对应 Rust 目标的 C++ 构建工具,Linux 侧要装 Tauri 与 WebKitGTK 依赖。构建过程需要联网拉取依赖,内核依赖走本地 vendor/kernel 工件,得先获取固定内核再装依赖。
下载文件建议做校验,README 给的写法是在 PowerShell 里执行:
Get-FileHash -LiteralPath '<下载文件路径>' -Algorithm SHA256
主要功能
- 随包运行环境:内置 DeepSeek Harness
0.2.0-rc.2、Node.js 和 npm,启动本地 Web UI,普通使用无需单独安装 Node.js。 - 会话文件变更视图:配套插件
dsh-file-changes与dsh-client-file-changes提供会话文件变更投影、变更视图与还原入口,改动可以逐项检查后回退。 - 上下文压缩:
dsh-compact在请求路径上做上下文压缩与有界溢出恢复,为长对话腾出上下文空间。 - 快速配置入口:
dsh-easy-setup集中管理视觉模型、人设与相关设置,按任务需求组织工具能力。 - 插件市场:
dsh-unified-market提供聚合目录与安装管理,插件按 builtin / recommended / external 三级分发。 - 插件保护:
dsh-plugin-shield提供快照、体检与回滚入口,插件装崩了可以退回上一步。 - 免费模型:V6.0.1 把 Our Free Model 作为新增预装插件纳入 full 预置层与 Pack 套件,随 full 版新增预装并默认启用。
- 外观可换:用户 Web UI 皮肤通过市场按需安装,未激活皮肤时使用宿主原生外观,皮肤与宿主之间有明确的资源契约。
另有 dsh-eac-locale-compat 负责配套及社区插件的英文界面兼容,dsh-viewport-lock 与 dsh-settings-scroll-fix 修视口约束和设置面板滚动问题。
安装与最短示例
README 给出的最短路径是去 Releases 页面下载 Windows x64 的安装包。v6.0.0 提供 Full Setup 与 Lite Setup 两个版本,也提供 Windows 安装版与便携版的选择。装好之后配置模型和 API Key,就能在主窗口里发起对话。
从这个仓库自己构建,README 的顺序是先取固定内核再装依赖:
git clone --recurse-submodules https://github.com/says693/Deepseek-Harness-EAC.git
cd Deepseek-Harness-EAC
git submodule update --init --recursive
node tauri-shell/check-dpx-pin.mjs
npm install --global [email protected]
cd dsh-desktop
node scripts/fetch-kernel.js
npm run ci:install
npm run typecheck
npm run build
npm run fetch-runtime
npm test
cd ..
装配与打包在仓库根目录执行,Windows 的写法是 node tauri-shell/stage-resources.mjs --target=win32 --skip-npm,再用 node dsh-desktop/scripts/verify-staged-runtime.mjs 校验,最后进 tauri-shell 目录跑 cargo fetch --locked 与 Tauri 的 build 命令。
关键参数
数据根的位置由环境配置决定,Windows 默认产品数据根是 %LOCALAPPDATA%\Deepseek Harness EAC,其他平台按系统数据目录推导。
桌面 profile 固定为 web-desktop,环境按 eac-<channel> 命名。同一通道复用同一个环境,不同通道分开存储,这是隔离发布通道的方式。环境目录结构如下:
<产品数据根>/
└── dpx/dsh-environments/eac-<channel>/
├── .dpx-environment.json # 环境身份
├── dsh-home/ # profile、会话、skills 与配置
├── home/ # 环境内用户目录
├── appdata/ # 应用数据
├── localappdata/ # 本地应用数据
├── tmp/ # 临时文件
└── workspace/ # 环境工作目录
便携包描述的是程序分发方式,数据位置仍由环境配置决定。备份时先退出应用,再保存实际的产品数据根与单独的项目目录。
插件来源与分发关系记录在 .sync/plugin-distribution.json 与 dsh-desktop/assets/SOURCES.json 两个文件里,想查某个组件归属哪个来源可以看这两处。资源装配由 tauri-shell/stage-resources.mjs 负责,界面资源通过 tauri-shell/skin-manager-artifact.lock.json 锁定工件并在装配时校验 SHA-256。
结果在哪里看
运行时的结果主要看应用主窗口。会话、工具执行和文件变更都由 Harness 内核承担,在 Web UI 里呈现,桌面操作通过桥接层交给宿主。Rust 与 Node 之间用 stdio JSON-RPC 通信,协议输出与诊断日志分开存放。
落盘的内容分几处:dsh-home/ 放 profile、会话、skills 与配置,workspace/ 是环境工作目录,日志与临时文件分别进 tmp/ 和各 appdata 目录。环境初始化失败会中止启动并记录错误,不会在错误的数据根里继续跑。
构建侧的验证结果看命令输出:在 dsh-desktop 目录执行 npm run typecheck、npm test,插件账本用 node scripts/plugin-ledger.mjs,同步校验用 node scripts/plugin-sync.mjs validate。
实际使用中的坑
仓库的 Issue 区留下了不少真实故障记录,挑几条典型的:
- 版本更新反复失败:有用户反馈每次出新版本都更新不成功,这条 Issue 有 14 条评论,是评论数最多的一条。目前状态已解决。
- Win10 便携版双击没反应:便携版双击后界面不出现,但在任务管理器里能看到进程。8 条评论,已解决。
- 插件下载成功后不在列表里显示:插件下载完成但插件列表里找不到,也开不了。5 条评论,已解决。
- 已装视觉模型却被告知不支持图片:用户装完视觉模型,使用 deepseek 模型时仍然提示该模型不支持图片输入。5 条评论,已解决。
另有用户反馈设置项过多、默认挂载的插件达到 42 条并默认启用,与之前手动装的插件功能重叠。这条也被标记为已解决。
横向对照
| 项目 | 适合谁 | 部署方式 | 主要限制 | 什么情况下选它更合适 | 项目地址 |
|---|---|---|---|---|---|
| EAC-Desktop | 想要开箱即用的 Windows 用户,不想碰命令行环境 | Windows 安装版与便携版;Linux、macOS 有包但版本落后 | 平台版本不同步,macOS 停在 v5.1.0;预装插件较多;DPX 不做文件系统沙箱 | 你主要在 Windows 上工作,希望装完就有完整插件生态 | EAC-Desktop |
| myYangyunfan/dsh_desktop | 只要一个能跑 dsh CLI 的 Windows 壳的用户 | 捆绑 Node.js 与 dsh CLI 的 Windows 桌面客户端 | 仓库没有说明它在 Windows 之外的平台支持情况 | 你只需要跑通 dsh,不想要整套插件编排与皮肤生态 | myYangyunfan/dsh_desktop |
| chokwinlee/deepseek-harness-desktop | 需要从 iPhone 远程接入的场景 | 紧凑的桌面宿主,带一个原生 SwiftUI 的 iPhone Remote 源码 | 仓库没有说明它的插件预置规模与平台覆盖范围 | 你希望用手机远程访问,而桌面侧保持尽量精简 | chokwinlee/deepseek-harness-desktop |
三者解决的是同一件事,取舍落在体积和覆盖面上。EAC-Desktop 的预装内容明显更重,Issue 里有用户抱怨 42 条插件全挂载、略显臃肿,如果你只想跑通 dsh 而不需要插件市场和皮肤,myYangyunfan/dsh_desktop 这类捆绑 CLI 的薄壳更省事。macOS 用户要多想一步:EAC-Desktop 的 macOS 包停在 v5.1.0,比 Windows 落后两个大版本,更新节奏跟不上,这种情况下其他仍在维护 macOS 的同类项目值得先看一眼。
适合谁用
Windows 用户、不想折腾 Node.js 环境、希望装完就能对话并能顺手装插件的人,是这个项目的主要受众。它把运行环境、插件市场和插件回滚都预制好了,开箱成本低。
主要用 macOS 或 Linux 的人暂时不适合,两个平台的包分别停在 v5.1.0 与 v5.3.6。只需要一个最小 dsh 宿主、不想要预装插件的人也该去看更薄的方案。习惯命令行、对目录布局有自己一套规则的人,同样没必要为了图形界面去换工作方式。
焚评:这个项目的量化评分
本项目的选题来自 焚.com(一个按公开公式给 GitHub 项目打分的站)。焚评当前总分 9.2 分(满分 10)。下表是各维度的得分:
| 评分维度 | 得分 |
|---|---|
| 热度动量(权重 25%) | 10.0 / 10 |
| 开发活跃(权重 25%) | 8.1 / 10 |
| 社区响应(权重 15%) | 10.0 / 10 |
| 文档质量(权重 15%) | 8.0 / 10 |
| 发布节奏(权重 10%) | 10.0 / 10 |
| 风险控制(权重 10%) | 10.0 / 10 |
评分口径、权重与计算方式见焚.com 的评分方法页;数据随 GitHub 指标刷新,具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写,评分数据由焚.com 授权引用。
内容核验说明
桌面客户端把 Node.js、dsh 运行环境和一批插件一起装好,省掉命令行配置,这是它对 Windows 用户最实在的价值。文中版本号、插件清单与数据根路径来自仓库 README 与作者披露,诀.com 未独立验证;Issue 记录显示更新失败、便携版启动等问题确实出现过。适合在 Windows 上想绕开环境配置的人;
正文中的版本号、插件清单、数据根路径与构建命令均来自仓库 README 及作者公开披露,诀.com 未独立验证;Issue 故障记录为用户自行报告,文中评分数据由焚.com 授权引用,数值随其页面刷新,实际以焚.com 当前页面为准。用户反馈摘要
根据仓库 Issue 来看,反馈集中在更新与插件两块:有提交者反映每次出新版更新都不成功、更新提示新旧版本号相同却仍要求更新,也有人报告 Win10 便携版双击后无界面但进程存在、插件下载完成后不在列表显示、已装视觉模型仍提示不支持图片且白名单保存不上。另有报告称插件管理里组件无法关闭,预装 42 条插件默认全挂载偏臃肿。上述 Issue 状态均为已解决。
基于该仓库公开 Issue 整理,只反映提交者报告的现象与诉求,不代表诀.com 立场,也不代表问题已被确认。项目来源与说明
开源项目:DSH-EAC(DSH-EAC)
本文由诀.com 编辑基于该项目的公开信息独立撰写,属原创解读,不是对项目文档的翻译或转载;文中提到的功能与参数以官方仓库为准,代码与文档版权归原作者所有。
查看项目仓库