AMR 生产发布影响报告

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

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

六个生产 workflow 最近一次成功运行停在的 commit 各不相同。越新的发布点意味着该服务已上线越多内容，feature 表里只允许列出发布点之后的变更；发布点之前的 commit 属于已生效，归入「已在生产生效」一节，不得重复出现在 feature 表。目标 commit 均为 cfbff0e9c （feat(admin): patrol v3 — full-volume stats, 7d window, anomaly tiers, per-table search + alert runner (#1734)）。

deploy-web-eks-prod.yml

最近成功：2026-08-25 06:57:01Z

发布点 commit：120d389b7

本次新增（120d389b7...cfbff0e9c）：4 commits

发布点之前已上线：pricing analytics bridge Web 侧（1c1e863e4）、支付 loading 反馈（41d813640）、usage 分页等已上线

deploy-api-eks-prod.yml

最近成功：2026-08-25 06:56:57Z

发布点 commit：120d389b7

本次新增（120d389b7...cfbff0e9c）：4 commits

发布点之前已上线：pricing analytics API（1c1e863e4）、coding plan models（487fcaf79）、AMR 监控调度器（3e9352522）等已上线

deploy-link-eks-prod.yml

最近成功：2026-08-24 11:11:53Z

发布点 commit：e0db21a1d

本次新增（e0db21a1d...cfbff0e9c）：7 commits

发布点之前已上线：last-good billing scope cache（bd0954edc）、Anthropic cache checkpoints（e109c7519）等已上线

deploy-admin-eks-prod.yml

最近成功：2026-08-24 11:11:56Z

发布点 commit：e0db21a1d

本次新增（e0db21a1d...cfbff0e9c）：7 commits

发布点之前已上线：patrol alert scheduler 基础版（de262b147）、Coding Plan 访问组（77bfa086f）、patrol 表格打磨（27d4520a2）等已上线

deploy-db-migrations-prod.yml

最近成功：2026-08-24 11:02:38Z

发布点 commit：e0db21a1d

本次新增（e0db21a1d...cfbff0e9c）：7 commits（新增 3 个 migration）

发布点之前已上线：最新已应用为 20260824081848_workspace_usage_cursor_pagination；更早的各种迁移均已应用

deploy-model-routing-catalog-prod.yml

最近成功：2026-08-24 11:13:13Z

发布点 commit：e0db21a1d

本次新增（e0db21a1d...cfbff0e9c）：7 commits（无 data/json 变更；仅 db/seeds/local 的 refund seed，非 catalog 生效范围）

发布点之前已上线：DeepSeek peak/off-peak COGS + Aiping/Aliyun billed rates（21632c51a）、deepseek-v4-flash-vision-exp（2de4e089c）、qwen3.8-27b（f279de19e）等已上线

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

feature 表只包含「各 workflow 发布点之后」的变更；发布点之前已生效的内容见「已在生产生效」一节，不要重复列入。定价分析桥接（1c1e863e4）的 Web/API 两侧均在 BASE_WEB/BASE_API（08-25）之前，已全部上线，故不进入本表。

Feature / Author / Commits	Web	API	Link	Admin	DB schema / migration	DB catalog（seed）
XXL订阅退款管理 + 批量退款工具 Admin 新增「退款管理」能力：单笔订阅退款/取消、退款状态筛选与 i18n 标签、审计动作标签，外加一个批量退款工具（drawer 向导，含策略提示）。API 侧新增退款/revoke 操作逻辑与路由，并以新表持久化退款操作记录。面向商业化/客服团队，配合 Stripe 订阅生命周期管理。 Author：nettee `ca0731ca0` feat(admin): add subscription refund management (#1758) `2d6b99127` feat(admin): add batch subscription refund tool (#1760)	无。	新增退款/revoke 路由与持久化：`services/api/src/billing/core.ts`（+362）、`billing/http/routes.ts`（新路由）、`billing/infra/postgres.ts`（+171，退款操作存储）。均在 BASE_API（120d389b7）之后。	无。	退款管理页 + 批量退款 drawer：`refund-management/page.tsx`、`subscription-refund-cancel-batch-form.tsx`（+474）、`lib/server/admin/{core,refund-management,router,users,coupons}.ts`、i18n、`audit-action-label.ts`。均在 BASE_ADMIN（e0db21a1d）之后。	`20260825122004_admin_subscription_refund_operations.sql`（新 migration）+ `db/schema/public.hcl`（+135，refund operations 表）。在 BASE_DB 之后。	`db/seeds/local/seed-refund-management.py` + 测试：local seed（退款管理 fixtures），非 model-routing-catalog seed，catalog workflow 不会自动应用；如需 prod fixtures 需手动处理。
LAdmin patrol v3：全量用量统计、7 天窗口、异常分级、按表搜索 + 通用告警 runner patrol 升级到 v3：KPI 聚合改为全量扫描（不再 SQL 截断，只对页面载荷分页）；默认 7 天窗口（按表搜索面板上限 30 天）；每个异常带 category + A/B/C 分级；抽取可复用的 alert-runner（advisory lock / baseline / signature 去重 / re-notify 全流程），patrol-alert-scheduler 强化为小时级 Feishu 通知 + severity 升级。面向平台运营，用于用量异常与配额告警。 Author：ivy-ting `cfbff0e9c` feat(admin): patrol v3 — full-volume stats, 7d window, anomaly tiers, per-table search + alert runner (#1734)	无。	无。	无。	`patrol/patrol-client.tsx`（+3090 重构）、`lib/server/admin/patrol.ts`（+618）、`lib/server/alert-runner.ts`（新，+192）、`lib/server/patrol-alert-scheduler.ts`（+242）、`lib/server/feishu-webhook.ts`、`components/ui/date-range-picker.tsx`（新）、`components/ui/calendar.tsx`（新）、i18n。均在 BASE_ADMIN（e0db21a1d）之后。	`20260826100000_add_patrol_reports.sql`（新 migration）+ `db/schema/public.hcl`（+48）、`db/schema/link.hcl`（+38）。在 BASE_DB 之后。	无 catalog 变更。
MMessage Center 消息 key 稳定化消息中心引入稳定的 message key：草稿可编辑后重发同一 key，软删除后通过 partial unique index 释放 key 以支持复用（活跃消息仍唯一）；key 以 toggle 开关控制；Admin 与 API 持久化层重构以支持 key 查询与唯一性约束。面向面向用户的消息触达稳定性。 Author：nettee `ac3f30d1e` feat(message-center): add stable message keys (#1753)	无。	`services/api/src/message-center.ts`、`persistence/message-center.ts`（+99）。均在 BASE_API（120d389b7）之后。	无。	`message-center/page.tsx`、`create-draft-drawer.tsx`、`edit-draft-drawer.tsx`、`lib/server/admin/message-center.ts`（+179）、i18n、key 开关。均在 BASE_ADMIN（e0db21a1d）之后。	`20260825113234_message_center_message_key.sql`（新 migration：message_key 列 + partial unique index）+ `db/schema/public.hcl`（+22）。在 BASE_DB 之后。	无 catalog 变更。
MLink 目录成员策略缓存共享 Link 网关把 catalog membership policy 缓存从每实例独立改为跨实例共享（单一缓存 key），Redis fallback 加 bound、缓存单调性修复、authority rejection 时主动失效。降低多副本下策略重复计算与不一致风险，提升网关稳定性。 Author：Caprika `cc0e715c8` feat(link): share catalog membership policy cache (#1735)	无。	无。	`services/link/internal/membership/client.go`（+324）、`internal/usage/metrics.go`、`internal/server/server.go`。均在 BASE_LINK（e0db21a1d）之后。	无。	无 migration。	无 catalog 变更。
SE2E 基础设施：清理过时 migration-only fixture e2e DB 启动脚本从 439 行精简到约 46 行，删除过时的 migration-only fixture 与对应测试。仅影响 e2e 测试基础设施，无运行时行为变更，不影响任何部署 workflow。 Author：nettee `120d389b7` fix(e2e): remove obsolete migration-only fixture (#1750)	无。	无 runtime 变更。	无 runtime 变更。	无。	不改 db/migrations（仅 e2e/db 脚本），不影响 migration workflow。	不影响 seed workflow（不改 db/seeds / data/json）。

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

以下 feature 的 commit 均在对应 workflow 最近一次成功发布点之前，已在生产运行。若在 main 上重新运行对应 workflow，只以各自发布点为基线，这些变更不会重新「上线」。生成报告时必须把这类内容从 feature 表挪到这里。两个相邻发布点之间（e0db21a1d 之后、120d389b7 之前）的 commit（1c1e863e4、cc0e715c8）是主要差异来源：其中 1c1e863e4 的 Web/API 两侧已上线；cc0e715c8 只涉及 Link 一侧（尚未上线，见 feature 表）。

Web（BASE_WEB=120d389b7 已生效，2026-08-25 06:57:01Z @ 120d389b7）：定价分析桥接的 Web 侧（1c1e863e4，apps/web 的 public-pricing locale 保留与 handoff）已上线；更早的 web 支付 loading 反馈（41d813640）等均已上线。
API（BASE_API=120d389b7 已生效，2026-08-25 06:56:57Z）：定价分析桥接的 API 侧（1c1e863e4，services/api/pricing-analytics.ts +501、app.ts 新路由，服务端校验/去重/PostHog 兼容）已上线；更早的 expose coding plan models（487fcaf79）、AMR 监控调度器（3e9352522）等均已上线。
Link（BASE_LINK=e0db21a1d 已生效，2026-08-24 11:11:53Z）：last-good billing scope cache（bd0954edc）、Anthropic cache checkpoints 预留（e109c7519）等已上线。
Admin（BASE_ADMIN=e0db21a1d 已生效，2026-08-24 11:11:56Z）：patrol alert scheduler 小时级基础版（de262b147）、Coding Plan 模型按 tier 访问组（77bfa086f）、patrol 表格打磨（27d4520a2）、本地时区渲染（4cac090d5）等已上线。
DB（BASE_DB=e0db21a1d 已生效，2026-08-24 11:02:38Z）：最新已应用 migration 为 20260824081848_workspace_usage_cursor_pagination；更早的 coding_plan_tier_model_groups（20260824030118）、stripe_subscription_cancellation_details（20260822063803）等均已应用。
Catalog（BASE_CATALOG=e0db21a1d 已生效，2026-08-24 11:13:13Z）：DeepSeek peak/off-peak COGS + Aiping/Aliyun billed rates（21632c51a）、deepseek-v4-flash-vision-exp via provider_deepseek（2de4e089c）、qwen3.8-27b via Aliyun（f279de19e）等 data/json + seed-model-routing-catalog.sql 变更均已上线。
本次范围内无「add → revert」净变更归零的 commit，无需迁移回退处理。

发布建议

Migration 判断：BASE_DB 之后有 3 个新 migration，需先运行 deploy-db-migrations-prod.yml：
- db/migrations/20260825113234_message_center_message_key.sql（message_key 列 + partial unique index）
- db/migrations/20260825122004_admin_subscription_refund_operations.sql（subscription refund operations 表）
- db/migrations/20260826100000_add_patrol_reports.sql（patrol reports 相关表/索引，另含 db/schema/link.hcl、public.hcl 变更）
范围内无被回退的 migration。注意 ac3f30d1e 的 message_key 为 partial unique index，软删除草稿不占用 key，可安全复用。
服务发布顺序：DB（3 个 migration）→ Catalog（无可发布项，仅 local seed）→ Link（1 commit：cc0e715c8）→ API（4 commits）→ Web（4 commits，无 runtime 变更）→ Admin（7 commits）。各 workflow 发布点不同：Link/Admin/DB/Catalog 基线为 e0db21a1d（7 commits），Web/API 基线为 120d389b7（4 commits，其中 ca0731ca0/ac3f30d1e 含 API 与 DB 变更，与 Admin 的退款、message-key 强相关）。
数据 seed / catalog 判断：本次无 data/json 与 db/seeds/model-routing-catalog 变更，deploy-model-routing-catalog-prod.yml 无可应用内容；退款管理 seed（db/seeds/local）不在 catalog workflow 范围内，如需 prod 退款 fixtures 需另行手动 seed。
发布后观测：patrol v3 的 Feishu 告警卡片与 severity 升级（参考 docs/ops/amr-patrol-db-verify.md 验证 patrol_reports 表与查询）；退款操作的审计记录与 Stripe 对账（refund_operations 表）；message-center 消息 key 唯一性与草稿重发；Link 网关 membership 缓存命中率/错误率与 Redis 负载；退款/余额相关 billing API 错误率。

备注：所有 workflow、commit、PR 或 compare range 均使用可点击的 GitHub 链接；每个 workflow 的 compare 链接均基于各自的发布点 BASE（Web/API=120d389b7，Link/Admin/DB/Catalog=e0db21a1d），而非统一基线。