WASI 版本发布管理全指南:Release Train 固定节奏与 GitHub Actions 自动化发布流程

原创2026-10-11 20:05:321,399 阅读

WASI 版本发布管理全指南:Release Train 固定节奏与 GitHub Actions 自动化发布流程

WASI(WebAssembly System Interface)以「版本列车(Release Train)」机制管理 0.3.x 系列的定期发布:每两个月固定一个发布日期,而不是等某个功能集齐才发版。本文基于 WASI 仓库的 Release 文档 展开,系统讲解其发布节奏的由来与演变、2026-2027 年的完整发版日程表,以及由 GitHub Actions 全自动驱动的四步发布流程(含 gh 命令行操作),同时结合仓库内的 Component Model 特性采用记录、specifications 版本快照 与各提案 WIT 文件中的版本号,说明一次发布如何在仓库中真正落地。读完本文,你将掌握 WASI 版本发布的完整时间线、手工创建新版本所需的全部命令与前置条件,并理解发布与 Component Model 特性门控之间的联动关系。

WASI Release Train:固定节奏驱动版本发布

WASI 0.3.x 的新补丁版本(patch version)采用严格的时间驱动发布策略:每两个月发布一次,固定在当月的第二个星期二。这套日程在社区中通常被称为「WASI 发布列车(WASI release train)」,因为发版与否完全由固定日程决定,而不是由是否达到某个功能门槛(feature threshold)决定。

这一机制的含义包括:

  • 可预期性:运行时(runtime)、工具链(toolchain)与下游用户可以根据日历提前规划升级与兼容性验证;
  • 小步快跑:每个 0.3.x 补丁版本携带的变更相对收敛,降低单次升级的破坏面;
  • 强制纪律:尚未完成的功能不会被「硬塞进」某个版本,而是自然顺延到下一个发版窗口。

WASI 0.3 版本在 README 中被定位为当前预览版(Preview 3),它基于 Component Model 构建,用组件模型原生的 future 与 stream 类型取代了 0.2 中显式的流与轮询接口(见 README.md)。每次 0.3.x 发版都会生成一份对应的规范快照(见下文「版本号在仓库中的落地」),因此这条「列车」的每一次停靠,都意味着 WIT 定义与规范文档的一次正式更迭。

历史发布节奏的演变:从 0.2.x 到 0.3.x

Release Train 机制并非一成不变,docs/Release.md 明确记录了它的历史调整:

时间段 发布节奏 说明
WASI 0.2.1 – 0.2.12 每两月的第一个星期二 同样为两月一次,但日期为当月首个周二
WASI 0.3.0 一次性发布(one-off vote) 唯一不遵循 0.3 Release Train 的版本,经由一次性投票决定
WASI 0.3.1 起 每两月的第二个星期二 当前 0.3.x 的标准节奏

其中 WASI 0.3.0 是 0.3 发布列车唯一的例外:它属于一次性投票产生的版本。之所以会有这种例外,从仓库内容可以推断,0.3.0 是整个 Preview 3 系列的第一个版本,承载着 async lift/lower、future 与 stream 等一批 Component Model 门控特性的首次采用(见 Component Model features in WASI),属于一次里程碑式的发版,因此单独安排投票而非走常规节奏。

文档同时给出了面向未来的规划:

  • WASI 1.0:当 1.0 准备就绪时,可能再次在发布列车之外安排一次性发版;
  • 1.0 之后:WASI 提案(proposals)的发布节奏目前尚未确定,未来可能调整。

2026-2027 年 WASI 0.3.x 发布日程表

docs/Release.md 给出了 2026-2027 年已经排定的 WASI 0.3 系列完整日程。以下是原文的完整表格(日期均为 UTC 视角下的当月第二个星期二,0.3.0 例外):

