发布日期：2026年9月30日 | 信息核验：DeepSeek 官网、官方 GitHub 仓库与官方文档

DeepSeek Harness 官方桌面版是 DeepSeek 于 2026 年面向全球开放测试的本地 AI Agent 客户端，以 Electron 封装完整的 dsh Web 应用，支持后台运行、本地文件读写、代码与命令执行、插件扩展及长任务处理。用户可以从 DeepSeek 官方下载页获取 Apple 芯片 macOS 版和 64 位 Windows 版，当前公开系统要求分别为 macOS 13 及以上、Windows 10 及以上。项目仍处于开发者预览阶段，官方明确提示未来可能发生破坏兼容性的变更，且尚未完成安全审计，因此安装后应先配置模型与工作区，再以最小权限运行任务。

DeepSeek Harness 官方桌面版下载地址

DeepSeek Harness 桌面版应从 DeepSeek 官网下载，不建议使用网盘转载、第三方打包站或来历不明的“绿色版”。

官方入口如下：

截至 2026 年 9 月 30 日，官方 CDN 返回的 macOS 安装包约 353 MB，Windows 安装包约 276 MB。两个地址中的文件名都带有 latest，表示它们会随官方更新指向新版本，不是永久固定到某个版本的归档链接。

官方 GitHub 仓库同期最新预发布标签为 dsh-v0.2.0-rc.2，发布时间为 2026 年 9 月 29 日。桌面端 package.json 也标记为 0.2.0-rc.2。由于官网安装包使用动态链接，安装后应打开应用菜单中的“关于 DeepSeek Harness”查看实际版本，不要只根据下载链接名称判断版本。

支持哪些操作系统？

平台

官网公开要求

安装文件

当前公开状态

macOS

Apple 芯片，macOS 13 或更高版本

.dmg

官方提供下载

Windows

64 位，Windows 10 或更高版本

.exe

官方提供下载

Intel Mac

官方下载页标注暂不支持

无公开下载按钮

不建议使用 Apple 芯片安装包

Linux

官网暂未提供桌面安装包

可运行 Web UI 或从源码开发

不属于当前官方桌面下载范围

这里需要区分桌面版和开源 Web UI。Linux 用户以及希望自己控制运行环境的用户，可以安装 Node.js 后执行：

npx @deepseek-ai/dsh web

命令默认在 http://127.0.0.1:3080 启动 Web UI。本机运行时会自动打开浏览器；通过 SSH 启动时，只输出访问地址。桌面版则把完整 Web 应用、Host 和运行时打包在客户端中，普通用户不需要先安装 Node.js 或 pnpm。

macOS 怎么安装 DeepSeek Harness？

第一步：确认 Mac 芯片和系统版本

点击屏幕左上角苹果菜单，打开“关于本机”。芯片一栏应显示 Apple M 系列，而不是 Intel；系统版本需要达到 macOS 13 或以上。

当前官网下载的是 dsh-latest-macos-arm64.dmg。arm64 对应 Apple 芯片。Intel Mac 用户不要强行安装这个文件，官网当前明确标注 Intel 芯片暂不支持。

第二步：从官网下载 DMG

打开 DeepSeek 官方下载页，选择 macOS 版。也可以使用上文列出的官方 CDN 直链。浏览器下载完成后，双击 DMG 文件并按照安装窗口提示将 DeepSeek Harness 放入“应用程序”目录。

第三步：首次启动

从“应用程序”目录打开 DeepSeek Harness。首次启动时，macOS 可能请求文件夹、麦克风或其他系统权限。只为当前工作确实需要的功能授权；如果暂时不使用语音输入，可以不开放麦克风。

桌面端首次进入后会创建默认工作区和空白会话，也可以选择一个已有项目目录。选择工作区意味着 Agent 可以在授权范围内读取或修改其中的文件，应避免直接选择整个用户目录、密钥目录或包含大量敏感数据的目录。

第四步：按需安装 dsh 命令

v0.2.0-rc.2 增加了桌面端内置 dsh 命令。打开应用菜单中的“管理 dsh 命令…”，可以安装、修复或移除命令行入口。macOS 默认在 /usr/local/bin/dsh 创建链接，目录权限不足时会请求管理员认证。

安装后应打开一个新的终端窗口，运行：

dsh --version

命令注册是可选操作，不影响桌面界面的基本使用。准备卸载桌面版前，先通过“管理 dsh 命令… → 移除”清除 CLI 注册；官方文档说明，直接卸载应用不会自动移除该注册。

Windows 怎么安装 DeepSeek Harness？

第一步：确认系统版本

官方要求 Windows 10 或更高版本，并提供 64 位安装包。可在“设置 → 系统 → 系统信息”中查看系统类型。

