桌面工作台 pwh19920920/deepseek-desktop

DeepSeek Harness Desktop

将 AI 工作流框架 dsh 打包为原生桌面应用

deepseek-harness AI 工作流引擎的原生桌面外壳

🌐 English

📸 截图

加载界面 · 启动中

主体界面 · 与官方一致

📋 项目概述

DeepSeek Harness Desktop 是一个基于 Tauri 2 的桌面应用，将 DeepSeek 官方的 deepseek-harness（简称 dsh）AI 工作流引擎包装为原生桌面体验。

它不是一个聊天机器人客户端，而是一个 AI 工作流引擎的桌面壳层 — 运行 dsh 的 Web UI，提供文件系统访问、系统通知、本地文件打开等原生能力桥接。

✨ 特性

🚀 原生轻量基于 Tauri 2，使用系统原生 WebView，不捆绑 Chromium。包体积小、内存占用低，启动即用。

🖥️ 跨平台支持 macOS (ARM64 / x64)、Windows (x64) 和 Linux (x64 / ARM64)，一套代码多端运行。

📦 自包含构建时自动下载对应平台的便携 Node.js 二进制，拷贝并裁剪 dsh 依赖。最终产物开箱即用，用户无需安装任何运行时。

🔌 插件市场内置 dsh-market 插件市场，支持 1,250+ 社区插件的一键安装、更新管理、热开关、备份恢复。

🎯 构建优化自动移除 typescript、vite、esbuild 等构建时依赖，只保留当前平台的 node-pty prebuild，极致减小包体积。

🔗 原生 OS 集成通过 Tauri 插件提供系统通知、文件对话框、默认程序打开文件等原生能力。

🎬 优雅启动启动时展示加载动画，实时推送 loading → ready / error 状态，体验流畅。

🧹 干净关闭窗口关闭时自动终止 dsh 侧边进程，无残留。

🚀 快速开始

1. 安装依赖 + 初始化环境
pnpm bootstrap

2. 开发模式（带热重载）
pnpm dev

3. 构建生产包
pnpm build

4. 清理构建产物
pnpm clean

前置条件

| 依赖 | 版本要求 |
| Rust | ≥ 1.77 |
| Node.js | ≥ 22.19 或 ≥ 24 |
| pnpm | ≥ 11.7 |
| Tauri 系统依赖 | 见 Tauri 文档 |

macOS

xcode-select --install

Windows

- Microsoft Visual Studio C++ 构建工具
- WebView2（Windows 10 以上已内置）

Linux

sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

命令参考

| 命令 | 用途 |
| pnpm bootstrap | 安装依赖 + 初始化环境 |
| pnpm dev | 开发模式（热重载） |
| pnpm build | 构建当前平台 |
| pnpm build macos | 构建 macOS (ARM64) |
| pnpm build windows | 构建 Windows (x64) |
| pnpm build linux | 构建 Linux (x64) |
| pnpm build all | 构建所有平台 |
| pnpm clean | 清理所有构建产物 |

🏗️ 架构

系统架构图

flowchart TB
subgraph Tauri["Tauri 桌面应用"] direction TB subgraph Frontend["前端层"]
WEB["WebView\nReact SPA"]
UI["加载/错误/就绪\n三种状态 UI"]
end
subgraph Backend["Rust 后端层"]
LIFECYCLE["dsh 生命周期管理\n启动 · 停止 · 端口发现"]
NATIVE["原生能力桥接\n文件选择器 · 系统通知 · 路径打开"]
PLUGIN["Tauri 插件\nshell · notification · dialog"]
end
subgraph Sidecar["侧边进程层"]
NODE["Node.js 便携版\n侧边进程"]
DSH["dsh web\nAI 工作流引擎"]
MARKET["dsh-market\n插件市场"]
end
end

WEB --> LIFECYCLE
LIFECYCLE --> NODE
NODE --> DSH
DSH --> MARKET
WEB --> UI
WEB --> NATIVE
WEB --> PLUGIN

工作流程

sequenceDiagram
participant User as 用户 participant UI as WebView UI participant Rust as Rust 后端 participant Node as Node.js 侧边进程 participant DSH as dsh 引擎

