SuperAPI AI 工具集

update-release-graph

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:在 .NET 新补丁、新主版本、CVE 数据变更或版本进入 EOL 时,重新生成 release-notes/ 下的 HAL+JSON 发布信息图。该图由相互链接的 JSON 文件组成,使用 HAL 的 _links 与 _embedded 属性,必须由源数据生成,不能手工编辑输出文件。

主要能力:release-notes 工具提供四个生成命令——generate version-index(根索引、主版本索引、补丁索引、manifest、SDK 索引、下载文件)、generate timeline-index(时间线根、年、月索引)、generate llms-index(llms.json,仅受支持版本)、generate indexes(一次生成全部)。命令格式为 release-notes generate <type> <input-dir> [output-dir] [--url-root <url>]。

使用方式:先安装工具 dotnet tool install -g release-notes --add-source https://nuget.pkg.github.com/richlander/index.json,并安装 markdownlint。确认源数据更新后运行 release-notes generate indexes release-notes,再生成旧格式文件 release-notes generate releases-index release-notes 与 release-notes generate releases release-notes,随后用 release-notes verify releases release-notes 校验链接与哈希,最后提交 PR。单独运行时顺序为 version-index → timeline-index → llms-index。

适用场景:月度服务补丁发布、新增主版本、CVE 刷新、版本 EOL、任何源数据修改后需同步图。

限制:生成文件不可手工编辑;_manifest.json 是源,manifest.json 是输出;_llms.json 为可选覆盖源;生成器幂等;GitHub Packages 即使公开仓库也需认证,401 时需配置凭据;verify 可能耗时数分钟,不要取消。