macOS 桌面封装版WTriumph/DeepSeek-Harness-macOS-Desktop-App

DeepSeek Harness macOS 桌面应用

DeepSeek Harness macOS 桌面版

中文
 · 
English

由 WTriumph 维护的 DeepSeek Harness
macOS 社区桌面发行版。App 使用 AppKit 与 WKWebView，内置 Node.js 和生产运行时，
双击即可运行，不需要安装 Node、npm 或 pnpm。

当前版本：Harness 0.1.0-rc.5 (Desktop 3)

非官方声明：本项目不是 DeepSeek 官方产品，与 DeepSeek 不存在隶属、赞助
或背书关系。“DeepSeek”及相关标识归其权利人所有，本项目仅在指代所再分发的
开源项目时使用该名称。完整声明见 NOTICE.md。

功能

- 原生 macOS App，启动后直接显示 Harness Web UI
- 内置 arm64 Node.js 24.18.0 与 Harness 生产依赖
- 后端仅监听随机的 127.0.0.1 端口
- 中文 Harness UI，支持中文输入法、剪贴板、附件、下载与目录选择
- 保存窗口大小和位置；首次窗口约为屏幕可用宽高的 70%
- 独立桌面数据目录，可选择从旧的 ~/.dsh 导入副本
- App Only、Standard、Complete 三种双语卸载模式

软件展示

开箱即用的原生窗口，启动后直接进入 Harness 工作区

深色模式下的会话、工具调用与任务状态

语言、权限、Agent 预设与外观设置

轨迹视图将模型、工具和上下文活动集中呈现

卸载服务

版本与版权归属

相较上游版本的改进与修改

本项目完整保留上游 DeepSeek Harness 的 Agent、模型接入、工具调用、权限确认和会话
的全部能力，重点解决其在 macOS 上作为日常桌面软件使用时的安装、生命周期和数据管理
问题。这里的“上游”指 deepseek-ai/deepseek-harness，
不表示本社区发行版获得了 DeepSeek 的官方认可。
| 项目 | 上游 DeepSeek Harness | 本 macOS 桌面版 |
| --- | --- | --- |
| 安装与启动 | 通过 dsh/Node.js 环境启动 Web UI | 双击 .app；内置固定版本的 Node.js 和生产依赖 |
| macOS 集成 | 浏览器或终端中的 Web 应用 | AppKit + WKWebView、Dock、标准菜单、全屏、窗口记忆和中文输入法 |
| 进程生命周期 | 由启动它的终端或用户管理 | 关闭最后窗口、Cmd+Q 和 Dock 退出统一停止 dsh；超时后清理整个进程组 |
| 本地服务 | 由命令行参数决定 | 强制监听随机 127.0.0.1 端口，严格校验启动 URL 后才加载 WebUI |
| 数据 | 默认使用命令行版数据位置 | 使用独立 App Support 目录；首次启动可校验并复制 ~/.dsh，不修改原目录 |
| 界面 | 上游 Web UI | 增加中文本地化修复、完善汉化、原生“设置”入口、启动/掉线/错误状态与外部链接处理 |
| 卸载 | 删除 CLI 或依赖需由用户自行处理 | App Only、Standard、Complete 三种模式，精确列出路径，可选备份并防止宽泛删除 |
| 构建 | 上游源码与常规包管理流程 | 固定源码、Node.js、pnpm 版本及 SHA-256；补丁从全新源码重复应用并测试 |

桌面版没有替换模型、削弱权限确认或绕过 Harness 的安全机制。对 Harness 源码的
修改仅包括生产部署依赖修复、中文界面修复，以及原生菜单打开设置面板所需的事件
接口；完整补丁顺序见 patches/harness/series。

系统要求

- macOS 13 或更高版本
- Apple Silicon Mac（arm64）

安装

从 GitHub Releases
下载 DeepSeek-Harness-macos-arm64.zip，解压后将 App 移入“应用程序”。

公开构建使用 ad-hoc 签名，尚未使用 Apple Developer ID 签名或公证。macOS 首次
启动可能显示 Gatekeeper 提示，可在 Finder 中右键 App 并选择“打开”。不要从未知
镜像下载本 App；发布页会提供 SHA-256 校验值。

