AMR 生产发布影响报告

生成时间:2026-10-09(观察时刻 2026-10-09T02:02:01Z);分析对象:从 origin/main(HEAD 4c9101650)发布 Web、API、Link、Admin、DB migration 与 Model Routing Catalog 的影响分析。四个服务以 EKS Pod 实际运行镜像为生产发布点,DB migration 与 Catalog 以对应 Forgejo workflow 最近一次成功运行的 commit_sha 为生产发布点;六个维度分别计算变更范围。

当前生产发布点(EKS 实态 + Forgejo workflow 记录)

Web、API、Link、Admin 的发布点来自 Grafana / Prometheus 观察到的 Ready EKS Pod 镜像(namespace nexu,datasource prometheus,由 kube-state-metrics 采集,样本新鲜度均在 30 秒内);DB migration 与 Catalog 的发布点来自对应 Forgejo workflow 最近一次成功运行。四个服务均已校验:同一服务所有 Ready Pod 的 commit 与 digest 一致、副本数 spec = updated = available、无滚动中或回滚中的混合状态。 feature 表里只允许列出发布点之后的变更;发布点之前的 commit 属于已生效,归入「已在生产生效」一节。目标 commit 均为 4c9101650(fix(pricing): Design Plan 移除 Sol 并加入 Haiku 5.5 (#219),2026-10-08 14:21,张辉华)。

Web · EKS Pod 实态
Workload:nexu/amr-web · container web
观察时间:2026-10-09T02:02:01Z(Grafana / Prometheus kube_pod_container_info,image 过滤 amr-web:prod-[0-9a-f]{40} 且仅取 Ready Pod)
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:4c9101650
镜像 digest:sha256:177555286f23dee3b836c66a8ce0fe11950589d469eccf94c899ae31c46bf849
Workflow 审计(仅供参考):deploy-web-eks-prod.yml 最近成功 run #4071 @ 4c9101650;与 Pod:一致(workflow 最近成功运行的 commit_sha 与 Pod 实态相同)
本次新增(4c9101650...4c9101650):0 commits,其中 0 个触及该服务目录的变更
发布点已等于 main HEAD:发布点之后 0 个 commit,无净新增内容。 Web 已于 2026-10-08T15:05:54Z 滚动到该 commit(Pod 集合为新的 ReplicaSet amr-web-7468b77fbb-*)。
API · EKS Pod 实态
Workload:nexu/amr-api · container api
观察时间:2026-10-09T02:02:01Z(Grafana / Prometheus kube_pod_container_info,image 过滤 amr-api:prod-[0-9a-f]{40} 且仅取 Ready Pod)
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:3b3ea92c1
镜像 digest:sha256:6599559c5f91bdad4c73298152779034a2938f27d32c74bc8808dee470f0a002
Workflow 审计(仅供参考):deploy-api-eks-prod.yml 最近成功 run #3477 @ 3b3ea92c1;与 Pod:一致(workflow 最近成功运行的 commit_sha 与 Pod 实态相同)
本次新增(3b3ea92c1...4c9101650):6 commits,其中 0 个触及该服务目录的变更
发布点之后 6 个 commit 均不触及 services/api/,API 无净新增内容。
Link · EKS Pod 实态
Workload:nexu/amr-link · container link
观察时间:2026-10-09T02:02:01Z(Grafana / Prometheus kube_pod_container_info,image 过滤 amr-link:prod-[0-9a-f]{40} 且仅取 Ready Pod)
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:3b3ea92c1
镜像 digest:sha256:0b5379e4c4f0e360fd5534abda3c2d5ded5b63c52b798be13a50b9357d2b7adf
Workflow 审计(仅供参考):deploy-link-eks-prod.yml 最近成功 run #3476 @ 3b3ea92c1;与 Pod:一致(workflow 最近成功运行的 commit_sha 与 Pod 实态相同)
本次新增(3b3ea92c1...4c9101650):6 commits,其中 23cfe2099 fix(link): observe media attempt and asynchronous task failures (#144)
发布点之后 6 个 commit 中 1 个触及 services/link/:23cfe2099(#144 媒体失败观测),即本报告 feature 表第 2 行。
Admin · EKS Pod 实态
Workload:nexu/amr-admin · container admin
观察时间:2026-10-09T02:02:01Z(Grafana / Prometheus kube_pod_container_info,image 过滤 amr-admin:prod-[0-9a-f]{40} 且仅取 Ready Pod)
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:4d9eee278
镜像 digest:sha256:dc8f4af23e8f449a8b71b69a20e9ac67e9ad7bf03abbc456ba578c01dc8b5fd9
Workflow 审计(仅供参考):deploy-admin-eks-prod.yml 最近成功 run #2873 @ 4d9eee278;与 Pod:一致(workflow 最近成功运行的 commit_sha 与 Pod 实态相同)
本次新增(4d9eee278...4c9101650):34 commits,其中 0dc3fc2fb feat(admin): expose public model status API (#127)、724488f4b feat(admin): restore drawers, navigation titles and query filters (#188)、ed2fdcd97 revert(admin): rollback public model status API and release phase idempotency (#127) (#193)
发布点之后 34 个 commit 中 3 个触及 apps/admin/:0dc3fc2fb(#127)→ 724488f4b(#188)→ ed2fdcd97(回退 #127);净变更只有 #188,即本报告 feature 表第 1 行。
DB migration · workflow 记录
最近成功:run #3104 @ 2026-09-28T11:54:21Z
发布点 commit:a7aa125f3
本次新增(a7aa125f3...4c9101650):25 commits,其中触及 db/migrations/ + db/schema/ 的变更 0 个
数据源为 Forgejo run 列表(tea api /repos/core/amr/actions/runs),不使用 GitHub Actions。发布点之后无 migration / schema 变更,无需重新运行该 workflow。仓库最新一份 migration 仍为已执行的 20260928085420_account_user_id_index.sql。
Model Routing Catalog · workflow 记录
最近成功:run #3923 @ 2026-10-08T06:37:30Z
发布点 commit:f3ab9fccd
本次新增(f3ab9fccd...4c9101650):1 commits,其中触及 data/json/ + db/seeds/ 的变更 0 个
数据源为 Forgejo run 列表(tea api /repos/core/amr/actions/runs),不使用 GitHub Actions。Catalog 基线已于 2026-10-08T06:37:30Z 前移到 f3ab9fccd(#209 Claude Haiku 5.5),发布点之后无 catalog 变更,本轮不需要再 apply。

此次发布真正新增的 feature 和影响面

feature 表只包含「各维度生产发布点之后」的变更:四个服务以 EKS Pod 实态为基线,DB migration 与 Catalog 以 Forgejo workflow 记录为基线。发布点之前已生效的内容见 「已在生产生效」。

结论:本轮只有 2 个待发布 feature,且各自只影响一个维度:Admin(724488f4b,#188 控制台 UI 恢复,L)与 Link(23cfe2099,#144 媒体失败观测,M)。Web 的发布点已经就是 main HEAD(4c9101650,2026-10-08T15:05:54Z 发布完成),本轮 Web 无待发布内容;API、DB migration、Model Routing Catalog 的发布点之后没有触及本维度目录的变更(API 6 个 commit、DB 25 个 commit、Catalog 1 个 commit 均为其他维度的提交),重发不会带来运行时变化。Admin 待发布范围内的 0dc3fc2fb(#127 公开模型状态 API)已被 ed2fdcd97(#193)完整回退,净变更归零,不进入 feature 表。

Feature / Author / Commits Web API Link Admin DB schema / migration DB catalog(seed)
LAdmin 控制台 UI 恢复:抽屉表单、导航标题对齐、统一带标签筛选栏

恢复此前被 #56 撤销的 Admin UI 优化:表单改用右侧抽屉(#47),页面 H1 与侧边导航标题一致并精简说明(#49),用户、成员、订单、退款、风控使用统一带标签筛选栏(新增 components/ui/query-filter-bar.tsx,筛选条件同步到 URL 参数、重置清除查询,#50);确认操作仍为弹窗。附带修复历史恢复抽屉关闭后的焦点丢失(Escape 回到触发入口)并补充先失败后通过的焦点回归测试。影响对象是内部运营 / 风控 / 财务人员,影响面广(17 个顶层页面 + 会员等级 / 模型规则 / 模型折扣 / 活动配置弹窗),是本轮影响面最大的 feature,但不改变任何后端契约。

注:该 feature 自 ed2fdcd97 合并起即为待发布状态(与上一份发布影响报告一致,本轮 Admin 发布点未变)。Admin 发布点已是三周前,本 feature 已累计待发布 5 天。

Author:Liu Yi

  • 724488f4b feat(admin): restore drawers, navigation titles and query filters(#188)
无。 无。 无。 29 files,+1799 / −1440,全部在 apps/admin/:页面 app/[locale]/(protected)/{activities,audit-logs,coding-plan,coupons,email-domains,entitlements,members,message-center,models/auto-availability,models/list,orders,patrol,refund-management,risk-control,users,workspaces}/page.tsx,新增 components/ui/query-filter-bar.tsx,组件 features/membership/{tier-dialog,model-rule-dialog,model-discount-dialog,model-groups-panel}.tsx、features/refund-management/historical-cancel-only-form.tsx、features/touchpoints/activity-manager.tsx、i18n 中英文案与测试。
仅展示层、文案与测试;未改 Server Actions、API handler、后端 repository、权限规则或数据库 schema。风险点集中在抽屉打开/关闭(含 Escape 焦点)与筛选栏 URL 同步。
无 schema / migration。 无 catalog 变更。
MLink:媒体调用失败与异步任务失败的告警可用观测

修复「媒体失败在告警中丢失」的问题:此前后备供应商成功会覆盖先前失败,异步视频任务失败还会被记成 HTTP 200 的成功轮询。现在在切换供应商 / 替换终态错误之前,先记录带上游归属维度(provider / model / request_id / endpoint)的有界 WARN 日志 event=provider_attempt_failed(upstream media request failed),覆盖公开与内部的图片生成 / 编辑、视频创建 / 查询 / 下载;图片调用复用既有 Bifrost failed-attempt observer,内部重试最终成功也保留失败观测。视频 create/retrieve 观察到 failed / expired / cancelled 时额外记录 event=provider_task_failed(upstream media task failed,含 task_id / task_status),即使该次 HTTP 是 200。不改变 HTTP usage 口径、计费结算、响应体、路由与重试策略;调用前的准入 / 校验拒绝仍走既有 rejection 日志,不伪装成供应商失败;日志不追加原始响应体、请求内容或下载 URL。告警生效还依赖 apps 仓库的 Grafana 规则(apps#587 的对应配置)已部署,且该 PR 自述「post-deployment delivery validation remains outstanding」。

Author:mrcfps

  • 23cfe2099 fix(link): observe media attempt and asynchronous task failures(#144)
无。 无。 commit 共 8 files,+357 / −3;其中 services/link/ 7 files,+353 / −3:新增 internal/handlers/media_observability.go(logMediaProviderFailure / logMediaTaskFailure)与 253 行单测 media_observability_test.go;internal/handlers/openai.go 在图片生成 / 编辑、视频创建 / 查询 / 下载失败与 io.Copy 中断处接入日志;internal_media_image.go / internal_media_video.go 接入内部接口同名路径并补测试。另有 specs/current/link/provider/README.md 记录日志契约。
无路由、无公共响应结构、无计费路径变更。
无。 无 schema / migration。 无 catalog 变更。

本轮被排除的 Admin 变更(净变更归零):0dc3fc2fb feat(admin): expose public model status API(#127)已被 ed2fdcd97 revert(admin): rollback public model status API and release phase idempotency(#193)完整回退。git diff 4d9eee278 4c9101650 -- apps/admin 与 724488f4b 单 commit 的 diff 逐行比对为一致(差异仅为 hunk 行号偏移)。该 API 从未进入生产(BASE_ADMIN 早于 #127),因此 净变更归零:既不进入 feature 表,也不需要回滚动作;Admin 此刻发布不会上线 GET /api/public/v1/models(发布后该路径应仍为 404),发布相位更新行为保持原状(相位不变时仍刷新 updated_at 并记录审计事件)。

范围内其余 commit 不触及六个维度的 runtime 路径:8a48165f6 fix(ci): 移除 Forgejo 不支持的 workflow permissions(#140,仅 .forgejo/workflows/)、37639613f feat(tools): 新增 Erosion / Verbosity 分析与独立报告(#129,tools/code_quality/)、8b22b0b11 docs: reconcile documentation with code evolution(#130)。这些 commit 在对应发布点之后,但只影响 CI / 工具 / 文档,不改变服务运行时行为,也不改变 deploy-*-prod.yml 的产物;若本轮滚动 Link / Admin,它们会作为历史一起被打包,但无运行时差异。

已在生产生效(发布点之前,本次不重复发布)

以下 feature / commit 均在对应生产发布点之前,已在生产运行。四个服务以 EKS Pod 实态为基线,DB migration 与 Catalog 以 Forgejo workflow 记录为基线;若从 main 重新发布,只分析各自基线之后的净新增。

发布建议

  1. Migration 判断:不需要跑 migration。BASE_DB a7aa125f3(2026-09-28)之后到 main 的 25 个 commit 中,没有任何 db/migrations/ 或 db/schema/ 变更;最新 migration 仍是已执行的 20260928085420_account_user_id_index.sql,无需触发 deploy-db-migrations-prod.yml。
  2. 服务发布顺序:本轮只需发布 Link、Admin 两个服务;Web / API 不必滚动(Web 发布点已是 main HEAD;API 之后没有 services/api/ 变更),Catalog 与 DB 不必触发。
    • Admin:触发 deploy-admin-eks-prod.yml,发布 724488f4b(发布点之后 34 个 commit 中净剩 1 个 feature)。
    • Link:触发 deploy-link-eks-prod.yml,发布 23cfe2099 共 1 个 commit(滚动后应等于 main HEAD)。
    • 两者之间没有依赖,可并行;若希望告警链路一次性对齐,建议 先 Link、后 Admin,并与 apps 仓库的 Grafana 规则(apps#587)同批上线,便于在同一时间窗内做投递验证。
    • Web 若为求 Pod 与 HEAD 完全一致而重发,也不会带来运行时变化(发布点 == 4c9101650)。
  3. 数据 seed / catalog 判断:
    • Catalog 已追平到 f3ab9fccd(10-08 apply),本轮没有待 apply 的 catalog 内容;重跑 deploy-model-routing-catalog-prod.yml 至 4c9101650 是无净数据变化的幂等操作,除非需要重新确认 baseline,不建议触发。
    • Public Pricing 仍是独立 workflow 的落后项:data/json/public_pricing.json 由 deploy-public-pricing-prod.yml 单独发布,当前基线仍是 0ab43a985(2026-09-24)@ run #2813。自该基线以来价格文件已被 2134cdb88(Sonnet 5.5)、392374aba(GPT-6.1 Sol)、f3ab9fccd(Haiku 5.5)三次修改,若希望 /api/v1/public/pricing/latest 与官网价格表出现这三行价格,需要单独触发该 workflow。这属于价格投影追平,不改变模型可用性;若不需要对外价格先更新,可暂不触发。
  4. 发布后观测:
    • Pod 实态:Link 与 Admin 镜像 tag 应变为 prod-4c9101650…,Ready 恢复 2/2,updated / available 与 spec 一致(当前 Link 与 Admin 的 spec 均为 2);Web(prod-4c9101650…,digest sha256:177555286f23dee3b…)与 API(prod-3b3ea92c1…,digest sha256:6599559c5f91bdad4…)镜像与 digest 应保持本报告值不变,用于确认「无净变化」预期。
    • Link 媒体观测(#144):图片生成 / 编辑、视频创建 / 查询 / 下载失败时应出现 Loki 中 event=provider_attempt_failed(upstream media request failed)与 event=provider_task_failed(upstream media task failed)日志,且带 provider / model / request_id / endpoint 归属字段;视频任务 failed/expired/cancelled 在 HTTP 200 轮询下也应产生日志。告警真正触发需要 apps 仓库 Grafana 规则已部署(apps#587);发布后应做一次投递验证(PR 自述 post-deployment delivery validation 仍待完成),并确认计费 / usage 口径未受这些日志改动影响。
    • Admin UI 回归(本轮影响面最大的 feature):用户 / 成员 / 订单 / 退款 / 风控五个页面筛选栏提交后 URL 参数与列表正确、重置能清空查询;会员等级额度按美元提交后换算正确(如 $20.50 → 205000 credits);模型规则 / 模型折扣 / 活动配置抽屉保存与失败恢复;历史恢复抽屉 Escape 后焦点回到触发入口。鉴权边界保持不变:GET /api/public/v1/models 应仍为 404(该路由已随 #127 回退,未被本次发布引入)。

备注:本报告所有 workflow、commit、PR 与 compare range 均指向 Forgejo code.powerformer.net/core/amr,不使用 GitHub Actions。四个服务的 compare range 基于 Grafana / Prometheus 观察到的 Ready Pod 镜像 commit;DB migration 与 Catalog 的 compare range 基于各自 workflow 最近一次成功运行的 commit_sha;四个服务维度另附对应 deploy-*-eks-prod.yml 最近成功记录作为审计对照。