使用 npx 安装 DeepSeek Harness
适用于命令行安装。先检查 Node.js 版本，再运行启动命令，最后配置模型和工作区。已使用 DSH Desktop 的用户不需要再执行这套安装步骤。
本页内容
使用 npx 运行 DeepSeek Harness
npx @deepseek-ai/dsh web这条官方快速启动命令会运行本地 DeepSeek Harness Web UI。使用期间保持终端打开，结束后按 Ctrl+C 停止服务。
需要准备什么
从 Node.js 官方下载页选择 Node 24 LTS，安装后重新打开终端。使用 v0.2.2-alpha.2 时，Node 需不低于 24.9.0；其他版本请核对对应包的要求。具体安装操作见对应系统教程。
检查当前终端实际使用的 Node.js 与 npm：
node --versionnpm --version历史源码快照声明 ^22.19.0 || >=24.0.0；v0.2.2-alpha.2 提高至 >=24.9.0。新安装建议使用 Node 24.9 或以上，并核对所选 DSH 版本。
使用 npm 快速启动不需要克隆 GitHub 仓库，也不需要运行 pnpm install。
还需要准备所选模型服务商的 API Key 和可用额度。使用 DeepSeek 时，见API 配置指南。
命令启动后会发生什么？
DSH 会启动本地 Web UI。官方默认地址是：
http://127.0.0.1:3080如果终端打印了其他地址，以实际输出为准。本地启动通常会自动打开浏览器；使用 npx @deepseek-ai/dsh web --no-open 可只启动服务。
页面打开只说明 Web 服务已启动。首次发送请求前，还需在 Settings → Models 保存服务商凭证、选中模型，并添加和选择测试工作区。随后按首次 Web UI 任务指南核验结果。
常见错误
系统无法识别 node、npm 或 npx
安装 Node.js，重新打开终端，再运行版本检查。
EBADENGINE 或 Node.js 版本不受支持
将 node --version 与上面的范围对照。切换到受支持版本，重新打开终端并再次检查，然后重启 DSH。
127.0.0.1:3080 无法打开
先检查终端。如果 DSH 进程已经退出，请在重试前阅读最后一条错误信息。遇到 EADDRINUSE、EACCES 或连接失败时，查看启动排查指南。
相关教程
官方快速启动说明、已核验源码快照中的 Node.js 版本范围。选择其他 DSH 版本时，请重新确认该版本的软件包要求。