release

在仓库根目录运行完 set-version.ts 后，执行：

releaseVersion=$(node -p "require('./packages/core/package.json').version")
releaseTag="remotion-release-$(printf '%s' "$releaseVersion" | tr . -)"
releaseManifest="/tmp/remotion-release-${releaseVersion}-packages.txt"
bun publish.ts --list > "$releaseManifest"

清单是需要检查并升级的准确包列表。记录每个包之前的 latest 标签，以便在部分升级后回滚。

检查清单中的任何软件包是否将首次发布到 npm。即使使用 --tag，Bun 也会在软件包首次发布时添加 latest。如果有新软件包，请在批量发布前停止，并单独规划它们的首次发布；此流程无法让它们的首个版本避开 latest。

使用上文创建的令牌运行 NPM_CONFIG_TOKEN=<token> bun publish.ts --tag="$releaseTag"。Bun 仍会打包软件包，并重写 workspace: 和 catalog: 依赖。此带标签的流程无法容忍重新发布错误。上传成功并不代表 npm 已完成扫描：请检查清单、确切的软件包版本和临时标签。扫描完成前，不要再次上传相同版本。如果发布尝试失败，且已确认该版本不存在，请使用相同令牌，仅恢复该软件包的发布：bun publish.ts --tag="$releaseTag" --only=<package>；切勿盲目重新运行整个清单。

对于清单中的每个软件包，在提升版本前，必须先通过 npm view <package>@<version> version --json 以及 npm pack <package>@<version> --pack-destination <temporary-directory>。打包检查可确认 tarball 确实能够获取。请使用 while read -r p; do ( ... ) & done < "$releaseManifest"; wait 循环逐个检查软件包（不要使用 xargs -I，否则会因“无法组装命令行”而失败）。发布后，预计约三分之一的软件包仍处于 validating 状态；这可能需要约 15 分钟。将轮询循环编写成脚本并在后台运行，同时起草变更日志。每分钟左右轮询一次尚未解决的软件包；在可用时使用 npm 生命周期状态 API：GET https://registry.npmjs.org/-/package/<encoded-package-name>/version/<version>/status，并使用具有发布权限的凭据进行身份验证。对作用域名称进行 URL 编码，例如 @remotion%2Fwhisper-web，并确保日志中不包含凭据。如果某个软件包在一小时后仍处于 validating 状态，请报告此次发布仍待处理，并让所有 latest 标签保留在上一版本上。blocked、rejected、需要人工审核、缺失和未知状态也都会阻止提升；请调查这些情况，不要将它们视为扫描延迟。

所有软件包均可安装后，使用发布令牌对清单中的每个软件包运行 npm dist-tag add <package>@<version> latest。npm CLI 会忽略 NPM_CONFIG_TOKEN（只有 bun publish 会使用它），并回退到登录会话，从而导致 EOTP 失败。应改用以下方式传递令牌：env "npm_config_//registry.npmjs.org/:_authToken=$TOKEN" npm dist-tag add ...。这会对每个软件包分别执行一次注册表操作；npm 不支持原子化的多软件包提升。请验证每个软件包的 npm view <package> dist-tags.latest --prefer-online 是否都等于发布版本。并行检查可能会让少数软件包返回过期的缓存标签；在将不匹配视为失败前，请逐个重新检查。如果提升过程中途失败，请为已更改的软件包恢复记录的先前 latest 标签，并报告此次发布未完成。成功提升后，请移除每个软件包的临时标签，并验证最终标签。发布令牌在执行 dist-tag rm 时会收到 E403，因此请使用已登录的会话，并为每次调用获取新的 OTP：npm dist-tag rm <package> <releaseTag> --otp=$(op item get "Npmjs" --otp --account remotiondev.1password.com)。如果调用因 OTP 过期而失败，请等待 30 秒后重试一次。

如果 npm 明确返回 E_STAGE_REQUIRED，则该软件包无法直接发布。请停止此次发布，并单独评估分阶段工作流；分阶段审批需要对每个软件包执行一次双重验证操作。不要在此直接发布流程中悄悄混入分阶段发布的软件包。