第二步：下载安装程序

从 DeepSeek 官方下载页选择 Windows 版本，下载 dsh-latest-windows-x64.exe。运行安装程序并按照界面提示完成安装。

如果系统安全提示显示发布者或来源信息，应确认文件来自 download.deepseek.com。不要为了安装而关闭系统安全软件，也不要使用第三方重新打包的安装程序。

第三步：了解关闭窗口后的行为

Windows 版会在运行期间显示系统托盘图标。关闭主窗口时，应用通常只是隐藏到托盘，正在运行的任务不会因此中断；单击托盘图标可以重新打开窗口，右键菜单可以退出应用。

真正退出应用时，如果仍有运行中的 Agent、后台任务或已加载会话中的定时提醒，桌面端会提示可能产生的影响。需要结束进程时，应从托盘菜单选择退出，而不是只关闭主窗口。

第四步：可选安装 dsh 命令

在应用菜单中打开“管理 dsh 命令…”，可以把桌面版内置的 dsh 注册到当前用户的 PATH。安装后重新打开 PowerShell 或终端，并运行：

dsh --version

如果系统中已有其他 dsh 命令，管理界面会显示当前命令位置，并在切换前要求确认。桌面应用移动位置后，可从新位置使用“修复”重新注册。

首次启动后如何配置模型？

DeepSeek Harness 是 Agent 框架，不等于安装后自动获得不限量模型调用。首次使用需要选择登录方式或配置模型提供商。

使用 DeepSeek API 时，打开“设置 → 模型”，在 DeepSeek 卡片中输入 API Key 并保存。官方文档说明，保存后界面只收到脱敏描述符，不会重新显示明文密钥；凭据存放在本地 $DSH_HOME/.credentials.yaml，设置文件只保存凭据引用。

Harness 也支持添加第三方提供商和自定义模型 API。内置提供商目录包括 Anthropic、OpenAI、Moonshot AI、智谱等入口；自定义 API 可以选择以下三类协议：

  • OpenAI Chat Completions

  • OpenAI Responses

  • Anthropic Messages

配置自定义网关时，需要填写 Provider ID、Base URL、API 协议、API Key 和模型 ID。Provider ID 会被请求、会话、默认模型和凭据引用使用，创建后不适合随意更名。

完成模型配置后，创建新会话并选择模型。已经发出过请求的会话会保留日志中记录的模型，因此切换默认模型不会自动改写旧会话。

如何选择工作区并运行第一个任务？

工作区是 Harness 获准操作的本地目录。建议先创建一个专门的测试文件夹，放入可恢复的示例文档或代码，不要第一次就选择生产仓库、财务资料目录或整个用户主目录。

进入工作区后，可以发送一个范围清晰的任务，例如：

阅读当前目录中的 Markdown 文件，输出结构摘要。不要修改文件，也不要运行网络请求。

确认只读任务正常后，再逐步尝试写文件、运行测试或使用插件。涉及删除、移动、安装软件、发送消息和访问外部账号的操作，应逐项查看审批提示。

DeepSeek 官网列出的典型能力包括整理文档、分析表格、编写代码、安排定时任务和通过插件扩展 Agent。桌面版还能调用本地文件夹选择器、在侧栏预览文件，并让长任务在窗口隐藏后继续运行。

标准、PTC、极简和创造模式有什么区别？

DeepSeek Harness 官网介绍了四种运行模式：

模式

主要特点

适合场景

标准模式

提供文件、Shell、检索、Skills、计划、子 Agent 和工作流等完整工具

日常代码与复杂任务

PTC 模式

通过模型生成的 TypeScript 程序组合多步工具调用

多步骤自动化与工具编排

极简模式

仅保留 Shell 和文件编辑工具

模型基准测试、最小环境

创造模式

检查运行时、试验插件并创建 Agent preset

开发自定义 Harness

普通用户可以从标准模式开始。PTC 和创造模式对运行环境与权限的影响更大，适合已经理解工具调用、插件配置和工作区边界的开发者。

桌面版、Web UI 和源码安装怎么选？

方式

优点

局限

推荐对象

官方桌面版

安装简单，内置运行时，支持后台、托盘和本地交互

当前只公开 Windows x64 与 Apple 芯片 macOS 版

希望开箱使用的个人和团队

npm Web UI

一条 npx 命令即可启动，适合本机或 SSH 环境

需要安装 Node.js，生命周期由终端管理

Linux、服务器和开发环境用户

从源码运行

可检查源码、修改配置和参与开发

构建步骤多，版本变化快

插件作者和框架开发者

从源码运行的官方命令为：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

