dsh 安装卡住怎么判断是真卡还是慢？

看输出与进度：终端长时间没有任何新输出、进度条停在 0%，几分钟不动，才是真卡；有进度在走、包在下载，只是慢。慢的优先换镜像源加速，卡的按本文排查步骤处理。

npx @deepseek-ai/dsh web 卡住不动怎么办？

多半是网络拉取依赖卡住。按 Ctrl+C 中断，切换到国内镜像源后再重试：npm config set registry https://registry.npmmirror.com，然后重新运行安装命令。

换镜像源会影响其他项目吗？

npm config set registry 是全局生效的；只想临时生效，可以在安装命令里加 --registry=https://registry.npmmirror.com，不用改全局配置。

安装卡住后中断重试，会不会把环境装坏？

不会。npx 是临时拉取，npm 中断后留下的只是不完整的缓存目录，重新运行会复用已下载的部分并继续，不会损坏已有环境。

换镜像源还卡，还有别的安装方式吗？

有。卡住主要发生在拉取大量依赖时，可以换安装方式：全局安装 npm install -g @deepseek-ai/dsh，或源码安装 git clone + pnpm install + 构建；新版（v0.1.0-rc.8 起）已改善下载依赖体积，更新到新版本也能减少卡住概率。

dsh 安装卡住不动怎么办？npx 卡死、DeepSeek Harness 安装无进度与断点重试指南

dsh 安装卡住，先分清「真卡」和「慢」：终端长时间无新输出、进度停在 0%，才是真卡；有进度只是慢。真卡按「网络 → 镜像源 → 代理 → npm 缓存」顺序排查，卡住就中断重试；官方已在新版本改善下载依赖体积，更新后安装更顺。

先判断：卡住还是慢？

判断错了方向，排查就白费——卡和慢的处理方式完全不同。 三种情况对照：

现象	判断	处理
进度条在走、包名在换、日志在刷新	慢	换镜像源、配代理加速
长时间无任何输出，进度停在 0%	真卡	按下方排查流程处理
按 Ctrl+C 都没反应，终端假死	系统级卡死	先看网络/系统负载，再杀进程重来

注意 npx 首次运行 npx @deepseek-ai/dsh web 时，要先从 npm 下载包本体、再解析依赖，第一分钟没输出很常见——先给 1-2 分钟，别一上来就中断（来源）。

真卡时的排查流程：按顺序做

安装卡住九成是网络问题——拉不到、拉不动依赖。 按下面 5 步排查，多数在第 2-3 步解决：

确认网络连通：先开个浏览器随便访问一个网页，确认网络本身没问题；同时确认没有公司防火墙、校园网这类会拦截 npm 的环境。
切换镜像源：npm 官方源在国内经常慢或连接不稳，换成国内镜像（npm registry 配置说明）：
bash
```
npm config set registry https://registry.npmmirror.com
```
不想全局生效，就在安装命令里临时指定：
bash
```
npx --registry=https://registry.npmmirror.com @deepseek-ai/dsh web
```
配置代理：如果你走代理上网，npm 默认不读系统代理。在 ~/.npmrc 里加：
ini
```
proxy=http://127.0.0.1:7890
https-proxy=http://127.0.0.1:7890
```
端口换成你代理软件的实际端口，然后重新运行安装。
清 npm 缓存再试：缓存损坏也会卡住下载。中断后执行：
bash
```
npm cache verify
```
然后重新运行安装命令。verify 会清理并校验缓存，比直接删除目录安全。

换安装方式兜底：都试过还卡，说明这条链路不稳定，换一条：

bash

# 方式一：全局安装（一次装好，之后直接 dsh web）
npm install -g @deepseek-ai/dsh
# 方式二：源码安装（拉源码自己构建）
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && pnpm install && pnpm run build

官方 README 确认源码方式需要先构建再运行（来源）。

官方已改善：更新版本减少卡住

卡住很多时候是「包太大 + 网络不稳」——新版已经把依赖体积做小了。 v0.1.0-rc.8 的发布说明明确写了「改善下载依赖体积」（来源）。两个实用结论：

确认你用的是新版本：npm view @deepseek-ai/dsh version 看最新版，dsh --version（或源码目录里）看当前版本，落后太多就更新再装。
体积变小 → 卡住概率降低：依赖体积小，下载时间短，中途断流的概率也小；更新后重试往往就装上了。

源码安装与代理的官方细节

卡在依赖拉取时，两个官方细节值得知道：源码运行有固定流程、代理要显式交给 Node。 官方 README 的源码方式共四步：git clone → pnpm install → pnpm run build → pnpm dsh web——注意最后一步是 pnpm dsh 而不是 npx，且构建必须在启动前完成（来源）。三点说明：

缺构建产物的报错形态：源码目录里跳过 pnpm run build 直接启动，缺 Typert 宿主产物时会报模块解析错误（module-resolution errors）；缺前端/客户端插件 bundle 时，启动会明确提示先运行 pnpm run build（来源）。看到这类报错先构建，别去改别的配置。
代理环境变量：Node 默认不读系统代理；源码运行时需要走 HTTP 代理，官方要求设置 NODE_USE_ENV_PROXY=1，Node 才会尊重 HTTP_PROXY / HTTPS_PROXY（来源）。这也解释了为什么只配了系统代理、安装还是卡。
dsh plugin 需要 pnpm 在 PATH：官方 CLI 参考明确，插件管理命令把参数转发给 pnpm、pnpm 必须在 PATH 上（来源）——装完 dsh 本体、装插件之前，先确认 pnpm --version 可用。

注意事项

先给 1-2 分钟判断，别把「慢」误判成「卡」。
卡住优先中断重试，别一直干等——断点重试不会装坏环境。
镜像源优先 npmmirror，代理写到 ~/.npmrc 的 https-proxy。
缓存异常用 npm cache verify，不要直接删目录。
安装 DSH 本体后，装插件如果也卡，推荐直接走 DSH Plugin Hub 的「设置 → 插件中心」图形化安装，绕开命令行拉依赖。

来源：DeepSeek Harness README、v0.1.0-rc.8 Release Notes、npm registry 官方文档