DSH Desktop 安装教程：DeepSeek Harness 桌面版图文全流程
以社区客户端 DSH Desktop 为例，从下载链接到首次启动逐屏截图：Windows 与 macOS 各走一遍。
最近更新: 2026-09-30
本站的安装教程都是把 harness 装到本机、再用浏览器打开它的 Web 界面——也就是说每次干活都得先开浏览器、敲地址。如果你觉得这一步多余，桌面客户端就是那条捷径：双击，同一套界面在独立窗口里打开。
这一页讲的是某一个具体客户端，不是泛泛的“dsh 桌面版”：DSH Desktop，MIT 许可证的社区项目，从 dshdesktop.cn 发布，也是我们收录的桌面客户端里星数最高的一个。下面每一张图都来自它在 Windows 和 macOS 上的真实安装录屏，安装器自己写出来的东西——文件名、版本号、向导页标题——都留在画面里，方便你和自己下载的文件逐字比对。
装完你会得到什么
- ▸不需要先装环境。课程讲义写明：当前正式安装包支持 Windows x64 和搭载 Apple 芯片的 macOS，普通用户不需要单独安装 Node.js、pnpm 或 DSH。
- ▸macOS 是拖拽安装：278.5 MB 的 universal DMG，把 DSH Desktop.app 拖进 Applications，第一次打开时由系统先验一遍。
- ▸Windows 是标准 NSIS 向导：140 MB 的 DSH-Desktop-2.0.0-x64-Setup-public.exe，选“仅为我安装”，目标文件夹保持默认，最后一页勾上运行 DSH Desktop。
二十一个步骤
先确认：装的是哪个客户端、从哪儿下
- 1
从下载表开始，不要从搜索结果开始
讲义的桌面 App 小节先给出插件地址，再列一张 平台 / 下载 / 安装方式 表：Windows x64 对应“运行 NSIS 安装程序并按提示完成安装”，macOS Apple Silicon 对应“打开 DMG，将 DSH Desktop 拖入 Applications”。表格上面那行正是大家最常问的：普通用户不需要单独安装 Node.js、pnpm 或 DSH。
https://www.dshdesktop.cn/api/downloads/windowshttps://www.dshdesktop.cn/api/downloads/mac
下载之前，讲义先把仓库地址和两条安装路径写清楚。看到 1:02 - 2
点下载之前，先把“即将离开飞书”那一页读完
讲义是一份飞书文档，所以每个外链都会先停在一张中转页上，而这张页会把真实目标地址原样打出来——macOS 这一条是 https://www.dshdesktop.cn/api/downloads/mac。这是你能拿到的最便宜的一次真伪校验：如果它写出来的域名不是项目自己的站点或 GitHub Releases，就别继续了。
中转页会把真实目标写出来——点“继续访问”前先读这一行。看到 1:08
macOS：拖进 Applications
- 3
看看真正下载到的是什么
macOS 拿到的是 DSH Desktop-2.0.1-universal.dmg——278.5 MB，种类是磁盘映像。文件名里的版本号就是你要装的版本，建议记下来：这期录屏 macOS 是 2.0.1、Windows 是 2.0.0，而项目一直在发补丁版本。如果这个位置出现的是 .zip、.exe，或者体积明显偏小，那就不是 macOS 正式包。
DSH Desktop-2.0.1-universal.dmg · 278.5 MB · 磁盘映像
文件名、大小、种类三项都说明这是 universal 的 macOS 正式包。看到 1:10 - 4
双击挂载，把 DSH Desktop.app 拖到 Applications
双击后挂载出的卷标是 DSH Desktop 2.0.1-universal，就是标准的拖拽布局：左边是应用，右边是 Applications 快捷方式。拖过去会弹出 正在将“DSH Desktop”拷贝到“应用程序”，总长度 725.4 MB——解开后的应用比 DMG 本身大，这是正常的。
拷贝总量 725.4 MB，比 DMG 本身大，属正常现象。看到 1:26 - 5
在启动台确认安装后的名字
启动台里它叫 DSH Desktop。这就是你在聚焦搜索里要输的名字，也是 DMG 标题、拷贝提示和 Windows 向导三方一致叫法。如果你装完出现的是别的名字，那你装的就不是它。
安装后的名字就是 DSH Desktop，聚焦搜索里也用它。看到 1:38 - 6
第一次打开，让 macOS 先验一遍
首次启动不会立刻出窗口：macOS 先弹出 正在验证 “DSH Desktop.app” …，确认这个文件是从哪里来的、能不能放行。等它走完再点“打开”。这一步是系统替你做你肉眼做不了的校验。
第一次打开，系统先校验完才让窗口出现。看到 1:44
Windows：NSIS 安装向导
- 7
Windows：保存文件时就地把文件名和说明看一遍
另存为对话框里的文件名是 DSH-Desktop-2.0.0-x64-Setup-public.exe；鼠标悬上去，不运行任何东西就能再读到三条事实：文件说明 “DSH Desktop: an Electron shell composed as a DeepSeek Harness Cordis plugin”、文件版本 2.0.0.0、大小 140 MB。它背后的中转页写的是 Windows 端点 https://www.dshdesktop.cn/api/downloads/windows。
DSH-Desktop-2.0.0-x64-Setup-public.exe · 140 MB · 文件版本 2.0.0.0
不运行任何东西就能读到三条身份信息：文件名、版本、说明。看到 2:20 - 8
双击运行，选“仅为我安装”
双击打开的是标题为 DSH Desktop 安装 的向导，第一张真正的页面是 安装选项 / 为哪位用户安装该应用？。选 仅为我安装——录屏里选中的就是 仅为我安装（22863）——除非这台机器真的多人共用。课程还特别提醒：装了 360 或电脑管家的话，它们可能拦住安装。讲师是提前退掉了安全软件，课程的建议是：如果你没退，就在确认过文件名和下载端点之后，自己决定继续，而不是让安全软件替你悄悄做决定。
不是多人共用的机器，就选“仅为我安装”。看到 2:32 - 9
目标文件夹保持默认，直接安装
文件夹这一页不需要你改什么，点 安装 等它跑完：正在安装 / DSH Desktop 正在安装，请稍候。绿色进度条走到底。向导每一页的左下角都印着正在安装的版本 DSH Desktop 2.0.0——这是除文件属性之外第二个能读到版本号的地方。
向导每一页的左下角都重复标注正在安装的版本。看到 2:56 - 10
勾上“运行 DSH Desktop”，点完成
最后一页写着 正在完成 DSH Desktop 安装向导 / DSH Desktop 已安装在你的系统，运行 DSH Desktop 已经勾上。点 完成 客户端立刻启动，安装和验证可以一次做完。
保留这个勾选，关掉向导的同时客户端就起来了。看到 3:04
首次启动
- 11
之前在 Web 界面配过，就直接落到工作界面
macOS 这一趟打开就是会话界面：左边是 新会话、工作区 列表、插件市场 和 设置，中间是空状态提示 选择一个工作区开始，macOS 菜单栏显示的应用名是 DSH Desktop。录屏里解释了为什么没有配置这一步：用网页版时已经填过 API 密钥，桌面客户端读的是同一份本机配置。
网页版配过的话，桌面版直接进同一套会话界面。看到 1:52 - 12
没配过，就在第一屏填一个 API Key
Windows 那一趟之前把配置删掉了，所以应用打开在 添加一个 API Key 开始使用 / 配置 DeepSeek 官方模型，即可开始使用。 上：一个 API 密钥 输入框，两个按钮 稍后配置 和 保存并继续。密钥从模型控制台的 API Key 页面复制后贴在这里——这也是安全清单最该起作用的一刻：一个客户端索要你从没配过的密钥，官方 harness 并不需要它这么做。
全新安装会先要一个密钥；Windows 的窗口标题栏写的是 DeepSeek Harness Desktop。看到 3:24
从零安装——Node.js + Web UI 路线
- 13
先看讲义的三步路线图
课程 p2 开场就把整条路线画在一张图上：准备 Node.js 环境、运行官方命令、配置模型 API 开始体验。这是不装安装包的另一条路——不走上面几组的 DSH Desktop 桌面应用，而是装好 Node.js、跑一条命令，把同一个 harness 以本地 Web UI 的形式拉起来。本组画面全部来自 Windows 实录。
讲义自己画的路线图：环境、命令、密钥，三步走完。看到 0:05 - 14
去 nodejs.org 拿对应系统的安装包
讲义指的就是 nodejs.org 官网。下载页当前提供 Node.js v24.19.0，macOS ARM64 和 Windows x64 都有预构建安装包，选和自己机器匹配的那个即可；已经在用版本管理工具的，走自己熟悉的那套就行。
https://nodejs.org/en/download
这条路线唯一的前置是 Node.js，按自己的系统下安装包。看到 0:45 - 15
运行安装器，勾掉许可协议
Windows 这趟装的是下载文件夹里的 node-v24.19.0-x64.msi，向导里唯一要停一下的就是 End-User License Agreement——勾选接受条款，其余默认一路到 Finish。macOS 的 .pkg 也是同样的下一步点完。
和 Node.js 装完之间，只隔一个许可协议勾选。看到 4:35 - 16
官方命令从 deepseek.com/harness 复制
官网落地页写着“一切皆插件”，一键使用标签页里就是那句 npx @deepseek-ai/dsh web。讲义的一键安装小节用红圈标了同样的两步——① 输入安装启动命令、② 输入y确认下载安装包——并注明 Mac 在终端、Windows 在 PowerShell 里执行。
https://www.deepseek.com/harness
命令以官网 Harness 页面为准，别从转载里抄。看到 5:38 - 17
执行命令，回一个 y
管理员 PowerShell 里，npx 下载前会先问一句：Need to install the following packages: @deepseek-ai/dsh@0.1.0-rc.6，Ok to proceed? (y)。回个 y 就开始拉包——这正是讲义红圈②指的那一下。
npx @deepseek-ai/dsh web
npx 下载前只问一次，一个 y 就开跑。看到 6:35 - 18
接住服务端打出的本地地址
装完时 PowerShell 打出 dsh web: http://127.0.0.1:3080。它不会自己开浏览器——把这个地址填进浏览器就行。窗口一关服务就停，再跑一遍同一条命令就能拉起来。
看到这一行，本地 harness 已经在服务了。看到 6:55 - 19
首次打开，先确认内容声明
Web UI 在 127.0.0.1:3080 的第一屏是内容声明对话框，说明这是开发者预览版——点确定进入工作区。从这里往后，它和桌面 App 内嵌的就是同一套 harness 界面。
一个确定，工作区就在后面。看到 8:40 - 20
去 DeepSeek 开放平台创建 API key
讲义第三步配置模型指向 platform.deepseek.com/api_keys：点创建 API key，起个名字，弹窗就返回全新的 sk- 密钥，旁边是复制按钮和保密提醒。密钥只贴进需要它的客户端，别处都不要去。
命名、创建、复制一次完成——之后只进需要它的客户端。看到 9:35 - 21
在用量信息页看余额和消耗
录屏里的账户：当前余额 ¥12.01、累计充值金额 ¥657.98，下方用量块是消息费用 ¥5.12、调用 400 次、19,321,218 Tokens，还有按天图表。小额余额就够起步——harness 到底花掉多少，看这一页就知道。
余额、累计充值、当天用量都在一页——跑完第一批调用就来看。看到 10:35
怎么确认你拿到的是真的安装包
桌面客户端同时碰得到你的文件系统和模型 API Key——正是假安装包最想要的两样东西。下面四项校验，上面的截图里都已经给出答案，一分钟做得完。
链接真正的落点
项目自己的下载端点是 https://www.dshdesktop.cn/api/downloads/windows 和 https://www.dshdesktop.cn/api/downloads/mac；dshdesktop.cn 正是本站收录的 anywhere-labs/dsh-desktop 条目上登记的官网。另一个我们认的来源是该仓库的 GitHub Releases。网盘镜像、“高速下载”按钮、群里传的安装包，都不算项目在说话，页面写得再像官方也不算。
文件名、版本号与文件说明
Windows 是 DSH-Desktop-<版本号>-x64-Setup-public.exe：录屏那一份报出 文件版本 2.0.0.0、大小 140 MB，文件说明是 “DSH Desktop: an Electron shell composed as a DeepSeek Harness Cordis plugin”。macOS 是 DSH Desktop-<版本号>-universal.dmg，278.5 MB。这几串字符读起来不花钱，但对重新打包的安装包来说很难对齐。
让操作系统做它那一半校验
macOS 会在首次打开 DSH Desktop.app 前先做一次验证。Windows 上 SmartScreen 或安全软件可能提示发布者陌生，课程也专门提到 360、电脑管家会拦安装。无论哪种，都请你自己判断：读清楚提示、确认文件来自上面那两个端点，再决定继续还是丢掉。
看项目自己怎么说
DSH Desktop 的 README 写明它是独立的社区开源项目，与深度求索不存在隶属、合作、授权或背书关系，内部原样运行固定版本的上游 Harness，桌面能力通过插件机制接入。任何把 dsh 桌面客户端说成 DeepSeek 官方桌面版的页面，讲的都是另一个东西——包括我们在对比页点名的那个 Microsoft Store 付费安装包。
还没决定装哪一个？对比页列出了我们能核实的每一个社区桌面客户端，以及同一份下载安全清单： DeepSeek Harness 桌面版：官方与社区的区别
桌面版去哪下载
搜「DeepSeek Harness 桌面版下载」出来的结果，正是仿冒安装包最爱待的地方——点任何东西之前先认官方渠道。点击前值得知道两件事（2026-09-30 核对）：
官方仓库是唯一的锚点
官方的一切都在 github.com/deepseek-ai/deepseek-harness——README、文档、讨论区和 Releases。发布说明里确实提到 macOS 和 Windows 桌面端（含「Manage dsh command」菜单项），但截至 2026-09-30，Releases 页面本身没有可下载的安装包附件；社区反馈（#8431）x64 包存在却没有下载入口。任何第三方「官方直链」都值得先怀疑一遍。
本页实测的社区客户端
上面步骤里实测安装的是 anywhere-labs 的 DSH Desktop（★29k+），社区桌面壳里星标最高的一款：macOS 给的是 universal DMG——一个包同时覆盖 Apple Silicon 和 Intel——Windows 则是 NSIS 安装器。它是社区维护、不是官方出品；下载入口走项目自己的分发页，本页第 1 步的截图拍下了当时用的确切 URL（dshdesktop.cn 的入口）。
不下载的路永远是官方路
觉得下载来路不对就跳过它：npx @deepseek-ai/dsh web 零安装包风险拿到完整 Web UI，CLI 用 npm 装也干干净净。拿不准的安装包先对照桌面应用指南里的客户端清单，再逐字母核对仓库名——仿冒者赌的就是文件名里出现「deepseek」你就放松警惕。
DSH Desktop 安装常见问题
双击安装包之前，大家最常问的几件事。
DSH Desktop 是 DeepSeek 官方桌面版吗？
不是。这期课程自己就说得很清楚：当前桌面版程序并不是官方提供的，而是社区第三方开发者提供的。项目 README 里也有同样的免责声明。dsh 官方的图形界面依然是用 dsh --profile web 启动的 Web UI。
装它之前要先装 Node.js、pnpm 或 dsh 命令行吗？
不用。讲义写明普通用户不需要单独安装 Node.js、pnpm 或 DSH，客户端运行需要的东西都打进安装包里了。这也是本页和本站命令行安装教程的区别：那条路线要你自己装运行环境。
为什么下载要先经过一页“即将离开飞书”？
因为课程讲义是飞书文档，飞书对每个外链都会插一张中转页。这张页反而有用：它把完整目标地址用明文写出来，你在任何文件开始下载之前就能看见自己要去的是 www.dshdesktop.cn。
macOS 一直在“正在验证”，窗口没出来，是出问题了吗？
这是从网上下载的 app 首次打开的正常表现：录屏里在窗口出现之前先有 正在验证 “DSH Desktop.app” …。等它走完再点“打开”。如果 macOS 直接拒绝，请回头确认文件来源，而不是硬闯过去。
360 或电脑管家拦住了 Windows 安装器，怎么办？
课程自己提到了这一点：国内 Windows 桌面上的安全软件会打断安装。讲师是提前把它们退掉了；如果你没退，课程的建议是在你已经核对过文件名和下载端点的前提下，自己把安装继续下去，而不是让安全软件替你默默决定。顺手选 仅为我安装、目标文件夹保持默认。
桌面版会沿用我在 Web 界面里配好的东西吗？
在这期录屏里是会的。macOS 那次直接进了会话界面，因为用网页版时已经填过 API 密钥；Windows 那次把之前的配置删了，同一个版本打开就变成了添加密钥那一屏。所以请把两者看成共用同一份本机配置，而不是两套独立账号。
相关教程
先挑客户端、或者干脆走命令行，又或者装完之后继续。
来源视频与署名
截图均取自下面链接的课时录屏，并裁掉了烧录字幕条与频道水印；窗口里的文字是安装器自己写的内容。讲解部分为归纳而非逐字转录，版本号、下载端点与许可证信息另经项目仓库核对。DSH Desktop 是社区项目，不是 DeepSeek 官方桌面版；本站收录的该项目档案页里，记有上文用到的许可证、版本与官网等信息： 本站的 DSH Desktop 项目档案