发布跟踪：新前端 SPA 迁移版本（旧前端版本后） #116

Context fact card

目标

• 发布线路：Ant Design Pro SPA 新前端。
• 主跟踪 PR：feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109。
• 前置条件：先完成 发布跟踪：旧前端紧急版本（先行发布） #115 旧前端紧急版本，并固定其发布提交。
• 目标分支：最终合入 main，但不得抢占旧前端先行发版窗口。

已确认事实

• feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 是新前端总迁移 PR，当前直接以 main 为基线。
• fix(frontend): SPA 去脚手架/AI 味体验打磨 #110、fix(frontend): SSE refresh + export blob compatibility (PR #109 review) #111 的修改已同步进入 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 分支，属于新前端辅助/审查修复 PR，不应作为独立发布入口。
• fix: migrate old backend fixes into SPA migration branch #112 当前把 fix(imap): 修复验证码提取详情错配 #67、fix(verification): 验证码提取保留原文大小写 #103、[codex] add domain claim endpoint #105、#108 的后端修复复制到 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 分支。
• 若旧前端版本先将这些修复合入 main，则 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 应优先同步最新 main，随后再重新核对 fix: migrate old backend fixes into SPA migration branch #112，避免重复提交、冲突或遗漏。
• perf: optimize email fetching with SSE, caching, and concurrent IMAP #36 本阶段不迁移，继续作为独立性能优化方向保留。

PR 分类

新前端主发布入口

• feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 Ant Design Pro SPA migration

已同步到主迁移分支的辅助 PR

• fix(frontend): SPA 去脚手架/AI 味体验打磨 #110 SPA 产品化体验打磨
• fix(frontend): SSE refresh + export blob compatibility (PR #109 review) #111 SSE 刷新与导出兼容修复
  • 两者均已声明改动同步进入 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109；确认提交存在后，可作为被 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 取代的辅助 PR 处置。

后端修复迁移桥接

• fix: migrate old backend fixes into SPA migration branch #112 old backend fixes into SPA migration branch
  • 当前承载 fix(imap): 修复验证码提取详情错配 #67、fix(verification): 验证码提取保留原文大小写 #103、[codex] add domain claim endpoint #105、#108 的迁移和部分 SPA 检查修复。
  • 在 发布跟踪：旧前端紧急版本（先行发布） #115 完成后，应先把发布后的 main 合入/变基到 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109，再判断 fix: migrate old backend fixes into SPA migration branch #112：
    1. 若后端修复已随 main 全部进入 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109，则 fix: migrate old backend fixes into SPA migration branch #112 只保留 SPA 专属修复；
    2. 若无剩余独立改动，则关闭为已被 main 同步取代；
    3. fix(imap): 修复验证码提取详情错配 #67 的“详情为空”补丁与测试必须确认没有丢失。

明确不进入本阶段

• perf: optimize email fetching with SSE, caching, and concurrent IMAP #36 旧前端 SSE、缓存、并发 IMAP 性能优化
  • 后续单独重构，不与 SPA 首版捆绑。

发版基线（v2.8.0）

• Tag: v2.8.0
• main SHA: caea904
• Release: https://github.com/ZeroPointSix/outlookEmailPlus/releases/tag/v2.8.0
• 前置 发布跟踪：旧前端紧急版本（先行发布） #115: 已于 2026-07-26 关闭

建议执行顺序

1. 等待 发布跟踪：旧前端紧急版本（先行发布） #115 完成，并记录旧前端发布标签与提交 SHA。
2. 将发布后的最新 main 同步到 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109。
3. 核对 fix(frontend): SPA 去脚手架/AI 味体验打磨 #110、fix(frontend): SSE refresh + export blob compatibility (PR #109 review) #111 的提交确实已存在于 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109，随后再决定关闭辅助 PR。
4. 重新整理 fix: migrate old backend fixes into SPA migration branch #112，移除与 main 重复的后端提交，仅保留必要的 SPA 专属适配。
5. 执行新前端构建、前后端契约测试、双进程冒烟、登录/邮件/邮箱池/Token 工具 UAT。
6. 全部通过后再将 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 合入 main 并发布 SPA 版本。

发布边界

• 在旧前端紧急版本标签生成前，不合并 feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 到 main。
• 后端缺陷修复优先进入 main，新前端通过同步 main 继承，不再长期维护两份实现。
• fix(frontend): SPA 去脚手架/AI 味体验打磨 #110、fix(frontend): SSE refresh + export blob compatibility (PR #109 review) #111、fix: migrate old backend fixes into SPA migration branch #112 是辅助 PR，不作为最终版本发布入口。

完成标准

• 发布跟踪：旧前端紧急版本（先行发布） #115 已完成并发布（v2.8.0 / caea904）。
• feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 已同步发布后的最新 main。
• fix: migrate old backend fixes into SPA migration branch #112 的重复与遗漏已处理。
• SPA lint、test、build 通过。
• 后端回归和关键业务 UAT 通过。
• feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes) #109 已合入并完成新前端版本发布。