桌面客户端 dongdong-agent/DSH-Desktop

DeepSeek Harness Desktop

DSH Desktop —— 为 DeepSeek Harness 打造的原生桌面客户端，基于 Tauri 2 + React 19。以子 webview 承载官方 DeepSeek Harness WebUI，并替你管理本地引擎。

其他语言版本： English · 日本語 · 한국어 · Español · Français · Deutsch

✨ 这是什么？

DeepSeek Harness Desktop 是一个围绕官方 DeepSeek Harness WebUI 的轻量原生壳。它不重新发明轮子，而是用子 webview（站点即 127.0.0.1 的顶层文档，而非跨站 iframe）承载官方 Web 界面，再补齐桌面应用该有的能力：

- 一键启动引擎 —— 自动检测本机环境（node + dsh）、挑选空闲端口、以正确 profile 启动引擎。
- 复用已有实例 —— 本机已有 dsh web 实例在跑时直接连接，绝不双开（不再争抢 ~/.dsh 会话存储）。
- 环境自检 + 一键安装 —— 缺 Node.js 或缺 dsh 引擎？启动页会明确指出缺什么，并可一键安装。
- 无边框窗口 —— 自定义标题栏（拖动 / 最小化 / 最大化 / 关闭）+ 状态栏（引擎状态 · 端口 · 缩放）。
- 引擎会话鉴权 —— 引擎 ≥ 0.1.5 会拒绝未鉴权请求，且会话 Cookie 为 SameSite=Strict。壳用受管凭据里的签名密钥自签该 Cookie 并注入子 webview，因此 WebUI 正常加载，而不是停在 401 页面。
- 官方更新自动跟进 —— 界面就是官方 WebUI 本体，官方发新版引擎后，桌面端在引擎更新后自动获得全部新功能、UI 改版、新模型，无需任何界面重写。
- 一键检测并升级引擎内核 —— 官方约每 1~2 天发一个新 rc；标题栏「检测并升级内核」按钮实时对比官方 npm registry，有新版时显示红点徽标。升级下载到应用私有内核目录（%APPDATA%\com.dsh.desktop\kernel\<版本>\，版本并存、秒级切换），无需命令行、不污染 pnpm/npm 全局；升级后若新版本未验证兼容性，状态栏显示「⚠ 新内核未验证 + 一键回滚」。
- 本地持久化 —— 会话数据全部落盘在 ~/.dsh/sessions/，关掉应用不丢任何工作。

其余的——会话、轨迹、插件、Agent 预设、设置——都是官方 DeepSeek Harness WebUI 的原生功能，由应用完整托管，零功能阉割。

🚀 快速开始

1. 从 Releases 下载最新安装包（DSH Desktop_0.1.13_x64-setup.exe，Windows x64），或直接复制绿色版 dsh-desktop.exe 到任意位置。
2. 启动应用。启动页会显示环境检测结果（Node.js / npx / dsh 引擎）。
3. 点击 启动引擎。应用会自动 spawn 引擎（dsh --profile web，监听 127.0.0.1:17800 或其他空闲端口）并自动加载官方 WebUI。
4. 像网页版一样使用——会话、插件、轨迹，应有尽有。

首次使用：若 Node.js 或 dsh 缺失，用启动页上的一键安装按钮即可。

📦 发布版本说明（三版对比）

仓库发布三种版本，按需选择：

| 版本 | 是什么 | 大小 | 需要 Node.js | 默认对话语言 |
| v0.1.12 | Tauri 桌面壳——原生 GUI（标题栏/状态栏/缩放），内嵌官方 WebUI | 2.5 MB | ✅ 需要（引擎运行时拉取） | 跟随引擎 |
|| v0.1.12-chinese | 中文全量便携版——内置 Node.js + dsh + 中文 persona（简体中文思考/对话） | 52 MB | ❌ 不需要 | 🇨🇳 中文 |
|| v0.1.12-chinese-lite | 中文简版——dsh + 中文 persona，用系统 Node.js | 31 MB | ✅ 需要 | 🇨🇳 中文 |
|| v0.1.12-full-english | 英文全量便携版——内置 Node.js + dsh（官方原版，未修改） | 52 MB | ❌ 不需要 | 🇬🇧 英文 |

怎么选？
- 学员没装 Node.js → v0.1.12-chinese（DSH-Desktop-Chinese-Setup-v0.1.12.exe）或 v0.1.12-full-english（DSH-Desktop-Full-English-v0.1.12.exe）——零依赖，双击即用
- 想要中文对话、已装 Node.js → v0.1.12-chinese-lite（31 MB，最小中文包）
- 想要中文对话、没装 Node.js → v0.1.12-chinese
- 已有 Node 环境 / 想要原生 GUI 壳 → v0.1.12（2.5 MB）

三个版本共用同一引擎（@deepseek-ai/dsh@0.1.0-rc.6），数据都在 ~/.dsh/，互不影响。

🖥 平台支持

| 平台 | 状态 | 使用方法 |
| Windows x64 | ✅ 官方支持 | 从 Releases 下载安装包，或直接运行便携版 exe |
| macOS（Apple Silicon / Intel） | 🚧 源码构建 | 见下文 |
| Linux（x64） | 🚧 源码构建 | 见下文 |

Windows 是主支持平台——安装包和 CI 构建优先产出 Windows 版本。macOS 和 Linux 在 Tauri 2 下可以构建运行，但目前还未发布预编译产物，需从源码构建：

前置要求（全平台通用）
- Node.js ≥ 18（https://nodejs.org）— 提供 node 和 npx
- Rust 稳定版工具链（https://rustup.rs）
- Tauri 平台系统依赖： macOS： Xcode Command Line Tools
Linux： sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

