相比原版 DeepSeek Harness 的优势

内核零改动：EAC 直接运行官方 dsh web，完整保留「一切皆插件」架构与全部官方能力，
与 CLI 共享 DSH_HOME 配置，已有会话/API Key 直接生效。

下载安装（部署方式）

GitHub Releases（推荐）

GitHub 无单文件大小限制，可直接下载完整安装包。

更多版本见 Releases 页面。

首次使用：

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

便携版数据目录在 exe 旁的 data\；安装版在 %APPDATA%\Deepseek Harness EAC v2.0\。
想强制指定 DSH 配置目录？启动前设置环境变量 DSH_HOME 即可（与 dsh CLI 行为一致）。

升级部署

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

功能一览

界面皮肤自定义（EAC 特色）

• 设置页「皮肤」标签页内置 10 款 Web UI 皮肤，卡片式网格展示（名称/简介/主色/作者/出处与许可角标）。
• 9 款来自社区 dsh-web-ui（BSD-3-Clause）+ 1 款 dsh-deep-whale 深海女仆工坊（CC BY-NC-SA 4.0，禁止商用）。
• 默认不启用任何皮肤（原生外观）；选中某款后其余自动禁用（互斥切换），「恢复默认皮肤」一键还原；切换后自动重启 Web 服务生效。
• 皮肤是 browser-only 的 dsh client 插件，由桌面端同步进 web profile 并幂等注册到 cordis.patch.yml，完整版权署名随包分发。

开箱即用

• 免装 Node：内置独立 Node 运行时与 npm CLI，目标机器无需安装 Node.js
• 内置 dsh CLI：完整打包 @deepseek-ai/dsh 及全部官方插件，离线可用
• 一键启动：双击即启动 dsh web，自动挑空闲端口，就绪后加载到原生窗口
• 与 CLI 共享配置：默认沿用 DSH_HOME（通常 ~\.dsh），已有会话/API Key 直接生效
• 便携版：数据跟随 exe 所在目录，拷到 U 盘就能用

桌面体验

• 风格化无边框窗口 + 系统托盘：无原生标题栏/菜单栏，自绘玻璃栏（圆角图标、⋯ 菜单、窗口控制），Win11 圆角；关闭默认隐藏到托盘
• 退出即清理：退出应用自动结束 dsh 进程树，不留孤儿进程
• 快捷方式自动维护：便携版自动创建/修复桌面与开始菜单快捷方式（exe 移动后自愈）
• 会话完成通知：agent 任务跑完时弹 Windows 系统通知，点击回到窗口

效率工具（配套插件体系）

• DeepSeek 余额小部件：对话底部统计栏显示「本轮 ¥X · 余额 ¥Y」，点击跳转充值，15 分钟自动刷新
• 文件更改追踪 + 一键还原：「文件」标签页查看本会话全部文件改动（新建/修改/删除 + 行级 diff）并逐文件/全部还原；数据只读复用会话日志，稳定不受升级影响
• 会话内终端：「终端」标签页在当前会话项目目录启动持久 PowerShell（SSE 流式、命令历史、断线重连），中文编码干净
• 项目文件树 + HTML/端口预览：VSCode 风格文件树，站内预览 HTML/本地端口服务（仅回环）
• 社区插件市场（v2 新增，dsh-webui-market）：设置 → 插件 → 市场，浏览 awesome-dsh-plugin.com 收录的 dsh 插件并一键安装/卸载到 profile；安装/卸载任务在服务重启窗口期排队执行，不打断当前会话
• 外置视觉模型（v2 新增，dsh-tool-vision）：inspect_image 工具把本地图片或图片 URL 发给任意 OpenAI 兼容视觉端点（qwen-vl / GLM-4V / Ollama 等），看图回答直接带回对话
• 长期记忆（v2 新增，dsh-tdai-memory）：腾讯云 Agent Memory 移植 —— L0 对话捕获 → L1 结构化记忆 → L2 场景 / L3 画像，自动召回注入 + 记忆/对话搜索工具，复用现有 ~/.memory-tencentdb/memory-tdai 数据
• soul.md 人设热重载（v2 新增，dsh-soul-md）：markdown 人设文件注入系统提示词（soul:persona），文件变更即时热重载，Agent 边干活边角色扮演
• 移动端布局修复（v2 新增，dsh-web-mobile-fix）：窄屏（≤400px）下设置面板、弹窗、侧栏、会话头布局修复，纯前端 CSS，不影响桌面布局
• 快速配置（dsh-easy-setup）：视觉模型提供商/模型一键选择、soul.md 人设可视化编辑、从 Codex / Claude Code 目录一键迁移 skills + MCP + 记忆
• 双重自动更新：官方 dsh agent 更新（npm overlay）+ 客户端封装自更新，均经用户同意，失败自动回退
• 稳定性自愈：profile-module-heal 自动修复 profile 模块遮蔽问题（如 prompt section already registered、模型列表/模式切换失效）；重启服务时等待旧进程完全退出（释放文件锁）再启动新服务，插件包（含自带 vendor 依赖）随安装包原样分发

系统要求

• Windows 10/11（x64）
• 无需预装 Node.js 或任何其他运行时

从源码构建

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        # 会话完成监听
├── profile-module-heal.js    # profile 模块遮蔽自愈
├── preload.js                # 沙箱预加载
├── assets/                   # 加载页、更新进度页、图标、皮肤、配套插件
│   ├── skins/                # 10 款内置 Web UI 皮肤
│   └── plugins/              # dsh-balance / dsh-file-changes / dsh-terminal
│                             # / dsh-easy-setup / dsh-skin-switch / dsh-plugin-marketplace …
├── scripts/                  # 构建与开发辅助脚本
├── build/icon.png            # electron-builder 图标
├── vendor/                   # 内置 node.exe / npm CLI（不入库）
├── electron-builder.yml      # 打包配置
└── dist/                     # 构建产物（不入库，发布到 Releases）
openclaw-dsh-bridge/          # 微信桥接插件（可选，研究性质）
research/                     # 第三方微信/桥接协议调研资料

License

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