选 DSH 版本先读懂版本号：dsh --version 看当前，npm view 看最新，rc 是候选发布版、接口可能变；要稳定追 latest，尝鲜才装 rc。想锁版本用 npm install -g @deepseek-ai/dsh@版本 或源码 git checkout tag，本文给出完整操作。
本文转自 DSH Plugin Hub 插件市场
选 DSH 版本按「读版本号 → 决定追不追 rc → 锁定安装」三步走：dsh --version 看当前、npm view @deepseek-ai/dsh version 看最新；求稳追 latest 标签，尝鲜才装 rc；要锁版本用 npm install -g @deepseek-ai/dsh@版本 或源码 git checkout tag，别让更新悄悄换掉你正在用的环境。
概览：为什么先学会选版本
DeepSeek Harness 处于开发者预览阶段，迭代快、有破坏性变更，版本选择直接影响插件的兼容性。 官方在 README 里明确提醒：现在是开发者预览，会持续快速迭代，存在不兼容变更（来源）。所以装之前先想清楚追哪个版本，比装完再折腾回退省事得多。本文只讲三件事：版本号怎么看、rc 与正式版怎么选、怎么把版本锁住不被动更新。
版本号怎么看？dsh --version 与 npm view
当前版本用 dsh --version，最新版本用 npm view @deepseek-ai/dsh version，两个命令一前一后就能判断自己落后多少。 操作步骤：
# 1. 查看当前运行版本
dsh --version
# 2. 查看 npm 上最新发布版
npm view @deepseek-ai/dsh version
# 3. 查看全部发布过的版本
npm view @deepseek-ai/dsh versions
# 4. 查看发布标签（latest 是正式推荐，next 通常是预览）
npm view @deepseek-ai/dsh dist-tags
如果提示 dsh: command not found，说明你用 npx 一键方式运行（npx @deepseek-ai/dsh web），dsh 没有装成全局命令——这不影响使用，用 npx @deepseek-ai/dsh --version 查版本即可（来源）。版本号格式是语义化版本：主版本.次版本.修订版本，后面跟 -rc.N 表示候选阶段，例如 0.1.1-rc.1。想在仓库里看每个版本的更新日志，打开 deepseek-ai/deepseek-harness 的 Releases 页面按发布时间看。
rc 版与正式版怎么选？要不要追 rc
稳定优先选 latest 标签，想提前用新功能再装 rc；rc 与 rc 之间接口可能变化，装之前先备份。 DeepSeek Harness 目前还在预览期，正式版发布前会先放出多个 rc 候选版本让社区试用（来源）。怎么选看你的场景：
- 日常使用、装了一堆插件：追
latest。rc 版接口可能变，插件兼容性跟着受影响，追 rc 等于替社区踩坑。 - 尝鲜新功能、开发插件：可以装 rc，但升级前先备份
~/.dsh/sessions数据，升级后跑一遍主要功能。 - 升级插件前：先核对插件详情页标注的兼容 DSH 版本。装 DSH Plugin Hub 后，插件页会直接标出兼容的目标版本（verified / unconfirmed），升级本体前先在 Hub 里核对一遍，能避免升级完插件全不加载。
怎么锁定指定版本安装？
想锁住某个版本，按安装方式操作：全局安装用 npm install -g @deepseek-ai/dsh@版本，源码构建用 git checkout 切 tag，npx 用 @版本 后缀直接跑指定版。 三种方式的具体命令：
# 方式一：npm 全局安装指定版本（会覆盖当前全局版）
npm install -g @deepseek-ai/dsh@0.1.1-rc.1
# 方式二：npx 直接跑指定版本（不污染全局环境）
npx @deepseek-ai/dsh@0.1.1-rc.1 web
# 方式三：源码构建锁定版本
cd deepseek-harness
git tag # 先列出仓库里的版本标签
git checkout v0.1.1-rc.1 # 切到目标版本标签
pnpm install
pnpm run build
pnpm dsh web
想回退旧版同理：全局安装的用 npm install -g @deepseek-ai/dsh@旧版本号 覆盖安装，源码构建的 git checkout 旧 tag 重建。要注意：版本锁定只影响 dsh 程序本体，~/.dsh 下的数据（密钥、profile、会话）不受版本切换影响，切版本不用动数据目录（来源）。npx 方式最灵活，npx @deepseek-ai/dsh@版本 web 想用哪个版跑哪个版，互不干扰，装完也不会留下全局残留。
选版本的注意事项
版本选择的关键是「稳定优先 + 提前核对兼容 + 锁定期望的版本」。 三点提醒：
- 别囤版本：DSH 迭代快，建议跟上
latest节奏，隔几个版本一次性升级更容易遇到连锁问题。 - 追 rc 前备份：rc 版可能有破坏性变更，升级前备份
~/.dsh/sessions会话数据，升级后验证主要功能。 - 锁版本要自知：锁住旧版等于放弃新功能与修复，只在你明确需要兼容特定插件时才锁；锁之前先在 DSH Plugin Hub 核对插件兼容的版本区间。
常见问题
dsh 怎么查看当前版本和最新版本？
当前版本用 dsh --version；npx 方式没有本地安装版本，用 npx @deepseek-ai/dsh --version 查。最新版本用 npm view @deepseek-ai/dsh version，全部版本用 npm view @deepseek-ai/dsh versions。
rc 版本和正式版有什么区别？该不该装 rc 版？
rc 是候选发布版（release candidate），0.1.1-rc.1 表示 0.1.1 正式版前的第 1 个候选版，接口可能变化。求稳追 npm 的 latest 标签，想提前用新功能再装 rc，并提前备份数据。
怎么锁定安装 DeepSeek Harness 的指定版本？
全局安装用 npm install -g @deepseek-ai/dsh@版本号；源码构建的在仓库里 git tag 列出标签、git checkout 对应 tag 再 pnpm install && pnpm run build。npm 上没发布过的版本锁不了。
想回退到旧版 dsh 怎么做？
全局安装的 npm install -g @deepseek-ai/dsh@旧版本号 覆盖安装即回退；源码构建的 git checkout 旧 tag 重建。npx 方式没有本地安装，npx @deepseek-ai/dsh@旧版本号 web 直接跑旧版，数据目录互不影响。
版本号 0.1.1-rc.1 怎么读？
语义化版本号：0.1.1 是主版本.次版本.修订版本，rc.1 表示第 1 个候选发布版。DSH 处于开发者预览阶段，正式版前会先放多个 rc，rc 与 rc 之间接口可能变化。
本文转自 DSH Plugin Hub 插件市场，版权归属 DSH Plugin Hub 插件市场。
分类：更新与升级
原文地址：https://dsh-plugin.org/zh/tutorials/update-version-pin
来源：deepseek-ai/deepseek-harness、dsh CLI README、官方 Quickstart