克隆并构建
git clone https://github.com/dongdong-agent/DSH-Desktop.git
cd DSH-Desktop
npm install
npm run tauri build # 产出 .app（macOS）/ .deb、.AppImage（Linux）到 src-tauri/target/release/bundle/

跨平台说明：

- 桌面壳（Tauri 2）完全跨平台；引擎是官方 @deepseek-ai/dsh npm 包，三平台都能通过 Node.js 运行。
- macOS/Linux 上引擎通过 node + npx 兜底链启动（Windows 专属的 dsh.cmd / 本地 bin.js 路径会在运行时探测，缺失则自动跳过）。
- 引擎会话数据存于 ~/.dsh/——三个平台的会话、配置、凭据互通。
- 需要 macOS/Linux 预编译产物？在 Issues 提需求——CI 工作流可扩展发布它们。

🏗 架构

┌────────────────────────────────────────────────────┐
│ TitleBar（自定义无边框标题栏 + 引擎状态点） │ ├────────────────────────────────────────────────────┤ │ 子 webview → 官方 DeepSeek Harness WebUI │ │ 会话 / 轨迹 / 插件 / 设置，全部官方功能 │ │ 以 127.0.0.1 为站点的顶层文档，Cookie 正常生效 │ ├────────────────────────────────────────────────────┤ │ StatusBar（引擎状态 · 端口 · 缩放） │ └────────────────────────────────────────────────────┘

- 前端：React 19 + TypeScript + Vite 6 + Tailwind CSS 4 + Zustand
- 桌面壳：Tauri 2（Rust），无边框窗口 + 自定义标题栏
- 引擎生命周期（src/lib/dshEngine.ts）：扫描已有实例 → 挑选空闲端口 → spawn（node + 本机 bin.js，备选 npx / dsh / dsh.cmd）→ 健康检查 → 停止
- 引擎界面（src-tauri/src/lib.rs）：引擎运行中时主窗口直接导航到引擎页面（顶层文档）；首次加载注入自签会话 Cookie（见 src/lib/engineAuth.ts）
- 会话鉴权（src/lib/engineAuth.ts）：从 ~/.dsh/.credentials.yaml 读取浏览器会话签名密钥，自签一份引擎可校验的 Cookie，每次页面加载完成时注入
- 诊断：spawn 过程与失败原因写入 %TEMP%\dsh-spawn.log

🧰 技术栈

| 层 | 选型 |
| 桌面壳 | Tauri 2（Rust），无边框 + 自定义标题栏 |
| 前端 | React 19 + TypeScript + Vite 6 |
| 样式 | Tailwind CSS 4 |
| 状态 | Zustand 5（仅 engine 一个 store —— 壳不保存任何对话/会话状态） |
| 内嵌 UI | 官方 DeepSeek Harness WebUI（Tauri 子 webview） |

🛠 开发

npm install
npm run tauri dev # 开发模式（Vite 端口 1422）

📦 构建

npm run build # tsc + vite build
npm run tauri build # 生产打包（NSIS 安装包 + 绿色版 exe）

产物：src-tauri/target/release/bundle/nsis/DSH Desktop_0.1.13_x64-setup.exe

📁 项目结构

src/
├── App.tsx # 壳布局：TitleBar + 子 webview 宿主 + StatusBar ├── lib/ │ ├── dshEngine.ts # ★ 引擎生命周期：findExistingInstance / startEngine / stopEngine │ │ # + candidateCommands（spawn 候选链）+ probePort + 诊断日志 │ ├── engineAuth.ts # 引擎会话 Cookie 自签（受管凭据） │ ├── updater.ts # 内核版本检测 / 安装 / 回滚 │ └── types.ts # 共享类型（EngineHealth） ├── stores/ # zustand store（engine） └── components/ ├── TitleBar.tsx # 自定义标题栏（拖动 / 最小化 / 最大化 / 关闭） ├── StatusBar.tsx # 引擎状态 · 内核版本 / 回滚 · 缩放 ├── EngineLauncher.tsx # 启动页：环境检测 + 一键安装 + 启动引擎 ├── CloseDialog.tsx # 关闭 / 最小化到托盘 / 停止引擎并退出 └── KeyManagerDialog.tsx# 受管 API Key / 凭据管理 src-tauri/ ├── capabilities/default.json # ★ 权限（shell spawn scope、窗口控制） ├── tauri.conf.json # 窗口 / 打包配置 └── src/lib.rs # 子 webview（mount / bounds / unmount）+ 插件注册

🔍 疑难排查

- 标题栏按钮或拖动无反应 —— 需在 src-tauri/capabilities/default.json 配置 core:window:* 权限（allow-minimize / allow-toggle-maximize / allow-close / allow-start-dragging）。capabilities 编译进二进制，改后必须重新构建。
- 引擎 spawn 失败 —— 查看 %TEMP%\dsh-spawn.log。常见原因：缺 shell:allow-spawn、scope 程序白名单缺失、scope 条目缺 cmd 字段（非 sidecar 条目必填）。日志里是精确错误信息。
- WebUI 空白 / 提示 authentication required —— 引擎 ≥ 0.1.5 要求会话 Cookie，且该 Cookie 为 SameSite=Strict。壳页面（tauri.localhost）里的 iframe 属跨站上下文，Cookie 永远不会被发送——这正是引擎 UI 改用子 webview 承载的原因。若出现 401 页面，请检查 ~/.dsh/.credentials.yaml 中是否仍有 client-connection/browser-session；没有签名密钥就无法生成 Cookie。
- 缩放后引擎视图错位 —— 壳在调用 set_engine_view_bounds 前，会按当前缩放比例把 CSS 像素换算成逻辑像素。改动布局时，请保持宿主元素尺寸与缩放换算同步。

📄 开源协议

MIT © 2026 dongdong-agent