安装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 并回车以继续安装。