让官方 DeepSeek Harness 开箱即用地运行在桌面上。
自动跟进官方源码，内置完整运行环境，为 macOS 和 Windows 提供无需另装 Node.js 的桌面体验。
DeepSeek Harness Desktop 是 DeepSeek Harness 的非官方桌面发行版。它保留官方 Web 应用和本地能力，只负责同步源码、准备运行环境并生成可以直接安装的软件。
项目仍处于开发者预览阶段。桌面版跟随官方快速迭代，功能和数据格式可能发生不兼容变化。
最新安装包请前往 Releases 下载。最终用户不需要安装 Node.js、npm 或 pnpm。
当前 macOS 安装包尚未完成 Apple 开发者签名与公证。请只从本项目的 Releases 下载；首次启动时，macOS 可能显示以下安全提示。
| 报错提示 | 原因 | 解决方法 |
|---|---|---|
| 「无法验证开发者」或「Apple 无法检查其是否包含恶意软件」 | macOS 拦截了未签名应用 | 在“访达”的“应用程序”中右键 DeepSeek Harness，选择“打开”，再在弹窗中选择“打开” |
| 「已损坏，无法打开。您应该将它移到废纸篓」 | macOS 对下载的应用添加了隔离标记 | 退出应用，确认它位于“应用程序”目录，然后在“终端”执行下方命令并重新打开 |
| 「打不开，因为来自身份不明的开发者」 | macOS 未识别到可信的开发者签名 | 打开“系统设置 → 隐私与安全性”，找到对应的拦截提示并选择“仍要打开” |
处理“已损坏”提示：
xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"该命令只移除这份应用的隔离标记，不会关闭整台 Mac 的安全保护。请仅对从本项目 Releases 下载的安装包执行；当前安装的版本通常只需处理一次，重新下载新版本后可能需要再次处理。
- 完整打包官方前端、本地服务和运行环境，不是简单嵌套在线网页。
- 安装后直接在本机运行，最终用户无需安装 Node.js、npm 或 pnpm。
- 每 30 分钟检查官方
master，自动把新提交同步到本仓库main。 - 官方版本变化后，自动构建并发布 macOS 和 Windows 安装包。
- 同步、构建或启动检查失败时停止发布，避免产生不可用版本。
- 官方同步不会覆盖桌面代码、发布流程、应用资源和自有文档。
Harness 可以理解为 agent（智能体）的运行和组织框架。它把模型、工具、会话、权限、工作流和扩展能力组合在一起，让 agent 不只是回答问题，还能在明确规则下持续完成任务。
DeepSeek Harness 的核心原则是「一切皆插件」。模型提供方、工具、存储、终端和工作流都可以独立组合或替换；桌面版在这套能力之外增加安装、启动和退出管理，不改变官方产品本身的工作方式。
- 桌面版版本号始终读取官方根目录的
package.json，发布标签使用v<官方版本号>。 - macOS 生成 DMG，Windows 生成安装程序；GitHub Release 同时保留对应版本的源码下载。
- 每个新版本都会成为本仓库的最新可用版本，即使官方版本号包含
rc等预发布标识。 - 每次正式打包前必须先完成官方源码同步、官方项目构建和真实启动检查，任一步失败都会停止发布。
- 安装包包含运行所需的环境和依赖，构建电脑仍需安装 Git、Node.js、pnpm 及当前系统要求的本地构建工具。
- 桌面图标直接使用官方仓库提供的 DeepSeek 图标。
本地生成当前系统安装包：
cd desktop
npm install
npm run dist生成结果位于 desktop/dist/。自动发布由 桌面发布流程 完成。
- 官方来源固定为
deepseek-ai/deepseek-harness的master分支，本仓库使用main分支。 desktop/upstream.json记录当前已同步的官方提交；每次执行npm run dist都会先检查并拉取官方最新代码。desktop/protected-paths.json列出本仓库独立维护的内容。同步不会改写桌面代码、双语首页、桌面设计记录和发布流程。- 官方历史被改写或更新产生冲突时，同步会撤销本次操作并停止，不会继续打包不完整的源码。
- 自动发布每 30 分钟检查一次官方
master；发现新提交就同步到本仓库main，官方版本号变化后再创建新版本，已发布的版本不会被重复覆盖。
| 位置 | 用途 |
|---|---|
desktop/src/ |
桌面窗口、官方服务启动与退出管理 |
desktop/scripts/ |
官方同步、版本对齐、运行环境准备、启动检查和打包 |
desktop/electron-builder.yml |
macOS、Windows 和 Linux 安装包规则 |
desktop/upstream.json |
当前对应的官方源码版本 |
desktop/protected-paths.json |
同步时必须保留的本仓库文件 |
.github/workflows/desktop-release.yml |
双平台构建与版本发布 |
更详细的构建说明见 桌面端说明。
- 持续跟进官方能力和桌面适配，缩短官方更新到桌面版本之间的时间。
- 完成 macOS 与 Windows 的正式签名，减少首次安装时的系统安全提示。
- 增加应用内更新，让用户不必手动下载每个新版本。
- 改进首次启动、配置迁移、故障提示和多平台安装体验。
- 在官方发布节奏稳定后，补充 Linux 安装包和更多系统架构。
- License：MIT
- 第三方许可：THIRD_PARTY_NOTICES.md
- DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- DeepSeek 官方网站：https://deepseek.com