AMR 生产发布影响报告

生成时间：2026-08-25；分析对象：在 origin/main（HEAD 120d389b7）手动运行六个生产 GitHub workflow 的影响分析。注意：各 workflow 最近一次成功发布点不同，下方「变更范围」按各自发布点分别计算，只有发布点之后的 commit 才属于该 workflow 本次新增。

当前生产发布点（各 workflow 独立计算）

六个生产 workflow 最近一次成功运行均停在 e0db21a1d（2026-08-24 11:02–11:19Z 协调发布，六条 workflow 全部成功），因此各 workflow 发布点相同、变更范围一致。 feature 表里只允许列出发布点之后的变更；发布点之前的 commit 属于已生效，归入「已在生产生效」一节，不得重复出现在 feature 表。目标 commit 均为 120d389b7 （fix(e2e): remove obsolete migration-only fixture (#1750)）。

deploy-web-eks-prod.yml
最近成功：2026-08-24 11:19:27Z
发布点 commit：e0db21a1d
本次新增（e0db21a1d...120d389b7）：3 commits
（发布点之前已上线：Web 个人支付加载/成功反馈优化 #1722、订阅 checkout 归因与报价防抖等）
deploy-api-eks-prod.yml
最近成功：2026-08-24 11:11:42Z
发布点 commit：e0db21a1d
本次新增（e0db21a1d...120d389b7）：3 commits
（发布点之前已上线：API 暴露 coding plan 模型 #1730、Stripe cancel_at 持久化 #1726、usage history 分页 #1737 等）
deploy-link-eks-prod.yml
最近成功：2026-08-24 11:11:53Z
发布点 commit：e0db21a1d
本次新增（e0db21a1d...120d389b7）：3 commits
（发布点之前已上线：billing scope last-good 缓存 #1710、Anthropic 缓存 checkpoints #1725 等）
deploy-admin-eks-prod.yml
最近成功：2026-08-24 11:11:56Z
发布点 commit：e0db21a1d
本次新增（e0db21a1d...120d389b7）：3 commits
（发布点之前已上线：Admin patrol 告警调度器 #1723、Coding Plan 模型分 tier 访问组 #1733 等；本次无 admin 变更）
deploy-db-migrations-prod.yml
最近成功：2026-08-24 11:02:38Z
发布点 commit：e0db21a1d
本次新增（e0db21a1d...120d389b7）：3 commits
（发布点之前已上线：与 08-24 发布配套的 migration（如 usage history 分页相关 schema）；本次无 migration）
deploy-model-routing-catalog-prod.yml
最近成功：2026-08-24 11:13:13Z
发布点 commit：e0db21a1d
本次新增（e0db21a1d...120d389b7）：3 commits（其中涉及 data/json 与 db/seeds 的 commit 才算 catalog 变更——本次无）
（发布点之前已上线：DeepSeek peak/off-peak COGS + Aiping/Aliyun billed rates #1731 等）

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

feature 表只包含「各 workflow 发布点之后」的变更；发布点之前已生效的内容见 「已在生产生效」 一节，不要重复列入。本次三个 commit 均在各 workflow 发布点（e0db21a1d）之后，按维度过滤后归类为 3 个 feature。

Feature / Author / Commits Web API Link Admin DB schema / migration DB catalog（seed）
XLLink 共享目录成员策略缓存（跨副本 membership policy last-good 缓存）

把 Link 网关的成员资格/模型授权（membership policy）缓存从单副本进程内（L1）升级为跨副本共享：复用既有 Redis（billing-scope last-good 缓存基础设施，统一命名为 modelCatalogRedis），新增 membership_policy_last_good:v1 Redis key（L2 层）。Redis 回落带 100ms 超时上限，不阻塞请求主链路；缓存语义改为单调（只增不减），authority 拒绝（invalidating 状态）时同时清 L1/L2。影响所有经 Link 的模型请求（含 GET /v1/models 的 catalog fallback 路径），目标是提升跨副本命中率、降低对外部授权/目录服务的依赖。

Author：Caprika

  • cc0e715c8 feat(link): share catalog membership policy cache (#1735)
 无。 无。 仅 Link 发布点（e0db21a1d）之后的变更：services/link/internal/membership/client.go（+324）、client_test.go（+438）、internal/server/server.go（注册 cache observer）、internal/usage/metrics.go（新增 gateway_membership_policy_cache_events_total 指标，event= cache_hit/stale_fallback/refresh_failure/cold_miss，layer= l1/l2/none）。 无。 无 schema/migration（db-migrations 发布点 e0db21a1d 之后无 db/migrations 变更）。 无 catalog 变更。
L认证定价桥接分析事件（authenticated pricing bridge analytics）

新增生产可调用的分析端点 POST /api/v1/analytics/pricing-events：要求会话鉴权（401）、trusted origin（403）、16KB body 上限（413）、按用户 60s/120 事件限流（429）、事件时间 24h/5min 窗口与重复 eventId 校验（400），并将事件映射到既有注册表 subscription_plan_exposure / subscription_pricing_click（含 change_interval / subscribe_now / upgrade_now / request_team_access / team_lead_submit 子类），保留 open_design 落地页 attribution（entryId / campaignId / odDeviceId / od_locale 等）。Web 侧公共定价页跳转改为按页面语言走 /{locale}/pricing/ 并携带 od_locale 参数。分析类 additive 变更，不影响主业务流。

Author：open-design-crew[bot]（Co-authored: zhanghuihua）

  • 1c1e863e4 feat(analytics): accept authenticated pricing bridge events (#1732)
 apps/web/src/lib/commerce/public-pricing.ts：定价页 URL 增加 locale 感知（zh/en/zh-TW/pt-br 等映射，od_locale query + 语言路径）；新增单测 public-pricing-routing.test.ts。仅 Web 发布点（e0db21a1d）之后。 services/api/src/pricing-analytics.ts（新文件，+501）、services/api/src/app.ts 注册路由；新增 pricing-analytics-routes.test.ts / pricing-analytics.test.ts / analytics-events.test.ts。仅 API 发布点之后。 无。 无。 无 schema/migration。 无 catalog 变更。
Se2e 数据库测试夹具清理（测试基础设施）

移除 e2e/db 中过时的 migration-only fixture：run-e2e-db.py 从 439 行精简到 46 行，test_run_e2e_db.py 相应裁剪（-660 行）。纯测试基础设施变更，不进入任何生产运行时维度，不影响六个 workflow 的部署产物；但会改变 e2e 本地/CI 数据库初始化行为。

Author：nettee

  • 120d389b7 fix(e2e): remove obsolete migration-only fixture (#1750)
 无。（不在 apps/web 内） 无 runtime 变更。 无 runtime 变更。 无。 不影响 migration workflow（不在 db/migrations 内）。 不影响 seed workflow（不在 db/seeds / data/json 内）。

已在生产生效（发布点之前，本次不重复发布）

以下 feature 的 commit 均在对应 workflow 最近一次成功发布点 e0db21a1d（2026-08-24 11:02–11:19Z 六条 workflow 全部成功）之前，已在生产运行。若在 main 上重新运行对应 workflow，只以各自发布点为基线，这些变更不会重新「上线」。生成报告时必须把这类内容从 feature 表挪到这里。

发布建议

  1. Migration 判断：db-migrations 发布点（e0db21a1d）之后无 db/migrations 变更（3 个 commit 均不触及 db/ 目录），不需要运行 deploy-db-migrations-prod.yml；范围内无被回退的 migration。
  2. 服务发布顺序：有实际 runtime 变更的只有 Link（1 commit：#1735）、API（1 commit：#1732）、Web（1 commit：#1732 的 web 部分）。建议顺序 Link → API → Web；Admin / DB / Catalog 无净变更，可跳过（重跑也为空部署）。各 workflow 发布点相同（e0db21a1d），实际发布范围均为 3 个 commit，但只有对应维度内的变更产生新产物。
  3. 数据 seed / catalog 判断：无 data/json 与 db/seeds 变更，deploy-model-routing-catalog-prod.yml 可不重跑；无需额外 runbook。
  4. 发布后观测：
    • Link：gateway_membership_policy_cache_events_total（观察 L2 命中率、refresh_failure/stale_fallback/cold_miss 是否异常走高，确认跨副本缓存生效且 100ms 超时未拖慢首字节）。
    • API：POST /api/v1/analytics/pricing-events 状态分布（202/401/403/413/429/400）与错误日志；确认事件入库/转发 PostHog 的 subscription_plan_exposure、subscription_pricing_click 落点。
    • Web：公共定价页跳转后 URL 带 od_locale 且语言路径正确（zh/en 等），落地页 attribution 参数完整回传。

备注：所有 workflow、commit、PR 或 compare range 均使用可点击的 GitHub 链接；本报告各 workflow 发布点一致（e0db21a1d），compare 链接基于该统一基线。