首页›教程

在 Windows 上安装 DeepSeek Harness

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

本页内容

开发者预览

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

开始前

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

第 1 步

安装兼容的 Node.js

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

SCREEN GUIDE · 安装 Node.js

https://nodejs.org/en/download

安装 Node.js

查看当前 DSH Node engine

下载 Windows 安装程序

运行安装程序

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

第 2 步

打开终端

按 Windows 键，输入 Terminal 并打开 Windows Terminal，然后使用 PowerShell 标签页。

SCREEN GUIDE · 打开终端

打开终端

1按 Windows 键

2输入 Terminal

3打开 Windows Terminal

4使用 PowerShell

这些命令也可以在 Windows PowerShell 中运行。

第 3 步

核验 Node.js 与 npm

node --version

npm --version

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

SCREEN GUIDE · 核验 Node.js

PS C:\Users\YourName> node --version
满足 ^22.19.0 或 >=24.0.0
PS C:\Users\YourName> 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

PS C:\Users\YourName> 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 C:\dsh-test

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

SCREEN GUIDE · 选择工作区

选择工作区

1点击 Choose workspace

2添加 C:\dsh-test

3选择该文件夹

4确认输入区可用

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

第 9 步

运行首次任务

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

SCREEN GUIDE · 首次会话

http://127.0.0.1:3080

首次会话

创建新会话

选择已配置模型

发送 Prompt

接受前阅读每项授权请求

检查 C:\dsh-test 中的 README.md

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

Windows 常见错误

node 或 npm 无法识别

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

npm 提示 Node engine 不兼容

运行 node --version，并与当前上游要求 ^22.19.0 || >=24.0.0 对照。Node 22 的小版本如果低于 22.19 仍然不满足要求。

npx 首次启动看起来停住

如果终端还没有明确报错，请保持窗口打开。第一次运行可能正在下载 DSH 包；不要在等待时再启动第二个 DSH。

EADDRINUSE：3080 已被占用

在 PowerShell 运行 Get-NetTCPConnection -LocalPort 3080 -State Listen。停止旧进程，或用 npx @deepseek-ai/dsh web --port 13080 临时换端口。

EACCES：3080 无监听进程仍无法绑定

Hyper-V、WSL2 或 Docker Desktop 可能保留包含 3080 的 TCP 范围。运行 netsh interface ipv4 show excludedportrange protocol=tcp；如果命中排除范围，选择范围外端口，例如 13080。

MISSING_CREDENTIAL

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

UNKNOWN_MODEL

选择当前已存在于所配置服务商下的模型。

查看完整问题排查步骤 →

从源码运行 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 下载页