DeepSeek Harness 的命令行入口 dsh 是一个 Node.js 工具，靠 npx 临时拉取运行，所以上手第一件事是把 Node 环境装对。
为什么需要 Node
npx @deepseek-ai/dsh web 这条命令背后，是 Node 在帮你下载并启动一个本地服务。没有 Node，后面所有命令都跑不起来。
安装步骤
- Windows：去 nodejs.org 下载 LTS 版（建议 20.x 或 22.x），一路下一步装完即可。
- macOS：用 Homebrew 最省事，终端执行
brew install node；或官网下载 pkg 安装包。
验证安装
node -v
npm -v
npx -v三个命令都能输出版本号，就说明环境 OK。Harness 要求 Node >= 18。
第一次试跑
npx @deepseek-ai/dsh web浏览器会自动打开本地 Web UI。看到界面，说明环境打通了。
新手常踩的坑
| 现象 | 原因 | 解决 |
|---|---|---|
| npx 卡住不动 | 默认源在国外 | 换国内镜像：npm config set registry https://registry.npmmirror.com |
| 提示 permission denied | 没写权限 | macOS 加 sudo；或装 nvm 避免全局权限问题 |
| 命令找不到 | 没装 Node | 回到第一步重装 |
本文基于 DeepSeek Harness v0.1 开发者预览版撰写。项目处于快速演进期，命令、目录与配置项可能有变动，一切以 官方仓库 最新文档为准。