User->>UI: 启动应用 UI->>Rust: 初始化 Rust->>Rust: 配置 dsh profile Rust->>Node: 启动侧边进程 Node->>DSH: 运行 dsh web
DSH-->>Node: 分配端口
Node-->>Rust: stdout 输出端口
Rust->>Rust: 正则匹配端口
Rust-->>UI: 推送状态 loading
Rust-->>UI: 推送状态 ready
UI->>DSH: WebView 导航到 dsh UI User->>DSH: 使用 AI 工作流 User->>UI: 关闭窗口 UI->>Rust: 关闭事件 Rust->>Node: 终止侧边进程
Node-->>Rust: 进程退出
Rust->>Rust: 清理资源

状态机

| 状态 | 含义 | 用户界面 |
| loading | 侧边进程启动中，等待端口 | 旋转圈 + 进度条动画 |
| ready | 侧边进程就绪，WebView 导航到 dsh UI | dsh 完整界面 |
| error | 启动失败（dsh 未找到、端口超时等） | 红色错误提示 + 详细信息 |

📁 项目结构

dsh-desktop/
├── .npmrc # pnpm 配置 ├── pnpm-workspace.yaml # 工作区定义 ├── package.json # 根调度脚本 ├── scripts/ │ ├── install.js # 安装依赖 │ ├── build.js # 多平台构建脚本 │ ├── dev.js # 开发模式入口 │ ├── clean.js # 清理脚本 │ └── fetch-node.js # 下载便携 Node.js ├── dsh-app-desktop/ │ ├── package.json # 子项目（含 dshmarket 依赖） │ ├── vite.config.ts # Vite 构建配置 │ ├── index.html # 启动加载页 │ ├── src/ # 前端 (React + TypeScript) │ │ ├── main.tsx # 入口 │ │ ├── App.tsx # 状态感知的启动 UI │ │ └── index.css # 样式 │ └── src-tauri/ # 后端 (Rust + Tauri) │ ├── Cargo.toml # Rust 依赖 │ ├── build.rs # 构建时拷贝 dsh 资源 │ ├── tauri.conf.json # Tauri 配置 │ ├── binaries/ # 便携 Node.js │ ├── resources/dsh/ # dsh 内核 │ ├── capabilities/ # 权限配置 │ └── src/ │ ├── main.rs # 入口 │ ├── lib.rs # 应用编排 │ ├── error.rs # 错误类型 │ ├── paths.rs # 路径解析 │ ├── dsh/ # dsh 生命周期 │ │ ├── mod.rs │ │ ├── port.rs # 端口发现 │ │ ├── spawn.rs # 进程启动 │ │ └── shutdown.rs # 进程关闭 │ ├── commands/ # Tauri 命令 │ │ ├── mod.rs │ │ ├── start.rs │ │ ├── stop.rs │ │ └── status.rs │ └── capabilities/ # 原生能力 │ ├── mod.rs │ ├── file_picker.rs │ ├── notifications.rs │ └── opener.rs └── screenshots/ # 截图

🔧 构建细节

平台映射

| 平台 | Rust 目标三元组 | 构建参数 |
| macOS (ARM64) | aarch64-apple-darwin | macos |
| macOS (x64) | x86_64-apple-darwin | — |
| Windows (x64) | x86_64-pc-windows-msvc | windows |
| Linux (x64) | x86_64-unknown-linux-gnu | linux |

跨平台构建

在 macOS 上即可交叉编译 Windows 和 Linux 版本：

pnpm build all

构建优化流程

构建过程中 build.rs 自动执行以下优化，极致减小最终包体积：

1. dsh 源码拷贝 — 从 node_modules/@deepseek-ai/dsh 拷贝到资源目录
2. 依赖拷贝 — 从 pnpm 虚拟存储拷贝运行所需依赖（含 dshmarket）
3. 依赖裁剪 — 移除 typescript、vite、esbuild 等构建时依赖
4. 平台预编译清理 — 只保留当前平台 node-pty 的 prebuild 文件
5. 文档清理 — 移除 CHANGELOG.md、CONTRIBUTING.md 等无用文件

