用 Deepseek-Harness-EAC 把 DeepSeek Harness 做成免装 Node 的桌面客户端

DeepSeek Harness 插件 DeepSeek DSH 桌面客户端 主题皮肤 Electron 2026-08-17 244 阅读

前言

DeepSeek Harness（简称 DSH，命令行入口是 dsh）把模型、工具、技能、会话和 UI 都做成插件，官方推荐的起步方式是先装 Node.js，再执行 npx @deepseek-ai/dsh web，用浏览器打开本机回环地址。这条路径对已经熟悉 Node 环境的人并不复杂，但对只想在 Windows 或 Linux 桌面上直接用 Web 界面的人，成本会叠在运行时安装、端口选择、浏览器标签页和插件管理上。

社区项目 Deepseek-Harness-EAC 把官方 @deepseek-ai/dsh 封进 Electron 桌面壳：内置独立 Node 运行时和 npm CLI，双击启动本地 dsh web，再把界面加载到原生窗口。EAC 是 Embracing All Creation 的缩写，仓库把它译成「揽尽万象」，指的是皮肤、插件、工具和记忆可以在客户端里一键安装，而不是改官方内核。它由 GitHub 用户 zouyuxuan122 维护，社区插件目录把它归在「主题与外观」分类。本文依据该目录详情页、仓库 README / package.json、GitHub Releases 以及官方 DeepSeek Harness 说明交叉核对后整理。

需要先分清两层关系。DeepSeek Harness 本身是 DeepSeek AI 开源的 Agent Harness，口号是「一切皆插件」。Deepseek-Harness-EAC 是社区封装的桌面客户端，不是官方应用；deepseek-harness-plugin.com 是独立的社区目录，和 DeepSeek / 幻方没有官方从属关系，收录不等于安全背书。

这是什么

Deepseek-Harness-EAC 是一个开源的 Windows / Linux 桌面客户端，仓库地址是 zouyuxuan122/Deepseek-Harness-EAC。截至 2026-08-17，GitHub API 显示该仓库约 564 星；社区目录页上的星标是 78，与 GitHub 一手数据不一致，下文以 GitHub 为准。dsh-desktop/package.json 声明许可证为 MIT，并依赖 @deepseek-ai/dsh@0.1.0-rc.6；仓库根目录没有单独的 LICENSE 文件，GitHub 元数据里也未自动识别到许可证，安装前仍应自行核对源码与第三方皮肤许可。

它要解决的问题可以概括成三件事：

  1. 目标机器不必预装 Node.js，也能跑官方 dsh web。
  2. 把浏览器标签页换成原生无边框窗口和系统托盘，关闭窗口默认不打断正在跑的任务。
  3. 在官方默认外观之外，内置 10 套 Web UI 皮肤，并附带插件市场、会话文件追踪、会话内终端等配套能力。

README 强调「内核零改动」：EAC 直接运行官方 dsh web，完整保留「一切皆插件」架构；默认沿用 DSH_HOME（通常是 ~/.dsh），已有会话和 API Key 可以直接生效。桌面端使用专属 web-desktop profile，插件树与原生 CLI 隔离，会话和密钥仍然共享。

核心功能

免装运行时与一键启动

官方起步命令是：

npx @deepseek-ai/dsh web

这要求本机已有 Node.js。EAC 把独立 Node 运行时、npm CLI 以及 @deepseek-ai/dsh（含官方插件）打进安装包，目标机器不需要再装运行时。启动流程按仓库架构图是：

  1. Electron 主进程做单实例锁、窗口和生命周期管理。
  2. 用内置 node.exe 执行 dsh web --host 127.0.0.1 --port 0，自动挑空闲端口。
  3. 解析输出里的 dsh web: http://127.0.0.1:<port>，轮询到 HTTP 200 后，把 Web UI 加载进原生窗口。
  4. 界面只走本机回环，不把服务暴露到局域网。

便携版数据目录在 exe 旁的 data\；安装版在 %APPDATA%\Deepseek Harness EAC\。若要指定 DSH 配置目录，启动前设置环境变量 DSH_HOME 即可，行为和 CLI 一致。

10 套内置皮肤

设置页「皮肤」标签以卡片网格展示 10 款 Web UI 皮肤，默认不启用任何一套，保持官方原生外观。选中某一款后其余自动禁用（互斥切换），「恢复默认皮肤」可还原；切换后会自动重启 Web 服务。皮肤是 browser-only 的 dsh client 插件，由桌面端同步进 web profile，并幂等写入 cordis.patch.yml。

9 款来自社区仓库 dsh-web-ui（BSD-3-Clause），1 款来自 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（禁止商用）

完整版权署名随包装分发。设置页还有「外观 · 字体与颜色」，可改界面/代码字体、字号以及文字与代码颜色，数据存在 localStorage。

桌面窗口与更新

窗口没有系统原生标题栏和菜单栏，而是自绘玻璃栏（圆角图标、菜单、窗口控制），Windows 11 下带圆角。关闭默认隐藏到托盘，agent 任务完成时会弹 Windows 系统通知，点击回到窗口。退出应用会结束整个 dsh 进程树，避免留下孤儿进程。

