跳到正文
MyDSH我的 DSH 实战笔记
English
独立维护,非DeepSeek官方;与mydsh.dev等其他MyDSH站点无关联。

首页/起步与安装/升级与降级路径

升级前后配置条目变化:怎么自己量一遍

升级后发现某些设置不生效了、或者多了不认识的配置项。想在升级前留一手可比对的底稿。

待实测版本与环境核验日期2026-11-14
对照版本
0.2.1-rc.5 → 0.2.2-rc.1
采集方式
dsh --dump-config前后各存一份再diff
状态
本站尚未在0.2.2上完成对照实测

可复制指令

dsh --dump-config > before.yml
这一页给的是可复现的采集方法,不是「升级会改哪些配置」的结论表。本站还没在0.2.2上跑完这次对照,所以不填具体条目——编一个出来比留空更糟。

升级会动到配置,这件事本身不奇怪;真正麻烦的是你事后说不清「原来是什么样」。所以升级前先存一份底稿,用同一台机器、同一条命令,前后各一次。

升级前

dsh --dump-config > before.yml

如果只想看默认层(不含你的用户层),用 --dump-default-config。两份都存更稳,能分清「版本变了」还是「我的改动丢了」。

升级

npm i -g @deepseek-ai/[email protected]

升级前把profiles目录按上一页的方法备份一份。配置被覆盖是能恢复的,前提是你有那份备份。

升级后

dsh --dump-config > after.yml
diff before.yml after.yml

diff出来三类结果,处理方式完全不同:

  • 新增条目:新版本引入的配置项。用默认值通常没问题,但值得看一眼它控制什么。
  • 消失的条目:最需要警惕。可能是改名了,也可能是功能被移除——你的设置可能悄悄失效。
  • 值变了:默认值调整。如果你的设置依赖旧默认值,行为会变。

怎么把这次记录变成别人也能用的材料

  • 写清版本对(dsh --version 原文)、node版本、操作系统。
  • 贴diff的原文,不要只写「配置变了」。
  • 对每条消失的条目说明你原本用它做什么、升级后靠什么替代——这部分才是别人想看的东西。

怎么算跑通

照着逐条对,全过才算完成。有一条没过,先解决它再往下。

  • 升级前后各有一份dump文件
  • diff能跑出结果(说明两份格式可比)
  • 对每条消失的条目有明确说明

会失败在哪

现象 / 原因 / 怎么办,按实际踩到的顺序写。

现象原因怎么办
diff输出全红,整份都不一样两次采集的机器/用户层不同,或版本差异过大确认同一台机器、同一份用户配置,只变版本
升级后配置直接没了profile目录被覆盖从升级前备份恢复profiles目录,再逐条比对

来源

标「已核验」的,来自本站实跑;标「公开资料整理」的,逐条附出处。