发布日期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 官网下载不建议使用网盘转载、第三方打包站或来历不明的“绿色版”。官方入口如下产品介绍页https://www.deepseek.com/harness/官方下载页https://www.deepseek.com/download/macOS Apple 芯片版https://download.deepseek.com/desktop/dsh-latest-macos-arm64.dmgWindows 64 位版https://download.deepseek.com/desktop/dsh-latest-windows-x64.exe官方开源仓库https://github.com/deepseek-ai/deepseek-harness桌面端中文文档https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.zh.md截至 2026 年 9 月 30 日官方 CDN 返回的 macOS 安装包约 353 MBWindows 安装包约 276 MB。两个地址中的文件名都带有latest表示它们会随官方更新指向新版本不是永久固定到某个版本的归档链接。官方 GitHub 仓库同期最新预发布标签为dsh-v0.2.0-rc.2发布时间为 2026 年 9 月 29 日。桌面端package.json也标记为0.2.0-rc.2。由于官网安装包使用动态链接安装后应打开应用菜单中的“关于 DeepSeek Harness”查看实际版本不要只根据下载链接名称判断版本。支持哪些操作系统平台官网公开要求安装文件当前公开状态macOSApple 芯片macOS 13 或更高版本.dmg官方提供下载Windows64 位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 CompletionsOpenAI ResponsesAnthropic 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、服务器和开发环境用户从源码运行可检查源码、修改配置和参与开发构建步骤多版本变化快插件作者和框架开发者从源码运行的官方命令为gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh 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 仍是实验性的开发者预览软件尚未接受安全审计不应被视为安全或已经可以直接用于生产环境的软件。它可以执行模型生成的代码和命令、加载第三方插件并访问用户开放给它的网络、进程、凭据和文件。错误输出、软件缺陷、配置错误、恶意输入或不可信插件都可能造成文件修改或删除、数据泄露及其他非预期影响。安装后至少应采取以下措施只选择完成当前任务所需的工作区不授权整个磁盘首次运行使用可恢复的测试目录为 Harness 可访问的文件保留独立备份不在工作区中明文保存生产密钥和敏感数据安装插件前检查来源、权限和代码执行命令、删除文件和外部操作前阅读审批内容处理不可信文件或高风险任务时使用虚拟机、容器或专用设备。沙箱、审批提示和权限控制可以降低风险但官方说明强调它们不能保证完全隔离也无法保护已经授权给 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 能力。官方参考资料DeepSeek Harness 产品页https://www.deepseek.com/harness/DeepSeek 官方下载页https://www.deepseek.com/download/DeepSeek Harness GitHub 仓库https://github.com/deepseek-ai/deepseek-harness桌面端中文文档https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.zh.md中文根 READMEhttps://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md模型配置指南https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/providers.zh.md官方安全说明https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.zh.mdv0.2.0-rc.2发布说明https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.0-rc.2七牛云 Token Plan 官方页面deepseek最低1.2折https://www.qiniu.com/ai/plan说明本文信息核验于 2026 年 9 月 30 日。DeepSeek Harness 仍处于快速迭代阶段安装包、系统要求、版本和功能可能更新请以 DeepSeek 官网、应用内“关于”面板与官方仓库最新说明为准。