AMR 生产发布影响报告

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

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

六个生产 workflow 最近一次成功运行停在的 commit 各不相同。越新的发布点意味着该服务已上线越多内容，feature 表里只允许列出发布点之后的变更；发布点之前的 commit 属于已生效，归入「已在生产生效」一节，不得重复出现在 feature 表。目标 commit 均为 aabbacce1 （chore(tools): remove obsolete AMR event prototype (#1791)，2026-08-29）。

deploy-web-eks-prod.yml

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

发布点 commit：b15c004d5

本次新增（b15c004d...aabbacce1）：10 commits

发布点 b15c004d 之前 web 变更均已上线。

deploy-api-eks-prod.yml

最近成功：2026-08-28 08:33:25Z

发布点 commit：9ae81cd0d

本次新增（9ae81cd0d...aabbacce1）：6 commits

API 发布点较新：coding plan catalog endpoint 移除、billing provision 均已上线。

deploy-link-eks-prod.yml

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

发布点 commit：b15c004d5

本次新增（b15c004d...aabbacce1）：10 commits

发布点之后无 services/link 代码变更（GLM AIPing 仅为 catalog 数据，见已生效一节），Link 本次无新内容。

deploy-admin-eks-prod.yml

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

发布点 commit：b15c004d5

本次新增（b15c004d...aabbacce1）：10 commits

Admin 发布点之后仅 1 个 commit 生效：cancel-only 退款恢复（#1779）。

deploy-db-migrations-prod.yml

最近成功：2026-08-27 11:07:57Z

发布点 commit：b15c004d5

本次新增（b15c004d...aabbacce1）：10 commits

发布点之后仅 1 个 migration：20260828061808_admin_subscription_refund_operation_mode.sql。

deploy-model-routing-catalog-prod.yml

最近成功：2026-08-28 09:11:29Z

发布点 commit：9ae81cd0d

本次新增（9ae81cd0d...aabbacce1）：6 commits（其中涉及 data/json 与 db/seeds 的 commit 才算 catalog 变更）

发布点之后无任何 data/json / db/seeds 变更：GLM AIPing、Z.AI provider 均已在 09:11 的 catalog 部署中上线，本次无需重跑.

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

feature 表只包含「各 workflow 发布点之后」的变更；发布点之前已生效的内容见「已在生产生效」一节，不要重复列入。六维映射：apps/web→web（BASE_WEB）、services/api→api（BASE_API）、services/link→link（BASE_LINK）、apps/admin→admin（BASE_ADMIN）、db/migrations+schema→DB（BASE_DB）、data/json+db/seeds→catalog（BASE_CATALOG）。

Feature / Author / Commits	Web	API	Link	Admin	DB schema / migration	DB catalog（seed）
XXLAdmin 仅取消订阅退款恢复（cancel-only subscription recovery） Admin 退款管理新增「仅取消订阅（cancel-only）」恢复模式：运营可将订阅恢复/退款操作限定为只取消、不退 stripe 款项，并提供历史恢复表单、重试按钮可见性控制与原子审计；API billing 层同步支持 cancel-only 模式持久化、保留基础设施失败、封闭竞态边界。跨 Admin / API / DB 三层的运营能力。 Author：nettee `c07e957fe` feat(admin): add cancel-only subscription recovery (#1779)	无。	BASE_API（9ae81cd0，08-28）之后：`services/api/src/billing/core.ts / http/routes.ts / infra/postgres.ts` 支持 cancel-only 恢复模式持久化、审计原子化、竞态封闭、内网失败保留。	无。	BASE_ADMIN（b15c004d，08-27）之后：refund-management 页面 + 新增 `cancel-only-subscription-button.tsx`、`historical-cancel-only-form.tsx`、`operation-action-visibility.ts`，i18n、audit-action-catalog、server/core、refund-management.ts 均更新。	新增 `db/migrations/20260828061808_admin_subscription_refund_operation_mode.sql`：`admin_subscription_refund_operations` 增加 `operation_mode` 列（NOT NULL，默认 `refund_and_cancel`）+ CHECK 约束（`refund_and_cancel\|cancel_only`）；`db/schema/public.hcl` 同步。	无 catalog 变更。
MWeb 修复零额度余额显示 Workspace B 面板 / owner overview 等界面此前将零额度余额隐藏，现改为如实展示 0 余额，避免用户误以为计费数据缺失；同时清理 plans 里过期的「无限额度」判定分支与相关单元测试。 Author：Caprika `1a8b8a30b` fix(web): show zero credit balances (#1789)	`components/team/credit-surfaces.tsx`、`workspace-b-dashboard-panel.tsx`、`admin-workspace-overview.tsx`、`data/commerce/plans.ts`、`lib/i18n.tsx` 调整，浏览器/单元测试更新。	无。	无。	无。	无 schema/migration。	无 catalog 变更。
SWeb 无用资源清理（hero 图片 + mock 数据）删除 web 端未引用的 `hero-mark.png` 大图资产（约 4.9MB）与 729 行未使用的 mock 数据集，缩小仓库与构建产物，无运行期行为变化。 Author：nettee `7c74444fd` chore(web): remove unused hero mark asset (#1792) `88e2c5821` chore(web): remove unused mock dataset (#1793)	删除 `apps/web/src/assets/home/hero-mark.png`、`apps/web/src/data/mock.ts`。	无 runtime 变更。	无 runtime 变更。	无。	不影响 db/migrations。	不影响 seed/data/json。
Se2e full-smoke 断言修正 full-smoke 测试对 usage 的断言忽略 provider name，使 smoke 不再因同一模型多 provider 路由（如 GLM 走 Z.AI / AIPing）而误报。仅影响 CI，无运行期变更。 Author：nettee `b5c253311` fix(full-smoke): ignore provider name in usage assertion (#1781)	无 runtime 变更（仅 e2e）。	无 runtime 变更。	无 runtime 变更。	无。	不影响 migration workflow。	不影响 seed workflow。
S文档与工具清理（specs 归档 + 删除过时工具脚本）归档一批过期 change/evidence 文档（github-actions bot 提交）并删除过时的 AMR event 报告原型脚本（`tools/prototype-amr-event-reporting.mjs`），仓库整洁性维护，均无运行期影响。 Author：github-actions[bot]、nettee `5461f8f1a` chore: archive old specs (#1677) `aabbacce1` chore(tools): remove obsolete AMR event prototype (#1791)	无 runtime 变更。	无 runtime 变更。	无 runtime 变更。	无。	不影响 migration workflow。	不影响 seed workflow。

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

以下 feature 的 commit 均在对应 workflow 最近一次成功发布点之前，已在生产运行。若在 main 上重新运行对应 workflow，只以各自发布点为基线，这些变更不会重新「上线」。生成报告时必须把这类内容从 feature 表挪到这里。

Catalog（BASE_CATALOG 已生效，2026-08-28 09:11:29Z @ 9ae81cd0d）：
- fee9d67fa GLM 5.3 Flash 走 AIPing 路由（#1787，nettee）：新增 provider_aiping 覆盖 GLM-5.3-Flash，与 Z.AI 同 priority 10、权重 4:1（Z.AI 4 / AIPing 1）；AIPing 行不设 cache tariff 使缓存计费回落输入价；seed 新增 backend_model_aiping_glm_5_3_flash 与 route_glm_5_3_flash_aiping_glm_5_3_flash。已在 09:11 的 catalog 部署中写入生产 DB。
- b15c004d Z.AI provider（#1774，nettee）：provider_pricing/provider_zai.json、providers.json、routes、policies 与 seed 随 catalog 09:11 部署上线。
Link（BASE_LINK 已生效，2026-08-27 11:24:39Z @ b15c004d）：Z.AI provider 路由已上线 —— b15c004d feat(link): add Z.AI provider route (#1774)，含 services/link/internal/bifrostengine/account.go 网关集成与 provider_zai 路由数据。BASE_LINK 之后无 services/link 代码变更，本次 Link 无新内容。
API（BASE_API 已生效，2026-08-28 08:33:25Z @ 9ae81cd0d）：
- 9ae81cd0d 移除 coding plan model catalog endpoint（#1788，Ray Xi）：删除 services/api/src/persistence/model-catalog.ts 相关路由、openapi 与 metrics 计数。
- ad461f1bf 订阅客户 provision 支持 portal 访问（#1777，Caprika）：billing 在 checkout 时自动 provision Stripe customer/portal 资访问；web 侧仅浏览器测试调整（workspace-dashboard.spec.ts），无 web runtime 变更。
Web（BASE_WEB 已生效，2026-08-27 11:24:43Z @ b15c004d）：发布点之前 web 变更均已上线；本次 web 新增仅 3 个 commit（1 个零余额修复 + 2 个清理，见 feature 表），无回退。

范围内无「add + revert」净变更归零的情况；本次没有需要特殊处理的已回退 migration。

发布建议

Migration 判断：BASE_DB（b15c004d）之后新增 1 个 migration：20260828061808_admin_subscription_refund_operation_mode.sql（admin_subscription_refund_operations.operation_mode 列 + CHECK 约束，默认 refund_and_cancel）。需要先运行 deploy-db-migrations-prod.yml。范围内无被回退的 migration。
服务发布顺序：
- ① DB migration（1 commit：c07e957fe）
- ② API（1 commit：c07e957fe billing 变更）
- ③ Admin（1 commit：c07e957fe）
- ④ Web（3 commits：1a8b8a30b、88e2c5821、7c74444fd）
- ⑤ Link 与 Catalog：范围内无对应变更，可跳过。
数据 seed / catalog 判断：本 release 在 BASE_CATALOG（9ae81cd0，08-28 09:11）之后无任何 data/json / db/seeds 变更，无需运行 deploy-model-routing-catalog-prod.yml；GLM AIPing 与 Z.AI 路由已随上次 catalog apply 进入生产 DB，不需要额外 runbook。
发布后观测：
- Admin：refund-management 页面仅取消恢复的创建/重试/历史表单与审计记录；观察 operation_mode 分布与并发竞态（serialize transitions）。
- Web：workspace B 面板 / owner overview 零额度余额显示是否符合预期。
- API：subscription refund/cancel 流程、Stripe portal provisioning 成功率、billing 相关 metrics 与 error rate。
- Migration 后：admin_subscription_refund_operations 新 CHECK 约束对存量数据无冲突（默认值兼容）；可抽查审计日志。

备注：所有 workflow、commit、PR 或 compare range 均使用可点击的 GitHub 链接；每个 workflow 的 compare 链接基于各自的发布点 BASE（web/link/admin/db = b15c004d，api/catalog = 9ae81cd0），而非统一基线。