ChatGPTClaudeGrok / X / CursorGemini

dsh 装错后的回退:退版本、退安装方式、退数据三种目标,按风险从小到大依次退,别先删数据

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
dsh安装回退降级版本固定数据恢复
回退不是重装。先判断要退的是版本、安装方式还是数据,三者顺序不同:数据最后动,命令先恢复。本文给出每种目标的操作步骤、验证点与不该回退的情况。

回退前先回答一个问题:你要退的是版本、安装方式,还是数据。 三者影响的范围完全不同,顺序错了会把可恢复的问题变成不可恢复。

dsh 回退先确定退哪一层

现象相似,修法不同。 对照:

现象该退哪一层影响范围
新版本行为变了、插件不兼容版本只有可执行文件
新安装方式不合手、命令冲突安装方式命令与 PATH
会话丢失、配置被写坏数据DSH_HOME
装完完全起不来先版本,再数据逐步收窄

从影响最小的那一层开始试。 先退版本能解决大多数问题,且几乎不碰数据。

dsh 回退目标一与二:版本和安装方式

退版本是最安全的回退,因为它不改数据、不改入口,只换可执行文件。 步骤:

  1. 记录当前版本:dsh --version;
  2. 确认要退回的目标版本存在:npm view @deepseek-ai/dsh versions;
  3. 全局安装回旧版:npm install -g @deepseek-ai/dsh@<旧版本>;
  4. 用 dsh --version 确认已变成旧版;
  5. 启动一次,确认页面与会话正常。

不需要先卸载再装。 直接装指定版本会覆盖当前版本,多一步卸载反而容易在中途失败后变成「什么都没有」。

npx 场景更简单:把版本号写进命令。 npx @deepseek-ai/dsh@<旧版本> web,不写版本就会一直拿最新。

插件要跟着回退。 插件声明了 engines.dsh 范围,主程序降级后可能落在范围之外,表现为安装或启动时被拒绝。

dsh 退安装方式的目标是恢复「熟悉的入口」,不动数据。 版本退完还有问题时,才换这一层。常见两种方向:

  1. 全局退回 npx:先 npm uninstall -g @deepseek-ai/dsh,再改用 npx @deepseek-ai/dsh@<版本> web;
  2. npx 退回全局:直接全局装一个固定版本,并把脚本里的 npx 调用替换掉。

卸载全局包后要确认命令真的消失。 执行 which -a dsh,还有命中说明另有安装或残留链接;同时检查 PATH 与别名,别让命令指向一个已不存在的路径。

这一步不碰 DSH_HOME。 会话与凭据都还在,换入口后再启动一次就能看到。

dsh 回退目标三:退数据

退数据是三种回退里唯一有丢失风险的,必须最后做。 步骤:

  1. 停止所有 dsh 进程,确认端口已释放;
  2. 把当前 DSH_HOME 改名留档,而不是直接覆盖;
  3. 把升级或迁移前的备份恢复到 DSH_HOME 位置;
  4. 检查目录与文件权限只属于当前用户;
  5. 启动并核对会话、插件与模型调用。

先留档再恢复,是这一步唯一不能省的顺序。 恢复错了还能换回来,直接覆盖就没有退路了。

只想重置某个 profile 时,不必动整个目录。 可以用 --from-default-profile <模板> 用随附模板重建指定 profile,保留其他数据。

三种目标放在一起对照,边界更清楚。 退版本只动可执行文件,退安装方式只动命令与 PATH,退数据才动 DSH_HOME;风险等级决定执行顺序,先低后高。低风险步骤能解决,就别动数据。

dsh 回退顺序与回退后的验证

三者有依赖:命令不对时,数据对不对你根本看不出来。 建议顺序:

  1. 先恢复命令与版本,让 dsh --version 能正常输出;
  2. 再确认启动可用,能打开页面;
  3. 最后才判断数据是否需要回退;
  4. 回退数据后,重新验证命令与启动。

不要同时执行两类回退。 命令与数据一起改,出问题时无法判断是哪一步引入的。

桌面端参与时额外小心。 桌面端使用保留的 profile 名称,CLI 会拒绝针对它的启动与配置操作,两边不要同时操作同一份数据。

顺序走完还要验收。 回退是否成功,看四条:

  1. 版本:dsh --version 与目标版本一致;
  2. 命令:which -a dsh 只有预期路径;
  3. 数据:历史会话仍在,能打开内容;
  4. 功能:发一条消息成功,插件入口正常。

四条里任何一条不通过,说明回退只完成了一半。 常见是版本退了但插件没退,表现成「能启动、功能缺」。

dsh 不该回退的情况与可重复回退

有些问题回退解决不了,反而会丢掉证据。 判据:

  1. 启动失败但没有留下日志时,先取诊断文件再动手;
  2. 是配置写错、网络不通或凭据失效,回退版本与安装方式都没用;
  3. 刚升级就回退,还没确认新版本是否能通过改配置修好。

能重复的回退要提前准备。 回退最怕临时找命令,所以提前记三样:当前稳定版本号、完整启动命令、一份带日期的 DSH_HOME 备份。有记录的回退是几分钟,没有记录的回退是一下午。

dsh 下一步

先退版本,再考虑退数据。 想看版本怎么固定,读 固定版本安装;想看迁移时怎么留回滚点,读 从旧安装迁移;想看磁盘上的多份安装怎么清,读 安装占用与清理;想找回误删的会话,读 会话恢复。

来源:dsh CLI 行为参考、dsh CLI README、deepseek-harness Releases

ChatGPTClaudeGrok / X / CursorGemini

常见问题

dsh 升级之后发现新版本不好用,怎么快速退回上一个稳定版本?

全局安装的话,直接装回指定版本即可,例如 npm install -g @deepseek-ai/dsh@<旧版本>,不需要先卸载。装完用 dsh --version 确认。如果用的是 npx,把命令里的版本号固定成旧的即可。

dsh 回退到旧版本之后插件提示版本不兼容,是回退失败了吗?

不是,这是插件与主版本范围不匹配。安装与 profile 启动时会按声明的 engines.dsh 范围检查运行时版本,不兼容插件需要显式确认豁免。回退版本时,插件通常也要回退到同期版本。

从全局安装回退到 npx 运行时,原来的会话和插件还会继续在吗?

在,只要 DSH_HOME 没动。会话、配置、插件依赖都在数据目录里,与安装方式解耦。但插件是跟 profile 走的,换安装方式后要确认 profile 名称没变,否则会看不到。

在什么情况下才需要回退 DSH_HOME 数据,而不是只退版本?

只有当 dsh 的数据本身被写坏或被误删时,才需要回退数据。单纯的版本问题、命令问题都不该动 DSH_HOME。回退数据前必须先停服务,并确认备份是迁移或升级之前做的。

相关术语

回退
回退是把版本、安装方式或数据恢复到此前某个已知可用状态,与重装的区别是保留未受影响的部分。— DeepSeek Harness 官方文档
版本固定
版本固定是在安装或运行命令里显式写出包版本号,让每次解析到的都是同一个版本,而不是 latest。— npm 文档
engines.dsh
engines.dsh 是插件声明的运行时版本范围,安装和 profile 启动时都会按它检查主程序版本是否兼容。— dsh CLI README
DSH_HOME
DSH_HOME 是 DeepSeek Harness 的数据根目录,默认 ~/.dsh,保存 profile、配置、会话、日志与凭据。— dsh CLI 行为参考

来源