安装与环境准备
本教程共 32 篇 · 第 2 篇 · 更新于 2026-08-15 · 约 5 分钟阅读
本节目标：把 DeepSeek Harness 装到你的电脑上，学会验证版本和升级。装完你能用一行命令把它跑起来。
安装前先检查环境
dsh 是 Node.js 应用，官方对 Node 版本有硬性要求（仓库 package.json 的 engines 字段实测）：
- Node.js
^22.19.0 || >=24.0.0，即 22.19 及以上，或 24 及以上
先看本机版本：
node -v输出类似 v22.23.1 或 v24.5.0 就满足要求。如果没装，去 nodejs.org 下载对应系统的安装包（Windows 用 .msi，macOS 用 .pkg），一路默认安装即可。想管理多个版本，可以装 nvm（macOS/Linux）或 nvm-windows。
Warning版本低于 22.19 的 Node 20.x 不建议硬跑，安装或构建时大概率会直接报 engines 校验错误。
其它准备项：
- pnpm：只有源码构建需要，
npm install -g pnpm即可安装 - 网络：首次运行要从 npm 拉取依赖，国内网络慢可配镜像（见文末）
- API Key：启动后需要在界面里配置 DeepSeek API Key，这一步第 3 章做，现在不用急
方式一：npx 一行运行（推荐新手）
不需要先安装任何东西，直接执行：
npx @deepseek-ai/dsh webnpx 是 npm 自带的命令，它会在需要时临时下载 @deepseek-ai/dsh 并运行，用完不占全局空间。首次运行会下载依赖，可能要等一两分钟，按提示确认（输入 y）即可。
启动成功后，终端会打印访问地址——默认是 http://127.0.0.1:3080。浏览器打开这个地址，看到 DeepSeek Harness 的界面就算装好了。
Tipdsh 会把调用命令时所在的目录作为默认文件系统位置。建议先
cd到你的项目目录，再执行启动命令，这样后面选工作区最方便。
方式二：源码构建（适合二次开发）
想读源码、开发插件或参与贡献，就从 GitHub 克隆仓库构建：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install # 安装依赖
pnpm run build # 构建包与前端产物，生产运行必需
pnpm dsh web # 以源码方式启动 Web UI这里有个新手容易看漏的点：pnpm run build 不能省。官方 CLI 文档明确说生产运行需要构建后的包和前端产物，跳过 build 直接启动会报模块解析错误。
从源码运行时，命令入口是 pnpm dsh，后面跟的参数和 dsh 完全一样：
pnpm dsh web # 启动 Web UI
pnpm dsh --profile headless "run the tests" # 一次性运行任务
pnpm dsh --profile web --dump-config # 查看实际配置树Note源码仓库的
packageManager字段锁定 pnpm@11.7.0。装好 pnpm 后一般无需额外配置，版本差异过大时按提示处理。
验证安装：dsh —version
安装完成后，确认版本号：
npx @deepseek-ai/dsh --version输出类似 0.1.0-rc.6。这就是 dsh 启动器（launcher）自身的版本。本教程的版本基线是 @deepseek-ai/dsh 0.1.0-rc.6（npm latest，2026-08-13 发布）。
Note项目处于 Developer Preview 阶段，版本号会快速变化。教程里的命令如果跑出来行为不一样，先执行
npx @deepseek-ai/dsh --version确认你拿到的是不是最新版，以实测为准。
升级方式
不同安装方式，升级方法不同。
npx 方式：npx 每次运行都会检查 npm 上的最新版，一般重新执行命令就自动用新版。想强制拉取最新版，显式指定标签：
npx @deepseek-ai/dsh@latest web如果 npx 缓存了旧包导致版本不更新，清一次缓存再试：
npm cache clean --force源码方式：拉取最新代码后重新构建：
git pull
pnpm install
pnpm run buildWarningrc 阶段可能随时有破坏性兼容变更。升级前先看仓库的 Release 说明或 changelog，别在重要项目目录里盲目升级。
常见安装问题
| 问题 | 排查方法 |
|---|---|
报 engines 错误，要求 Node ^22.19.0 || >=24.0.0 | Node 版本太低，升级到 22.19+ 或 24+ |
npx 找不到 @deepseek-ai/dsh | 确认网络正常；清 npx/npm 缓存后重试；必要时换源码安装 |
| 下载依赖很慢或超时 | 给 npm 配国内镜像：npm config set registry https://registry.npmmirror.com，pnpm 同理 |
| 提示 pnpm 不是内部或外部命令 | 先 npm install -g pnpm，再重新打开终端 |
pnpm install 或 pnpm run build 失败 | 优先检查 Node 版本是否满足 engines；网络受限时配置镜像；删除 node_modules 重装 |
启动后浏览器打不开 http://127.0.0.1:3080 | 终端进程可能已退出（关窗口会停服务）；端口被占用时换端口：dsh web --port 8080 |
TipWindows 用户如果公司电脑限制了 npm 安装权限，用管理员身份打开 PowerShell 再跑命令。日常使用在项目目录里建一个独立练习文件夹当工作区，别一上来就在正式项目上试。
小结
环境就绪的标准：node -v 满足 22.19+ 或 24+，npx @deepseek-ai/dsh --version 能打印出版本号。
新手走 npx 一行命令，二次开发走源码构建。版本确认用 dsh --version，升级按安装方式对应操作。下一章，启动 Web 界面，完成第一次对话。