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

长期使用建议下面三条:

  1. 在脚本里固定版本号,不用 @latest,避免不同时间装到不同的版本。
  2. 升级前用单独的 DSH_HOME 试运行,避免改动日常使用的 profile。
  3. 升级后重新执行一次插件加载检查: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。