用途:为 WebUI 准备发布版本升级 PR。输入必须是裸 semver 版本号(不带前导 v),例如 0.0.16;仅在比较或创建 Git 标签时使用 v<version>。热修复发布改用仓库命令:cargo xtask hotfix <commit> <oldest-tag> [--dry-run] [--support-commit <commit>]。<oldest-tag> 可带或不带 v;该命令会为范围内每个稳定发布标签独立递增 -hotfix.<number> 后缀,创建 hotfix/v<version> 分支并推送以排队受保护的 Azure 发布流水线;准备多条发布线时先加 --dry-run;当旧发布线需要更新版本的热修复工具时可使用 --support-commit。
主要流程:确认工作分支不是 main,必要时创建 <user>/bump-v<version> 分支;执行 git fetch --tags --quiet 更新标签;运行 cargo xtask version <version> 完成版本升级;运行 cargo xtask check 完整质量门并修复失败。随后找出上一个发布标签(v 前缀),若找不到则停止。需在提交版本升级之前收集上一发布到当前基线的提交,以免发布说明包含本次升级提交。提交信息使用命令式:chore: bump version to <version>,并附带 Co-authored-by: Copilot 署名行。发布 PR 标题同为该信息。
发布说明分桶:Features(feat: 提交、功能 PR、新用户可见能力、演示)、Fixes(fix: 提交、缺陷修复、回归、正确性修复)、Docs(docs: 提交、纯文档 PR、政策/issue 模板变更及混合 PR 中的文档工作)、Maintenance(与发布相关的杂项、重构、依赖或 CI 变更);省略空桶。优先写简洁的用户可见摘要,可合并相关提交为一条,每条附上支持 PR 标题、编号与贡献者,格式为「- 摘要 (PR 标题 #编号 by @贡献者).」,贡献者取 PR 作者的 GitHub 登录名,不用提交作者或共同作者;一条合并多个 PR 时逐个重复 #编号 by @贡献者。不要包含提交 SHA。PR 正文含 Release、Changes、Validation 三段,Validation 列出 cargo xtask check,并移除空桶。
限制:资料未提供费用、价格、平台支持范围及失败恢复细节。