AMR 生产发布影响报告

生成时间：2026-09-08 21:00 CST（已追加 origin/main 的 2 个新提交）；目标：origin/main @ b6a6adafb（feat(admin): show and compare model pricing in Admin (#1941)）。六个 workflow 的最近成功发布点独立计算；表格各维度只计入该维度发布点之后的代码或数据。

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

本次若从 main 手动运行六个 workflow，Web 有 32 个提交，API/Admin/DB/Catalog 各有 40 个提交。Link 最近成功 workflow 的 range 为 32，但该镜像随后被 GitOps 回滚，故以当前实际镜像 9a866eb28 为有效基线，Link 本次实际新增为 40 个提交。提交数是 Git range 总数；下表 feature 则按目录和实际生产语义筛选。Public Pricing 的数据发布另有独立 workflow，未包含在题设六项中，详见发布建议。

deploy-web-eks-prod.yml

最近成功：2026-09-04 07:34:54Z

发布点：43b4fd245

新增：43b4fd245...b6a6adafb，32 commits

deploy-api-eks-prod.yml

最近成功：2026-09-04 03:09:28Z

发布点：9a866eb28

新增：9a866eb28...b6a6adafb，40 commits

deploy-link-eks-prod.yml

最近成功：2026-09-04 07:43:48Z @ 43b4fd245

实际生产基线：prod-9a866eb28（rollback PR #514）

实际新增：9a866eb28...b6a6adafb，40 commits

deploy-admin-eks-prod.yml

最近成功：2026-09-04 03:11:32Z

发布点：9a866eb28

新增：9a866eb28...b6a6adafb，40 commits

deploy-db-migrations-prod.yml

最近成功：2026-09-04 03:05:20Z

发布点：9a866eb28

新增：9a866eb28...b6a6adafb，40 commits

deploy-model-routing-catalog-prod.yml

最近成功：2026-09-04 03:16:06Z

发布点：9a866eb28

新增：9a866eb28...b6a6adafb，40 commits

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

“已上线”只表示该维度的提交早于该 workflow 的发布点；不会被重复计为这次该维度的新增。测试专用 catalog、CI/文档提交未作为生产 feature 计入。

Feature / Author / Commits	Web	API	Link	Admin	DB schema / migration	DB catalog（seed）
XXL订阅退款按比例回收 Credits，并补齐退款证据 Stripe 成功部分退款会按原始 grant 的累计退款比例回收尚未消费/未过期的个人或 Workspace Subscription Credits；支持乱序、重试与审计 ledger，不产生负债。后续四个修复补齐替换订阅、历史 Workspace lineage、资金期取消和状态证据。 Author：Caprika `dfd3c492f` prorate subscription credits after refunds (#1864) `f15e13e32` reclaim replacement subscription full refunds (#1930) `5123c7b7a` recover legacy workspace refund lineage (#1933) `632154a17` sync Team cancellations with funded periods (#1936) `52f1d367e` correct refund status evidence and Workspace lineage (#1940)	Stripe webhook、subscription/workspace credit settlement 与 refund lineage 修复。	无。	无。	无。	新增 `20260902110703_subscription_refund_credit_adjustments.sql`：三张退款调整/事件账本表、索引及 seat allocation 字段/约束。	无。
XXL统一 Public / Cloud Pricing Surface API 成为版本化、匿名可读的 Public Pricing 事实源；Web 的 Cloud 与公开 embed 复用一个渲染树，旧 pricing relay/team-lead 路径删除。该能力还需要独立 Public Pricing 发布，不能只运行题设六个 workflow。 Author：nettee `929ad14ac` unify public and Cloud pricing surfaces (#1908) `1f66cd991` minimize public pricing contract (#1915)	新增公开 pricing/embed 入口、跨源 iframe 协议与 Cloud adapter；统一套餐 UI/CTA。`929ad14ac`、`1f66cd991`。	新增版本化、locale/ETag/cache 的 Public Pricing read API；删除旧 analytics relay。`929ad14ac`、`1f66cd991`。	无。	无。	新增 `20260904141602_public_pricing_revisions.sql`：revision、active revision、locale projection 三表。	本列的 model-routing seed 不发布 Public Pricing；`public_pricing.json` 的事实需走独立 Pricing workflow。
XLAdmin Member 全面只读权限 Member 仍可读取所有已认证 Admin 数据，但不能执行任何非 GET 请求；中心 router 及各模块 mutation seam 双重拒绝，页面隐藏而非禁用写操作。这是权限收紧，需验证成员不会再看到或绕过敏感操作（退款、风控处置、优惠券、模型/权益配置等）。 Author：nettee `4fbe04954` enforce member read-only access (#1942)	无。	无。	无。	中心权限 helper、router 与各 Admin 页面/handler 收紧为 member read-only；Owner/Admin 保持管理能力。	无。	无。
XL公共模型三态发布阶段以 `pre_release / released / archived` 取代仅有的开关；只有 `released` 可被发现和路由。迁移会把旧值映射为新阶段并补齐缺失 gate，目标是表示升级而非改变既有曝光。 Author：nettee `43b4fd245` add public model release phases (#1905) `b113645bb` polish public model release phase badges (#1906)	无。	模型、媒体与价格发现改为只返回 `released` 模型。`43b4fd245`	本次必须重新上线。此前 `43b4fd245` 镜像因缺少此 migration 的 `release_phase` 列 CrashLoopBackOff，被 GitOps PR #514 回滚至 `9a866eb28`。DB 成功后，Link 的 catalog/路由改为只接受 `released`。	模型抽屉可读写三态并审计；`b113645bb` 改善 phase badge。	`20260904061917_add_public_model_release_phase.sql` 与 `20260904061932_backfill_public_model_release_phase.sql`：加约束/列、映射旧 gate、补齐缺失行并校验一致性。	seed generator 保存 Admin-owned phase；baseline 仅初始化缺失 gate。`43b4fd245`
L新模型：GPT-6 Astra 与 DeepSeek V4.1 Flash preview 生产 catalog 增加两个模型及路由、价格、公开定价、release gate 与上下文/推理配置。Astra 的 OpenAI provider 工具函数也随 Link 发布更新；DeepSeek 的 Link 改动为 E2E 覆盖。 Author：nettee `b475bca9b` onboard GPT-6 Astra (#1909) `02d3d8ab7` add DeepSeek V4.1 Flash preview (#1934)	无。	无。	GPT-6 Astra 的 OpenAI request utility 兼容调整；DeepSeek 仅新增 retry E2E 覆盖。`b475bca9b`	无。	无 migration。	生产 seed 增加两模型的 `models.json`、provider routes/pricing、route policies、public pricing 与 release gates。测试专用 Astra/TeamoRouter 提交未计入生产变更。
LAdmin 巡检改为异常花费与账务对账巡检从粗粒度模型健康转向每个 provider 的用户实收、内部估算、供应商实报三方成本对账；增加花费突增/未覆盖成本等告警，并更新飞书巡检卡片。 Author：open-design-crew[bot] `b6d2d10be` retarget patrol to spend and billing reconciliation (#1879)	无。	无。	无。	Patrol 页面、异常规则与 Feishu 通知改为花费/账务视图；运营告警内容和查询负载变化。	无。	无。
MAdmin 模型价格展示与后端报价对比模型目录补充 backend input/output/cache 单价，并在路由页加入按 provider 对比 public list price 与实际 backend price 的矩阵；显示价格会做统一格式化/四舍五入。 Author：nettee `b6a6adafb` show and compare model pricing in Admin (#1941)	无。	无。	无。	Backend Model 列表新增四类价格列；模型路由页新增 provider 报价对比 matrix。	无。	无（只读展示现有 catalog 数据）。
MAdmin Coding Plan 共享权益档位运营配置从 Go/Plus/Pro/Max 收窄到 Personal 与 Team 共享的 Plus/Pro/Max；模型 inclusion、贡献倍率、额度策略和审计不再暴露 Go。 Author：nettee `68bc3c3b1` share Coding Plan entitlement tiers (#1902) `0b0c0502c` extract coding plan modules (#1924)	无。	无。	无。	三档的读写、模型/限额配置 UI 和 i18n 更新；后续模块拆分不改产品 contract。	无。	无。
MAdmin 品牌与明暗主题可用性生产/测试环境采用可区分 brand mark；修复同源 redirect，并大范围改用 theme token/暗色样式，避免登录、表格、状态和表单在暗色或浅色模式下不可读。 Author：nettee、open-design-crew[bot] `9da4facd4` dark mode text readability (#1925) `ecb6b4dd6` distinguish test environment branding (#1935) `3c1cdd32b` preserve light mode colors (#1937) `04489a0f7` keep brand-mark redirects same-origin (#1938)	无。	无。	无。	生产使用绿色 mark、测试黄色 mark；品牌资源 redirect 改为相对同源；浅/暗色可读性回归修复。	无。	无。
M退款外的两个用户路径修复 Workspace 用户可从 dashboard 深链直达自动充值设置；已发布 Team Project 的历史版本保持可读，避免已发布内容因后续状态变化不可访问。 Author：lefarcen、open-design-crew[bot] `20410eb64` auto-recharge dashboard deep link (#1900) `2b0fcf9d3` keep published Team Project versions readable (#1913)	新增自动充值 setting 的 dashboard deep link 与选中 Workspace 逻辑。`20410eb64`	已发布 Team Project 读取及 OpenAPI contract 修复。`2b0fcf9d3`	无。	无。	无。	无。
MLink 可靠性与 499 预热指标因为有效生产基线已回到 `9a866eb28`，Vertex Gemini stream idle timeout 传播和预热 499 指标修正都随本次 Link 重新进入发布范围；前者影响长流式请求超时传递，后者改善观测准确性。 Author：nettee `54543ec10` propagate Vertex Gemini stream idle timeout (#1901) `27f0a6a3c` prewarm model request 499 metrics (#1939)	无。	无。	Vertex/Gemini streaming idle-timeout 传播；调整 prewarm 499 usage metric 的记录位置。	无。	无。	无。

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

Link 的“最近成功 workflow”不是当前生产版本。run 33850053988 构建并同步了 43b4fd245，但其启动查询 pmrg.release_phase 时因列不存在 CrashLoopBackOff；rollback PR #514 已将 GitOps 镜像恢复到 9a866eb28。因此所有 9a866eb28..target Link 运行时代码都属于本次真实新增。
API/Admin/DB/Catalog @ 9a866eb28：最近成功 run 已包含 in-modal refund policy；更早的 19ccc33cd Muse Spark 1.3、062f8e38a Gemini 3.8 Flash 等不属于本次新增。
范围内未发现 add→revert 的净零 migration。

发布建议与阻断项

先执行 Migration（必需，且是 Link 重新发布的前置）。运行 deploy-db-migrations-prod.yml，将执行三份新增 migration。对 release-phase，按变更规范在 migration 到 Admin/API 验证期间暂停 Public Model phase/gate 编辑，核对 backfill 的 notice、无缺失行且 boolean 与 phase 同步。退款能力先以 shadow 配置和真实 webhook/ledger 指标验证，不会自动回放历史部分退款。
Public Pricing 是题设外的必需发布路径。在 DB migration 和 API/Web 具备兼容版本后，另行审批/运行 deploy-public-pricing-prod.yml，发布并验证 active immutable revision。仅运行 model-routing catalog workflow 不会发布该 pricing revision。
推荐顺序。DB（40）→ API（40）→ Catalog（40；只含生产数据）→ Link（40，实际基线为 9a866eb28）→ Web（32）→ Admin（40）→ Public Pricing（独立 workflow）。不得先发 Link：PR #514 已证明缺少 release_phase 列会使 43b4fd245 CrashLoopBackOff；DB 后再验证模型发现/直连路由及全部副本 Ready。
发布后观测。退款：Stripe webhook 成功率、adjustment ledger 的 pending/failed/unmatched、实际/理论回收差额与 Workspace lineage；模型：GPT-6 Astra/DeepSeek 路由成功率、provider cost、/v1/models 仅含 released；Pricing：read API 的 active revision、ETag/locale 与 embed handshake；Admin：Member 的 GET 成功而非 GET 返回 403、无 mutation 控件，价格对比矩阵与 Patrol/浅暗色登录；Link：启动不再出现 release_phase does not exist、所有新 ReplicaSet Ready、Vertex stream 与 prewarm 499 指标。

数据来源：GitHub Actions 最近成功 run、apps GitOps rollback PR #514 与当前 amr-link image tag、git rev-list BASE..origin/main、路径过滤（apps/web、services/api、services/link、apps/admin、db/schema+migrations、data/json+db/seeds）及相应提交 diff。所有 compare、workflow、run 和 commit 均可点击追溯。