补充md文件

项目文件结构说明.md

@@ -116,6 +116,45 @@
 
 ## `tests/`
 
+## 2026-04-17 增量补充
+
+### 新增共享模块
+
+- `managed-alias-utils.js`
+  共享 Gmail / 2925 的别名邮箱规则，负责：
+  - 解析基邮箱
+  - 校验“当前完整注册邮箱”是否仍与基邮箱兼容
+  - 生成 Gmail `+tag` 与 2925 随机后缀邮箱
+  - 输出 sidepanel 可复用的 UI 文案
+
+### 本轮受影响文件
+
+- `background/generated-email-helpers.js`
+  现在除了 Duck / Cloudflare / iCloud / Cloudflare Temp Email，也统一承接 Gmail / 2925 的别名邮箱生成入口。
+
+- `background/signup-flow-helpers.js`
+  在 Gmail / 2925 模式下，会优先复用已经存在且仍兼容的完整注册邮箱；只有不兼容或为空时才重新生成。
+
+- `background/auto-run-controller.js`
+  fresh-attempt reset 时，额外保留 `gmailBaseEmail` 与 `mail2925BaseEmail`，避免自动流程重置后丢失别名基邮箱配置。
+
+- `sidepanel/sidepanel.js`
+  现在把 Gmail / 2925 的“基邮箱输入”“完整注册邮箱输入”“自动生成按钮”“兼容性校验”统一接到共享别名逻辑上。
+
+- `sidepanel/sidepanel.html`
+  加载 `managed-alias-utils.js`，并把旧的“邮箱前缀”字段语义改为“别名基邮箱”。
+
+### 新增/补充测试
+
+- `tests/managed-alias-utils.test.js`
+  覆盖 Gmail / 2925 共享别名工具的解析、生成、兼容性判断。
+
+- `tests/background-signup-step2-branching.test.js`
+  补充“已有兼容别名邮箱时应直接复用，不应再次重生成”的行为验证。
+
+- `tests/auto-run-fresh-attempt-reset.test.js`
+  补充 `gmailBaseEmail` / `mail2925BaseEmail` 在自动流程 fresh reset 后仍被保留的回归验证。
+
 - `tests/activation-utils.test.js`閿涙碍绁寸拠鏇炲敶鐎圭鍓奸張顒佺负濞茶崵鐡ラ悾銉ょ瑢 Step 9 閸欘垱浠径宥夋晩鐠囶垰鍨介弬顓溾偓?
 - `tests/auto-run-fresh-attempt-reset.test.js`閿涙碍绁寸拠鏇″殰閸斻劏绻嶇悰灞芥躬閺傞绔存潪顔肩磻婵澧犳导姘跺櫢缂冾喗妫潻鎰攽閺冩湹绗傛稉瀣瀮閵?
 - `tests/auto-run-step6-restart.test.js`閿涙碍绁寸拠鏇″殰閸斻劏绻嶇悰灞芥躬濮濄儵顎?6 娑斿鎮楅柆鍥晩閺冩湹绱伴崶鐐插煂濮濄儵顎?6 闁插秴绱戦敍灞借嫙閸︺劌鎳℃稉?add-phone 閺冭泛浠犲銏ゅ櫢瀵偓閵?