更新分两路，都要用户同意：

  • 客户端本体：启动后检查 GitHub Releases，便携版原地替换并重启，安装版引导新安装包；失败则保留当前版本。
  • 官方 agent：检测 @deepseek-ai/dsh 新版本后装到数据目录 overlay，原子切换；新版启动失败可回退到内置版本。

截至 2026-08-17，GitHub 上标记为 latest 的 Windows 发行版是 v3.0.1（2026-08-16 发布）。仓库 main 分支的 package.json 版本号是 4.0.0，与 latest Release 标签并不相同，下载安装包时应以 Releases 页面为准，不要把源码版本号当成已发布安装包版本。

配套效率能力

README 把下面这些写成桌面壳附带的配套插件，而不是改官方 dsh 源码：

  • 插件市场（dsh-webui-market）：设置 → 插件 → 市场，浏览 awesome-dsh-plugin.com 收录的插件并一键安装/卸载；任务在服务重启窗口期排队，不打断当前会话。
  • 插件保护中心：融合社区快照回滚、安装守卫和静态体检三类能力。安装与启动前自动快照（保留 10 份）；启动失败则体检 → 修复 → 重试 → 回滚到最后良好快照，并留下事故报告。设置页可手动快照、回滚、体检和修复。
  • 余额小部件：对话底部显示「本轮 ¥X · 余额 ¥Y」，点击跳转充值，约 15 分钟刷新一次。
  • 文件更改追踪：会话「文件」标签查看新建/修改/删除和行级 diff，支持逐文件或全部还原；数据只读复用会话日志。
  • 会话内终端：在当前会话项目目录启动持久 PowerShell，SSE 流式输出，带命令历史和断线重连。
  • 自动压缩：接近上下文上限（默认 80%，可调）时自动执行官方 /compact。
  • 人设卡：6 张内置预设、卡片库，以及 soul.md 热重载。
  • MCP / skills 迁移：可从 Claude Code / Codex 的配置目录导入 MCP，并一键迁移 skills、MCP 与记忆。
  • 外置视觉模型（dsh-tool-vision）：inspect_image 把本地图片或 URL 发给 OpenAI 兼容视觉端点。
  • 长期记忆（dsh-tdai-memory）：移植腾讯云 Agent Memory 的分层记忆，复用已有 ~/.memory-tencentdb/memory-tdai 数据。

以上条目均来自仓库 README 对当前源码树的说明。若你安装的是某个历史 Release，功能集合可能少于这份清单，以对应版本的说明为准。

安装与启用

社区目录给出的标准插件安装命令如下。在已经装好 DeepSeek Harness 的终端里运行：

dsh plugin add github:zouyuxuan122/Deepseek-Harness-EAC

如需可复现安装，按目录页说明固定 commit 哈希：

dsh plugin add github:zouyuxuan122/Deepseek-Harness-EAC#<commit>

把 <commit> 换成仓库里实际的提交哈希。插件以当前 dsh 进程的权限运行，安装时可能执行代码，装前应检查源码和许可证。

需要注意：这个仓库的主体是 Electron 桌面客户端（dsh-desktop/），不是一份只往现有 Web UI 打补丁的皮肤包。仓库 README 把 GitHub Releases 下载安装包 写成推荐部署方式。已经在用 npx @deepseek-ai/dsh web 的人，目录里的 dsh plugin add 适合对照社区收录信息；若目标是「双击出一个桌面窗口」，应按 README 下载客户端。

Windows：从 Releases 安装

系统要求：Windows 10/11（x64），无需预装 Node.js。latest 资源名如下（大小约 167 MB）：

文件 说明
Deepseek-Harness-EAC-Portable-x64.exe 免安装，双击即用，可放 U 盘
Deepseek-Harness-EAC-Setup-x64.exe 安装到系统，创建桌面和开始菜单快捷方式

直接下载入口：

  • 便携版：https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/latest/download/Deepseek-Harness-EAC-Portable-x64.exe
  • 安装版：https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/latest/download/Deepseek-Harness-EAC-Setup-x64.exe

路径必须是纯英文。README 写明：中文路径（例如 D:\迅雷下载\）会触发 Chromium 渲染进程原生崩溃，窗口弹出数十秒后自动退出。默认安装到 C:\Users\<用户名>\AppData\Local\Programs\ 即可。

v3.0.1 的 Release 说明还写了一次手动升级：若从 v3.0.0 / v2.0.x 点「立即重启」没有反应，需先完全退出（托盘右键退出），再到 %APPDATA%\Deepseek Harness EAC\updates\ 运行已下载的 Setup，或直接从 Releases 下载安装包。这是该版本要修的更新脚本 bug，装上 v3.0.1 之后才生效。

Linux：社区打包

中文 README 写明 Linux x86_64 打包由 @Luoye-hb 在 PR #12 贡献，随 v3.0.1-linux 发布，支持 Arch / Ubuntu / Debian / Fedora 以及通用 AppImage。包名示例：

# Arch
sudo pacman -U ./Deepseek-Harness-EAC-3.0.1-x64.pacman

