补充md文件

项目完整链路说明.md

@@ -310,6 +310,46 @@
 
 ## 7. 邮箱与 provider 链路
 
+### 7.1 2026-04-17 补充：Gmail / 2925 统一别名邮箱链路
+
+本轮将 Gmail 与 2925 的注册邮箱逻辑统一收敛为“共享别名邮箱链路”：
+
+- 两者都先填写“基邮箱”
+  - Gmail：`name@gmail.com`
+  - 2925：`name@2925.com`
+- 两者都允许两种入口：
+  - 点击侧边栏按钮自动生成完整注册邮箱
+  - 直接在“注册邮箱”输入框中手动填写完整邮箱
+
+当前行为约定：
+
+1. sidepanel 展示“别名基邮箱”输入框，并根据当前 provider 显示对应文案
+2. 点击 `获取 / 生成` 时：
+   - Gmail 生成 `name+tag@gmail.com`
+   - 2925 生成 `name123456@2925.com`
+3. Step 2 / Step 3 进入注册流程前，会先判断当前 `state.email`
+   - 如果已经是与当前基邮箱兼容的完整邮箱，则直接复用
+   - 如果为空或不兼容，则按当前 provider 重新生成
+4. 保存或执行 Step 3 时，如果手动填写的完整邮箱与当前 Gmail / 2925 基邮箱不兼容，sidepanel 会直接拦截
+5. auto-run fresh attempt reset 时，会保留：
+   - `gmailBaseEmail`
+   - `mail2925BaseEmail`
+
+### 7.2 共享模块分工
+
+- `managed-alias-utils.js`
+  统一承接 Gmail / 2925 的：
+  - 基邮箱解析
+  - 完整邮箱兼容性判断
+  - 别名邮箱生成
+  - UI 文案输出
+
+- `background/generated-email-helpers.js`
+  在原有 Duck / Cloudflare / iCloud / Cloudflare Temp Email 生成链路之外，新增 Gmail / 2925 的共享生成接入。
+
+- `background/signup-flow-helpers.js`
+  负责在真正提交注册邮箱前做“复用已有完整邮箱 / 重新生成”的最终决策。
+
 ### 7.1 生成邮箱
 
 文件：