dsh 版本对照:npm dist-tags 与 GitHub tag
核验于 2026-10-31dsh 0.2.1-rc.5版本说明
当前版本号
2026-10-31 核验到的状态:
- npm latest:
0.2.1-rc.5—— 用npx安装时默认拿到的版本 - npm next:
0.2.1-rc.5—— 当前与 latest 指向同一个版本;两个标签并不保证一直相同 - npm alpha:
0.2.2-alpha.2—— 已经走到下一个次版本的 alpha 线 - GitHub tag:
dsh-v0.2.1-rc.5—— 仓库 release 的最新 tag
上面四个版本号不在同一条发布线上,也不会自动同步。latest、next、alpha 是 npm 的发布标签;GitHub tag 由另一套发布动作产生,发布时间和内容都可能与 npm 不同。这次 latest 与 next 重合、tag 又刚好等于 latest,是发布节奏的结果;下一次发布就可能重新分开,所以引用版本号时要写出具体版本,不要只写通道名。
npx 默认安装 latest 的原因
npm 的默认标签是 latest。下面两条命令等价:
npx @deepseek-ai/dsh web
npx @deepseek-ai/dsh@latest web
这两条命令拿到的都是 latest 指向的 0.2.1-rc.5。本页核验时 next 恰好也指向同一个版本,但两个标签并不保证相同;想明确选择通道,就在命令里写出标签:
npx @deepseek-ai/dsh@next web
npx @deepseek-ai/dsh@alpha web
要确认各通道当前的版本号,用下面这条命令向 npm 查询:
npm view @deepseek-ai/dsh dist-tags
版本号的各段含义
0.2.1-rc.5 分成四段,每段的含义:
0:主版本。官方仍处于 developer preview,主版本停在 0,破坏性变更随时可能出现。2:次版本。次版本变化通常包含功能调整。1:补丁版本。rc.5:预发布标记。alpha更早,rc更接近稳定。
同一个次版本内,预发布序号越大代表版本越新;跨次版本时不要只比较数字大小,要先看 release 说明。
升级
最可控的做法是把版本号直接写进命令:
npx @deepseek-ai/dsh@0.2.1-rc.5 web --no-open
长期使用建议下面三条:
- 在脚本里固定版本号,不用
@latest,避免不同时间装到不同的版本。 - 升级前用单独的
DSH_HOME试运行,避免改动日常使用的 profile。 - 升级后重新执行一次插件加载检查:
dsh --profile web --dump-config。
破坏性变更的跟进方法
官方在 README 里明确标注 developer preview,意味着会有兼容性破坏。跟进破坏性变更时看下面三处:
- GitHub Releases 的说明
engines.dsh:插件声明的兼容范围- 官方
upgrade-guide文档
插件作者尤其要注意:engines.dsh 与当前 dsh 版本不匹配时,安装或启动阶段就会被拒绝,问题比运行时才报错暴露得更早。
本站的核验规则
- 每页头部写明核验时的 dsh 版本与日期
- 每周由脚本比对 npm dist-tags 与 GitHub 最新 tag
- 页面核验超过 30 天会显示提示条
- 版本对照表以
src/data/versions.json为准,该文件由脚本生成
如果页面写的版本与当前 npm 不一致,请比较官方 release 与本页的核验日期,以更新的那一条为准,也欢迎提 issue。