升级指南
DeepSeek Harness 处于开发者预览期，破坏性变更随时可能到来——官方文档明确如此声明。本指南提供预览版本间的安全升级路径（2026-08-13 核实）。
目前还没有稳定版。请把每次升级都当作可能破坏现有配置：备份配置、阅读更新日志、保留回退途径。
先确认你的版本
版本历史在 npm 注册表——GitHub Releases 没有 tag。检查已安装版本：
$ dsh --version
$ npm ls -g @deepseek-ai/dsh # 或 npx @deepseek-ai/dsh --version
$ npm ls -g @deepseek-ai/dsh # 或 npx @deepseek-ai/dsh --version
当前版本线：0.1.0-rc.6（截至 2026-08-13 的 npm 最新版）。
目前发布的版本线
| 版本 | 发布时间 | 变化 | 升级风险 |
|---|---|---|---|
0.0.1-rc.1 | 2026-08-10 | 第一个公开 npm 产物；npx @deepseek-ai/dsh web 成为可用的一键安装。 | 预览 |
0.1.0-rc.2 | 2026-08-13 | 版本线转入 0.1.0-rc；生态爆发（300+ 带 dsh-plugin 话题的仓库）。 | 换线 |
0.1.0-rc.6 | 2026-08-13 | 无需特殊权限即可公开 npm 安装；新用户应安装此基线。 | 当前 |
安全升级步骤
1. 备份配置
你的 profile 在 $DSH_HOME/profiles/，机器级偏好是 $DSH_HOME/cordis.patch.yml。复制整个 home 目录（或至少你的 profile patch）：
$ cp -r \"$DSH_HOME\" dsh-home-backup
2. 阅读本版本的更新日志
查看 dsh.so 更新日志——每条都有官方变更 + dsh.so 对用户与插件影响的解读。
3. 启动前检查组合配置
升级包之后，验证机器将加载的配置树——特别是你有自定义 patch 或插件时：
$ dsh --profile web --dump-config
# 注意 stderr 中未匹配的 patch 目标
$
# 注意 stderr 中未匹配的 patch 目标
$
4. 升级包
$ npm install -g @deepseek-ai/dsh@latest
$ dsh --version # 确认新版本
$ dsh --version # 确认新版本
如果从源码检出运行：git pull、pnpm install、pnpm run build，然后 pnpm dsh web。
5. 验证插件是否存活
启动后确认插件正常加载（注意启动日志中的错误），并在 dsh.so 上查看它们的兼容记录——注册表显示每个插件的声明 vs 已验证状态，版本兼容矩阵追踪 dsh.so 有记录的版本。记住：目前没有任何插件被独立验证——声明兼容只是作者的说法。
出了问题怎么办
- 回滚包——固定旧版本：
npm install -g @deepseek-ai/dsh@0.1.0-rc.2。 - 恢复配置——把
dsh-home-backup/复制回$DSH_HOME。 - 隔离变更——用
--dump-config看哪些行变了；最常见的元凶是 patch 替换了整行config值。 - 求助——官方 Discussions，或看常见问题排查。
结论
新安装：用 0.1.0-rc.6。已有环境：一次只升一条版本线，把旧版本留在一条命令之外，升级前绝不能跳过阅读更新日志——预览期的破坏是常态，不是例外。
加入社区
问题或建议？官方 Discussions 是项目规范的支持渠道；Discord 里能找到活跃的社区成员。dsh.so 本身欢迎通过提交插件或反馈改进。