DeepSeek Harness 开发者预览版安装全流程实战（避坑指南：C盘爆满 + Node版本报错）
DeepSeek Harness 开发者预览版安装全流程实战（避坑指南：C盘爆满 + Node版本报错）
DeepSeek Harness 开发者预览版已开放。官方号称"一切皆插件"，最近热度很高。但很多人在安装第一步就卡住了——下载慢、C盘空间不足、Node版本报错。本文基于实测，完整记录一次"从零到启动"的安装流程，并解决两个最常见的坑。
目录
- 一、先搞清楚：Harness 不是下载安装包，是 npm 工具
- 二、坑1：下载慢 + C盘爆满
- 三、坑2：Node 版本太老直接启动失败
- 四、完整安装流程（可直接复制）
- 五、启动与验证
- 六、常见问题 FAQ
一、先搞清楚：Harness 不是下载安装包，是 npm 工具
DeepSeek Harness 官方页面提供了两种安装方式：
- 快速体验：
npx @deepseek-ai/dsh web（基于 Node.js） - 源码安装：
git clone https://github.com/deepseek-ai/deepseek-harness
它没有.exe/.msi安装包，本质是一个 Node.js 生态下的 npm 包。这意味着：
- 真正"下载"东西的是 npm，下载到哪里、速度快不快，全由 npm 配置决定；
- 它依赖比较重的运行时环境（Node 版本要求高，依赖很多）。
理解了这一点，下面两个坑就都清楚了。
二、坑1：下载慢 + C盘爆满
npm 默认会把文件下载到 C 盘的两个位置：
| 用途 | 默认路径 | 说明 |
|---|---|---|
| 缓存（大头） | C:\Users\<用户名>\AppData\Local\npm-cache | 几百 MB，依赖越多越大 |
| 全局包 / npx 缓存 | C:\Users\<用户名>\AppData\Roaming\npm | dsh命令就装在这 |
解决办法：把这两个位置都挪到其他盘（比如 F 盘），并把 npm 源换成国内镜像加速。
:: 1. 缓存挪到 F 盘 npm config set cache "F:\npm-cache" :: 2. 全局包挪到 F 盘 npm config set prefix "F:\npm-global" :: 3. 换国内镜像源（下载提速，解决"下载慢"） npm config set registry https://registry.npmmirror.com说明：
npm config set会写入用户级.npmrc配置，永久生效。之后所有 npm / npx 下载都会走 F 盘 + 国内镜像。
三、坑2：Node 版本太老直接启动失败
Harness 的依赖链要求Node >= 22.12.0（部分依赖甚至要求>=22.19.0）。
如果 Node 版本太低（比如常见的 v18），执行npx @deepseek-ai/dsh web时会出现两种症状：
症状A：刷屏的 EBADENGINE 警告
npm warn EBADENGINE Unsupported engine { npm warn EBADENGINE package: 'sharp@0.35.3', npm warn EBADENGINE required: { node: '>=20.9.0' }, npm warn EBADENGINE current: { node: 'v18.20.8' } npm warn EBADENGINE }症状B：启动直接报错崩溃
file:///C:/Users/xxx/AppData/Local/npm-cache/_npx/xxx/node_modules/@deepseek-ai/dsh-app-boot/lib/index.js:4 import { parseEnv } from "node:util"; ^^^^^^^^ SyntaxError: The requested module 'node:util' does not provide an export named 'parseEnv'
parseEnv是 Node 20 才加入的 API。报这个错 = 版本太老，不是下载没完成，别傻等。
解决办法：升级 Node 到 22 LTS 或更高（推荐最新 LTS）。
最简单的方式是命令行一键升级：
winget install OpenJS.NodeJS.LTS装完关掉当前终端、重新打开（让 PATH 刷新），再验证版本：
node -v确认输出是v22.x或更高（比如v24.19.0）即成功。
如果
node -v还是老版本，说明系统里残留了旧 Node，需要手动清理：卸载旧版本，并把环境变量里的旧路径删掉，只保留新版本路径。
四、完整安装流程（可直接复制）
以下是从零开始的完整流程，按顺序执行即可：
:: ========== 第 1 步：检查当前 Node 版本（<22 必须先升级） ========== node -v :: ========== 第 2 步：升级 Node 到最新 LTS（用 winget） ========== winget install OpenJS.NodeJS.LTS :: 装完务必关闭终端重开，让 PATH 生效 node -v :: 确认 >= v22 :: ========== 第 3 步：npm 缓存和全局包挪到 F 盘（解决 C 盘爆满） ========== npm config set cache "F:\npm-cache" npm config set prefix "F:\npm-global" :: ========== 第 4 步：换国内镜像源（解决下载慢） ========== npm config set registry https://registry.npmmirror.com :: ========== 第 5 步：启动 Harness Web UI ========== npx @deepseek-ai/dsh web结果如下：
五、启动与验证
执行到最后一步，看到类似输出：
dsh web: http://127.0.0.1:3080说明启动成功。用浏览器打开http://127.0.0.1:3080即可进入 DeepSeek Harness Web 界面,输入api 即可使用。
注意事项：
- 终端窗口要保持开着，关掉终端 = 服务停止；
- 下次启动直接再执行
npx @deepseek-ai/dsh web即可，由于缓存已在 F 盘，会秒启动、无需重新下载； - 停止服务：在终端里按
Ctrl + C。
六、常见问题 FAQ
Q1：为什么我执行 npx 后提示 "Need to install the following packages: @deepseek-ai/dsh@0.1.0-rc.6"？
正常现象。npx 首次运行需要下载并临时安装该包，输入y回车继续即可。下载位置受npm config set cache控制，已配置到 F 盘的话不会占用 C 盘。
Q2：一堆 EBADENGINE 警告要管吗？
如果你的 Node 版本符合要求（>=22.12），这些只是警告、不影响运行。若 Node 版本太老，则会伴随启动报错，必须升级 Node。
Q3：升级 Node 后node -v还是旧版本？
通常是旧 Node 没卸载干净或环境变量残留。检查系统环境变量 PATH，把旧版本 Node 的安装路径删掉，只保留新版路径。
Q4：端口 3080 打不开 / 被占用？
检查终端是否还开着、是否输出了http://127.0.0.1:3080。若端口被占用，杀掉占用进程或查看官方文档是否有端口参数配置。
Q5：C 盘已经塞了很多 npm 缓存，怎么清理？
:: 查看缓存位置和大小 npm config get cache :: 清空缓存 npm cache clean --force建议清空后重新执行第 3 步配置，这样之后缓存都落在 F 盘。
小结
DeepSeek Harness 安装本质上就三步：
- Node 升到 22+（解决版本报错）
- npm 缓存/全局包挪到非系统盘（解决 C 盘爆满）
- 换国内镜像源 + 启动（解决下载慢）
祝大家玩得愉快。如果文章对你有帮助，欢迎点赞收藏，评论区交流遇到的问题。
环境参考：Windows 11（10.0.26200），Node v24.19.0，npm 10.x