开发环境

准备本地环境并从源码运行 DeepSeek Harness Desktop。

开发需要 JavaScript 前端工具链和 Rust/Tauri 平台工具链；正式版用户不需要这些工具。

​

前置条件

• Node.js 22，建议 22.22.0，与托管环境一致。
• Rust 1.93+ 与 Cargo：修补后的通知依赖要求此版本。
• Corepack 与桌面仓库固定的 pnpm 11.7.0；不要套用独立文档仓库的 pnpm 版本。
• Git 和对应平台的 Tauri 依赖。

Windows安装带 MSVC 工作负载的 Microsoft C++ Build Tools 和 WebView2。

macOS安装并选用 Xcode 16+，确保 Swift 6 可用；通知后端使用 Swift 6 typed throws，仅旧版 Command Line Tools 不够。

Ubuntu / Debian

需要 WebKitGTK 4.1 和 Tauri 原生构建依赖：

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

​

从源码运行

1. 克隆仓库

   git clone https://github.com/dsh-tauri/deepseek-harness-desktop.git
   cd deepseek-harness-desktop
   
2. 启用固定 pnpm

   corepack enable
   corepack install
   
3. 安装依赖

   pnpm install --frozen-lockfile
   pnpm build:plugins
   
4. 启动 Tauri 开发模式

   pnpm tauri dev
   

• Vite 开发服务器：http://localhost:1420。
• Debug Harness：默认 127.0.0.1:3081，端口占用时可避让。
• 托管依赖：<AppData>/dev；数据：~/.dsh.dev，忽略继承的 DSH_HOME。
• 完整路径见运行时与数据。

pnpm dev 只启动 Vite；原生功能使用 pnpm tauri dev。修改 packages/ 时另开终端运行 pnpm dev:plugins，或使用 pnpm dev:desktop 同时启动插件 watcher 与桌面开发模式。