如果目标只是使用桌面 Agent，直接下载官方安装包更省事。如果需要在 Linux 服务器运行、通过 SSH 使用远端工作区，或者需要修改框架源码，再选择 Web UI 或源码方案。

插件、MCP 和本地能力如何使用？

DeepSeek Harness 采用“一切皆插件”的架构。模型、工具、技能、会话、沙箱、存储、调度和 UI 都可以由插件提供，并通过 Cordis 服务和事件协作。

桌面端插件管理器可以安装、配置、启用和停用插件。v0.2.0-rc.2 的内置 dsh 命令也可用于插件管理，无需单独安装 Node 或 pnpm。

MCP 用于连接外部工具和资源。官方版本已支持发现与读取 MCP 资源、使用 URI 模板，并提供实验性的 Playwright MCP、Chrome DevTools MCP 和 Stagehand 浏览器后端。接入 MCP 服务前，需要核对它能访问哪些文件、网络和账号，不要把来源不明的 MCP 配置直接导入含有敏感数据的工作区。

DeepSeek Harness 桌面版安全吗？

官方安全说明给出的结论很明确：DeepSeek Harness 仍是实验性的开发者预览软件，尚未接受安全审计，不应被视为安全或已经可以直接用于生产环境的软件。

它可以执行模型生成的代码和命令、加载第三方插件，并访问用户开放给它的网络、进程、凭据和文件。错误输出、软件缺陷、配置错误、恶意输入或不可信插件都可能造成文件修改或删除、数据泄露及其他非预期影响。

安装后至少应采取以下措施：

  1. 只选择完成当前任务所需的工作区，不授权整个磁盘；

  2. 首次运行使用可恢复的测试目录；

  3. 为 Harness 可访问的文件保留独立备份；

  4. 不在工作区中明文保存生产密钥和敏感数据；

  5. 安装插件前检查来源、权限和代码；

  6. 执行命令、删除文件和外部操作前阅读审批内容；

  7. 处理不可信文件或高风险任务时使用虚拟机、容器或专用设备。

沙箱、审批提示和权限控制可以降低风险，但官方说明强调，它们不能保证完全隔离，也无法保护已经授权给 Agent 的资源。

常见安装与使用问题怎么排查？

Mac 提示无法安装或打不开

先确认设备使用 Apple 芯片并运行 macOS 13 或更高版本，再确认 DMG 来自 DeepSeek 官方 CDN。Intel Mac 不在官网当前支持范围内。

Windows 关闭窗口后任务仍在运行

这是桌面端的后台运行设计。到系统托盘重新打开应用，或者从托盘菜单选择退出。退出前查看任务中断提示。

安装后找不到 dsh 命令

CLI 注册不是默认必需步骤。打开桌面应用菜单中的“管理 dsh 命令…”，选择安装或修复，然后重新打开终端运行 dsh --version。

模型列表为空或不能发送消息

打开“设置 → 模型”，确认已经保存 API Key 并选择模型。自定义网关还要核对 Base URL、协议类型和模型 ID。模型发现失败时，可以按照官方文档手动添加模型 ID。

自定义 OpenAI 兼容网关持续报错

部分网关不接受 developer 角色或 max_completion_tokens 字段。官方文档建议根据网关实际协议，在 profile 的 cordis.patch.yml 中调整兼容设置。不要在不清楚错误原因时反复更换 API Key。

更新后模型或插件失效

Harness 仍处于快速迭代阶段。v0.2.0-rc.2 的发布说明提到，第三方模型目录更新后，部分旧模型 ID 被移除，已经保存的选择可能需要重新选择。升级前应记录当前模型、插件和关键配置，并避免在重要任务执行过程中安装更新。

DeepSeek Harness 桌面版是否值得安装？

如果希望使用本地工作区、插件、MCP、后台任务和可观察的 Agent 执行过程，官方桌面版比从源码搭环境更方便。Windows 10 及以上或 Apple 芯片 Mac 用户，可以从官网下载后在测试目录中体验。

如果设备是 Intel Mac 或 Linux，当前更适合使用 npm Web UI；如果需要稳定生产环境、安全审计和严格兼容性保证，则应继续评估，因为官方仍将 Harness 定义为开发者预览软件。

下载时只认 DeepSeek 官方域名。安装完成后先查看“关于 DeepSeek Harness”确认实际版本，再配置模型、选择最小范围工作区并运行只读测试，确认权限和任务行为符合预期后，再逐步开放写文件、命令执行、插件和 MCP 能力。

官方参考资料

说明：本文信息核验于 2026 年 9 月 30 日。DeepSeek Harness 仍处于快速迭代阶段，安装包、系统要求、版本和功能可能更新，请以 DeepSeek 官网、应用内“关于”面板与官方仓库最新说明为准。