在 macOS 上安装 DeepSeek Harness

下载并打开 DSH Desktop，配置 DeepSeek 模型，再用空文件夹检查连接。桌面安装包已包含运行环境。

本页内容

macOS 最短安装路径

下载 macOS 版 DSH Desktop，打开应用，配置模型，再选择一个空的测试文件夹。安装包已经包含运行环境。

安装前准备：官方 Mac 桌面预览安装包仅适用于 Apple 芯片；Intel Mac 请看下方命令行安装。准备可联网的电脑和 DeepSeek API Key。

完成标准：DSH 能打开，模型选择器显示可用模型，并且一条只读测试消息能返回 dsh-test 工作区且没有报错。

安装 DSH 不附带 API 调用额度。

第 1 步

下载并安装 macOS 桌面版

官方预览 DMG 仅适用于 Apple 芯片 Mac，Intel Mac 请使用本页命令行路径。下载完成后再打开文件。

Apple 芯片 Mac 打开 DMG，把 DeepSeek Harness 拖入 Applications（应用程序）后启动。Intel Mac 请使用下方命令行安装方式。

第 2 步

打开官方 DeepSeek Harness Desktop，按应用内首次启动提示完成设置。模型 API Key 在下一步配置。

检查启动结果

能看到 DSH 对话主界面。应用打不开或闪退时，查看桌面端排错。

第 3 步

API Key 是 DSH 调用 DeepSeek 时使用的密钥。没有的话，先到 DeepSeek API Keys 创建。

回到 DSH，打开设置（Settings）→ 模型（Models）→ DeepSeek，粘贴 API Key 并保存。随后打开模型选择器，选中 DeepSeek 下可用的模型。

不要把真实 API Key 放进截图、代码仓库或公开的求助消息。API 余额不足时，即使保存了 Key，也无法完成请求。

检查模型选择

模型选择器显示已选模型的名称，而不是 Select model。

第 4 步

在访达中新建空文件夹 dsh-test。回到 DSH，点击选择工作区（Choose workspace），添加并选中这个文件夹。第一次不要选重要项目。

检查工作区

界面显示已选中的 dsh-test。如果输入框仍是灰色，检查工作区和模型是否都已选中。

第 5 步

复制下面这句话发给 DSH：

请使用工具读取当前工作区的完整路径，并列出这个文件夹里的文件。不要创建、修改或删除任何文件。

检查测试结果

模型正常回复，工具返回的路径与 dsh-test 完整路径一致，文件列表也与电脑上的文件夹一致。仅在回答中出现文件夹名称，还不能确认工具读取成功。

检查通过后，可以继续创建第一个文本文件。如果请求失败，按下面的症状排查。

这与桌面安装包是两种独立的启动方式。已经打开 DSH Desktop 的用户，不需要再执行以下命令。

打开 Node.js 下载页，选择 Node 24 LTS 和当前操作系统的安装包。运行 macOS Installer（.pkg）。安装完成后重新打开终端。
按 Command + Space，输入 Terminal，然后按 Return。
运行 node --version 和 npm --version。对于 v0.2.2-alpha.2，Node 需不低于 24.9.0；旧版请核对对应包的要求。
运行 npx @deepseek-ai/dsh web。
首次运行可能需要下载 DSH。如果出现 Ok to proceed?，核对包名后输入 y。浏览器未自动打开时，复制终端打印的完整地址（包括可能附带的访问令牌）。默认本机端口是 3080。
保持终端运行，从配置 API Key继续。结束使用后，在终端按 Ctrl+C 停止服务。