用途:为 ONNX Runtime 升级所固定的 ONNX 依赖与 opset(例如 ONNX 1.21/opset 26 升至 1.22/opset 27)提供可重复的逐步检查清单,每次 ONNX 发布都会复用。参考 PR:#27601(ONNX 1.21,rc1→正式版,最佳示例)、#26579(1.20.1)、#25678(1.19),另见 docs/How_To_Update_ONNX_Dev_Notes.md。
策略:先集成 RC,按发布分支 HEAD 提交固定(vX.Y.0rcN 标签通常尚不存在),跑完整构建与测试,发现 ONNX 侧缺陷则上游报 bug;每个 RC 重新固定,通常只改 Group-A 版本管线文件,并删除 ONNX 已合并的 onnx.patch 片段;正式版发布后再固定到 vX.Y.0 标签。
文件分类:Group A 版本管线(cmake/deps.txt、cmake/external/onnx 子模块、vcpkg 端口文件、onnx.patch、binskim.patch、7 个 requirements.txt 及 QNN/android CI yaml 等)必须最先落地;Group B opset 启用(optimizer_api.h 的 kMaxSupportedOpset、cpu_execution_provider.cc 内核注册、各 EP 同步版本拆分与 GetMaxSupportedOpSet 上限);Group C 文档与测试数据(OperatorKernels.md、webgl-operators.md、backend 测试过滤与覆盖文件);Group D 条件性修改。IR 版本不手动升级,随 ONNX 头文件自动跟随。
归档哈希:cmake/deps.txt 第三字段为 .zip 的 SHA1,vcpkg portfile.cmake 用 .tar.gz 的 SHA512;子模块提交 SHA 与归档 SHA1 不可互换。vcpkg 产物须先镜像到 Microsoft vcpkg 存储,否则 --use_vcpkg 构建失败;镜像需 Windows + az 凭据 + Terrapin 工具,属微软内部步骤,外部/Linux CI 无法执行。可用 curl 探测镜像是否就绪(200 已镜像,404 未镜像),每次 RC 与正式版都需重新上传。
限制:资料未提供该清单的自动化程度、适用版本范围之外的信息,也未说明收费或平台支持情况。