Storybook 的发布方式

Storybook 包（storybook 以及 @storybook 组织下的所有包）遵循语义化版本控制（semver）。我们有一个结构化的发布流程，以确保稳定性、兼容性以及为用户提供顺畅的升级路径。本页面概述了我们的发布渠道、支持的版本以及主版本、次版本、补丁版本和预发布版本的发布周期。

发布渠道

我们通过两个渠道发布版本。您可以通过 npm 标签安装特定渠道：

• 稳定版渠道 (latest)：安装最新的稳定版本。

npm create storybook@latest

• 预发布渠道 (next)：安装最新的预发布版本。

npm create storybook@next

支持的版本

我们积极维护 Storybook 的最新主版本。在当前主版本内，我们仅对最新的次版本进行补丁更新。大多数修复和新功能将进入下一个次版本（有时是主版本），并且不会向后移植。关键的安全修复可能会更广泛地向当前主版本移植，在极少数情况下（例如，在新主版本发布后的短时间内），可能会向前一个主版本移植。

例如，如果最新版本是 9.2.1

• 我们支持 9.x.x 版本，并发布 9.2.x 补丁版本
• 大多数修复和新功能将作为 9.3.0-alpha.x 版本发布
  • 如果下一个版本是主版本，它将是 10.0.0-alpha.x
• 我们将关键的安全修复向后移植到 9.1.x 或 9.0.x
• 极少数情况下，我们可能会根据需要向后移植关键修复到 8.6.x

为了与其他 JavaScript 生态系统中的库和工具兼容，请参阅兼容性跟踪器。

发布周期

主版本发布

发布周期：大约每年一次

渠道：稳定版 (latest)

主版本发布会引入重大更改和重要新功能。我们通过主版本发布来适应生态系统的变化，改进 Storybook 的架构和 API，并使工具更快速、更精简、更易于使用。

一旦我们开始进行主版本开发，我们会暂停次版本发布，但会根据需要继续发布补丁版本。主版本发布会经历一系列预发布——alpha、beta 和 rc（发布候选版）——之后才会进入稳定渠道。我们旨在包含自动化迁移工具，并在需要手动更改时提供全面的迁移指南。

次版本发布

发布周期：大约每 8 周一次

渠道：稳定版 (latest)

次版本发布会带来新功能、增强功能和非破坏性改进。每个次版本发布可能会有一个 alpha 预发布（例如 x.y.0-alpha）。

补丁版本发布

发布周期：按需发布（仅针对当前次版本）

渠道：稳定版 (latest)

补丁版本发布包含关键的 bug 修复和安全更新。这些仅针对当前次版本发布，并且不会进行预发布。

预发布

发布周期：定期

渠道：预发布 (next)

预发布是为了在正式发布前收集早期反馈并确保稳定性。次版本稳定发布前会有带有 alpha 标签的预发布（例如 x.y.0-alpha），没有补丁预发布。主版本稳定发布前会有更完整的 alpha、beta 和 rc 预发布周期，然后才是最终发布。