首页›教程

在 macOS 上安装 DeepSeek Harness

安装兼容的 Node.js，启动本地 DSH Web UI，连接 DeepSeek，并在可丢弃文件夹中测试一次文件改动。

本页内容

开发者预览

DSH 可能随版本变化。如果本页与当前产品不一致，请以页面底部链接的官方仓库和文档为准。

开始前

需要 macOS、网络连接和 DeepSeek 账号。npm 快速启动不要求安装 Git。当前上游 DSH 的 Node engine 为 ^22.19.0 || >=24.0.0。

第 1 步

安装兼容的 Node.js

打开 Node.js 官方下载页，选择适用于 macOS 且满足当前 DSH ^22.19.0 || >=24.0.0 要求的版本，然后运行安装程序。

SCREEN GUIDE · 安装 Node.js

https://nodejs.org/en/download

安装 Node.js

查看当前 DSH Node engine

下载 macOS 安装程序

运行安装程序

不要只看“Node 22/24”大版本；npm 报 engine 错误时应核对完整版本范围。

第 2 步

打开终端

按 Command + Space，输入 Terminal，然后按 Return。

SCREEN GUIDE · 打开终端

打开终端

1按 Command + Space

2输入 Terminal

3按 Return

4等待 Shell 提示符

本指南使用系统内置 Terminal 即可。

第 3 步

核验 Node.js 与 npm

node --version

npm --version

两个命令都应输出版本号。把 Node 版本与当前 DSH 要求 ^22.19.0 || >=24.0.0 对照；“已经是 Node 22”并不代表 22.19 以前的小版本一定可用。

SCREEN GUIDE · 核验 Node.js

MacBook:~ you$ node --version
满足 ^22.19.0 或 >=24.0.0
MacBook:~ you$ npm --version
XX.X.X

DSH 的 engine 可能随版本更新；出现 engine 报错时以当前上游 package.json 为准。

第 4 步

启动 DeepSeek Harness

npx @deepseek-ai/dsh web

第一次启动可能更慢

npx 可能需要先下载 DSH 包。如果终端还没有明确报错，请保持窗口打开，等待 Web UI 地址或真正的 npm/网络错误。不要在等待期间连续启动多个 DSH。

使用 DSH 时保持这个终端进程运行；关闭进程会停止本地 Web UI。

SCREEN GUIDE · 启动 DSH

MacBook:~ you$ npx @deepseek-ai/dsh web
... DSH 下载/启动 ...
Web UI: http://127.0.0.1:3080

启动输出与首次启动时间可能变化，真正需要关注的是最终 URL 或准确错误码。

第 5 步

打开本地 Web UI

http://127.0.0.1:3080

本机正常启动时，DSH 通常会自动打开默认浏览器。如果没有自动打开，请手动打开终端实际打印的地址。若终端先出现 EADDRINUSE 或 EACCES，先解决端口问题。

SCREEN GUIDE · 打开 DSH

http://127.0.0.1:3080

打开 DSH

先看 DSH 是否已自动打开浏览器

没有打开时手动进入终端打印地址

保持 DSH 终端运行

页面失败时查看准确错误码

通过 SSH 启动时不自动开浏览器属于正常行为。

第 6 步

获取 DeepSeek API Key

打开 DeepSeek API Keys，登录后创建或复制一个 Key。

妥善保管 Key

不要把真实 API Key 放入截图、代码仓库、Prompt 或公开支持信息。

SCREEN GUIDE · DeepSeek API Keys

https://platform.deepseek.com/api_keys

DeepSeek API Keys

创建或复制 API Key

返回 DSH

DeepSeek 账号界面可能独立于 DSH 发生变化。

第 7 步

配置 DeepSeek

在 DSH 中打开 Settings → Models，把 API Key 粘贴到 DeepSeek 服务商卡片并保存。保存后下一次请求即可使用，不需要为此重启 DSH。

DeepSeek Harness 官方 Models 设置页 — 来自 DeepSeek Harness 模型配置文档的官方截图。

第 8 步

选择测试工作区

mkdir -p ~/dsh-test

在 DSH 中点击 Choose workspace，选择 ~/dsh-test。启动命令所在目录不会自动成为已选工作区，首次会话请明确选中可丢弃文件夹。

SCREEN GUIDE · 选择工作区

选择工作区

1点击 Choose workspace

2添加 ~/dsh-test

3选择该文件夹

4确认输入区可用

不要从重要仓库或包含敏感信息的文件夹开始。

第 9 步

运行首次任务

在这个工作区创建 README.md，内容为“Hello from DeepSeek Harness”。然后总结你做了什么改动。

SCREEN GUIDE · 首次会话

http://127.0.0.1:3080

首次会话

创建新会话

选择已配置模型

发送 Prompt

接受前阅读每项授权请求

检查 ~/dsh-test 中的 README.md

请在工作区中直接核验文件，不要只依赖聊天回答。

macOS 常见错误

node 或 npm 找不到

关闭 Terminal 后重新打开。如果仍然失败，请重新安装或修复 Node.js。

npm 提示 Node engine 不兼容

运行 node --version，并与当前上游要求 ^22.19.0 || >=24.0.0 对照。

npx 首次启动看起来停住

如果终端还没有明确报错，请保持窗口打开。第一次运行可能正在下载 DSH 包。

EADDRINUSE：3080 已被占用

运行 lsof -nP -iTCP:3080 -sTCP:LISTEN 找到监听进程，停止旧进程，或使用 --port 13080 启动。

MISSING_CREDENTIAL

打开 Settings → Models，重新保存 DeepSeek API Key。

查看完整问题排查步骤 →

从源码运行 DSH

仅当你要参与 DeepSeek Harness 仓库开发时才使用下面的方式。当前上游还要求 pnpm，并使用同样的 Node engine 范围。

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

下一步使用 DSH Web UI

继续 →

来源

DeepSeek Harness 仓库 · 当前 Node engine · CLI 行为参考 · Node.js 下载页