# Ubuntu / Debian
sudo apt install ./Deepseek-Harness-EAC-3.0.1-amd64.deb

# Fedora
sudo dnf install ./Deepseek-Harness-EAC-3.0.1.x86_64.rpm

AppImage 需先 chmod +x 再运行。卸载命令分别是 pacman -Rns dsh-desktop、apt remove dsh-desktop、dnf remove dsh-desktop。Linux 版由系统包管理器升级，不走应用内自更新；数据目录仍是 ~/.dsh（DSH_HOME）。英文 README 仍只写 Windows，与中文 README、仓库 description（Windows / Linux）不一致，本文以中文 README 和 Releases 标签为准。仓库没有列出 macOS 安装包。

从源码构建

在已安装 Node.js 的开发机上：

cd dsh-desktop
npm install
npm run fetch-runtime    # 内置 node.exe + npm CLI
npm run dist             # 构建 portable + NSIS 安装包 → dist/

网络受限时可设置镜像：

$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）。

典型用法

按 README 的「首次使用」：

  1. 双击运行，先看到启动动画，随后自动加载 DeepSeek Harness Web UI（仅本机回环）。
  2. 若尚未配置 API Key，在界面「设置」里填写，方式和命令行 dsh 相同。
  3. 常用入口：设置 → 皮肤（10 款切换）/ 插件市场 / 模型一键选择；对话区 → 终端 / 文件标签页。

换皮肤时保持默认即可继续用官方外观；需要怀旧或主题化界面时，在皮肤页点选一张卡片，等 Web 服务重启。maid-atelier 是 CC BY-NC-SA 4.0，商用场景不要启用这一套。

已经在用官方 CLI 的人，只要 DSH_HOME 指向同一目录，桌面端可以读到已有密钥和会话。v3.1 起 README 把桌面端放到 web-desktop profile，避免和 npx dsh 抢同一套插件树；共享模块 junction 的归属由桌面端巡检修复。

从 Claude Code 或 Codex 迁过来时，可在设置页勾选导入 ~/.claude.json 与 ~/.codex/config.toml 里的 MCP 服务器，并迁移 skills 与记忆，而不必先手改 YAML。

适用场景与注意事项

比较适合：

  • 不想先装 Node.js，只想在 Windows 10/11 x64 或 Linux x86_64 上双击使用官方 Web UI 的人。
  • 需要托盘常驻、任务完成通知、便携目录或 U 盘携带的人。
  • 希望在官方外观和 10 套社区皮肤之间切换，并在客户端内浏览、安装社区插件的人。

不太适合：

  • 只要命令行 / TUI、不需要桌面窗口的人，直接用官方 dsh 即可。
  • 需要 macOS 安装包的人：当前 README 与 Releases 均未提供。
  • 把社区目录当成官方应用商店、或把 EAC 当成 DeepSeek 官方客户端的人。同类桌面封装还有其他社区项目，EAC 的差异主要在内置皮肤、插件市场和配套保护/效率插件，而不是「官方唯一桌面版」。

使用前建议核对这几条：

  • 权限与来源：无论走 dsh plugin add 还是运行 exe，代码都以当前用户权限执行。安装前阅读仓库源码、许可证和第三方皮肤许可。maid-atelier 禁止商用。
  • 路径：Windows 下不要放在中文或含非 ASCII 字符的目录。
  • 版本：以 GitHub Releases 的 tag 为准。latest Windows 包是 v3.0.1；Linux 另有 v3.0.1-linux；源码 package.json 的 4.0.0 不代表你下载到的安装包版本。
  • 与官方 CLI 共存：默认共享 DSH_HOME。若插件树出现异常，优先看桌面端的插件保护中心和 web-desktop profile 隔离说明，而不是同时改两套配置。
  • 社区目录：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-eac/ 只是收录页，不代表 DeepSeek 官方认证。

小结

Deepseek-Harness-EAC 把官方 DeepSeek Harness 的 dsh web 封进 Electron 窗口：免装 Node、托盘常驻、10 套可切换皮肤，并带插件市场和若干配套工具。它不修改官方内核，会话和 API Key 仍走 DSH_HOME。维护者是 zouyuxuan122，Linux 打包由 Luoye-hb 贡献。若要在现有 dsh 里按社区目录安装，使用：

dsh plugin add github:zouyuxuan122/Deepseek-Harness-EAC

若要桌面客户端，从 GitHub Releases 下载对应系统的安装包或便携版，并避开中文路径。

  • 社区目录：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-eac/
  • GitHub：https://github.com/zouyuxuan122/Deepseek-Harness-EAC
  • 官方 Harness：https://github.com/deepseek-ai/deepseek-harness

相关文章

快速从零部署一个DeepSeek-R1服务 2025-04-05 使用 dsh-anchored-standard 为 DeepSeek Harness 配置两阶段 Agent 预设 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 网页界面补成工作台 2026-08-17 用 modlens 给 DeepSeek Harness 的纯文本模型补上视觉 2026-08-17 用 dsh-TUI 给 DeepSeek Harness 补上全屏终端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