数据与隐私

桌面版 Harness 数据位于：

~/Library/Application Support/DeepSeek Harness/Harness

本桌面壳不会添加遥测，也不会把工作区、日志、API 密钥或凭据上传给 WTriumph。
Harness 连接模型服务时的数据处理行为取决于用户配置的服务提供商。卸载备份可能
包含 API 密钥、凭据、会话和工作区文件，请将备份保存在可信位置。

卸载

在 App 菜单选择“卸载 DeepSeek Harness…”，然后选择：

1. 仅移除 App / App Only：App 移到废纸篓，保留全部数据。
2. 标准卸载 / Standard：删除 App 与桌面版专属数据，保留 ~/.dsh、
~/.agents 和用户工作区。
3. 完全卸载 / Complete：在列出精确路径并要求输入 DELETE ALL 后，额外永久
删除 ~/.dsh、~/.agents，以及 Harness 登记的用户工作区。

完全卸载会删除真实项目文件且无法通过 App 恢复。执行前可创建完整 ZIP 备份。
恢复脚本支持同样的模式和 --dry-run：

./scripts/uninstall-deepseek-harness.sh --mode standard --dry-run
./scripts/uninstall-deepseek-harness.sh --mode complete --dry-run

构建

固定构建输入见 config/build-versions.env：Harness 源 ZIP、Node.js 和 pnpm 都有
固定版本及 SHA-256。Harness 修改以 patches/harness/series 中的补丁保存。

DEVELOPER_DIR=/Applications/Xcode-beta.app/Contents/Developer \
./scripts/build-app.sh

产物：

dist/DeepSeek Harness.app
dist/DeepSeek-Harness-macos-arm64.zip

安全与许可证

- 安全问题请按 SECURITY.md 私密报告，不要在公开 Issue 中粘贴
API 密钥、日志或工作区文件。
- 本仓库新增的桌面打包、原生外壳、构建和卸载代码：Copyright (c) 2026
WTriumph，依据仓库根目录的 MIT License 发布。
- 再分发的上游 DeepSeek Harness 0.1.0-rc.5：Copyright (c) 2026 DeepSeek，
依据其 MIT License 使用；原始 ZIP 保持不变，桌面修改以补丁保存。
- “DeepSeek”及相关标识的权利归其各自权利人所有。MIT 许可证不授予商标权，
本项目名称仅用于说明兼容及再分发对象。
- Node.js 与其他第三方组件保留各自版权和许可证；详见 NOTICE.md、
THIRD-PARTY-NOTICES.txt 以及 App 内
Resources/Licenses。

English

Community-maintained macOS distribution of
DeepSeek Harness, maintained
by WTriumph. The native AppKit and WKWebView application embeds Node.js and the
production runtime, so no Node, npm, or pnpm installation is required.
当前版本：Harness 0.1.0-rc.5（Desktop 3）

非官方发行版： 本项目并非 DeepSeek 官方产品，
与 DeepSeek 无关联，亦未获得其赞助或认可。“DeepSeek”
及相关标识归其各自所有者所有，此处仅用于
标识所重新分发的开源项目。参见 NOTICE.md。

功能特性

- 原生 macOS 应用，可直接打开 Harness Web UI
- 内嵌 arm64 Node.js 24.18.0 及仅生产环境的 Harness 依赖
- 后端仅绑定到随机的 127.0.0.1 端口
- 中文 Harness UI，支持输入法、剪贴板、附件、下载和文件夹
- 窗口大小和位置持久化；首个窗口使用约 70% 的
可用屏幕宽度和高度
- 隔离的桌面数据，可选从旧版 ~/.dsh 复制迁移
- 双语 App Only、Standard 和 Complete 卸载模式

相对上游的改进与变更

本项目保留了上游 DeepSeek Harness 的 agent、模型提供方、
工具调用、审批和会话能力。其变更侧重于使
Harness 可作为日常 macOS 应用进行安装和管理。此处，
“上游”指
deepseek-ai/deepseek-harness；
这并不意味着 DeepSeek 认可此社区发行版。

