DeepSeek Harness官方桌面版下载与使用实测:下载、安装、避坑全流程

DeepSeek Harness 桌面版是 DeepSeek 官方仓库 deepseek-ai/deepseek-harness 中 apps/desktop 子项目的打包产物，基于 Electron 封装完整的 dsh Web 应用，官方安装包已经上线到 download.deepseek.com 域名下的腾讯云对象存储，macOS Apple Silicon 版为 382MB 的磁盘映像，Windows 64 位版为 322MB 的可执行安装包，两者均于 2026 年 9 月 24 日上传。本文给出经实测返回 200 的官方下载地址与安装步骤，同时提醒一个必须看懂的细节：当前产物文件名为 0.1.7-rc.1.20260924.1，按官方自己公布的版本规则，这个日期加序号的后缀标记的是测试版而非正式发布版，官方仓库中也仍无 desktop-v 开头的发布标签，配套的自动更新清单实测返回 404。文中同时说明桌面版已公布的关键设定：默认端口 19387、仅提供 macOS Apple Silicon 与 Windows x64 两种产物、自带 Python 与 Node 运行时并预装办公文档技能、独占 desktop 配置目录且与命令行共享会话数据但不共享可执行包。

官方下载地址

以下两个地址均托管在 DeepSeek 官方下载域名 download.deepseek.com 下，实测返回 HTTP 200，服务端标识为腾讯云对象存储，与官方文档所述的上传通道一致。

macOS（Apple Silicon）

https://download.deepseek.com/dsh-desk/bin/mac-arm64/deepseek-harness-0.1.7-rc.1.20260924.1-mac-arm64.dmg

Windows（64 位）

https://download.deepseek.com/dsh-desk/bin/win-x64/deepseek-harness-0.1.7-rc.1.20260924.1-win-x64.exe

实测到的产物信息如下，可用于下载完成后核对文件是否完整：

同目录下的 mac-arm64 压缩包同样返回 200，它是 Electron 自动更新机制使用的产物形态，手动安装用磁盘映像即可。

两个平台之外的产物实测均不存在：mac-x64 的磁盘映像返回 404，Linux 产物返回 404。这与官方文档一致，官方明确写明 Linux 不是受支持的桌面发布目标，打包命令只有 macOS arm64、macOS x64 和 Windows x64 三个，而当前实际上线的只有 arm64 与 win-x64 两种。使用 Intel 芯片 Mac 或 Linux 的读者，目前只能走后文的网页版方案。

装之前请先看懂这个版本号

当前产物的版本号是 0.1.7-rc.1.20260924.1，按官方公布的规则，末尾的日期加序号后缀标记的是测试版，不是正式发布版。

这一条值得单独拎出来说，因为它直接影响你的使用预期。官方在桌面版文档里给出了完整的版本推导规则：正式桌面版使用与 dsh 完全相同的版本号，包含 alpha、beta、rc 这类预发布标识；而测试版会保留完整的预发布基础版本号，并追加 .YYYYMMDD.index 后缀。官方给出的对照示例是这样的：

把 0.1.7-rc.1.20260924.1 对照第二行的模式，可以清楚看出它属于测试版一列，日期是 2026 年 9 月 24 日，当天序号为 1。

另外三条旁证指向同一结论。

其一，官方文档规定正式版上传会在产物公开后把打包提交标记为 desktop-v<版本号>。复核官方仓库的全部标签列表，desktop-v 前缀的标签数量为零，现有标签全部是 dsh-v 开头的命令行版本标签，最新为 dsh-v0.1.7-rc.2。

其二，自动更新清单不可用。官方文档提到固定的 Nightly 更新通道使用 nightly.yml 与 nightly-mac.yml 两个清单文件名，实测在 mac-arm64、win-x64、mac-x64 三个目录下请求这两个文件，均返回 404，响应内容是下载站的通用页面。这意味着装上之后大概率收不到自动更新，需要手动重新下载。

其三，dsh 命令行当前最新版是 0.1.7-rc.2，而桌面产物的基础版本是 0.1.7-rc.1，落后一个预发布号。官方把版本一致列为首要设计决策，正式发布时两者应当严格相同。

界面预览

主要特性

• 下载安装即用：应用内置 Node.js、Harness 运行时及所需依赖。
• 官方 Harness 界面：直接启动官方本地 Web UI，不维护独立的前端分支。
• 本地优先：Harness 服务仅监听 127.0.0.1，应用数据保存在操作系统的用户数据目录。
• 运行时更新：启动后及每 6 小时检查官方 @deepseek-ai/dsh npm 版本，验证成功后启用，失败时自动回退。
• 原生桌面外壳：macOS 提供独立标题栏、拖动区和原生红黄绿按钮；Windows 使用标准系统窗口；Linux 提供原生软件包。
• 官方源码同步：官方源码作为 upstream Git 子模块保留，可与桌面客户端独立更新。

工作原理

Electron 主进程
├── 在 127.0.0.1 启动内置 @deepseek-ai/dsh
├── 在安全隔离的 BrowserWindow 中打开官方 Harness Web UI
├── 将会话和设置保存到 macOS 用户数据目录
├── 退出应用时停止本地 Harness 进程
└── 从官方 npm 发布渠道检查并验证运行时更新

Electron 客户端版本与 Harness 运行时版本分别管理。更新 Harness 运行时不会替换 Electron 应用，安装包内置版本始终保留为回退版本。

项目结构

.
├── desktop/                 Electron 客户端与打包代码
├── upstream/                DeepSeek Harness 官方 Git 子模块
├── README.md                英文文档（默认）
├── README.zh-CN.md          简体中文文档
├── AGENT.md                 供开发 Agent 使用的维护说明
└── 更新官方源码.command       macOS 双击更新官方源码脚本

从源码构建

环境要求

• Apple 芯片或 Intel Mac、Windows x64 或 Linux x64 电脑
• Node.js 24 或更高版本
• npm
• Xcode Command Line Tools

构建步骤

git clone --recurse-submodules git@github.com:huangj17/deepseek-harness-desktop.git
cd deepseek-harness-desktop/desktop
npm ci
npm run check

在对应的目标系统上构建：

# Apple 芯片 macOS
npm run dist:mac:arm64

# Intel macOS
npm run dist:mac:x64

# Windows x64 安装程序与便携 ZIP
npm run dist:win

# Linux x64 AppImage 与 deb
npm run dist:linux

构建完成的软件包位于 desktop/dist/。带版本标签的发布会在 GitHub 原生 macOS、Windows 和 Linux 构建机上自动打包、冒烟测试、生成校验值并发布。

常用验证命令：

npm run check
npm run smoke:runtime
npm run smoke:updater
npm run smoke:packaged

部分测试会打开本地端口或访问官方 npm 仓库，可能需要 macOS 权限或网络访问。

所以准确的说法是：这是官方构建、官方域名分发的真实产物，可以装、可以用，但它是一个测试构建，不是正式发布版。官方已知限制清单里还写着账号登录尚未接通、登录按钮处于禁用状态，以及 Windows 材质渲染仍需平台质量验证。请按体验预览版的心态使用，不要放到生产环境依赖。

最新评论