版本 发布日期 备注
WASI 0.3.0 2026-06-11 一次性发布(one-off release)
WASI 0.3.1 2026-08-11 回归 Release Train
WASI 0.3.2 2026-10-13 常规发版
WASI 0.3.3 2026-12-08 常规发版
WASI 0.3.4 2027-02-09 常规发版
WASI 0.3.5 2027-04-13 常规发版
WASI 0.3.6 2027-06-08 常规发版
WASI 0.3.7 2027-08-10 常规发版
WASI 0.3.8 2027-10-12 常规发版
WASI 0.3.9 2027-12-14 常规发版

对照日历可验证其规律:例如 2026 年 8 月 11 日、10 月 13 日、12 月 8 日均是该月的第二个星期二;2027 年各版本同样遵循此规则。任何关心 WASI 演进节奏的开发者,都可以用这张表规划自己的依赖升级窗口——例如选择在发版后数周再跟进最新 0.3.x,以观察社区反馈。

创建新版本:GitHub Actions 驱动的四步自动化流程

docs/Release.md 明确指出:发布过程完全由 GitHub Actions 自动化。要创建新版本,由 WASI 联席主席(Co-chair)运行名为「Release WASI」的 workflow(对应仓库中的 release.yml),随后一系列 PR 与 Release 会被自动创建。整个流程分为以下四个步骤:

第一步:触发 Release WASI 工作流

在 WASI 仓库中,通过 GitHub CLI 执行:

gh workflow run release.yml -f prev_version=0.3.<prev> -f next_version=0.3.<next>

两个关键参数:

  • prev_version=0.3.<prev>:上一个已发布版本号(例如 0.3.1);
  • next_version=0.3.<next>:本次要发布的新版本号(例如 0.3.2)。

工作流依据这一对「前/后」版本号确定本次发版需要更新的所有版本号位置。命令只负责触发,后续的 PR 创建、版本号替换等动作全部由 workflow 自动完成。

第二步:版本号更新 PR

工作流会自动创建一个更新所有版本号的 Pull Request。该 PR 处于两个阻塞条件之下:

  1. CI 必须通过:仓库的持续集成会验证版本号一致性、WIT 编码等内容;
  2. 必须经过人工审查:由维护者 review 后合并。

这一步保证仓库内所有引用旧版本号的地方(包括各提案的 WIT package 版本、文档、依赖声明等)被一次性同步替换,避免出现「版本号不一致」的发布事故。

第三步:创建 GitHub Release

版本号 PR 合并后,创建 GitHub Release,命令为:

gh release create "v0.3.<version>" --generate-notes

其中 v0.3.<version> 是形如 v0.3.2 的标签(tag)。--generate-notes 让 GitHub 根据合并的 PR 自动生成发布说明。

这里有一个必须人工介入的检查点:如果该次发布采用了新的 Component Model 特性(例如 0.3.1 采用的 map<K, V> 类型、implements 与 external-id 注解),生成后的发布说明必须被编辑,显式点名这些新采用的特性。采用的完整记录见 Component Model features in WASI,其流程细节见 CONTRIBUTING.md 中的「Adopting Component Model features」一节(该节明确要求「该版本的发布说明必须点名新采用的 Component Model 特性」)。

第四步:自动填充 specifications/ 目录

Release 创建成功之后,系统会自动创建第二个 PR,用于填充仓库根目录下的 specifications/ 目录——即为本次发布生成一份规范快照。从当前仓库的结构可以观察到这套机制的落地成果:

  • specifications/wasi-0.2.0/Overview.md 至 specifications/wasi-0.2.12/Overview.md:覆盖 0.2 系列全部 13 个快照;
  • specifications/wasi-0.3.0/Overview.md、specifications/wasi-0.3.1/Overview.md:0.3 系列的快照(当前已生成到 0.3.1,与文档中的 Release Train 时间表吻合)。

当这第二个 PR 合并后,整个发布流程即宣告完成。

发布流程中的角色与职责小结

参与者 职责
WASI Co-chair 运行触发命令(gh workflow run)
GitHub Actions 自动创建版本号 PR、自动生成 Release、自动创建 specifications PR
CI + 人工审查 阻塞版本号 PR,确保一致性
维护者 编辑 Release notes,点名新采用的 Component Model 特性

