DSH-Desktop-EAC

目录

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

为什么选择 EAC

EAC 不修改官方 dsh 内核，完整保留插件架构和官方能力；默认共享 DSH_HOME 中的会话与 API Key，同时隔离桌面端插件环境。

快速开始

系统要求

• Windows 10/11（x64）
• macOS 13+（Apple Silicon / arm64，桌面版）
• 无需预装 Node.js 或任何其他运行时

Windows

当前发布线为 5.x（Tauri/Rust 壳）。5.2 起桌面版统一为 Tauri 壳；更早的 v4.4.1 Electron 版已退役（仅 Release 存档）。安装包直接从 Release 下载。

更多版本见 Releases 页面。

💡 升级说明（老用户必读）：

• 直接下载上方最新安装包覆盖安装即可；
• 插件、皮肤、会话与配置全部保留——数据在 %APPDATA%\Deepseek Harness EAC\ 与 ~/.dsh，升级过程不触碰。

macOS（Apple Silicon / arm64）

macOS 桌面版与 Windows/Linux 同源同版本，随 v5.1.0 Release 一同发布。

• 桌面配置目录：~/Library/Application Support/deepseek-harness-eac/；dsh 数据仍在 ~/.dsh（与 CLI 共享，会话互通）。
• 未签名、未公证（个人自用定位）：首次打开若被 Gatekeeper 拦截，右键 →「打开」。
• 客户端自更新在 macOS v1 暂不提供（上游 Release 暂无 macOS 资产）；dsh agent（内核）更新完整保留。

Linux（x64）

Linux 桌面端由 CI（Ubuntu 22.04）持续构建与验证，以独立版本线发布（最近维护版 v4.4.0）。Windows/macOS 走统一版本线（当前 v5.1.0），Linux 并入统一版本线待发布管线就绪后补发。

• 依赖：Tauri 2 + webkit2gtk-4.1（debian 系安装 libwebkit2gtk-4.1-dev 等构建依赖见仓库 CI）；AppImage 自带运行时，构建基线 Ubuntu 22.04。
• 桌面配置目录：~/.config/deepseek-harness-eac（XDG）；dsh 数据仍在 ~/.dsh（与 CLI 共享）。
• 剪贴板等系统集成依赖桌面环境的 wl-copy/xclip/xsel，通知依赖 notify-send；缺失时对应能力自动降级为「外部依赖」，不伪装成功。

首次使用

1. 双击运行，显示启动动画，随后自动加载 DeepSeek Harness Web UI（原生窗口，仅本机回环访问）。
2. 如尚未配置 API Key，在界面「设置」内完成配置即可开始使用（与命令行 dsh 完全一致）。
3. 常用入口：设置 → 皮肤（10 款内置皮肤切换）/ 插件市场 / 模型一键选择；对话区 → 终端 / 文件标签页。

数据目录

桌面端配置在 %APPDATA%\Deepseek Harness EAC\（设置/更新缓存），dsh 数据 在 ~/.dsh（DSH_HOME，会话与 API Key 与 CLI 共享）。安装版与便携版一致。 想强制指定 DSH 配置目录？启动前设置环境变量 DSH_HOME 即可（与 dsh CLI 行为一致）。

升级方式

• 客户端本体：启动后自动检查上游新版本（GitHub Releases 双源回退），经你同意后下载安装； 便携版下载整包后自动「目录树交换」并重启，安装版引导新 Setup 静默覆盖。 失败自动保留当前版本。
• 官方 agent（dsh）：自动检测 @deepseek-ai/dsh 新版本，同意后安装到数据目录 overlay，原子切换，新版启动失败可一键回退内置版本。
• 也可直接下载上方最新安装包覆盖安装，数据不会丢失。

功能一览

开箱即用与桌面体验

• 内置运行环境：完整打包 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/。

开发者文档

完整的当前分支开发参考见 docs/DEVELOPMENT.md，包括 Tauri 三层架构、L2 模块边界、开发/测试/打包命令、运行时数据目录、桥接契约和排障清单。

从源码构建（Tauri 壳，v5.0 默认）

cd dsh-desktop
npm install
npm run fetch-runtime            # 内置 node.exe + npm CLI
node tauri-shell/stage-resources.mjs   # 装配打包资源（sidecar + dsh-desktop 运行树）
cd tauri-shell
npx -y @tauri-apps/cli@2 build   # release 构建 + NSIS 安装包
node make-portable.mjs           # 便携 zip（可选）→ target/release/portable/

# 开发态（热迭代）：cargo run（Rust 工具链需 RUSTUP_HOME/CARGO_HOME）

Rust 工具链：rustup + MSVC；NSIS 打包由 Tauri 自动下载（%LOCALAPPDATA%\tauri\NSIS）。 偶发 makensis mmap error（杀软放大触发）——重跑即可。

cd dsh-desktop
npm install
npm run fetch-runtime
# 打包（Tauri 三段链，产出入 tauri-shell/target/release/）
node ../tauri-shell/stage-resources.mjs     # 装配 staged-resources
cd ../tauri-shell
npx -y @tauri-apps/cli@2 build              # → bundle/nsis/*-setup.exe（含 sidecar 运行树）
node make-portable.mjs                      # → portable/*-portable.zip + SHA256SUMS.txt

运行测试：

cd dsh-desktop
npm test                 # node --test test/*.test.mjs（pretest 含 tsc 全量类型检查）
node ../gui-smoke.js     # Tauri 壳 GUI 冒烟（18 项，需先 cargo build）
node ../update-smoke.js  # 自更新链路冒烟（mock 发布源 + 目录树交换）

架构（v5.0：三层壳边界，ADR 0002）

┌──────────────────────────────────────────────────────────┐
│  L1 Rust 壳 (tauri-shell/src/main.rs)                    │
│  · 单实例锁 / 主窗+浮窗 / 托盘 / 退出策略                  │
│  · 壳层 WS 方法本地拦截（win.* / menu 壳动作 / 日志）       │
│  · 壳页 HTTP 路由（/loading /exit /died /update /about /wizard）│
│  · spawn sidecar（stdio JSON-RPC）+ WS 中继 127.0.0.1:19873│
└──────────────┬───────────────────────────────────────────┘
               │  stdio JSON-RPC（L1 ↔ L2）
               ▼
┌──────────────────────────────────────────────────────────┐
│  L2 Node sidecar (tauri-shell/sidecar/server.ts)          │
│  · 挂载 lib/desktop/* 全部模块 + boot-server 服务编排      │
│  · 桥方法面（chrome.init / balance / plugins / rescue /    │
│    client-update / onboard.* / menu.action …）             │
└──────────────┬───────────────────────────────────────────┘
               │  spawn vendor/node + dsh web --port 0
               ▼
       L3 dsh 内核（@deepseek-ai/dsh，零改动）
       输出 "dsh web: http://127.0.0.1:<port>"
               │  webUrl 经通知回传 L1
               ▼
       主窗导航真实 Web UI（仅本机回环访问）

目录结构

dsh-desktop/