DSH 更新卡住、更新慢多是网络问题：npm 慢换镜像源，git 卡住先看输出，死等无进度就 Ctrl+C 中断再重试。本文给 dsh update 卡死排查步骤与网络加速方案。
本文转自 DSH Plugin Hub 插件中心
DSH 更新卡住、更新慢按「判断 → 中断 → 清缓存 → 加速 → 重试」五步处理：先看输出判断是否真卡住，确认卡住就 Ctrl+C 中断，清 npm 缓存，npm 走镜像源、git 走代理加速，再重新执行更新；插件更新卡住也可以装 DSH Plugin Hub 在「设置 → 插件中心」一键更新。
概览：更新卡住的排查总路线
本文把排查拆成五步：判断是否真卡住、安全中断、清理缓存、网络加速、重试更新。 DeepSeek Harness 处于预览期、迭代快，更新主要发生在三个环节：npm 拉包（npx 方式与插件）、git 拉代码（源码构建）、构建产物。这三个环节都依赖网络，所以更新卡住的根因高度集中在网络——npm 官方源慢、git 连接不稳、代理配置错误导致请求挂起；少数情况是本地缓存损坏或依赖冲突，表现为报错而不是死等（来源）。排查路线：
| 步骤 | 目的 | 关键操作 |
|---|---|---|
| 第一步 | 判断是否真卡住 | 看阶段输出、网速、时间 |
| 第二步 | 安全中断 | Ctrl+C |
| 第三步 | 清理缓存 | npm cache clean --force |
| 第四步 | 网络加速 | npm 镜像 / git 代理 |
| 第五步 | 重试更新 | 重跑原命令并验证 |
第一步：判断是不是真卡住了
正常更新有阶段输出，长时间停在同一个阶段、网速归零、进程无响应，才是真卡住。 判断要点：
- 看有没有阶段输出：npm 拉包会打印下载进度，git 拉代码会打印
remote: ...与Receiving objects，构建会打印编译日志。只要输出还在动，就没卡住。 - 看停留时长：单个大依赖下载几十秒到几分钟都算正常；同一阶段超过几分钟不动，基本可判定卡住。
- 看网速：打开任务管理器 / 活动监视器，网络占用归零而命令无输出，多半是连接挂了。
源码构建的更新要格外耐心：首次安装要联网拉整个依赖树，比 npx 慢很多，属于正常现象，增量构建才会快起来（来源）。
第二步：安全中断卡住的更新
卡住就果断中断，按 Ctrl+C 停止当前命令。 操作要点：
- 在卡住的终端窗口里按
Ctrl+C，命令会收到中断信号并退出。 - 等终端回到可以输入命令的提示符，确认进程真的退出了；如果按了没反应，再按一次或检查是不是有其他 dsh 进程在跑。
- 中断不会损坏数据——更新只动代码和依赖，会话数据在
~/.dsh/sessions下不受影响。
不要直接关掉整个终端或强杀系统，Ctrl+C 是干净的中断方式，能避免留下残缺的下载临时文件。
第三步：清理缓存与残留
中断后先清理缓存再重试，避免坏缓存导致再次卡住或报错。 分情况处理：
# 1. 清理 npm 缓存（npx 拉包、插件更新都受影响）
npm cache clean --force
# 2. 查看 npm 配置的 registry，确认当前走的源
npm config get registry
git 拉代码卡住的（源码构建），中断后还要确认仓库状态：
# 进入仓库目录
cd deepseek-harness
# 查看状态，确认没有遗留的合并 / 拉取中间状态
git status
如果提示有未完成的操作或冲突，先处理干净再重试；node_modules 状态异常（半装状态）时，删掉 node_modules 重新 pnpm install。
第四步：网络加速（npm 镜像与 git 代理）
加速的核心是换条更快的路：npm 切国内镜像源，git 走代理或镜像仓库。 具体做法：
# npm 切换国内镜像源（以 npmmirror 为例）
npm config set registry https://registry.npmmirror.com
# 查看当前 registry，确认切换成功
npm config get registry
npx 拉包和 DSH plugin 更新都走 npm，切镜像后拉包速度会有明显提升。git 拉不动 GitHub 时，配置代理（git config --global http.proxy http://127.0.0.1:你的代理端口）或使用镜像仓库都行。注意：切换 registry 只影响 npm 拉包，不影响 DeepSeek Harness 的功能和会话数据；想还原官方源时执行 npm config set registry https://registry.npmjs.org。
第五步：重试更新并验证
清完缓存、换好网络后，重新执行原更新命令。 按你的安装方式对号入座：
# npx 方式：重跑启动命令即重新拉包
npx @deepseek-ai/dsh web
# 源码构建：拉代码 + 装依赖 + 重建
cd deepseek-harness
git pull
pnpm install
pnpm run build
pnpm dsh web
# 插件更新：更新当前 profile 全部插件
dsh plugin --profile web update
重试后如果还卡在同一个位置，多半是网络环境本身的问题——换个网络（比如切手机热点）再试，或等网络恢复再更新。更新完成后用 dsh --version 确认版本到位。
插件更新卡住：走 DSH Plugin Hub 一键更新
dsh plugin update 卡住多为拉包网络问题，懒得盯命令行就装 DSH Plugin Hub 在应用内一键更新。 dsh plugin 命令会把参数原样转发给 profile 目录里的 pnpm，所以插件更新卡住的根因和 npx 拉包一样是网络（来源）。装好 Hub 后，更新流程变成：
- 打开 设置 → 插件中心，Hub 检测到插件有新版本会显示「更新」。
- 点「更新」一键覆盖安装，界面内实时显示进度。
- 更新失败时界面直接给出错误信息，不用去翻终端日志。
Hub 收录 4,805 个社区插件、其中 4,401 已人工精选验证，安装与使用见《DSH Plugin Hub 怎么用？》。
更新卡住后的注意事项
卡住中断后别直接放弃，按顺序排查：网络 → 缓存 → 仓库状态 → 重试。 几点提醒：
- 更新只动代码和依赖，卡住中断不会丢数据；但建议更新前还是把
~/.dsh/sessions备份一份。 - 多次强制中断可能留下残缺依赖，重试前确认 git 仓库干净、
node_modules状态正常，必要时删掉重装。 - 如果更新后插件不加载、界面异常，那不是网络问题，去查《DSH 常见问题排查》。
常见问题
DSH 更新卡住怎么判断是真的卡住了？
看进度输出：npm 拉包、git 拉代码都有阶段输出，长时间停在同一个阶段、网速归零、进程无响应，超过几分钟基本可判定卡住。正常大依赖下载几十秒到几分钟都算正常。
dsh update 卡死怎么中断重试？
先按 Ctrl+C 中断，再执行 npm cache clean --force 清理缓存，必要时删掉卡住的临时文件，然后换网络环境重新运行原命令。源码构建的卡住先看 git 输出，确认仓库状态干净再重试。
DeepSeek Harness 更新慢怎么加速？
npm 走官方源慢就切镜像：npm config set registry https://registry.npmmirror.com。git 拉代码卡住可换代理或改用镜像仓库；源码构建的首次安装会联网拉大量依赖，比 npx 慢属于正常现象。
插件更新卡住怎么办？
dsh plugin update 会把参数转发给 profile 目录里的 pnpm，卡住同样多为拉包网络问题。也可以在应用内更新：装 DSH Plugin Hub 后，「设置 → 插件中心」检测到新版本一键更新，界面实时显示进度。
更新卡住会导致 DSH 数据丢失吗？
不会。更新只动代码和依赖，会话数据在 ~/.dsh/sessions 下不受影响。但多次强制中断可能留下残缺依赖，重试前确认 git 仓库干净、node_modules 状态正常。
本文转自 DSH Plugin Hub 插件中心，版权归属 DSH Plugin Hub 插件中心。
分类：更新与升级
原文地址：https://dsh-plugin.org/zh/tutorials/update-dsh-stuck
来源：DeepSeek Harness 官网、DeepSeek Harness 官方文档 - 参考、dsh CLI README
