AMR 生产发布影响报告

生成时间：2026-08-18；分析对象：在 origin/main（HEAD=85c3b227）手动重跑五个生产 workflow：web / api / link / admin / db-migrations。模型路由目录 seed 由独立的 deploy-model-routing-catalog-prod.yml 管理，一并核对。

当前生产发布点

五个生产 workflow 最近一次成功运行落在不同 commit（见下方卡片），其中 link 与模型路由目录已同步到 08-17 的 af8fa6c1（chore(models): price DeepSeek V4 at peak rates (#1642)），几乎在最新位置；web / api / admin / db 分别落后 21 / 11 / 39 / 41 个 commit。本次发布的实际变化量远小于 git 原始差距——大多数 catalog 路由与 link 侧功能（V4 Pro 0813、Gemini/Grok、Flash 权重、SSE drain 等）已经上线，不属本次新增；真正的新功能只有图片风控错误合同（#1641）。

待发布范围按各服务自身发布点起算：web db4ab87e...85c3b227（21）、api b5e370ef...85c3b227（11）、link af8fa6c1...85c3b227（仅 1）、admin a68d6480...85c3b227（39）、db a42ed27c...85c3b227（41；实际仅 2 笔 migration）。

deploy-web-eks-prod.yml

最近成功：2026-08-13 16:22:18Z

commit：db4ab87e（待发布 21）

deploy-api-eks-prod.yml

最近成功：2026-08-14 08:59:03Z

commit：b5e370ef（待发布 11）

deploy-link-eks-prod.yml

最近成功：2026-08-17 12:36:25Z

commit：af8fa6c1（仅待发布 1）
✓ 已含 08-17 前全部 catalog/SSE/定价变更

deploy-admin-eks-prod.yml

最近成功：2026-08-11 06:06:23Z

commit：a68d6480（待发布 39）

deploy-db-migrations-prod.yml

最近成功：2026-08-10 13:04:36Z

commit：a42ed27c（待发布 41，实际 2 笔 migration）

注：deploy-model-routing-catalog-prod.yml 最近成功为 2026-08-17 12:06:58Z（af8fa6c1），与 link 同步；模型路由 seed 无需本次重复发布。

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

Feature / Author / Commits	Web	API	Link	Admin	DB schema / migration
XL图片风控错误合同与提示词留存唯一全链路新功能内容安全拒绝（BytePlus 400 / fal 422 / Atlas moderation）在链路中统一归一为 `safety_rejection`（400 而非 502），并在 `image_tasks.error_subject` 留存对 prompt / input_image / output_image 的归属（仅凭供应商结构化错误码分类，不依赖本地化文案）；CLI 同步暴露错误合同供风控审计。这是 link 本轮唯一待发布的 commit，也是 api 本轮两项 runtime 变更之一。 Author：Caprika `85c3b227` feat(media): 图片风控错误合同与提示词留存 (#1641)	Web 前端无 runtime 变更；CLI（`apps/cli` media 命令）随 `vela-cli-release` 独立发布，不在本 workflow 内。	新变更：media 链路（image-task worker、routes、diagnostics、generation、link-client、config）分类拒绝并透传 `error_subject`。	新变更：`internal/media/safety.go` 供应商错误码分类表（BytePlus/fal/Atlas）+ 400 归一，涉及 `atlas.go` / `fal.go` / `internal_media_image` handler。	无。	需要 migration：`20260817085328_image_task_error_subject.sql` 为 `media.image_tasks` 增加 `error_subject text NULL` 列。
MAPI：workspace 目录失效推送 workspace 目录变更时通过 workspace-events 推送失效通知，使资源会话/成员同步及时失效重建；这是 api 本轮除图片风控外的另一项 runtime 变更（api 待发布的 11 个 commit 中仅两个触及 `services/api`）。 Author：lefarcen `6ac0cdab` fix(api): push workspace directory invalidations (#1586)	无。	新变更：resources auth / workspace-events bus/routes / workspaces 路由。	无。	无。	无 schema/migration。
MWeb：计费摘要缓存与前端展示 API 侧 billing summary 缓存（backend 已于 api 发布点 b5e370ef 上线）对应的 Web 前端展示（团队看板 / wallet / billing-client）随本轮 web 发布上线；同时 DeepSeek V4 定价数据在 web 内嵌 catalog 中更新至 off-peak ↔ peak 调整。 Author：Marc Chan、nettee `f442f5a1` perf(api): cache billing summary reads (#1589)（web 前端部分暂未上线） `e53acfbd` chore(models): raise DeepSeek V4 prices to off-peak rates (#1607)（web 内嵌 model-catalog 数据）	新变更：`billing-client`、`wallet.tsx`、`team-dashboard.tsx`、`model-catalog.ts` 价格数据。	API 侧缓存已在 08-14 上线（b5e370ef 已含）；本轮 API 无新增。	无。	无。	无 schema/migration。
SWeb：移除退役 cloud 页面与品牌素材 web 前端移除已退役的 cloud 页面、客户 logo、首页组件与样式，同步清理 i18n 文档并更新 qa-browser-ci 浏览器测试；属低风险前端资产瘦身。 Author：nettee `397d1b77` refactor(web): remove retired cloud pages (#1621) `c8273fc8` fix(web): stabilize Open Design attribution test (#1561)（测试随附）	新变更：app.tsx、首页/brand 组件、样式、资产与测试。	无。	无。	无。	无 schema/migration。
SAdmin：Combobox 状态徽章展示修复 admin 控制台 Combobox 选项展示模型 active 状态徽章（宽窄布局修复 + 复用 StatusBadge），随本次 admin 追平合并进来（admin 待发布的 39 个 commit 中唯一触及 `apps/admin` runtime 的变更）。 Author：nettee `09a4dcc8` docs: add AMR release skill (#1595)（附带 admin combobox 修复）	无。	无。	无。	新变更：`components/ui/combobox.tsx` 徽章布局与状态复用。	无 schema/migration。
SDB：usage settlement 结算扫描索引为 `link.usage_events` 增加条件索引（created_at + request_id + 成功/计费过滤），加速结算对账扫描。 Author：nettee `b6b91b91` chore(db): track usage settlement scan index (#1582)	无。	无 runtime 变更（结算由 link 侧消费）。	无 runtime 变更（纯索引加速）。	无。	需要 migration：`20260813132230_add_usage_events_settlement_scan_index.sql` 建条件索引。
S非 runtime：基建、文档与 CI 类新增 AMR release / observability 技能、Grafana 查询与凭证加载、full-smoke 允许辅助模型缺失、feature-test 绑定 go plan、sandbox 回收孤儿 Redis 分配、AMR path proxy Worker 版本化（独立 worker，不在五流程内）、API 资源池隔离修复（#1513 合并后 #1514 回滚，净变更 0）。发布点无 runtime 影响，随各服务追平一并带入。 Author：nettee、lefarcen `2755aa39` docs: remove AMR release source note (#1598) `9c7aabf9` docs(observability): load Grafana token from AWS Secret (#1517) `d79e6ca7` docs(observability): specialize AMR Grafana queries (#1552) `d9ce682f` fix(full-smoke): allow optional auxiliary model absence (#1567) `0c747d62` chore(feature-test): bind go plan rollout (#1600) `ae0f8d45` fix(sandbox): reclaim orphaned Redis allocations (#1613) `bda7304a` feat(edge): version AMR path proxy worker (#1615) `0d45418e` fix(api): stop the resource hub from starving auth and billing (#1513) —— 已由 `a68d6480` (#1514) 回滚，净变更 0	无 runtime 变更。	无净 runtime 变更（#1513 已回滚）。	无 runtime 变更。	无。	无 schema/migration。

已在生产生效、不属本次新增（供参考）

以下变更已经在 08-17 的 link + model-routing-catalog 发布或更早的 web/api 发布中上线，不是本次发布的新内容；若本次部署看到它们出现在 diff 中，属于"追平发布点"，无需重复验证：

模型路由：DeepSeek V4 Pro 0813 provider 与路由收敛（cc039919 #1568、8e049fce #1575、dc01d78e #1577、e687da0a #1638）
新模型接路：Gemini 3.7 Flash（d336ef7c #1587）、Grok 4.6（bcf1de37 #1560）
DeepSeek V4 Flash 权重与通道路由多轮调优（71df1f9f #1588、79b92215 #1590、72165dd3 #1562、9bd9b7b4 #1569、b5e370ef #1601）
Link SSE drain 灰度上线（49a640a7 #1537）、模型调用 RPM/并发指标（1d014457 #1573）、model-limit 日志归因与用量补齐（b29fa5aa #1605、72a1c7ae #1629）
计费 campaign 与余额/账单体验（dff53320 #1583）、billing summary 缓存 API 侧（f442f5a1 #1589 API 部分）、cronjob 资源隔离（cb22be5b #1578）与身份读取去锁（db4ab87e #1584）
工作区控制台 UI 打磨（de4ee82e #1515）、团队自动充值默认开启（9af554e1 #1570）、个人账单页过滤（c847e0e1 #1536）
资源中心批量拉取共享 blob（9d9e13ef #1519、b8b0422a #1555，API+CLI）

发布建议

Migration 判断：需要跑 migration，且必须先于 api/link 部署。共两笔 additive 变更：deploy-db-migrations-prod.yml 落在 85c3b227 应用 20260817085328_image_task_error_subject.sql（image_tasks 加列）与 20260813132230_add_usage_events_settlement_scan_index.sql（索引）。
服务发布顺序：DB migrations（先行）→ link（图片风控，本轮唯一变更，需 migration 就绪）→ api（图片风控 + workspace 失效推送）→ web（计费前端 + 页面清理 + 价格数据）→ admin（combobox 修复）。model-routing-catalog 已在 08-17 同步，无需重复发布。
数据 seed / catalog 判断：模型路由 seed 已由 deploy-model-routing-catalog-prod.yml 于 08-17 发布（af8fa6c1），本次无需额外 runbook。图片风控 spec（specs/change/20260817-image-safety-error-contract）要求生产验证时对照真实采样复核 Atlas 错误码清单。
发布后观测：①媒体图片风控拒绝归一 400、image_tasks.error_subject 正确留存；②workspace 目录失效事件正常推送；③billing summary 前端展示与缓存一致、DeepSeek V4 价格展示为最新档位；④admin 模型选择 Combobox 状态徽章正常显示；⑤link/API 无 SSE、模型限额回归（link 侧 SSE drain 已在线，确认本次未受影响）。