安装DeepSeek Harness npx @deepseek-ai/dsh web 长时间没反应，安装失败，如何解决?

以下是针对该问题的具体解决方案，您可以根据情况逐一尝试：

• 1. 解决网络问题（最常见原因）
  npm 默认从国外源下载包，在国内网络环境下可能会非常缓慢甚至超时。您可以切换到国内镜像源来加速下载。

  • 设置全局镜像源：在终端中执行以下命令，将 npm 的默认源切换为国内镜像。

    npm config set registry https://registry.npmmirror.com
    

  • 临时使用镜像源：您也可以在不更改全局设置的情况下，为单次命令指定镜像源。

    npx -y --registry=https://registry.npmmirror.com @deepseek-ai/dsh web
    

• 2. 检查 Node.js 版本
  DeepSeek Harness 对 Node.js 版本有特定要求。版本过低或不兼容可能导致安装或运行失败。

  • 检查版本：在终端运行 node -v 查看当前版本。
  • 版本要求：官方要求 Node.js 版本为 v22.19 及以上，或 v24 系列。如果您的版本过低，请使用 nvm (Node Version Manager) 等工具升级到兼容的版本后再重试。

• 3. 清理 npx 缓存
  之前下载过程中产生的缓存文件可能已损坏，导致后续安装卡住。

  • 清理缓存：执行以下命令清理 npx 缓存。

    npx clear-npx-cache
    

  • 手动删除：如果上述命令无效，可以尝试手动删除缓存目录：
    • Windows: rm -rf %LOCALAPPDATA%\npx-cache
    • Mac/Linux: rm -rf ~/.npm/_npx

• 4. 尝试全局安装
  如果 npx 方式持续失败，可以尝试先将工具全局安装到本地。

  • 安装：

    npm install -g @deepseek-ai/dsh
    

  • 运行：安装完成后，直接在终端运行 dsh web 来启动服务。
  • 注意：如果您使用的是较新版本的 npm（如 v12），可能会因为默认禁止安装脚本而导致 node-pty 等原生模块编译失败。此时，需要添加 --ignore-scripts=false 参数：

    npm install -g @deepseek-ai/dsh --ignore-scripts=false
    

• 5. 其他检查项

  • 端口占用：服务默认在 http://127.0.0.1:3080 或 http://localhost:3080 启动。请确保 3080 端口未被其他程序占用。有用户反馈使用 localhost 比 127.0.0.1 更稳定。
  • 防火墙：检查系统防火墙是否阻止了 Node.js 的网络访问，首次运行时请确保已允许。
  • 等待并确认：首次运行时，终端可能会提示 Ok to proceed? (y)，请确保输入 y 并回车以继续安装。

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/m0_53830442/article/details/163993894