AMR 生产发布影响报告
当前生产发布点
五个生产 workflow 最近一次成功运行均停在 commit:0fcd8c26(docs: remove obsolete runbooks (#1028))。如果现在在 origin/main 发布,目标 commit 是 b1f0866c(fix(web): stack the sidebar utility links on two left-aligned rows (#1107))。
变更范围:0fcd8c26...b1f0866c,共 165 个 commit(first-parent 15 个;主体来自 workspace-team 合并分支)。
0fcd8c260fcd8c260fcd8c260fcd8c260fcd8c26此次发布的 feature 和影响面
| Feature / Author / Commits | Web | API | Link | Admin | DB schema / migration |
|---|---|---|---|---|---|
XXLTeam Billing / Subscription / Checkout 影响团队订阅、升级、结账、支付返回和订阅门户路径;这是本次最大的钱包外部支付链路变更。 Author:Caprika、lefarcen、nettee
| Plan dialog、Team upgrade、checkout return、billing portal/cancel、个人/团队入口归因。 | Team subscription、checkout、Stripe webhook/recovery、计划变更、订阅状态。 | 无直接 Link gateway 功能;扣费归属依赖 Workspace billing scope。 | 无。 | 需要 migration:workspace_team 中 billing/subscription/checkout 相关表结构。 |
XXLWallet / Credit / Auto-recharge / Ledger 影响余额、额度、低余额告警、自动充值、账本展示与历史订阅/发票协调。 Author:Caprika、lefarcen、nettee
| 余额/额度、低余额告警、auto recharge modal、ledger filter、wallet recovery。 | Workspace wallet/credit、scoped ledger、reconciliation、auto recharge policy。 | 影响 usage credit/accounting 归属。 | 无。 | 需要 migration:workspace_team 中 credit/ledger/auto-recharge 相关结构。 |
XLWorkspace Console UI(壳、导航、概览、路由) 影响用户进入 Workspace 后看到的主壳、侧栏、概览、角色导航和页面落点。 Author:Caprika、lefarcen、nettee
| Workspace shell、dashboard、settings、models、usage、sidebar、context strip、owner/member routing。 | 少量 dashboard/context 字段与 workspace access 支撑。 | 无。 | 无。 | 无独立 migration;依赖 Workspace 基础表存在。 |
LMember / Invite / Seat Allocation 影响邀请邮件/链接、邀请接受、成员状态、付费席位分配与成员操作。 Author:Caprika、lefarcen
| 邀请预览/继续、成员页、成员操作、邮件素材。 | Invite/accept、member directory、seat allocation、notification intents 原子写入。 | 无直接变更。 | 无。 | 需要 migration:workspace_team 中 invite/member/seat 相关结构。 |
LWorkspace Event Stream / Replay / Notifications 影响 Workspace billing/member/resource 变更的事件流、回放、通知投递和一致性恢复。 Author:lefarcen、nettee | 间接影响通知、状态刷新和 owner notification badges。 | Event bus、changelog、cursor replay、billing revisions、ops events fan-out。 | 无。 | 无。 | 需要 migration:event changelog/revision 相关结构随 workspace_team/collab migration 上线。 |
LResource Hub / Collab Presence / Publish Safety 影响资源发布、对象存储、manifest/ref 变更、presence 授权、并发保护与回滚安全。 Author:PerishFire、lefarcen、Caprika
| 少量资源入口/Workspace 间接影响。 | Resources/collab/presence API、blob-store、manifest/version/ref、rollback、并发保护。 | 无。 | 无。 | 需要 migration:resource_hub、collab_cloud。 |
MTeam Projects + CLI 授权/拉取 影响 CLI 查询 team project、授权 staged pulls 与项目资源拉取性能。 Author:lefarcen、PerishFire | 基本无。 | Team-projects API/OpenAPI、授权项目查询。 | 无。 | 无。 | 轻/无独立 migration;依赖 Workspace/resource 数据结构。 |
MCLI Runtime / Sandbox Execution 影响 CLI bundled OpenCode runtime、Sandbox 使用发布版 OpenCode、session-scoped dev CLI。 Author:Caprika、nettee、lefarcen、PerishFire | 无直接 Web runtime 影响。 | 少量 CLI/API contract 支撑。 | 无。 | 无。 | 无。 |
MLink Service Runtime / HPA / Timeout 影响 Link 服务扩缩容、流式请求超时、Redis/Bifrost 连接池配置与扣费域。 Author:Marc Chan、nettee | 无。 | API chart 也支持 HPA。 | Link HPA、timeout、Redis pool sizing、billing scope/usage credit 相关稳定性。 | 无。 | 无。 |
SAdmin Dev Cache / CI / Docs 清理 主要是 Admin 本地开发 cache、CI/workflow、spec archive、文档清理;生产用户影响低。 Author:nettee、lefarcen、github-actions[bot] | 少量 sidebar/CI/test 配置维护。 | CI、migration gate、ops-event 工具维护。 | workflow/chart 配置维护。 | Admin dev-only cache 配置。 | migration workflow/gate 有维护;不代表额外 schema。 |
发布建议
- Migration 判断:本次有 DB schema/migration 变更,先运行 deploy-db-migrations-prod.yml,确认
resource_hub、collab_cloud、workspace_team三个 migration 成功。 - 服务发布顺序:建议 DB migration → API → Link → Web → Admin。API/Link 依赖新 schema 与 Workspace billing/resource 表;Web 最后发布可减少前端先暴露新入口但后端/表未就绪的窗口。
- 数据 seed / catalog 判断:本次主要不是模型目录 seed 发布;无需额外模型 catalog workflow。团队 billing catalog/fixture 相关 seed 变更多用于本地/测试,生产仍以 migration 与服务配置为准。
- 发布后观测:重点验证 Team checkout、余额/额度/自动充值/账本、Workspace console、邀请/席位、event replay、resource publish/rollback、CLI team-project pull、Link HPA/timeout 与扣费归属。
所有 workflow、commit 与 compare range 均已链接到 GitHub。