zouyuxuan122/Deepseek-Harness-EAC · 上手攻略

仓库：zouyuxuan122/Deepseek-Harness-EAC
链接：https://github.com/zouyuxuan122/Deepseek-Harness-EAC
分类：ai · deepseek · desktop-app · agent-tools
作者：Jay
更新：2026-08-25

这是什么

Deepseek Harness EAC（EAC = Embracing All Creation，揽尽万象）是一个将官方 deepseek-ai/deepseek-harness（@deepseek-ai/dsh）封装为开箱即用桌面客户端的项目，内置完整 Node.js 运行时 + dsh CLI，提供 Windows/Linux 安装版、便携版和 Tauri 轻量版，以及 10 款内置皮肤、统一插件市场、文件树/diff/终端等开发工具链。

本质上是 DeepSeek Harness 的桌面化外壳，不修改官方内核，完整保留 dsh 的插件架构，同时提供原生桌面体验。

解决什么问题

官方 DeepSeek Harness 需要手动安装 Node.js、通过 CLI 启动，主要在终端或浏览器中使用。EAC 解决了：

零配置安装：双击即用，内置 Node.js，无需预装任何运行时
桌面原生体验：系统托盘、快捷方式、进程管理、任务通知
插件管理可视化：内置插件市场，一键安装/卸载/保护/回滚
界面定制：10 款内置皮肤，字体/字号/颜色自定义，移动端布局适配
开发工具集成：文件树、行级 diff、持久终端、HTML/本地端口预览
会话管理：临时对话、自动压缩、人设卡管理

快速安装

Windows（推荐）

从 Releases 页面下载：

类型	文件	大小
安装版	`Deepseek-Harness-EAC-Setup-v4.4.1-x64.exe`	~246 MB
便携版	`Deepseek-Harness-EAC-Portable-v4.4.1-x64.exe`	~212 MB
Lite 版（Tauri）	`Deep.Harness.EAC.v4Lite_4.5.0_x64-setup.exe`	~73 MB

下载后双击运行，显示启动动画后自动加载 DeepSeek Harness Web UI。

⚠️ Lite 版与正式版相互独立、可并存，数据目录为 ~/.dsh-v4lite。

Linux

支持 Arch / Ubuntu / Debian / Fedora，另有通用 AppImage：

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

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

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

# 通用 AppImage
chmod +x Deepseek-Harness-EAC-4.4.0-x86_64.AppImage
./Deepseek-Harness-EAC-4.4.0-x86_64.AppImage

卸载：pacman -Rns dsh-desktop / apt remove dsh-desktop / dnf remove dsh-desktop

升级

直接下载最新安装包覆盖安装即可，插件、皮肤、会话、配置全部保留（位于 %APPDATA%\Deepseek Harness EAC\ 和 ~/.dsh）。

核心用法

首次启动

双击运行，显示启动动画
自动加载 DeepSeek Harness Web UI（原生窗口，仅本机回环访问）
若未配置 API Key →「设置」→ 配置 DeepSeek API Key
开始使用，与命令行 dsh 完全一致

主要功能入口

设置 → 皮肤切换（10 款内置）
设置 → API Key / 模型选择
设置 → MCP 可视化配置
设置 → 插件市场
对话区 → 文件标签页（文件树/diff/终端）

数据目录

桌面客户端配置：%APPDATA%\Deepseek Harness EAC\（设置/更新缓存）
dsh 数据：~/.dsh（DSH_HOME，会话与 API Key 与 CLI 共享）
强制指定配置目录：启动前设置环境变量 DSH_HOME

CLI 共存

桌面端使用独立 web-desktop profile，与 CLI 共享 DSH_HOME 中的会话和 API Key，插件环境相互隔离。

架构说明

L1 Rust 壳 (tauri-shell/src/main.rs)
  ├── 单实例锁 / 主窗+浮窗 / 托盘 / 退出策略
  ├── 壳层 WS 本地拦截（win.* / menu / 日志）
  └── 壳页 HTTP 路由（/loading /exit /died /update /about /wizard）
         ↓ stdio JSON-RPC
L2 Node sidecar (tauri-shell/sidecar/server.ts)
  └── 桥方法（chrome.init / balance / plugins / rescue / client-update …）
         ↓ spawn vendor/node + dsh web --port 0
L3 dsh 内核（@deepseek-ai/dsh，零改动）

插件体系

EAC 通过 dsh-unified-market 聚合多个插件源，支持搜索和一键安装/卸载。内置核心插件包括：

插件	功能
`dsh-auto-compact`	上下文接近上限时自动执行 /compact
`@deepseek-ai/dsh-balance`	DeepSeek 余额查询
`@deepseek-ai/dsh-file-changes`	会话文件更改追踪与还原
`@deepseek-ai/dsh-terminal`	会话内交互式命令行
`@deepseek-ai/dsh-skin-switch`	皮肤切换
`dsh-plugin-guard`	插件快照/回滚/体检/守护
`@deepseek-ai/dsh-openclaw-bridge`	微信 ClawBot / OpenClaw 桥接
`dsh-soul-md`	soul.md 人设卡注入 + 热重载
`@dsh-external/dsh-side-session`	临时会话（不污染主会话）
`picturereader`	统一图片理解（视觉模型）

⚠️ 插件由社区贡献，质量参差，首次安装建议配合 dsh-plugin-guard 的快照功能。

典型适用场景

DeepSeek 重度用户：不想折腾 Node.js 环境，直接下载双击使用
多工具用户：需要同时管理多个 dsh 会话、人设卡和插件
开发者：需要文件树、diff、终端等开发工具集成
皮肤定制党：10 款内置皮肤 + 移动端布局优化
微信/Discord 集成：通过桥接插件接入消息平台

坑与注意

⚠️ 内置 Node.js：EAC 自带 Node.js 运行时，与系统已有的 Node.js 相互独立，不需要卸载系统 Node.js。

⚠️ 仅本机访问：Web UI 仅本机回环访问（127.0.0.1），不暴露到局域网。

⚠️ Electron vs Tauri：当前正式版（v4.4.1）使用 Electron 壳，Lite 版使用 Tauri（Tauri 版更轻量，但与正式版独立）。

⚠️ Linux 打包由社区贡献：@Luoye-hb 贡献，打包版本为 v4.4.0（略落后于 Windows v4.4.1）。

⚠️ NSIS 打包偶发错误：Linux 打包偶发 makensis mmap error（杀软触发），重跑即可。

⚠️ 插件可靠性：插件通过市场分发，质量不一，dsh-plugin-guard 的快照/回滚功能是保护伞，首次安装新插件建议先体检。

与同类对比

特性	DeepSeek Harness EAC	官方 dsh CLI	CherryStudio	AnythingLLM
安装体验	双击即用（内置 Node）	需装 Node.js	独立安装	独立安装
桌面原生	✅ 原生窗口+托盘	❌ 浏览器	✅	✅
皮肤定制	✅ 10 款内置	❌	✅	❌
插件市场	✅ 统一市场	CLI 安装	✅	✅
微信/消息桥接	✅	❌	❌	❌
CLI 共存	✅ 插件隔离	—	❌	❌
Tauri 轻量版	✅ Lite (~73MB)	❌	❌	❌

一句话结论

DeepSeek Harness EAC 是官方 dsh 的最佳桌面化体验——双击即用、内置 Node.js、10 款皮肤、统一插件市场 + 保护机制，非常适合不想折腾 CLI 环境的 DeepSeek 用户；Electron 壳略重（有 Lite Tauri 版可选），插件生态依赖社区贡献质量参差，整体成熟度在桌面 AI 工具中属中上水平。