DeepSeek Harness 更新后 DSH plugin 不兼容？插件版本回滚与降级操作指南

DSH plugin 更新后不兼容，先确认症状再动手：回滚插件钉回旧版本，或把 DSH 本体降回去；平时升级前看插件详情页的兼容状态就能避开大部分。

概览

更新后插件不兼容不会总报错，很多是功能悄悄消失。 处理分三步：识别症状、回滚插件或降级本体、以后升级前先核对兼容状态。DSH 是开发者预览阶段（当前 0.1.0-rc.6），破坏性变更随时可能出现（来源），插件作者跟进本体节奏有快有慢，所以「本体升了、插件没跟上」是预览版最常踩的坑。这篇文章按「确认症状 → 回滚操作 → 预防」走，动手前先备份，别在没确认原因时反复重装。

更新后 DSH plugin 不兼容的典型症状

插件不兼容的表现往往是能力没了，而不是红字报错。 常见三种：

1. 界面插件没改 UI、工具插件不在工具列表里——装了像没装。
2. 启动时插件加载报错，终端有报错日志。
3. DSH 本体一升级，某个插件立刻失效。

想确认插件到底有没有加载，执行 dsh --dump-config 看组合后的配置树，插件注册没注册一眼能看出来（来源）。操作前先记一个判断点：只有「本体升级后立刻失效」这条最值得回滚插件；如果是插件刚更新就失效，优先怀疑插件包本身，走更新失败那篇的排查。

怎么回滚 DSH plugin、怎么降级本体

回滚有两条路：插件钉回旧版本，或把 DSH 本体降回去。 视情况选：

• 插件回滚：dsh plugin 的 add 会把参数转发给 pnpm，所以在包名后带版本号就能钉回旧版：
  bash

  dsh plugin --profile web add <插件包名>@<旧版本>
  

  装完重启 dsh web，插件回到旧版本行为。不确定旧版本号时，先在对应 profile 目录里 pnpm list 看当前装了哪些版本，或去插件详情页看历史版本列表，别随手填一个不存在的版本号。
• 本体降级：npx 方式直接装指定版本 npx @deepseek-ai/[email protected] web；源码构建用 git log --oneline 找到旧 commit，git checkout <commit> 回退后重新 pnpm install && pnpm run build。

回滚前先把 ~/.dsh/sessions 会话数据备份一份，具体操作细节还可以看《DeepSeek Harness 更新失败怎么办》。回滚后别急着当没事发生：把失效的插件逐个加载一遍，确认功能回来了，再考虑要不要把其他插件也钉到兼容版本——预览版里一次只动一个，出问题好定位。

回滚命令本身也可能被网络卡住：git 源的插件回滚会走 git 协议拉旧版本，拉不动时给 git 配代理或改装 npm 版，方法见《DSH plugin 下载慢？镜像源与代理加速》；回滚后插件仍报 ERR_MODULE_NOT_FOUND 一类加载错误，说明包入口有问题，排查见《DeepSeek Harness 安装报错排查》。版本号记不准确时，优先用 pnpm list 或插件详情页的历史版本列表确认，别随手写一个不存在的版本。

怎么避免更新后 DSH plugin 不兼容

先核对兼容状态再升级，是性价比最高的防翻车方式。 具体做法：

1. 升级前看插件详情页标注的兼容 DSH 版本，版本不匹配可能静默失败。
2. 装了 DSH Plugin Hub 的，直接在「设置 → 插件中心」核对：DSH Plugin Hub 收录 4,401 个人工精选插件并与官网每日同步，插件卡片标注了兼容版本与验证状态，升级本体前先看一遍再动手。
3. 批量更新后逐个验证核心功能，不兼容的插件用上面的回滚命令钉回旧版。
4. 本体大版本升级前，先确认自己装的插件都声明了对应的兼容目标（插件详情页会标注）。

最后一条建议：预览版迭代快，别追求「永远最新」。你的核心工作流跑得好好的，就先别急着升级本体；真要升，挑一个工作日的早上做，留足下午验证和回滚的时间。把「升级前查兼容、升级后验功能」养成习惯，比任何修复命令都管用。

来源：dsh CLI README、官方 Quickstart、dshplugin/dsh-plugin-hub