教程 06 · 卸载回滚
dsh 插件装坏了怎么卸载、怎么回滚
dsh 插件装坏了怎么卸载回滚:用 dsh plugin --profile web remove 卸载包,用 dsh rescue --from-default-profile web 重建 profile,再还原 DSH_HOME 备份。命令可在官方仓库核对,数据更新于 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 选入口。 - 不重启。 卸载也需要重启宿主才彻底生效。
相关
相关插件
- dsh-market 怎么安装使用:自带备份与恢复,插件还能打开时先用它回滚。
- dsh-purge 怎么安装使用:自带本机备份和回滚面板。
常见问题
卸载插件会删掉我的会话吗?
通常不会。`remove` 移除的是包,会话数据在 DSH_HOME 的会话目录里。但动过会话存储的插件可能改过格式,卸载前先备份会话目录。
dsh rescue 会覆盖我原来的 profile 吗?
官方 CLI 帮助的示例是用 `--from-default-profile web` 重建 `rescue` profile,并提示会替换同名自定义 profile。它针对的是 rescue,不是直接覆盖你正在用的 web;操作前仍要确认。
插件市场里卸载和命令行卸载有区别吗?
入口不同,目标一样:把包从 profile 移除。市场类插件可能还会帮你清理补丁行和状态;命令行更直接。两者都建议重启宿主。