AMR 生产发布影响报告
当前生产发布点（各 workflow 独立计算）
六个生产 workflow 最近一次成功运行停在的 commit 各不相同。越新的发布点意味着该服务已上线越多内容，feature 表里只允许列出发布点之后的变更；
发布点之前的 commit 属于已生效，归入「已在生产生效」一节，不得重复出现在 feature 表。目标 commit 均为
8bfdab4d7
（fix(web): clear pricing intent after plan upgrade (#1823)）。
关键差异：Admin 最近一次成功发布点即为目标 commit（8bfdab4d7），Admin 已与 main 完全同步，本次无新增；API 发布点（9b62435b4）晚于其余四个（aabbacce1），billing 退款修复等 6 个 commit 已先行上线。
aabbacce1aabbacce1...8bfdab4d7）：12 commits9b62435b49b62435b4...8bfdab4d7）：6 commitsaabbacce1aabbacce1...8bfdab4d7）：12 commits8bfdab4d7（= 目标）aabbacce1aabbacce1...8bfdab4d7）：12 commits（其中 4 个新 migration 属 #1808）aabbacce1aabbacce1...8bfdab4d7）：12 commits，其中 catalog 相关（data/json + seed-model-routing-catalog）0 变更此次发布真正新增的 feature 和影响面
| Feature / Author / Commits | Web | API | Link | Admin | DB schema / migration | DB catalog（seed） |
|---|---|---|---|---|---|---|
|
XXLSupport 自动邮件回执与邮件基础设施
新增 API 邮件系统：support-mail 模块（收件/回执生成/投递/重试/失败跟踪），邮件回执自动发送，支持入站认领租约与可重试投递；接入 API 启动入口与配置（SMTP、模板、域名等），并新增 4 张表/迁移支撑。面向用户：工单/客服邮件链路自动回执。 Author：Caprika
|
无。 | BASE_API（9b62435b4）之后：services/api/src/support-mail 新模块（repository / inbound / receipt / delivery / routes / index）+ app.ts、config.ts、index.ts 接线，约 2.4k 行新增。 | 无。 | 无新增（admin 已同步到 target，见已生效一节）。 | BASE_DB（aabbacce1）之后：4 个新 migration（20260829174339_support_mail_receipts、20260830091738_support_mail_inbound_claim_lease、20260830094250_support_mail_outbound_failure、20260831082250_support_mail_retryable_delivery）+ db/schema/public.hcl（+426 行）+ atlas.sum。 | 无。 |
|
XLWeb 恢复控制台内定价页面并对齐着陆页
恢复 Web 控制台内的定价（commerce/plans pricing 页面），新增 plan-selection-modal 与 landing pricing 组件/内容（模型、FAQ、团队版、卡片图），并同步调整升级入口路由与测试。面向用户：控制台内可直接查看/比较套餐定价。 Author：nettee
|
BASE_WEB（aabbacce1）之后：apps/web 46 文件 +8463/−3252（pricing-plans.tsx 重写、landing-pricing-* 系列、plan-selection-modal、pricing 模型/套餐 assets、购/升级路由、浏览器与单元测试）。 | 无 runtime 变更（该 commit 在 BASE_API 之后但未触及 services/api）。 | 无。 | 无新增。 | 无。 | 无。 |
|
LLink 退休 legacy API-key USD limiter 运行时
彻底移除遗留的 API-key USD 限额运行时（usage/limits.go −374 行、auth middleware 简化、postgres repository 清理、e2e/本地脚本清理），新计费/限额栈（usage events + provider cost）完全接管，删除本地 usage-limit seed 脚本。行为变化：旧限额逻辑不再生效，限额判定统一走新链路。 Author：nettee
|
无。 | 无 runtime 变更（该 commit 在 BASE_API 之后但未触及 services/api）。 | BASE_LINK（aabbacce1）之后：services/link 移除 legacy limiter（usage/limits.go −374、middleware/auth.go −33、repositories/postgres.go −136、openai.go −28），server/config 接线与大量测试更新。 | 无新增。 | 无 migration；db/seeds/local/clear-local-usage-limit.sh 删除（本地脚本，不影响 catalog workflow）。 | 无（非 model-routing-catalog seed）。 |
|
LLink 上游限流结果标准化（effective error contract）
统一 Link 对上游限流结果的判定与错误契约：openai.go 与各 media provider（byteplus / dataeyes / openrouter）对 429/限流的结果归一化，usage metrics 与成功计数调整，配套新增 effective-error-contract spec 文档。行为变化：上游限流在链路中表现一致，观测更准确。 Author：nettee
|
无。 | 已上线（该 commit 在 BASE_API 9b62435b4 之前，见已生效一节）。 | BASE_LINK（aabbacce1）之后：services/link 限流/错误契约统一（openai.go +165、media 各 provider、usage/metrics.go）+ specs/20260831-link-effective-error-contract 文档。 | 无新增。 | 无。 | 无。 |
|
MWeb 计划升级后清理 pricing intent
修复「升级后 pricing intent 残留」问题：升级完成后在 use-personal-plan-change 清理 intent，team-dashboard 路由配套调整，并补浏览器回归测试。面向用户：升级成功后再进入定价/订阅页面不再弹出残留升级意图。 Author：nettee
|
BASE_WEB（aabbacce1）之后：apps/web use-personal-plan-change.ts +6、team-dashboard.tsx +4、upgrade-cta-routing.spec.ts 测试。 | 无 runtime 变更（该 commit 在 BASE_API 之后但未触及 services/api）。 | 无。 | 无新增。 | 无。 | 无。 |
|
S工具/文档/测试附随变更
非生产 runtime 变更，随各 workflow 重新运行而进入版本基线：CLI ACP 帧上限提升至 4 MiB（#1806）；本地运行时/observability skill 文档微调（#1812、#1819）；admin patrol 窗口测试修复（#1805，admin 维度已上线）。不改变六维服务的运行行为。 Author：nettee |
无 runtime 变更。 | 无 runtime 变更。 | 无 runtime 变更。 | #1805 已上线（admin 已同步到 target）。 | 无 migration。 | 无 seed 变更。 |
已在生产生效（发布点之前，本次不重复发布）
以下 feature 的 commit 均在对应 workflow 最近一次成功发布点之前，已在生产运行。若在 main 上重新运行对应 workflow，只以各自发布点为基线，这些变更不会重新「上线」。生成报告时必须把这类内容从 feature 表挪到这里。
- Admin（BASE = target 8bfdab4d7，2026-09-01 03:22:30Z @ run 33465978188）：Admin 最近一次成功发布点就是目标 commit，已与 main 完全同步，本次 0 新增。已上线的 Admin 变更：context budget 整 K 单位编辑
39a16bec0(#1816)、退款操作历史分组e50eb8084(#1810)、patrol 窗口测试修复b838fee4a(#1805)。 - API（BASE 9b62435b4，2026-08-31 09:40:27Z @ run 33378835351）：已上线的 API 变更：billing 退款成功后再注销
9b62435b4(#1818)。API 发布点之前还有 link 限流标准化e88cd4253(#1815，对 Link 维度属本次新增)、admin 退款历史分组e50eb8084(#1810)。 - Web / Link / DB / Catalog（BASE aabbacce1，2026-08-31 02:44~02:50Z）：aabbacce1 之前已上线内容举例：admin 取消专用订阅恢复
c07e957fe(#1779)、web 零额度余额展示1a8b8a30b(#1789)、link GLM 5.3 Flash 走 AIPingfee9d67fa(#1787)、api 移除 coding plan catalog endpoint9ae81cd0d(#1788)、理财门户客户预置ad461f1bf(#1777) 等。 - Catalog（BASE aabbacce1 已生效）：本次
aabbacce1...8bfdab4d7范围内 无 data/json 与 seed-model-routing-catalog 变更，catalog workflow 无需重新运行；之前的模型/路由目录状态保持生效。
发布建议
- Migration 判断：BASE_DB（aabbacce1）之后有 4 个新 migration，全部来自 #1808 support-mail（
20260829174339_support_mail_receipts.sql、20260830091738_support_mail_inbound_claim_lease.sql、20260830094250_support_mail_outbound_failure.sql、20260831082250_support_mail_retryable_delivery.sql），schema（public.hcl）与 atlas.sum 同步更新。需先运行 deploy-db-migrations-prod.yml 再发布 API；范围内无非预期的回退 migration。 - 服务发布顺序：建议顺序 DB migrations（4 个新 migration）→ Catalog（无变更，可跳过）→ API（6 commits，含 support-mail 运行时）→ Link（12 commits，limiter 退休 + 限流契约）→ Web（12 commits，定价页 + intent 清理）；Admin 已同步到 target（0 commits），无需发布。注意 API 发布点较新（9b62435b4），实际新增 6 commits；其余四个 workflow 各 12 commits。
- 数据 seed / catalog 判断：本次无 data/json 与 model-routing-catalog seed 变更，deploy-model-routing-catalog-prod.yml 的 apply 步骤无需执行；#1822 删除的
db/seeds/local/clear-local-usage-limit.sh是本地开发脚本，不在 catalog workflow 应用范围内。若后续需要跑 catalog，按既有 plan → apply runbook 即可。 - 发布后观测：① support-mail：回执投递/重试/失败表（support_mail_receipts 等 4 张新表）行数与告警、邮件事件日志；② Web：控制台定价页可访问性、升级 CTA 路由、升级后 intent 不再残留；③ Link：限流错误契约后的 429/upstream 指标、旧 limiter 移除后 USD 限额是否按新链路生效；④ API：billing 退款取消流程（#1818 已上线，验证注销时序）。
备注：所有 workflow、commit、PR 或 compare range 都使用可点击的 GitHub 链接；每个 workflow 的 compare 链接均基于各自的发布点 BASE（web/link/db/catalog = aabbacce1，api = 9b62435b4，admin = target），而非统一旧基线。