Skip to content
MyDSHMy DSH Field Notes
中文
Independently maintained; not affiliated with DeepSeek. No association with mydsh.dev or other MyDSH sites.

Home/Getting started/Upgrade & rollback paths

Config diff across an upgrade: how to measure it yourself

After an upgrade some settings stop applying, or unfamiliar keys appear. You want a baseline to compare against before upgrading.

To be testedVersion and environmentChecked 2026-11-14
Versions
0.2.1-rc.5 to 0.2.2-rc.1
Method
save --dump-config before and after, then diff
Status
not yet measured on 0.2.2 here

Copyable command

dsh --dump-config > before.yml
This page gives a reproducible method, not a table of 'what an upgrade changes'. We have not finished the 0.2.2 comparison, so no specific entries are filled in — inventing them is worse than leaving the gap.

Upgrades touching config is not surprising; what hurts is being unable to say what it looked like before. Capture a baseline with the same command on the same machine, once before and once after.

Before

dsh --dump-config > before.yml

For the default layer only (no user layer), use --dump-default-config. Keeping both tells you whether the version changed or your own edits vanished.

Upgrade

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

Back up the profiles directory first, as on the previous page. An overwritten config is recoverable only if that backup exists.

After

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

The diff produces three kinds of result, each handled differently:

  • Added entries: new keys. Defaults usually work, but read what they control.
  • Removed entries: the alarming case. A rename, or a feature dropped — your setting may be silently dead.
  • Changed values: default shifts. If your setup leaned on the old default, behaviour changes.

Turning this into material others can use

  • State the version pair (verbatim dsh --version), node version, and OS.
  • Paste the diff verbatim, not 'the config changed'.
  • For each removed entry, say what you used it for and what replaces it — that is the part people need.

What counts as working

Check every line. All of them pass or the job is not done.

  • One dump file exists on each side
  • diff produces output, so the two files are comparable
  • Every removed entry has an explicit note

Where it fails

Symptom, cause, what to do — written in the order it actually happens.

SymptomCauseWhat to do
The diff is entirely redDifferent machines, user layers, or a very large version jumpSame machine, same user config, only the version changes
Config vanished after the upgradeThe profile directory was overwrittenRestore profiles from the pre-upgrade backup, then compare entry by entry

Sources

Verified means measured here. Compiled means every line carries a source.