用途:根据提交历史与贡献者元数据,生成风格一致的 ONNX Runtime 发布说明草稿,适用于完整版本发布或限定组件(如 in-tree plugin EP)发布。
主要能力:按预设名称选择发布配置,而非手动提供路径/版本文件;为亮点条目添加 PR 链接;根据贡献者元数据构建仅含人类的致谢名单;支持 ort、webgpu-plugin-ep、cuda-plugin-ep 等预设,配置定义见 presets.json,含 displayName、versionFile、可选 pathsFile(每行一个 git pathspec,可用 :(top) 锚定仓库根)。
必要输入:preset、base_ref(上一发布标签)、target_ref;可选 version、output_dir。版本解析顺序为显式 version、预设 versionFile;输出目录解析顺序为显式 output_dir、共享 outputDirPattern。
使用方式:先生成元数据,缺贡献者产物时运行 python .\tools\python\compile_contributors.py --base <previous_tag> --target <target_ref> --dir <resolved_output_dir>,有 pathsFile 时加 --paths-file。复用产物前需核对 logs.txt 的 base/target 一致。以 detail.csv 为 PR 编号、标题、作者、提交与 cherry-pick 映射的主要来源,logs.txt 用于贡献者摘要与校验,git log 仅作兜底。随后按完整或限定模式构建亮点分类并写出 markdown 草稿到 resolved_output_dir/<draftFileName>,内容含引言、Highlights(每条带内联 PR 链接)、Contributors,必要时附范围说明与 AI 免责声明。
限制与注意:生成耗时较长(扫描历史并抓取 PR 元数据);贡献者名单仅含人类并排除机器人与代理,按字母排序;需检查作者列表异常庞大的 PR 是否因 rebase 引入无关提交,不能仅因其作者身份而致谢;草稿内容不得提及 preset、pathsFile、配置文件等实现细节,也不得自称“draft”;除上述参数与命令外,其余配置与效果暂未提供。