AMR 生产发布影响报告

生成时间:2026-07-24 11:21:21;分析对象:在 origin/main 手动运行五个生产 GitHub workflow。

当前生产发布点

五个生产 workflow 最近一次成功运行停在 commit: 24742c42Deploy production workflows @ 24742c42)。如果现在在 origin/main 发布,目标 commit 是 e21f3988

变更范围: 24742c42...e21f3988,共 2 个 commit。

此次发布的 feature 和影响面

Feature / Author / Commits Web API Link Admin DB schema / migration
XL模型路由目录生产播种与发布

新增 model routing catalog 的生产 plan/apply 发布能力:通过 GitHub Actions 先 precheck、输出计划摘要,再人工批准 apply。上线后会更新 Link 使用的 providers、backend_models、public_models、public_model_routes 数据,影响实际模型路由结果。

Author:nettee

  • 17e2be5a feat(catalog): add model routing seed plan workflow (#942)
  • e21f3988 fix(catalog): show prod precheck plan summary (#945)
无 Web 代码直接变更;对所有经 Link 调用模型能力的 Web 用户路径有间接影响。 无 API 代码直接变更;对所有经 Link 调用模型能力的 API 路径有间接影响。 有影响:Link 的模型路由 catalog 数据会通过新的 seed plan/apply 流程更新,可能改变 provider、backend model、public model route 的实际选择。 无 Admin runtime 代码变更。 无 schema migration:没有 db/schema 或 db/migrations 变更;但有生产数据 seed/catalog 变更,应使用新的 deploy-model-routing-catalog-prod.yml 执行 precheck/apply。

发布建议

  1. Migration 判断:不需要跑 Atlas schema migration(本次没有 schema/migration 文件变更);需要跑新的 deploy-model-routing-catalog-prod.yml 做 catalog precheck/apply。
  2. 服务发布顺序:本次五个既有生产服务 workflow 没有必须重发的 runtime 代码差异;建议先触发 catalog precheck,审核计划摘要后批准 apply,再验证 Link 路由。若仍要统一走生产发布,可按 DB migration 判断 → Link → API/Web/Admin 的顺序,并以 catalog apply 结果作为 Link 验证重点。
  3. 数据 seed / catalog 判断:catalog 数据发布不由 deploy-db-migrations-prod.yml 覆盖,应使用新增 catalog workflow;审批时重点核对计划摘要中 providers、backend_models、public_models、public_model_routes 的新增/更新/删除。
  4. 发布后观测:验证 Link 模型路由 smoke、重点 public model 的 provider 命中、错误率/429/5xx、计费链路是否正常。

参考:GitHub Comparemodel routing catalog seed runbook