构建产物

| 平台 | 产物格式 | 路径 |
| macOS | .dmg / .app | target//release/bundle/macos/ |
| Windows | .msi / .exe | target//release/bundle/msi/ |
| Linux | .deb / .AppImage | target//release/bundle/deb/ |

🆙 更新 dsh 版本

修改 dsh-app-desktop/package.json 中的版本号然后运行：
pnpm install

版本声明在 dsh-app-desktop/package.json 的 dependencies 中：

"@deepseek-ai/dsh": "^0.1.0-rc.7"

🧩 插件市场

本应用预装了 dsh-market，启动后进入 Settings → Plugin Market 即可：

- 浏览 & 搜索 — 1,250+ 社区插件，支持分类筛选和关键词搜索
- 一键安装 — 点一下即可安装，实时进度显示
- 更新管理 — 逐个或批量更新插件，插件市场自身也能自更新
- 热开关 — 无需重启即可启用/禁用插件
- 备份恢复 — 支持 JSON 导出/导入、WebDAV 自动备份、GitHub Gist 同步

插件市场在首次启动时自动配置，用户无需任何额外操作。

🧹 清理

pnpm clean

清理以下内容：

| 路径 | 说明 |
| node_modules/ | 所有依赖 |
| dsh-app-desktop/node_modules/ | 工作区依赖 |
| dsh-app-desktop/dist/ | Vite 前端构建产物 |
| dsh-app-desktop/src-tauri/target/ | Rust 编译产物 |
| dsh-app-desktop/src-tauri/gen/ | Tauri 代码生成 |
| dsh-app-desktop/resources/dsh/ | dsh 资源拷贝 |
| dsh-app-desktop/src-tauri/binaries/ | 下载的 Node.js |
| .tmp/ | 临时文件 |

📦 安装包说明

macOS

构建产物为 .dmg 和 .app，位于 dsh-app-desktop/src-tauri/target/aarch64-apple-darwin/release/bundle/。

⚠️ macOS 注意： 由于未使用 Apple Developer 账号签名，macOS Gatekeeper 可能会提示"已损坏"。安装后运行以下命令即可解决：
sudo xattr -rd com.apple.quarantine /Applications/DeepSeek\ Harness.app

Windows

构建产物为 .msi 或 .exe，位于 dsh-app-desktop/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/。

Linux
构建产物为 .deb 和 .AppImage，位于 dsh-app-desktop/src-tauri/target/x86_64-unknown-linux-gnu/release/bundle/。

⚖️ 免责声明

第三方社区项目 · 与 DeepSeek 官方无关

本应用是非官方的第三方桌面壳层，由社区开发者独立维护，不代表 DeepSeek 官方，与 DeepSeek（深度求索）公司无任何关联或隶属关系。

本应用仅提供一个运行 deepseek-harness 的桌面环境，本身不提供任何 AI 模型、API 密钥或服务。用户需自行准备和遵守所使用的 AI 服务条款。

使用者自行承担一切风险。开发者不对因使用本软件而产生的任何直接或间接损失承担责任。

🛠️ 技术栈

| 层 | 技术 |
| 桌面框架 | Tauri 2 |
| 后端语言 | Rust |
| 前端框架 | React 18 + TypeScript |
| 构建工具 | Vite 5 |
| 包管理 | pnpm |
| AI 引擎 | deepseek-harness (dsh) |
| 插件市场 | dsh-market |
| 原生插件 | shell, notification, dialog |

🔗 关联项目

| 项目 | 说明 |
| deepseek-harness | DeepSeek 官方的 AI 工作流引擎（dsh），本应用的核心 |
| @deepseek-ai/dsh | dsh 的 npm 包，版本管理透明 |
| dsh-market | 社区插件市场，提供 1,250+ 插件 |
| Tauri 2 | 本应用使用的桌面框架 |

📄 许可

MIT — 与 deepseek-harness 相同。

Built with ❤️ by the community · 由社区爱好者构建

Not affiliated with DeepSeek · 与 DeepSeek 官方无关