零配置桌面客户端 lonesafe/deepseek-harness-desktop

DeepSeek Harness Desktop

运行环境零配置 · 简单易用 · 开箱即用 · 零开发门槛

下载安装后直接打开，无需安装 Node.js、pnpm、Electron，无需执行终端命令，也无需手动启动浏览器。桌面客户端已经包含运行 DeepSeek Harness 所需的完整环境；需要调用模型时，可直接在应用内填写服务商要求的凭据。

从官网下载 DeepSeek Harness Desktop

DeepSeek Harness Desktop 把官方开源的 DeepSeek Harness Web 体验打包成自包含桌面应用，支持 macOS、Linux 和 Windows。安装包内含 Electron、Node.js、生产插件图和 Web 资源，你无需准备开发环境。

这是由社区维护的桌面发行版，并非 DeepSeek 官方产品，也未获得 DeepSeek AI 的认可或隶属关系。

界面预览

DeepSeek Harness Desktop 中文主界面

下载并开始使用

1. 打开官网客户端下载页；也可以查看 GitHub Releases。
2. 下载适合当前系统的安装包。
3. 安装并打开应用。

| 平台 | 架构 | 安装包 |
| macOS | Apple Silicon | DMG 或 ZIP |
| macOS | Intel | DMG 或 ZIP |
| Windows | x64 | NSIS 安装程序或 ZIP |
| Linux | x64 | AppImage 或 DEB |

发布流水线会在具备 Apple Developer 凭据时自动签名、公证并验证 macOS 应用；没有证书时仍会发布未签名安装包，并在 Release 说明中标明状态。Windows SmartScreen 也可能显示未知发布者警告。

macOS 未签名版本安装与首次启动

1. 下载与 Mac 架构对应的 DMG，打开后把 DeepSeek Harness 拖入应用程序文件夹；如果下载 ZIP，请先解压，再把应用移入应用程序。
2. 首次启动不要直接双击。在访达的应用程序中按住 Control 点击 DeepSeek Harness，选择打开，然后在确认窗口中再次点击打开。
3. 如果系统提示无法验证开发者并阻止启动，请打开系统设置 → 隐私与安全性，找到被阻止的 DeepSeek Harness，点击仍要打开并完成系统验证。
4. 上述操作通常只需执行一次，之后可以像普通应用一样启动。无需也不建议全局关闭 Gatekeeper。

远程访问

1. 首次启动或尚未授权账号时，桌面客户端会提示登录或注册，并说明登录后可以从手机或其他设备远程使用这台电脑。用户可以暂不登录，继续在本机使用。
2. 授权完成后可以开启远程控制。该功能默认关闭，也可以随时在设置 → 通用设置 → 远程控制中管理。未登录用户开启远程控制时会再次看到登录提示，完成登录前无法启用。
3. 登录官网的设备中心，选择属于当前账号的在线电脑并点击连接，即可在新的浏览器标签页继续对话、查看任务和使用电脑上的工作区。

零配置桌面体验

- 无需安装运行环境：安装包已经包含 Electron、Node.js、生产插件图和 Web 资源。
- 无需使用命令行：桌面启动器会自动启动和关闭本地 Harness 服务。
- 无需单独打开浏览器：完整的 Harness 界面会直接显示在桌面窗口中。
- 无需开发经验：下载适用于 macOS、Windows 或 Linux 的原生安装包即可开始使用。

版本更新

桌面客户端启动后会立即向官网版本中心检查新版本，之后每隔 10 分钟检查一次。发现新版本时，左下角会显示更新标识；点击后由客户端从官网下载安装包，右下角实时显示下载与校验进度，并可随时取消。安装包通过文件大小和 SHA-256 完整性校验后才会交给系统打开。官网的客户端下载页和 GitHub Releases均提供安装包下载。

Beta 状态

当前为桌面 Beta 版本，提供 macOS Apple Silicon、macOS Intel、Linux x64 和 Windows x64 安装包，并包含桌面运行环境、账号授权、远程访问、移动端适配和官网版本更新能力。DeepSeek Harness 本身仍在快速开发，稳定桌面版发布前，配置、插件和持久化数据都可能发生变化。

从源码构建

需要 Git、Node.js 24 和 pnpm 11，以及桌面构建说明列出的平台原生工具：macOS 的 Xcode Command Line Tools、Linux 的 musl-tools，或 Windows 的 Visual Studio C++ Build Tools。

git clone https://github.com/lonesafe/deepseek-harness-desktop.git
cd deepseek-harness-desktop
pnpm install
pnpm run desktop:dist

当前平台的安装包会写入 dist/desktop。原生依赖在安装阶段按平台选择，所以每个目标都要在对应操作系统上打包：

pnpm run desktop:dist:mac
pnpm run desktop:dist:linux
pnpm run desktop:dist:windows

桌面安装包工作流用 GitHub 原生 runner 构建 macOS arm64、macOS x64、Linux x64 和 Windows x64。推送 v* 标签后，工作流会把安装包附加到对应 GitHub Release。

macOS 发布签名

macOS 打包始终启用 Hardened Runtime 和 Electron 所需的 entitlements。仓库维护者可以配置完整的 Apple Developer 凭据，让 Release 自动签名并完成 Apple 公证。凭据完整时，流水线会执行签名、公证和系统验证；没有配置凭据时仍会生成未签名安装包，用户按上面的首次启动步骤打开即可；只配置部分凭据会停止构建，避免把未完成的产物误认为已签名版本。

开发与验证

pnpm run desktop:dev
pnpm --dir apps/desktop run test
pnpm run verify-desktop-runtime-closure
pnpm run build

应用数据

Harness 数据位于 Electron 标准逐用户应用数据目录的 runtime 子目录。卸载应用不会自动删除这些数据。如果已保存的会话很重要，请在不同 Beta 版本之间迁移前进行备份。

引用

@misc{deepseek-harness2026,
title={DeepSeek Harness: Everything is a Plugin},
author={DeepSeek-AI},
year={2026},
publisher={GitHub},
howpublished=},
}

上游与许可证

智能体运行时、Web UI 和插件系统来自 deepseek-ai/deepseek-harness，桌面专用代码位于 apps/desktop。项目采用 MIT 许可证分发。