用途:为 NVIDIA Warp 的即将发布版本生成 GitHub 发布说明的 Markdown 草稿,供发布经理编辑后发布。
主要能力:自动从版本号判断是功能版(patch 为 0)还是修复版(patch 大于 0);自动选择正确的上一个发布标签作为 diff 基准;从 Towncrier 片段或已打标签的 CHANGELOG.md 提取当前版本内容;统计提交范围并做 cherry-pick 过滤;生成贡献者致谢;输出为 GitHub Gist 或本地 Markdown 文件。
使用方式:位置参数可为分支名(按 upstream/、origin/、本地顺序解析)、标签(如 v1.13.0)或省略(默认 HEAD)。版本号来自 VERSION.md 或标签名。流程分阶段:先解析目标与上一版本,再与用户确认范围与输出目标,然后收集输入、规划分组、起草各节。gh 可用且已认证时默认输出到 secret gist,文件名 warp-<version-string>-release-notes.md;否则输出到本地带日期的 Markdown 文件。
适用场景:Warp 功能版与修复版的发布说明撰写,需要面向用户的可读摘要、代码示例、破坏性变更前后对比、公告与致谢。
限制:依赖 git、gh、uv/uvx 与固定版本 towncrier==25.8.0;需用户显式确认后才继续;贡献者致谢仅自动渲染 classification 为 external 且 already_shipped 为 False 的条目;无 gh 时无法关联 GitHub 用户名;平台支持与发布节奏变更仅在确实变化时才写入;资料未提供具体收费、价格或平台信息。