发布与 Component Model 特性采用的关系

发布列车与 Component Model 的特性门控(gated features)紧密耦合。WASI API 以 Component Model 为定义基础,而后者把新的 WIT 语法、类型与规范 ABI 功能放在「门控特性」之后逐步开放。稳定(@since 门控)的 WASI API 只有在 WASI Subgroup 投票采纳之后,才允许依赖某个门控特性,采用流程见 CONTRIBUTING.md。

采纳是累积式的:实现某个 WASI 版本,需要默认(非门控)的 Component Model 特性,加上该版本及所有更早版本中已采纳的全部特性。这一点在 docs/ComponentModelFeatures.md 的采用记录表中明确列出:

WASI 版本 门控 特性 采纳时间
0.2.0 — 默认(非门控)的 Component Model 特性 WASI 0.2 投票(早于本流程)
0.3.0 🔀 async lift/lower、future 与 stream WASI 0.3 投票(早于本流程)
0.3.1 🗺️ map<K, V> 类型 2026-08-06
0.3.1 🏷️ 纯命名接口导入导出上的 implements 与 external-id 注解 2026-08-06

值得注意的是:采纳某个特性,并不等于某个 WASI API 已经使用它,而是意味着该版本及之后版本的 API 可以使用它,同时实现该 WASI 版本的运行时与工具链必须实现该特性(即使目前尚未被用到)。这正是 0.3.1 的发布说明需要点名 map 类型与 implements 注解的原因。

CI 对该约束有强制保障:docs/ComponentModelFeatures.md 说明,每次变更的提案都会被编码为组件,并以上表中已启用特性的集合进行验证——任何依赖未采纳特性的提案都会在验证阶段失败,从而从机制上杜绝「稳定版悄悄引入门控特性」的风险。

版本号在仓库中的落地:从 WIT 包到规范快照

一次发布最终会在仓库的多个位置留下痕迹,可以从当前仓库中直接验证:

1. 提案的 WIT 包版本号

各提案的 WIT 文件顶部声明了 package wasi:<proposal>@<version>。以当前仓库为例,所有提案目录中的 WIT 文件均已同步到 0.3.1:

@since(version = 0.3.0) 这样的门控注解正是版本与特性联动机制的源码级体现——它标记 API 自 0.3.0 起稳定,同时暗含了 0.3.0 已采纳的 async/future/stream 特性基线。

2. 规范快照目录

specifications/ 下每个版本的 Overview.md 记录该版本包含的提案及其 OCI 包版本。例如 specifications/wasi-0.3.1/Overview.md 列出了 wasi:random@0.3.1、wasi:clocks@0.3.1、wasi:sockets@0.3.1、wasi:filesystem@0.3.1、wasi:cli@0.3.1、wasi:http@0.3.1 六个提案,并附上该版本要求采纳的 Component Model 特性表;specifications/wasi-0.3.0/Overview.md 则只有 async、future、stream 一行。这两份相邻快照的差异,正好可以作为「采纳是累积的」这一规则的真实样本。

结语

WASI 的发布管理是一套「时间驱动 + 全自动化 + 特性门控」三位一体的工程机制:Release Train 保证了 0.3.x 每两个月第二个星期二的稳定交付节奏;GitHub Actions 将版本号更新、Release 创建、规范快照生成全链路自动化;而 Component Model 特性采用记录与 CI 验证则确保任何稳定版都不会意外依赖未采纳的门控特性。对于运行时与工具链的维护者,理解 gh workflow run / gh release create 这套命令与四步流程,即可完整复现一次 WASI 发版;对于下游用户,2026-2027 的日程表则为依赖升级提供了清晰的日历锚点。WASI 1.0 之后节奏如何调整,docs/Release.md 明确表示尚未确定——这也意味着上述机制在未来仍可能继续演进。

登录后查看全文
WASI