DSH 提示 Node 版本不支持或 npx 找不到怎么办

直接答案

DeepSeek Harness 0.1.1-rc.2 声明的 Node.js 范围是 ^22.19.0 || >=24.0.0。这意味着 Node 22 必须至少为 22.19.0，Node 23 不在声明范围内，Node 24 及更高版本满足这一表达式。很多“已经安装 Node 但 DSH 仍不可用”的问题，实际是报错终端仍指向旧版本或另一套 PATH。

本文基于官方固定 Release 和 npm、Node.js 官方文档进行静态审阅，没有修改本机 Node 环境，也没有把任一操作系统上的示例当作全平台实测。

第一步：在发生错误的终端检查

不要用另一个终端的成功截图代替问题现场。在同一个窗口执行：

node --version
npm --version
npx --version

macOS 与 Linux 再检查命令路径：

command -v node
command -v npm
command -v npx

PowerShell 可以使用：

Get-Command node
Get-Command npm
Get-Command npx

如果版本符合要求但三个命令来自不同安装目录，先解决 PATH 和版本管理器冲突。图形界面编辑器在安装或切换 Node 前已经打开时，集成终端可能保留旧环境；完全退出编辑器和终端，再打开后复查。

哪些版本组合不符合要求

当前 Node.js	对 DSH 0.1.1-rc.2 的判断	处理
22.18.x 或更低	不符合	升级到至少 22.19.0
22.19.0 及更高的 22.x	符合 ^22.19.0	继续检查 PATH 与 npx
23.x	不在声明范围	切换到受支持的 22.x 或 24+
24.x 及更高	符合 >=24.0.0	继续检查 npm、npx 与网络

版本范围来自项目 package.json，不是“越新一定越好”的猜测。将来官方 Release 改变 engines.node 后，应以目标版本的固定文件为准。

第二步：确认 npx 自身可用

npx 由 npm 提供。若 node 可用但 npx 找不到，通常应先修复同一套 Node/npm 安装，而不是立刻删除缓存或 DSH 数据。检查 npm --version 与命令路径，确认没有把系统 Node、版本管理器 Node 和编辑器环境混在一起。

更换 Node 版本后，重新打开终端，再执行三条版本命令。只有 node、npm、npx 都来自预期环境时，才继续验证 DSH。

第三步：用固定版本验证 DSH

先只验证 CLI 能否解析版本，不启动 Web 服务、不读取模型凭据：

npx @deepseek-ai/dsh@0.1.1-rc.2 --version

成功时应输出所调用的 DSH 版本。然后再按安装与 Web UI 指南启动：

npx @deepseek-ai/dsh@0.1.1-rc.2 web

固定版本能避免“教程审阅的是一个版本，npx 临时解析到另一个版本”的混淆。命令能打印版本只证明 CLI 入口可以执行，不证明模型、Web 端口、Profile 或插件都已经配置正确。

根据错误出现在哪一步分流

node 命令不存在

Node.js 尚未安装到该终端的 PATH，或版本管理器没有在当前 shell 初始化。先按照 Node.js 官方安装入口或你现有版本管理器的说明修复，不要继续排查 DSH。

npx 命令不存在

检查 npm 是否与当前 Node 一起安装，以及 npm 和 node 是否来自同一路径。只重装 DSH 不会补齐缺失的 npx。

出现 engine 或 unsupported Node 提示

对照目标 DSH Release 的 package.json。如果是 Node 23、过低的 Node 22，切换版本后必须重新打开终端并再次确认路径。

npx 找不到包或下载失败

保留完整错误、npm 版本和当前 registry/代理信息。此时问题已经从 Node 版本转向包解析、DNS、代理、证书或 registry；不要把网络失败改写成“DSH 包不存在”。先用 npm 官方诊断方法检查当前环境，再重试固定版本。

DSH 能执行但 Web 打不开

Node 与 npx 已经通过，不要继续清缓存。转到DSH Web UI 启动失败排查或3080 端口占用修复。

为什么不建议先删除缓存

缓存不是版本和 PATH 错误的首要解释。直接删除整个 npm 缓存、全局包目录、用户 Home 或 DSH Profile 会扩大影响范围，也会丢失原始证据。先记录：

• 完整错误文本；
• node、npm、npx 的版本和路径；
• DSH 固定版本；
• 操作系统与终端类型；
• 是否使用代理、企业证书或私有 registry。

只有错误明确指向缓存内容，并且已经按照 npm 官方说明确认目标范围时，才进行最小化处理。不要使用来源不明的一键清理脚本。

本文的验证范围

本文核对了 DSH 固定版本的 Node engine、官方 npx 启动方式和 CLI 版本参数。没有在 Windows、macOS、Linux 上逐一切换运行时，也没有验证企业代理、私有 registry 或所有 Node 版本管理器。

环境通过后返回DeepSeek Harness 中文入门；若下一步出现模型密钥错误，请使用DSH MISSING_CREDENTIAL 与 401 排查。