安装 - DeepSeek Harness Desktop

下载与你的平台和架构匹配的安装包。常规安装包首次启动会下载兼容的运行时和预构建 Harness 内核，无需自行配置 Node.js、pnpm 或 Docker。

选择版本并下载

当前稳定版为 0.19.1，测试版为 0.20.0-beta.1。资源来自 GitHub Releases；自动同步可能滞后，以发布页面实际列出的文件为准。不是每个版本都有 Bundle，0.20.0-beta.1 未提供 Bundle；不要据此假设首次启动可离线完成。

上方版本选择器单独列出该版本的 Bundle 下载。稳定版 0.19.1 提供：

平台	Bundle 安装包
Windows x64	`Deepseek.Harness.Desktop_Bundle_0.19.1.exe`
macOS Apple Silicon	`Deepseek.Harness.Desktop_Bundle_0.19.1_aarch64.dmg`
macOS Intel	`Deepseek.Harness.Desktop_Bundle_0.19.1_x64.dmg`
Linux x64（Debian / Ubuntu）	`Deepseek.Harness.Desktop_Bundle_0.19.1.deb`

Bundle 随包携带运行时、Harness 与内置插件，减少首次启动下载；模型访问与后续更新仍可能需要联网。所选版本没有 Bundle 时，上方不会显示该列表。

以下为 0.20.0-beta.1 的实际发布资源与系统要求：

平台	要求与架构	安装包
Windows	Windows 10+、WebView2；x64	`.exe` / `_x64_en-US.msi` / `_x64_zh-CN.msi`
macOS	macOS 12+；Web 界面需 Safari 17.4+ 能力；Apple Silicon / Intel	`_aarch64.dmg` / `_x64.dmg`
Linux	x64；WebKit2GTK 4.1 运行库	`.deb` / `.AppImage`

架构和安装包类型以所选版本的实际资源为准。Git 工作树等 Git 功能还需要系统安装 Git。 macOS 也可通过 Homebrew 安装：

brew install dsh-tauri/desktop/deepseek-harness

模型请求、插件安装和更新仍可能需要联网，不能把本地运行理解为全程离线。

Windows 安全提示或缺少 WebView2

先确认安装包来自官方 Release。若缺少 WebView2，安装 Microsoft 提供的 WebView2 Runtime 后重试。

macOS 阻止首次启动

验证下载来源后，在系统设置 → 隐私与安全性中允许应用运行。系统版本满足最低要求时，也需确认 WebView 的兼容能力。

Linux Wayland 黑屏

可先尝试 .deb。AppImage 仍然黑屏时尝试：

WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 GDK_BACKEND=x11 ./Deepseek*.AppImage

更多启动、权限和显示问题见故障排除。