dsh插件市场

教程 06 · 卸载回滚

dsh 插件装坏了怎么卸载、怎么回滚

dsh 插件装坏了怎么卸载回滚:用 dsh plugin --profile web remove 卸载包,用 dsh rescue --from-default-profile web 重建 profile,再还原 DSH_HOME 备份。命令可在官方仓库核对,数据更新于 2026-11-20。

上次核对:2026-11-20

症状 / 是什么

装完一个插件后,dsh 启动失败、Web UI 打不开、某个命令报错,或者行为和你预期的不一样。你想把它撤掉,但不知道从哪一步开始。

为什么会这样

dsh 的插件是打进 profile 的补丁层,宿主启动时会组合这些层。一个插件加载失败,可能导致整个 profile 起不来;插件写进 profile 的配置、补丁行或数据文件,也不会因为「删掉包目录」自动消失。所以卸载要按 profile 的机制来,而不是手动删文件夹。

步骤

1. 先卸掉最近装的包

官方 CLI 帮助里,dsh plugin 会把参数转给 profile 里的 pnpm,remove 是支持的:

dsh plugin --profile web remove <包名>

把 <包名> 换成你装的那个包(不是仓库名)。桌面端用自己的 profile 时,把 web 换成对应名称。卸完重启宿主。

2. 启动不起来,用 rescue 重建 profile

如果宿主已经起不来,官方 CLI 帮助给了一个救援入口:

dsh rescue --from-default-profile web

它会用官方 web 模板重建 rescue profile,然后启动。你可以在 rescue 里把坏掉的 profile 的配置读出来、对比、修好,再切回去。注意:这会覆盖同名 rescue profile 的旧内容,先确认里面没有你要保留的东西。

3. 还原装之前的备份

如果你按怎么挑插件里的建议备份过 DSH_HOME(或至少 profile 目录),把备份里的配置、补丁层和会话目录还原。只还原你确定被改过的文件,不要整目录覆盖,以免把新会话弄丢。

4. 用插件自带的备份/回滚

有些插件自己提供备份和回滚,例如 dsh-market 的「备份与恢复」会导出插件清单与配置;dsh-purge 有本机备份和回滚面板。插件还能打开时,优先用它的回滚,再用命令行兜底。

5. 检查残留

卸载后看三处:profile 目录里还有没有它的包目录;cordis.patch.yml 里还有没有它的 - id: 行;DSH_HOME 下还有没有它写的状态文件。残留的补丁行可能让宿主继续加载一个不存在的包。手动改补丁文件前先复制一份。

常见坑

  • 用仓库名 remove。 remove 要的是安装时的包名。
  • 只删 node_modules。 profile 的补丁层和状态文件还在,宿主仍会尝试加载。
  • 整目录覆盖备份。 会丢掉备份之后的新会话;只还原被改的文件。
  • 在桌面端用 CLI 卸。 桌面端有自己的 profile,CLI 的 web 不一定是它用的那个;按插件 README 选入口。
  • 不重启。 卸载也需要重启宿主才彻底生效。

相关

相关插件

常见问题

卸载插件会删掉我的会话吗?

通常不会。`remove` 移除的是包,会话数据在 DSH_HOME 的会话目录里。但动过会话存储的插件可能改过格式,卸载前先备份会话目录。

dsh rescue 会覆盖我原来的 profile 吗?

官方 CLI 帮助的示例是用 `--from-default-profile web` 重建 `rescue` profile,并提示会替换同名自定义 profile。它针对的是 rescue,不是直接覆盖你正在用的 web;操作前仍要确认。

插件市场里卸载和命令行卸载有区别吗?

入口不同,目标一样:把包从 profile 移除。市场类插件可能还会帮你清理补丁行和状态;命令行更直接。两者都建议重启宿主。

接着看

教程目录