AMR 生产发布影响报告
当前生产发布点（各 workflow 独立计算）
六个生产 workflow 最近一次成功运行停在的 commit 各不相同。越新的发布点意味着该服务已上线越多内容，feature 表里只允许列出发布点之后的变更；
发布点之前的 commit 属于已生效，归入「已在生产生效」一节，不得重复出现在 feature 表。目标 commit 均为
1c24a9d
（feat(catalog): add Muse Spark 1.2 (#1764)）。
120d389b7120d389b7...1c24a9d）：9 commits（其中 apps/web runtime 变更 = 0）120d389b7120d389b7...1c24a9d）：9 commits（其中 services/api runtime 变更 = 3）e0db21a1de0db21a1d...1c24a9d）：12 commits（其中 services/link runtime 变更 = 3）e0db21a1de0db21a1d...1c24a9d）：12 commits（其中 apps/admin runtime 变更 = 5）e0db21a1de0db21a1d...1c24a9d）：12 commits（其中新 migration = 5）e0db21a1de0db21a1d...1c24a9d）：12 commits（其中 data/json 与 db/seeds 的 catalog 变更 = 2）此次发布真正新增的 feature 和影响面
| Feature / Author / Commits | Web | API | Link | Admin | DB schema / migration | DB catalog（seed） |
|---|---|---|---|---|---|---|
|
XXL模型上下文预算（Model Context Budgets）
为公开模型增加 Author：nettee
|
无。 | 无。 | catalog 投影/仓库透出 context_budget（catalog.go、projection.go、domain/types.go、repositories/postgres.go）。 | 模型列表 context-budget 覆盖输入、admin core/models.ts 服务端逻辑（41fae9bb2，08-24 发布点后）。 | 20260826100001_add_public_model_context_budget.sql（link.public_models / public_model_admin_overrides 增加 context_budget；link.hcl +8）。 | generate_model_routing_catalog.py 重新生成 seed-model-routing-catalog.sql（145 行变更，写入 context_budget）。 |
|
XLOpen Design Run 终端计费强制（enforced terminal billing）
强制 Open Design Run 的终端态计费：CLI 在 run 成功/失败/取消时上报 terminal 状态，API 依据终端状态将用量落账（billing scope 生效），不再漏记「开放运行」的时长/用量，属于计费正确性收口。 Author：Caprika
|
无。 | billing/core.ts 计费强制、billing/infra/postgres.ts 落账（+232）、app.ts 路由（+209）、openapi.json（+129）。（API 08-25 发布点后） | 仅测试（membership/client_test、middleware/auth_test），无 prod runtime 变更。 | 无。 | 20260826122147_opend_run_terminal_billing.sql（新表 open_design_run_terminal_states + 索引；public.hcl +39）。 | 无。（CLI 侧 open-design client/run.go 随 vela-cli 发布） |
|
XLAdmin 巡检 Patrol v3（全量统计 + 告警 runner）
巡检能力升级 v3：支持全量统计、7 天窗口、异常分级（tier）、按表搜索，并新增定时告警 runner 通过 Feishu webhook 推送巡检报告；新增 patrol_reports 报表表与 usage/credit 相关索引，供运维每日巡检与风险提示。 Author：ivy-ting
|
无。 | 无。 | 无。 | patrol 页重构（patrol-client.tsx +3090）、服务端 patrol.ts（+618）、alert-runner.ts 新增、patrol-alert-scheduler.ts（+242）、Feishu webhook、日期范围选择器。 | 20260826100000_add_patrol_reports.sql（usage_events / credit_usages 新索引 + 新表 patrol_reports；link.hcl +38 / public.hcl +48）。 | 无。 |
|
LAdmin 订阅退款管理（Refund Management）
Admin 新增订阅退款管理：可按订阅执行退款/取消与重试，跟踪退款操作状态与审计；API 增加退款业务核心逻辑（billing/core.ts +362）与 postgres 落库（+171），新增退款操作表 migration，配套本地 seed 供开发环境使用（不部署到 prod catalog）。 Author：nettee
|
无。 | billing/core.ts（+362）退款流程、billing/http/routes.ts（+26）、billing/infra/postgres.ts（+171）。（API 08-25 发布点后） | 无。 | refund-management 页面/表单、refund-management.ts、core.ts（+289）、users.ts、审计标签、侧边栏入口。 | 20260825122004_admin_subscription_refund_operations.sql（public.hcl +135）。 | 无 prod seed（db/seeds/local/seed-refund-management.py 仅本地）。 |
|
LLink provider 流建连观测（stream establishment）
观测各 provider 流式连接建立过程：新增 streamestablishment 生命周期、tracing、usage metrics 与 bifrost engine/处理层插桩，覆盖 bedrock/openai 传输层，可定位「建连慢/失败」与计费记账时机，属于可观测性增强。 Author：Caprika
|
无。 | 无。 | bifrostengine/engine.go、handlers/stream_establishment.go、streamestablishment/lifecycle.go、tracing、usage/metrics、bifrost-core bedrock/openai 传输层（+2141 行为主）。 | 无。 | 无 schema/migration。 | 无 catalog 变更。 |
|
MLink 目录会员策略缓存共享
将 catalog membership policy 的缓存共享到 Link 服务内（membership/client.go +324），减少每次请求对策略的重复解析/调用，提升鉴权带宽与一致性；配套 server 注入与 usage metrics。注意该 commit 在 web/api 发布点（08-25）之前、但在 link 发布点（08-24）之后，故属于 Link 本次新增。 Author：Caprika
|
无。 | 无。 | membership/client.go（+324）、server.go 注入、usage/metrics 指标。 | 无。 | 无 schema/migration。 | 无 catalog 变更。 |
|
MAdmin 批量订阅退款工具
Admin 新增批量退款工具：按条件选择订阅批量取消/退款（subscription-refund-cancel-batch-form），服务端 users.ts（+448）与 actions 实现批量处理并写审计日志，用于运营批量处理争议订阅。 Author：nettee
|
无。 | 无。 | 无。 | batch 退款表单（+474）、actions、admin/users.ts（+448）、审计标签。 | 无 schema/migration。 | 无。 |
|
M消息中心稳定 message key
消息中心草稿/消息增加稳定 Author：nettee
|
无。 | message-center.ts、persistence/message-center.ts 按 key 幂等写库。 | 无。 | message-center 草稿新建/编辑 drawer（create-draft / edit-draft）、服务端 message-center.ts。 | 20260825113234_message_center_message_key.sql（message_center_drafts / messages 增加 message_key + 唯一索引 + 格式 CHECK）。 | 无。 |
|
M新增 Muse Spark 1.2 模型（catalog）
将 Muse Spark 1.2 加入公开模型目录：models.json、openrouter 元数据/定价、provider 路由、public_pricing、route_policies 与 release gate 同步更新，seed-model-routing-catalog.sql 增加对应记录。发布后该模型公开可购、可被路由。 Author：nettee
|
无。 | 无。 | 无 runtime 变更（web 不直接消费该数据文件；公价展示由 catalog 数据驱动）。 | 无。 | 无 schema/migration。 | data/json（models / openrouter_metadata / provider_pricing / provider_routes / public_pricing / route_policies / release_gates）+ seed-model-routing-catalog.sql（+7）。 |
|
Se2e / sandbox 基础设施调整
e2e 冒烟与 sandbox 服务 DNS 隔离调整（docker-compose / cli / full-smoke bootstrap），仅影响 CI 与沙箱环境，不进入任何 prod runtime 维度；不需重新发布任何服务，但会改变后续 CI/e2e 行为。 Author：nettee
|
无。 | 无 runtime 变更。 | 无 runtime 变更。 | 无。 | 不影响 migration workflow（无 db/ 变更）。 | 不影响 seed workflow（无 data/json、db/seeds 变更）。 |
已在生产生效（发布点之前，本次不重复发布）
以下 feature 的 commit 均在对应 workflow 最近一次成功发布点之前，已在生产运行。若在 main 上重新运行对应 workflow，只以各自发布点为基线，这些变更不会重新「上线」。
- Web / API（BASE 120d389b7 已生效，2026-08-25 06:57Z @
120d389b7）： 已上线1c1e863e4feat(analytics): accept authenticated pricing bridge events (#1732)（web 公价页上报认证事件 + API pricing-analytics 模块 +501），以及 08-24 及更早全部 web/api 变更（Stripe 订阅、workspace usage 分页、campaign 等）。本次 web 维度新增 runtime 变更 = 0。 - Link（BASE e0db21a1d 已生效，2026-08-24 11:11Z）：已上线 last-good billing scope cache（
bd0954edc#1710）、Anthropic cache checkpoint 预留（e109c7519#1725）、coding-plan tier multipliers（215724e2e#1717）、per-tier access groups（77bfa086f#1733）等。 - Admin（BASE e0db21a1d 已生效）：已上线 per-tier access groups（#1733）、coding-plan tier multipliers（#1717）等，与上一条相同窗口。
- DB（BASE e0db21a1d 已生效）：20260824081848_workspace_usage_cursor_pagination、20260824030118_coding_plan_tier_model_groups、20260822063803_stripe_subscription_cancellation_details 等 migration 已执行。
- Catalog（BASE e0db21a1d 已生效，2026-08-24 11:13Z）：已上线
21632c51afeat(catalog): DeepSeek peak/off-peak COGS + Aiping/Aliyun billed rates (#1731) 及更早模型/定价变更。 - e2e-only commit（无 runtime 影响）：
120d389b7fix(e2e): remove obsolete migration-only fixture (#1750) 本身即 web/api 发布点 commit，已随 08-25 部署；仅涉及 e2e/db，不进入任何维度。
发布建议
- Migration 判断：BASE_DB（e0db21a1d）之后共有 5 个新 migration，必须先跑 deploy-db-migrations-prod.yml： 范围内无回退 migration，5 个全部会执行。
- 服务发布顺序（按依赖：DB → Catalog → Link → API → Admin → Web）：
- DB migrations：5 个 migration（e0db21a1d...1c24a9d 共 12 commits 基线）
- Model Routing Catalog：2 个 catalog commit（Muse Spark 1.2 seed + context_budget 重新生成 seed）
- Link：3 个 runtime commit（membership cache、stream establishment、context budget 投影）
- API：3 个 runtime commit（refund core、message-key 幂等、Open Design Run terminal billing）
- Admin：5 个 runtime commit（refund management、batch refund、patrol v3、message keys、context budget）
- Web：runtime 变更 = 0，可跳过不跑（或按流程重跑无实际内容变化）
- 数据 seed / catalog 判断：seed 由 deploy-model-routing-catalog-prod.yml 的 plan/apply 步骤覆盖（重新生成 seed-model-routing-catalog.sql，含 context_budget 字段与 Muse Spark 1.2 记录）；无需额外 runbook。退款管理的 local seed（db/seeds/local）不部署 prod。
- 发布后观测：
- patrol_reports 表开始产出日报/告警（Admin 巡检页 + Feishu 推送）
- 退款操作：billing refunds E2E、审计日志、Stripe 侧退款状态回传
- 计费正确性：open_design_run_terminal_states 随 run 结束落账，账单金额符合预期
- Muse Spark 1.2 在公价页可见、可发起路由请求（release gate 生效）
- context_budget：Admin 配置后，Link 投影与 CLI agent 实测上下文约束生效
- Link stream establishment metrics / tracing 在监控面板可见
备注：所有 workflow、commit、PR 或 compare range 均为可点击的 GitHub 链接；每个 workflow 的 compare 链接基于各自的发布点 BASE（web/api = 120d389b7，link/admin/db/catalog = e0db21a1d）。