| 领域 | 上游 DeepSeek Harness | 此 macOS 桌面发行版 |
| --- | --- | --- |
| 安装与启动 | 通过 dsh 和 Node.js 环境启动 Web UI | 可双击的 .app，固定 Node.js 和生产依赖 |
| macOS 集成 | 从浏览器或终端使用的 Web 应用 | AppKit + WKWebView、Dock、标准菜单、全屏、窗口持久化和 CJK 输入法 |
| 进程生命周期 | 由启动终端或用户管理 | 关闭窗口、Cmd+Q 和 Dock 退出会一致地停止 dsh；超时会清理进程组 |
| 本地服务 | 由 CLI 参数控制 | 绑定到随机的 127.0.0.1 端口；在加载 WebUI 前严格验证启动 URL |
| 数据 | 使用 CLI 数据位置 | 隔离的 App Support 数据，并经过验证从 ~/.dsh 复制迁移；源数据保持不变 |
| 界面 | 上游 Web UI | 中文本地化修复、原生设置入口、启动/断开/错误状态以及外部链接处理 |
| 卸载 | 手动移除 CLI 和依赖 | App Only、Standard 和 Complete 模式，具有精确路径、可选备份和广泛删除防护 |
| 可复现性 | 上游源代码和包管理器工作流 | 固定源代码、Node.js、pnpm 和 SHA-256 值；补丁应用于全新源代码树并经过测试 |

桌面发行版不会替换模型、削弱审批检查或
绕过 Harness 安全控制。Harness 补丁仅限于生产
部署依赖修复、中文 UI 修复以及原生
设置菜单所使用的事件。参见 patches/harness/series 了解
完整有序补丁集。

要求与安装

需要 Apple Silicon 上的 macOS 13 或更高版本。从
GitHub Releases
下载 DeepSeek-Harness-macos-arm64.zip，解压后将应用程序移入 Applications。

公开构建采用临时签名，未经 Apple Developer ID 签名或公证。Gatekeeper 可能要求
首次启动时通过 Finder 的 打开 上下文菜单操作。请仅从项目发布页面下载，并
验证公布的 SHA-256 校验和。

数据、隐私与卸载

Desktop Harness 数据存储于：

~/Library/Application Support/DeepSeek Harness/Harness

桌面外壳不添加任何遥测，也不会将工作区、日志、API 密钥或凭据上传至 WTriumph。
发送至已配置模型提供商的数据受这些提供商管辖。卸载备份可能包含凭据、会话和
工作区文件，必须安全存储。

该应用程序提供三种卸载模式：

1. 仅应用 将应用移至废纸篓并保留所有数据。
2. 标准 移除应用及桌面拥有的数据，同时保留 ~/.dsh、~/.agents 和用户
工作区。
3. 完全 列出确切路径并要求输入 DELETE ALL，然后永久移除 ~/.dsh、
~/.agents 以及 Harness 注册的工作区。

完全卸载会删除真实项目文件，且无法通过应用撤销。删除前可选择进行完整的 ZIP
备份。

构建

固定输入和 SHA-256 值位于 config/build-versions.env；上游变更以可复现补丁
形式存放于 patches/harness/series。

DEVELOPER_DIR=/Applications/Xcode-beta.app/Contents/Developer \
./scripts/build-app.sh

输出：

dist/DeepSeek Harness.app
dist/DeepSeek-Harness-macos-arm64.zip

安全与许可

- 请遵循 SECURITY.md 进行私密漏洞报告。切勿在公开 issue 中发布
API 密钥、私有日志或工作区文件。
- 本仓库中新增的桌面打包、原生外壳、构建和卸载代码：版权所有 (c) 2026
WTriumph，依据本仓库的 MIT License 发布。
- 再分发的上游 DeepSeek Harness 0.1.0-rc.5：版权所有 (c) 2026 DeepSeek，
依据其 MIT License 使用。原始 ZIP 保持不变，桌面修改以补丁形式存储。
- “DeepSeek” 及相关标识归其各自所有者所有。MIT License 不授予商标权；该名称
仅用于标识与上游项目的兼容性及其再分发。
- Node.js 及其他第三方组件保留其各自的版权和许可。参见 NOTICE.md、
THIRD-PARTY-NOTICES.txt 以及
捆绑的 Resources/Licenses。