Node.js 环境看似正常但 DSH 命令不可用怎么办

确认当前终端看到的版本

同一台电脑可能同时存在系统 Node.js、版本管理器安装和编辑器内置终端配置。先在发生错误的同一个终端中检查 node、npm 和 npx，不要用另一个终端的成功结果代替。

记录命令解析到的实际路径和版本。图形界面编辑器如果在安装 Node.js 前已经打开，可能仍然使用旧环境变量，完全退出并重新打开后再测试。

DSH 0.1.0-rc.5 根包声明的 Node.js 范围是 ^22.19.0 || >=24.0.0。Node 22 低于 22.19.0 不符合要求，Node 23 也不在声明范围内。先执行：

node --version
npx --version

检查项目目录与缓存

确认命令在预期工作目录执行，并查看是否存在项目级版本约束。不要一遇到问题就删除所有全局缓存或依赖目录，这会扩大影响范围并掩盖原始原因。

需要清理时先保存锁文件、错误日志和当前版本，按照 npm 官方说明选择最小范围的检查或清理方式。

用最小命令验证

先验证运行时和包执行器自身，再验证 DSH 命令。每一步只改变一个因素，例如切换版本、重新打开终端或更换工作目录。把成功和失败的组合记录下来，就能判断问题来自环境、项目还是目标包。

验证完成后再回到DeepSeek Harness 中文入门，继续模型配置和第一次 Session；完整安装路径见安装与 Web UI 指南。