DeepSeek Harness 更新失败先分安装方式排查：npx 报错多为网络与 npm 缓存问题，源码构建遇 git pull 冲突要先解决本地改动；失败后可回滚到旧版本。DSH plugin 升级报错可在 DSH Plugin Hub 内置插件中心重新安装。
本文转自 DSH Plugin Hub 插件中心
DeepSeek Harness 更新失败先看安装方式：npx 报错多为网络与 npm 缓存，源码构建主要是 git pull 冲突；失败后回滚旧版本，DSH plugin 升级失败可在 DSH Plugin Hub 重新安装。
概览
更新失败不是单一问题，先分清你用的是哪种安装方式。 DSH 是开发者预览阶段（当前 0.1.0-rc.6），迭代快（来源）。npx 一键运行和源码构建两种方式的更新路径完全不同，报错类型也完全不同——npx 每次启动时从 npm 拉最新包，源码构建靠 git pull 拉代码再本地编译。排查的第一步是确定安装方式，再对症处理，否则容易把网络问题误判成代码问题，白折腾半天。
怎么判断自己是哪种？很简单：平时用 npx @deepseek-ai/dsh web 启动的就是 npx 方式；在 clone 下来的 deepseek-harness 仓库里构建后运行、更新靠 git pull 的就是源码方式。下面两类故障分开讲，对号入座。
DeepSeek Harness 更新失败原因排查：npx 报错与 git pull 冲突
npx 方式更新失败，九成是网络与 npm 缓存问题。 npx @deepseek-ai/dsh web 每次启动都会从 npm 拉取最新包（来源），这个阶段最容易出三类错：
- 网络不通或 npm 官方源慢，表现为超时 /
ETIMEDOUT/ECONNRESET。先确认当前源：npm config get registry，默认是https://registry.npmjs.org/；再换镜像源npm config set registry https://registry.npmmirror.com，重试。若还是超时，检查代理：npm config get proxy，确认代理没失效、没把 registry 指向不可达的地址。 - npm 缓存损坏，报
EINTEGRITY/EACCES。执行npm cache clean --force后重试；若EACCES反复出现，是 npm 全局目录权限不足，用npm config get prefix看安装位置，把目录属主改成当前用户（sudo chown -R $(whoami) <prefix>）再试。 - Node 版本过低，
node -v查一下，升级到较新版本后重试；过旧的 Node 在解析依赖时容易报语法类错误，这是预览版项目里最常见的隐藏坑。
源码构建更新失败，基本是 git pull 冲突。 在仓库里执行 git pull 时如果本地有未提交的改动，git 会拒绝合并报冲突。处理方式是先暂存 git stash，pull 成功后再 git stash pop；或先把改动提交掉再 pull。如果 git stash pop 后仍冲突，说明你的本地改动和上游改动重叠，需要打开冲突文件手动合并，再 git add 标记解决。冲突解决后按 pnpm install && pnpm run build 重新构建（来源）。
DeepSeek Harness 更新失败后怎么回滚
回滚也分两种安装方式：npx 用指定版本，源码用 git 回退。 核心思路是回到「上次能正常运行的版本」，而不是盲回最早的版本——越老的版本和现有插件的兼容性越差。
- npx 方式没有本地安装，直接装回指定版本即可：
npx @deepseek-ai/dsh@0.1.0-rc.5 web（版本号换成你要回的版本）。不确定有哪些版本可选，先用npm view @deepseek-ai/dsh versions列出 registry 上发布过的全部版本。 - 源码方式先
git log --oneline找到要回的 commit，再git checkout <commit>回到旧代码，然后pnpm install && pnpm run build。之后想回到最新，git checkout master（或你所在的分支名）再git pull即可。
回滚前先把 ~/.dsh/sessions 里的会话数据备份一份，防止回滚过程中数据错乱。回滚完成后建议先启动一次确认 Web UI 正常，再逐个加载常用插件，确认没有兼容性报错再正式用。
DSH plugin 升级失败怎么办
插件升级报错，先确认 DSH 本体是最新版，再看插件来源。 本体不是最新版时，预览版之间插件的依赖声明可能不兼容，dsh plugin --profile web update 会直接失败。本体确认最新后，如果某个插件反复升级失败，多半是插件包本身有问题——这时可以在 DSH Plugin Hub 内置的「设置 → 插件中心」里找到该插件重新安装。DSH Plugin Hub 是社区插件市场，收录 4,401 个人工精选插件并与官网每日同步，插件详情页标注了兼容的 DSH 版本，升级前先核对再动手。
另一个常见场景是插件走 GitHub 源：git 分发的插件包可能没打 tag、没提交构建产物，装完入口文件缺失导致加载失败。遇到这类报错，优先改装 npm 分发的版本，或反馈给插件作者。判断插件来源：详情页会标明安装来源是 npm 还是 github，GitHub 源的插件升级前先确认仓库有对应的版本 tag，没有就直接找作者要新版本。
注意事项
- DSH 是预览版，更新前备份
~/.dsh/sessions。 - 别囤多个版本一次性升级，跟上官方的发布节奏。
- 升级插件前看插件详情页的兼容版本，更新后跑一遍主要功能。
- 更新后插件不加载，回头看《DSH 常见问题排查》。
常见问题
DeepSeek Harness 更新失败，npx 方式报错是什么原因？
多为网络与 npm 缓存问题：官方源慢或超时换镜像源，缓存损坏执行 npm cache clean --force 后重试；Node 版本过低也会导致拉取失败，升级后重试。
DSH 源码构建 git pull 更新失败、提示冲突怎么办？
本地有未提交改动时 git 会拒绝合并。先 git stash 暂存改动，pull 成功后再 git stash pop；或先提交改动再 pull，冲突解决后重新构建。
DeepSeek Harness 更新失败后怎么回滚到旧版本？
npx 方式执行 npx @deepseek-ai/dsh@<版本号> web 装回指定版本；源码方式用 git log 找到旧 commit 后 git checkout 回退，再重新构建。
DSH plugin 升级失败怎么办？
先确认 DSH 本体是最新版，预览版之间插件依赖可能不兼容；本体没问题还失败，可在 DSH Plugin Hub 内置插件中心找到该插件重新安装。
本文转自 DSH Plugin Hub 插件中心，版权归属 DSH Plugin Hub 插件中心。
分类：更新与升级
原文地址：https://dsh-plugin.org/zh/tutorials/update-dsh-failed
来源：官方 Quickstart、dsh CLI README、deepseek-ai/deepseek-harness
