DeepSeek Harness Desktop

让官方 DeepSeek Harness 开箱即用地运行在桌面上。

自动跟进官方源码，内置完整运行环境，为 macOS 和 Windows 提供无需另装 Node.js 的桌面体验。

English | 中文 | 中文副本

项目简介

DeepSeek Harness Desktop 是 DeepSeek Harness 的非官方桌面发行版。它保留官方 Web 应用和本地能力，只负责同步源码、准备运行环境并生成可以直接安装的软件。

项目仍处于开发者预览阶段。桌面版跟随官方快速迭代，功能和数据格式可能发生不兼容变化。

最新安装包请前往 Releases 下载。最终用户不需要安装 Node.js、npm 或 pnpm。

macOS 未签名应用安装说明

当前 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

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 与官方地址

• License：MIT
• 第三方许可：THIRD_PARTY_NOTICES.md
• DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
• DeepSeek 官方网站：https://deepseek.com