用途:在需要把 github/gh-aw 更新到更新的 github/gh-aw-firewall 发布版本时使用,目标是干净地完成版本升级、重建生成产物,并审查上游发布/规范变更,找出应随升级一并处理的后续工作。
主要能力:读取并记录 pkg/constants/version_constants.go 中的 DefaultFirewallVersion 与所有 AWFMinVersion 常量;查询最新 github/gh-aw-firewall 发布;若最新标签与 DefaultFirewallVersion 相同则报告无需升级;若有更新则更新版本固定值,并按新发布引入或变更的受门控标志/特性调整 AWFMinVersion。审查发布说明中的新增标志、移除或弃用标志、schema/配置新增、安全修复及可能影响测试、文档或 ADR/规范的行为变化。对照上游规范与 schema 检查 pkg/workflow/schemas/awf-config.schema.json、specs/awf-config-sources-spec.md 及本地 AWF 配置生成与校验代码。
使用方式:编辑前先查阅最新发布元数据与正文、版本常量、规范文件、嵌入 schema 及 pkg/workflow/awf_config.go、awf_helpers.go 和相关测试;对比目标发布或标签中的 docs/awf-config-spec.md、docs/awf-config.schema.json、src/awf-config-schema.json 及发布资产。更新嵌入 schema 副本、版本门控辅助代码/测试、规范或 ADR,并在升级改变已发布行为时添加或更新 patch changeset。编辑后按顺序执行 make build、make recompile、make recompile,再对涉及的 Go 代码或 schema 逻辑运行聚焦验证。
适用场景:gh-aw 与 AWF 防火墙版本集成、schema 与规范同步、版本门控维护。
限制:资料未提供具体版本号、命令输出、测试命令细节及收费信息;需以实际仓库与上游发布为准。