抽取cookie清理逻辑为新的第六步

项目文件结构说明.md

@@ -1,8 +1,8 @@
-# 妞ゅ湱娲伴弬鍥︽缂佹挻鐎拠瀛樻
+# 项目文件结构说明
 
-閺堫剚鏋冨锝呭灙閸戝搫缍嬮崜宥勭波鎼存挷鑵戦幍鈧張澶嗏偓婊堟姜韫囩晫鏆愰弬鍥︽閳ユ繐绱濋獮鎯邦嚛閺勫孩鐦℃稉顏呮瀮娴犲墎娈戞担婊呮暏閵?
+本文档列出当前仓库中所有“非忽略文件”，并说明每个文件的作用。
 
-娑撳秶鎾奸崗銉︽拱濞撳懎宕熼惃鍕嫹閻ｃ儳娲拌ぐ鏇窗
+不纳入本清单的忽略目录：
 
 - `.github/`
 - `_metadata/`
@@ -10,207 +10,170 @@
 - `.vscode/`
 - `.git/`
 
-閺囧瓨鏌婄憴鍕灟閿?
+更新规则：
 
-- 閺傛澘顤冮妴浣稿灩闂勩們鈧線鍣搁崨钘夋倳闂堢偛鎷烽悾銉︽瀮娴犺泛鎮楅敍灞界箑妞よ鎮撳銉︽纯閺傜増婀伴弬鍥︽閵?
-- 婵″倹鐏夐弬鍥︽閼卞矁鐭楅崣鎴犳晸閺勫孩妯夐崣妯哄閿涘奔绡冭箛鍛淬€忛崥灞绢劄閺囧瓨鏌婇張顒佹瀮娴犳湹鑵戦惃鍕嚛閺勫簺鈧?
+- 新增、删除、重命名非忽略文件后，必须同步更新本文件。
+- 如果文件职责发生明显变化，也必须同步更新本文件中的说明。
+- 本文档不保留“增量补充”“结构补充”一类追加章节；结构变化时，直接更新对应文件条目与职责说明。
 
-## 閺嶅湱娲拌ぐ?
+## 根目录
 
-- `.gitignore`閿涙艾鐣炬稊澶夌波鎼存挸鎷烽悾銉潐閸掓瑱绱濊ぐ鎾冲韫囩晫鏆?`docs/md/`閵嗕梗.github/`閵嗕梗_metadata/`閵嗕梗.vscode/` 缁涘娲拌ぐ鏇樷偓?
-- `LICENSE`閿涙岸銆嶉惄顔款啅閸欘垵鐦夐弬鍥︽閵?
-- `README.md`閿涙岸娼伴崥鎴滃▏閻劏鈧懐娈戞い鍦窗娴犲绮涢妴浣哥暔鐟佸懓顕╅弰搴涒偓浣藉厴閸旀稒绔婚崡鏇氱瑢閹垮秳缍旈幐鍥х穿閵?
-- `background.js`閿涙碍澧跨仦鏇炴倵閸?Service Worker 閸忋儱褰涙竟绛圭礉鐠愮喕鐭楀Ο鈥虫健鐟佸懘鍘ら妴浣稿灥婵瀵查妴浣稿弿鐏炩偓鐢悂鍣洪妴浣哥毌闁插繋绻氶悾娆戞畱妫板棗鐓欓崙鑺ユ殶娑撳氦绻嶇悰灞藉弳閸欙絻鈧?
-- `cloudflare-temp-email-utils.js`閿涙loudflare Temp Email 閻╃鍙ч惃鍕嚱瀹搞儱鍙块崙鑺ユ殶閿涘矁绀嬬拹?URL閵嗕礁鐓欓崥宥冣偓渚€鍋栨禒璺哄敶鐎归€涚瑢 MIME 閺佺増宓佽ぐ鎺嶇閸栨牓鈧?
-- `hotmail-utils.js`閿涙otmail 鐠愶箑褰挎稉搴ㄧ崣鐠囦胶鐖滈幓鎰絿閻╃鍙ч惃鍕嚱瀹搞儱鍙块崙鑺ユ殶閿涘矁绀嬬拹锝堝閸欓鐡柅澶堚偓渚€鐛欑拠浣虹垳閸栧綊鍘ら妴浣侯儑娑撳鏌熼幒銉ュ經閺佺増宓佽ぐ鎺嶇閸栨牓鈧?
-- `icloud-utils.js`閿涙Cloud 闂呮劗顫嗛柇顔绢唸閻╃鍙ч惃鍕嚱瀹搞儱鍙块崙鑺ユ殶閿涘矁绀嬬拹?host閵嗕礁鍩嗛崥宥呭灙鐞涖劊鈧椒绻氶悾娆戝Ц閹降鈧礁鍑￠悽銊уЦ閹胶鐡戣ぐ鎺嶇閸栨牓鈧?
-- `luckmail-utils.js`閿涙瓈uckMail 閻╃鍙ч惃鍕嚱瀹搞儱鍙块崙鑺ユ殶閿涘矁绀嬬拹锝夊仏缁犺精鍠樻稊鎷岊唶瑜版洏鈧焦鐖ｇ粵淇扁偓渚€鍋栨禒?cursor閵嗕線鐛欑拠浣虹垳閸栧綊鍘ょ粵澶婄秺娑撯偓閸栨牓鈧?
-- `manifest.json`閿涙hrome 閹碘晛鐫嶅〒鍛礋閿涘苯锛愰弰搴㈡綀闂勬劑鈧浇鍎楅弲顖濆壖閺堫兙鈧椒鏅舵潏瑙勭埉閵嗕礁鍞寸€圭鍓奸張顑跨瑢鐟欏嫬鍨梿鍡愨偓?
-- `microsoft-email.js`閿涙瓉icrosoft Graph / Outlook 闁喕娆㈢拠璇插絿鏉堝懎濮Ο鈥虫健閿涘矁绀嬬拹锝呭煕閺傞鎶ら悧灞惧床 token閵嗕線鍋栫粻鍗炪仚鏉烆喛顕楅崪宀勭崣鐠囦胶鐖滈幓鎰絿閵?
-- `package.json`閿涙矮绮ㄦ惔鎾存付鐏?Node 閸栧懘鍘ょ純顕嗙礉閻╊喖澧犳稉鏄忣洣閹绘劒绶靛ù瀣槸閼存碍婀扮€规矮绠熼妴?
-- `rules.json`閿涙岸娼ら幀?DNR 鐟欏嫬鍨敍灞煎瘜鐟曚礁顦╅悶?iCloud 閻╃鍙х拠閿嬬湴婢舵番鈧?
-- `start-hotmail-helper.bat`閿涙瓙indows 娑撳鎯庨崝銊︽拱閸?helper 閻ㄥ嫯鍓奸張顒婄幢瑜版挸澧犻弮銏℃箛閸斺€茬艾 Hotmail 閺堫剙婀撮弨鏈典繆閿涘奔绡冮張宥呭娴滃氦澶勯崣鐤箥鐞涘苯宸婚崣鍙夋瀮閺堫剛鏆€濡楋絻鈧?
-- `start-hotmail-helper.command`閿涙acOS 娑撳鎯庨崝銊︽拱閸?helper 閻ㄥ嫯鍓奸張顒婄幢瑜版挸澧犻弮銏℃箛閸斺€茬艾 Hotmail 閺堫剙婀撮弨鏈典繆閿涘奔绡冮張宥呭娴滃氦澶勯崣鐤箥鐞涘苯宸婚崣鍙夋瀮閺堫剛鏆€濡楋絻鈧?
-- `瀵偓閸欐垼鈧寬I瀵偓閸欐垳绗孭R閹绘劒姘﹀ù浣衡柤.md`閿涙矮绮ㄦ惔鎾跺箛閺堝娈?AI 瀵偓閸欐垳绗?PR 閹绘劒姘﹀ù浣衡柤鐠囧瓨妲戦妴?
-- `妞ゅ湱娲伴弬鍥︽缂佹挻鐎拠瀛樻.md`閿涙艾缍嬮崜宥嗘瀮娴犺绱濈紒瀛樺Б閺佺繝閲滄禒鎾崇氨闂堢偛鎷烽悾銉︽瀮娴犲墎娈戠紒鎾寸€稉搴や捍鐠愶絿鍌ㄥ鏇樷偓?
-- `妞ゅ湱娲扮€瑰本鏆ｉ柧鎹愮熅鐠囧瓨妲?md`閿涙岸娼伴崥?AI/瀵偓閸欐垼鈧懐娈戠€瑰本鏆ｉ崝鐔诲厴闁炬崘鐭剧拠瀛樻閿涘瞼鏁ゆ禍搴℃彥闁喓鎮婄憴锝囬兇缂佺喐鏆ｆ担鎾圭箥鐞涘矁绻冪粙瀣ㄢ偓?
-- `妞ゅ湱娲板鈧崣鎴ｎ潐閼煎喛绱橝I閸楀繋缍旈敍?md`閿涙岸娼伴崥?AI/瀵偓閸欐垼鈧懐娈戞い鍦窗瀵偓閸欐垼顫夐懠鍐︹偓浣哄閺夌喍绗岄崣妯绘纯濡偓閺屻儲绔婚崡鏇樷偓?
+- `.gitignore`：定义仓库忽略规则，当前忽略 `docs/md/`、`.github/`、`_metadata/`、`.vscode/` 等目录。
+- `LICENSE`：项目许可证文件。
+- `README.md`：面向使用者的项目介绍、安装说明、能力清单与操作指引。
+- `background.js`：扩展后台 Service Worker 入口壳，负责模块装配、初始化、全局常量、少量保留的领域函数与运行入口。
+- `cloudflare-temp-email-utils.js`：Cloudflare Temp Email 相关的纯工具函数，负责 URL、域名、邮件内容与 MIME 数据归一化。
+- `hotmail-utils.js`：Hotmail 账号与验证码提取相关的纯工具函数，负责账号筛选、验证码匹配、第三方接口数据归一化。
+- `icloud-utils.js`：iCloud 隐私邮箱相关的纯工具函数，负责 host、别名列表、保留状态、已用状态等归一化。
+- `luckmail-utils.js`：LuckMail 相关的纯工具函数，负责邮箱购买记录、标签、邮件 cursor、验证码匹配等归一化。
+- `managed-alias-utils.js`：共享 Gmail / 2925 的别名邮箱规则，负责解析基邮箱、校验“当前完整注册邮箱”是否仍与基邮箱兼容、生成 Gmail `+tag` 与 2925 随机后缀邮箱，并输出 sidepanel 可复用的 UI 文案。
+- `manifest.json`：Chrome 扩展清单，声明权限、背景脚本、侧边栏、内容脚本与规则集。
+- `microsoft-email.js`：Microsoft Graph / Outlook 邮件读取辅助模块，负责刷新令牌换 token、邮箱夹轮询和验证码提取。
+- `package.json`：仓库最小 Node 包配置，目前主要提供测试脚本定义。
+- `rules.json`：静态 DNR 规则，主要处理 iCloud 相关请求头。
+- `start-hotmail-helper.bat`：Windows 下启动本地 helper 的脚本；当前既服务于 Hotmail 本地收信，也服务于账号运行历史文本留档。
+- `start-hotmail-helper.command`：macOS 下启动本地 helper 的脚本；当前既服务于 Hotmail 本地收信，也服务于账号运行历史文本留档。
+- `开发者AI开发与PR提交流程.md`：仓库现有的 AI 开发与 PR 提交流程说明。
+- `项目文件结构说明.md`：当前文件，维护整个仓库非忽略文件的结构与职责索引。
+- `项目完整链路说明.md`：面向 AI/开发者的完整功能链路说明，用于快速理解系统整体运行过程。
+- `项目开发规范（AI协作）.md`：面向 AI/开发者的项目开发规范、约束与变更检查清单。
 
 ## `background/`
 
-- `background/account-run-history.js`閿涙俺澶勯崣鐤箥鐞涘苯宸婚崣鍙壞侀崸妤嬬礉鐠愮喕鐭楃亸鍡樺灇閸?婢惰精瑙?閸嬫粍顒涚紒鎾寸亯閹镐椒绠欓崠鏍у煂 `chrome.storage.local`閿涘苯鑻熼崷銊ユ儙閻劎瀚粩瀣畱閺堫剙婀?txt 閻ｆ瑦銆傞柊宥囩枂閸氬氦鎷烽崝鐘插晸閸忋儲鏋冮張顒佹）韫囨ぜ鈧?
-- `background/auto-run-controller.js`閿涙俺鍤滈崝銊ㄧ箥鐞涘奔瀵岄幒褍鍩楅崳顭掔礉鐏忎浇顥婃径姘崇枂閹笛嗩攽閵嗕線鍣哥拠鏇樷偓浣界枂濞嗏剝鎲崇憰浣碘偓浣哄殠缁嬪妫块梾鏂剧瑢閸婃帟顓搁弮鑸典划婢跺秹鈧槒绶妴?
-- `background/generated-email-helpers.js`閿涙氨鏁撻幋鎰板仏缁犺精绶熼崝鈺佺湴閿涘苯鐨濈憗?Duck閵嗕竼loudflare閵嗕竼loudflare Temp Email閵嗕巩Cloud 闂呮劗顫嗛柇顔绢唸閻ㄥ嫯骞忛崣鏍偓鏄忕帆閵?
-- `background/logging-status.js`閿涙艾鎮楅崣鐗堟）韫囨ぜ鈧焦顒炴銈囧Ц閹降鈧線鏁婄拠顖欎繆閹垰鎷伴懟銉ュ叡閻樿埖鈧礁鍨介弬顓犳畱閸忣剙鍙″銉ュ徔鐏炲倶鈧?
-- `background/message-router.js`閿涙艾鎮楅崣鐗堢Х閹垵鐭鹃悽鍗炵湴閿涘矁绀嬬拹锝咁槱閻?`chrome.runtime.onMessage` 鏉╂稑鍙嗛惃鍕閺堝绗熼崝鈩冪Х閹垬鈧?
-- `background/navigation-utils.js`閿涙艾顕遍懜顏冪瑢 URL 閸掋倖鏌囧銉ュ徔鐏炲偊绱濈拹鐔荤煑 callback閵嗕礁鍙嗛崣锝夈€夐妴涓哖A/SUB2API 閸︽澘娼冮妴浣诡劄妤犮倛鐑︽潪顒傛祲閸忓啿鍨介弬顓溾偓?
-- `background/panel-bridge.js`閿涙PA / SUB2API 闂堛垺婢樺銉﹀复鐏炲偊绱濈亸浣筋棅 OAuth 閸︽澘娼冮懢宄板絿閹碘偓闂団偓閻ㄥ嫰銆夐棃銏″ⅵ瀵偓閵嗕浇鍓奸張顒佹暈閸忋儱鎷伴柅姘繆閵?
-- `background/signup-flow-helpers.js`閿涙碍鏁為崘宀勩€夋潏鍛И鐏炲偊绱濈拹鐔荤煑閹垫挸绱戝▔銊ュ斀閸忋儱褰涢妴浣虹搼瀵板懎鐦戦惍渚€銆夋禒銉ュ挤鐟欙絾鐎借ぐ鎾冲濞翠胶鈻奸幍鈧悽銊╁仏缁犱究鈧?
-- `background/tab-runtime.js`閿涙碍鐖ｇ粵楣冦€夋稉搴″敶鐎圭鍓奸張顒冪箥鐞涘本妞傞崺铏诡攨鐠佺偓鏌﹂敍灞界殱鐟佸懏鐖ｇ粵鐐暈閸愬被鈧礁鍟跨粣浣圭閻炲棎鈧焦绉烽幁顖濈Т閺冭翰鈧焦鏁為崗銉╁櫢鐠囨洑绗岄梼鐔峰灙閵?
-- `background/verification-flow.js`閿涙碍鏁為崘?閻ц缍嶆宀冪槈閻礁鍙℃禍顐ｇウ缁嬪鐪伴敍灞界殱鐟佸懘鍣搁崣鎴欌偓浣界枂鐠囶潿鈧焦褰佹禍銈冣偓浣搞亼鐠愩儱娲栭柅鈧妴浣藉殰鐎规矮绠熼柇顔绢唸鐠哄疇绻冩禒銉ュ挤 2925 闂€鑳枂鐠囥垹寮弫鑸偓?
+- `background/account-run-history.js`：账号运行历史模块，负责将成功、失败、停止结果持久化到 `chrome.storage.local`，并在启用独立本地 txt 留档配置后追加写入文本日志。
+- `background/auto-run-controller.js`：自动运行主控制器，封装多轮执行、重试、轮次摘要、线程间隔与倒计时恢复逻辑；fresh-attempt reset 时会额外保留 `gmailBaseEmail` 与 `mail2925BaseEmail`，避免自动流程重置后丢失别名基邮箱配置。
+- `background/generated-email-helpers.js`：生成邮箱辅助层，除了 Duck / Cloudflare / iCloud / Cloudflare Temp Email，也统一承接 Gmail / 2925 的别名邮箱生成入口。
+- `background/logging-status.js`：后台日志、步骤状态、错误信息和若干状态判断的公共工具层。
+- `background/message-router.js`：后台消息路由层，负责处理 `chrome.runtime.onMessage` 进入的所有业务消息。
+- `background/navigation-utils.js`：导航与 URL 判断工具层，负责 callback、入口页、CPA / SUB2API 地址、步骤跳转相关判断。
+- `background/panel-bridge.js`：CPA / SUB2API 面板桥接层，封装 OAuth 地址获取所需的页面打开、脚本注入和通信。
+- `background/signup-flow-helpers.js`：注册页辅助层，负责打开注册入口、等待密码页以及解析当前流程所用邮箱；在 Gmail / 2925 模式下会优先复用已经存在且仍兼容的完整注册邮箱，只有不兼容或为空时才重新生成。
+- `background/tab-runtime.js`：标签页与内容脚本运行时基础设施，封装标签注册、冲突清理、消息超时、注入重试与队列。
+- `background/verification-flow.js`：注册/登录验证码共享流程层，封装重发、轮询、提交、失败回退、自定义邮箱跳过以及 2925 长轮询参数。
 
 ## `background/steps/`
 
-- `background/steps/confirm-oauth.js`閿涙碍顒炴?8 鐎圭偟骞囬敍宀冪鐠?OAuth 閸氬本鍓版い鍨瘻闁筋喖鐣炬担宥冣偓浣哄仯閸戞眹鈧勾ocalhost 閸ョ偠鐨熼惄鎴濇儔娑撳骸娲栫拫鍐ㄧ暚閹存劑鈧?
-- `background/steps/fetch-login-code.js`閿涙碍顒炴?7 鐎圭偟骞囬敍宀冪鐠愶絿娅ヨぐ鏇㈢崣鐠囦胶鐖滈梼鑸殿唽閻ㄥ嫰鍋栫粻杈枂鐠囶澀绗岄崶鐐衡偓鈧幒褍鍩楅妴?
-- `background/steps/fetch-signup-code.js`閿涙碍顒炴?4 鐎圭偟骞囬敍宀冪鐠愶絾鏁為崘宀勭崣鐠囦胶鐖滈梼鑸殿唽閻ㄥ嫰銆夐棃銏犲櫙婢跺洣绗屾宀冪槈閻焦绁︾粙瀣弳閸欙絻鈧?
-- `background/steps/fill-password.js`閿涙碍顒炴?3 鐎圭偟骞囬敍宀冪鐠愶絽鐦戦惍浣烘晸閹存劑鈧椒绻氱€涙ǜ鈧礁娲栨繅顐＄瑢閹绘劒姘﹂妴?
-- `background/steps/fill-profile.js`閿涙碍顒炴?5 鐎圭偟骞囬敍宀冪鐠愶絽顫橀崥宥冣偓浣烘晸閺冦儱锝為崘娆忚嫙閹跺﹨绁弬娆愬絹娴溿倗绮板▔銊ュ斀妞ら潧鍞寸€圭鍓奸張顑锯偓?
-- `background/steps/oauth-login.js`閿涙碍顒炴?6 鐎圭偟骞囬敍宀冪鐠愶絽鍩涢弬?OAuth 闁剧偓甯撮妴浣烘瑜版洖鎷扮涵顔荤箽鏉╂稑鍙嗘宀冪槈閻線銆夐妴?
-- `background/steps/open-chatgpt.js`閿涙碍顒炴?1 鐎圭偟骞囬敍宀冪鐠愶絾澧﹀鈧?ChatGPT 鐎规缍夐獮鍓佲€樼拋銈呭弳閸欙絽姘ㄧ紒顏傗偓?
-- `background/steps/platform-verify.js`閿涙碍顒炴?9 鐎圭偟骞囬敍宀冪鐠?CPA / SUB2API 閸ョ偠鐨熸宀冪槈閵?
-- `background/steps/registry.js`閿涙碍顒炴銈嗘暈閸愬矁銆冨銉ュ范閿涘矁绀嬬拹锝囨暏缁嬪啿鐣鹃惃鍕劄妤犮倕鍘撻弫鐗堝祦閺勭姴鐨犻崚鐗堝⒔鐞涘苯娅掗妴?
-- `background/steps/submit-signup-email.js`閿涙碍顒炴?2 鐎圭偟骞囬敍宀冪鐠愶絾鏁為崘灞藉弳閸欙絿鍋ｉ崙姹団偓渚€鍋栫粻杈ㄥ絹娴溿倓绗岄幓鎰唉閸氬氦鎯ら崷浼淬€夐崚鍡樻暜閸掋倖鏌囬妴?
+- `background/steps/clear-login-cookies.js`：步骤 6 实现，负责登录前 Cookie 清理。
+- `background/steps/confirm-oauth.js`：步骤 9 实现，负责 OAuth 同意页按钮定位、点击、localhost 回调监听与回调完成。
+- `background/steps/fetch-login-code.js`：步骤 8 实现，负责登录验证码阶段的邮箱轮询、验证码回填与回退控制。
+- `background/steps/fetch-signup-code.js`：步骤 4 实现，负责注册验证码阶段的页面准备与验证码流程入口。
+- `background/steps/fill-password.js`：步骤 3 实现，负责密码生成、保存、回填与提交。
+- `background/steps/fill-profile.js`：步骤 5 实现，负责姓名、生日填写并把资料提交给注册页内容脚本。
+- `background/steps/oauth-login.js`：步骤 7 实现，负责刷新 OAuth 链接、登录和确保进入验证码页。
+- `background/steps/open-chatgpt.js`：步骤 1 实现，负责打开 ChatGPT 官网并确认入口就绪。
+- `background/steps/platform-verify.js`：步骤 10 实现，负责 CPA / SUB2API 回调验证。
+- `background/steps/registry.js`：步骤注册表工厂，负责用稳定的步骤元数据映射到执行器。
+- `background/steps/submit-signup-email.js`：步骤 2 实现，负责注册入口点击、邮箱提交与提交后落地页分支判断。
 
 ## `content/`
 
-- `content/activation-utils.js`閿涙艾鍞寸€圭鍓奸張顒勨偓姘辨暏濠碘偓濞茶崵鐡ラ悾銉ヤ紣閸忓嚖绱濈拹鐔荤煑閹稿鎸抽悙鐟板毊閺傜懓绱￠崚銈嗘焽娑?Step 9 閸欘垱浠径宥呫亼鐠愩儲鏋冨鍫濆灲閺傤厹鈧?
-- `content/duck-mail.js`閿涙uckDuckGo Email Protection 妞ょ敻娼伴懘姘拱閿涘矁绀嬬拹锝囨晸閹存劖鍨ㄧ拠璇插絿 `@duck.com` 閸︽澘娼冮妴?
-- `content/gmail-mail.js`閿涙mail 闁喚顔堟潪顔款嚄閼存碍婀伴敍宀冪鐠愶絽婀?Gmail 妞ょ敻娼版稉顓炲爱闁板秹鐛欑拠浣虹垳闁喕娆㈤妴?
-- `content/icloud-mail.js`閿涙Cloud 闁喚顔堟い鐢告桨閼存碍婀伴敍宀冪鐠愶絽婀?iCloud Mail 妞ょ敻娼版稉顓☆嚢閸欐牠鍋栨禒鎯邦嚊閹懎鎷版宀冪槈閻降鈧?
-- `content/inbucket-mail.js`閿涙nbucket 闁喚顔堟潪顔款嚄閼存碍婀伴敍宀冪鐠愶絽婀?Inbucket 妞ょ敻娼版稉顓☆嚢閸?閸掔娀娅庢宀冪槈閻線鍋栨禒韬测偓?
-- `content/mail-163.js`閿?63 / 163 VIP 闁喚顔堟潪顔款嚄閼存碍婀伴敍宀冪鐠愶絿缍夋い鐢稿仏缁犻亶鐛欑拠浣虹垳鐠囪褰囬崪宀勫仏娴犺埖绔婚悶鍡愨偓?
-- `content/mail-2925.js`閿?925 闁喚顔堟い鐢告桨閼存碍婀伴敍宀冪鐠?2925 闁喚顔堥弨鏈垫鏉烆喛顕楁稉搴ㄧ崣鐠囦胶鐖滈崠褰掑帳閵?
-- `content/qq-mail.js`閿涙瓐Q 闁喚顔堟潪顔款嚄閼存碍婀伴敍宀冪鐠愶絿缍夋い鐢稿仏缁犻亶鐛欑拠浣虹垳鐠囪褰囬妴?
-- `content/signup-page.js`閿涙碍鏁為崘?閻ц缍?閹哄牊娼堟稉璇插敶鐎圭鍓奸張顒婄礉鐠愮喕鐭?OpenAI / ChatGPT 妞ょ敻娼版稉濠勬畱濮濄儵顎冮幍褑顢戦妴?
-- `content/sub2api-panel.js`閿涙瓔UB2API 閸氬骸褰撮崘鍛啇閼存碍婀伴敍宀冪鐠愶綀骞忛崣?OAuth 閸︽澘娼冮崪灞惧絹娴?localhost 閸ョ偠鐨熼妴?
-- `content/utils.js`閿涙艾鍞寸€圭鍓奸張顒€鍙曢崗鍗炰紣閸忓嘲鐪伴敍宀冪鐠愶絾妫╄箛妞尖偓涓稥ADY/COMPLETE/ERROR 娑撳﹥濮ら妴浣稿帗缁辩姷鐡戝鍛偓浣界翻閸忋儰绗岄悙鐟板毊閵?
-- `content/vps-panel.js`閿涙PA 闂堛垺婢橀崘鍛啇閼存碍婀伴敍宀冪鐠愶綀骞忛崣?OAuth 閸︽澘娼冮妴浣瑰絹娴溿倕娲栫拫?URL閿涘苯鑻熼崺杞扮艾缁墽鈥橀幋鎰瀵拌姤鐖ｆ稉搴ㄦ晩鐠囶垱鈧礁浠?Step 9 閸掋倕鐣鹃妴?
+- `content/activation-utils.js`：内容脚本通用激活策略工具，负责按钮点击方式判断与平台回调可恢复失败文案判断。
+- `content/auth-page-recovery.js`：认证页共享恢复模块，统一封装 `Try again / 重试` 页识别、点击重试和等待退出重试页；当前由注册验证码等待、OAuth 登录恢复、OAuth 同意页重试恢复链路复用。
+- `content/duck-mail.js`：DuckDuckGo Email Protection 页面脚本，负责生成或读取 `@duck.com` 地址。
+- `content/gmail-mail.js`：Gmail 邮箱轮询脚本，负责在 Gmail 页面中匹配验证码邮件。
+- `content/icloud-mail.js`：iCloud 邮箱页面脚本，负责在 iCloud Mail 页面中读取邮件详情和验证码。
+- `content/inbucket-mail.js`：Inbucket 邮箱轮询脚本，负责在 Inbucket 页面中读取、删除验证码邮件。
+- `content/mail-163.js`：163 / 163 VIP 邮箱轮询脚本，负责网页邮箱验证码读取和邮件清理。
+- `content/mail-2925.js`：2925 邮箱页面脚本，负责 2925 邮箱收件轮询与验证码匹配。
+- `content/qq-mail.js`：QQ 邮箱轮询脚本，负责网页邮箱验证码读取。
+- `content/signup-page.js`：注册、登录、授权主内容脚本，负责 OpenAI / ChatGPT 页面上的步骤执行。
+- `content/sub2api-panel.js`：SUB2API 后台内容脚本，负责获取 OAuth 地址和提交 localhost 回调；当前承接步骤 10。
+- `content/utils.js`：内容脚本公共工具层，负责日志、READY / COMPLETE / ERROR 上报、元素等待、输入与点击。
+- `content/vps-panel.js`：CPA 面板内容脚本，负责获取 OAuth 地址、提交回调 URL，并基于精确成功徽标与错误态做步骤 10 判定。
 
 ## `data/`
 
-- `data/names.js`閿涙岸娈㈤張鍝勵潣閸氬秲鈧胶鏁撻弮銉х搼濞村鐦弫鐗堝祦濠ф劑鈧?
-- `data/step-definitions.js`閿涙艾鍙℃禍顐ｎ劄妤犮倕鍘撻弫鐗堝祦閿涘苯澧犻崥搴″酱閸忓崬鎮撴担璺ㄦ暏閿涘瞼鏁ゆ禍搴″З閹焦瑕嗛弻鎾虫嫲濮濄儵顎冨▔銊ュ斀閵?
+- `data/names.js`：随机姓名、生日等测试数据源。
+- `data/step-definitions.js`：共享步骤元数据，前后台共同使用，用于动态渲染和步骤注册。
 
 ## `docs/`
 
-- `docs/Hotmail閸欏本膩瀵繘鈧倿鍘ゅ鈧崣鎴炴煙濡楀牆寮峰鈧崣鎴ｎ唶瑜?md`閿涙otmail 閸欏本膩瀵繑甯撮崗銉ф畱閸樺棗褰堕弬瑙勵攳閸滃苯绱戦崣鎴ｎ唶瑜版洏鈧?
-- `docs/娴犳挸绨遍崡蹇庣稊閼板寬I閸掑棙鐎絇R娑撳骸鎮庨獮鑸电垼閸戝棙绁︾粙?md`閿涙矮绮ㄦ惔鎾冲礂娴ｆ粏鈧懓绻樼悰?AI 閸掑棙鐎?PR 娑撳骸鎮庨獮鑸垫閻ㄥ嫭绁︾粙瀣嚛閺勫簺鈧?
-- `docs/images/娴溿倖绁︾紘?jpg`閿涙瓓EADME 娑擃厼鐫嶇粈铏规畱娴溿倖绁︾紘銈呮禈閻楀洩绁┃鎰┾偓?
-- `docs/images/閸椾浇鐤嗛懛顏勫З.png`閿涙瓓EADME 娑擃厼鐫嶇粈铏规畱閼奉亜濮╂潻鎰攽閺佸牊鐏夐崶淇扁偓?
-- `docs/images/瀵邦喕淇?png`閿涙瓓EADME 娑擃厼鐫嶇粈铏规畱瀵邦喕淇婇弨鑸殿儥閻礁娴橀悧鍥モ偓?
-- `docs/images/閺€顖欑帛鐎?jpg`閿涙瓓EADME 娑擃厼鐫嶇粈铏规畱閺€顖欑帛鐎规繃鏁瑰▎鍓х垳閸ュ墽澧栭妴?
-- `docs/refactor/2026-04-16-architecture-refactor-plan.md`閿涙碍婀版潪顕€鍣搁弸鍕▉濞堢數娈戠紒鎾寸€拋鎹愵吀娑撳氦绺肩粔鏄忣吀閸掓帟顔囪ぐ鏇樷偓?
-- `docs/superpowers/plans/2026-04-10-hotmail-oauth-mail-pool.md`閿涙otmail OAuth 闁喚顔堝Ч鐘茬杽閻滄媽顓搁崚鎺撴瀮濡楋絻鈧?
-- `docs/superpowers/specs/2026-04-10-hotmail-oauth-design.md`閿涙otmail OAuth + Graph Mail 閻ㄥ嫯顔曠拋陇顫夐弽鍏兼瀮濡楋絻鈧?
+- `docs/仓库协作者AI分析PR与合并标准流程.md`：仓库协作者进行 AI 分析 PR 与合并时的流程说明。
+- `docs/images/交流群.jpg`：README 中展示的交流群图片资源。
+- `docs/images/十轮自动.png`：README 中展示的自动运行效果图。
+- `docs/images/微信.png`：README 中展示的微信收款码图片。
+- `docs/images/支付宝.jpg`：README 中展示的支付宝收款码图片。
+- `docs/refactor/2026-04-16-architecture-refactor-plan.md`：本轮重构阶段的结构设计与迁移计划记录。
+- `docs/superpowers/plans/2026-04-10-hotmail-oauth-mail-pool.md`：Hotmail OAuth 邮箱池实现计划文档。
+- `docs/superpowers/specs/2026-04-10-hotmail-oauth-design.md`：Hotmail OAuth + Graph Mail 的设计规格文档。
 
 ## `icons/`
 
-- `icons/icon128.png`閿涙碍澧跨仦?128 閸嶅繒绀岄崶鐐垼閵?
-- `icons/icon16.png`閿涙碍澧跨仦?16 閸嶅繒绀岄崶鐐垼閵?
-- `icons/icon48.png`閿涙碍澧跨仦?48 閸嶅繒绀岄崶鐐垼閵?
+- `icons/icon128.png`：扩展 128 像素图标。
+- `icons/icon16.png`：扩展 16 像素图标。
+- `icons/icon48.png`：扩展 48 像素图标。
 
 ## `scripts/`
 
-- `scripts/hotmail_helper.py`閿涙碍婀伴崷?helper 閺堝秴濮熼敍宀冪鐠愶綁鈧俺绻冮張顒€婀撮幒銉ュ經閸楀繐濮?Hotmail 閼惧嘲褰囬柇顔绘閸滃矂鐛欑拠浣虹垳閿涘苯鑻熼幓鎰返鐠愶箑褰挎潻鎰攽閸樺棗褰堕弬鍥ㄦ拱鏉╄棄濮為幒銉ュ經閵?
+- `scripts/hotmail_helper.py`：本地 helper 服务，负责通过本地接口协助 Hotmail 获取邮件和验证码，并提供账号运行历史文本追加接口。
 
 ## `sidepanel/`
 
-- `sidepanel/hotmail-manager.js`閿涙矮鏅舵潏瑙勭埉 Hotmail 鐠愶箑褰垮Ч鐘殿吀閻炲棗娅掗敍宀冪鐠愶絽鍨悰銊ｂ偓浣割嚤閸忋儯鈧線鐛欑拠浣碘偓浣圭ゴ鐠囨洘鏁规穱鈥虫嫲閹靛綊鍣洪幙宥勭稊閵?
-- `sidepanel/icloud-manager.js`閿涙矮鏅舵潏瑙勭埉 iCloud 闂呮劗顫嗛柇顔绢唸缁狅紕鎮婇崳顭掔礉鐠愮喕鐭楅崚妤勩€冮妴浣虹摣闁鈧椒绻氶悾娆嶁偓浣稿灩闂勩倕鎷伴幍褰掑櫤閹垮秳缍旈妴?
-- `sidepanel/luckmail-manager.js`閿涙矮鏅舵潏瑙勭埉 LuckMail 缁狅紕鎮婇崳顭掔礉鐠愮喕鐭楅柇顔绢唸閸掓銆冮妴浣虹摣闁鈧礁鎯庨崑婧库偓浣风箽閻ｆ瑤绗岄幍褰掑櫤閹垮秳缍旈妴?
-- `sidepanel/sidepanel.css`閿涙矮鏅舵潏瑙勭埉閺嶅嘲绱￠弬鍥︽閵?
-- `sidepanel/sidepanel.html`閿涙矮鏅舵潏瑙勭埉妞ょ敻娼扮紒鎾寸€敍灞界秼閸撳秵顒炴銈呭灙鐞涖劌鍑￠弨閫涜礋閸斻劍鈧礁顔愰崳顭掔礉楠炶泛婀弮銉ョ箶閸栫儤鐖ｆ０妯圭瑓閺傚綊顣╅悾娆掑閸欑柉绻嶇悰灞藉坊閸欏弶鎲崇憰浣规蒋鐢负鈧?
-- `sidepanel/sidepanel.js`閿涙矮鏅舵潏瑙勭埉娑撹鍙嗛崣锝堝壖閺堫剨绱濈拹鐔荤煑 UI 閻樿埖鈧礁鎮撳銉ｂ偓浣稿З閹焦顒炴銈嗚閺屾挶鈧焦瀵滈柦顔绘唉娴滄帇鈧浇澶勯崣鐤箥鐞涘苯宸婚崣鍙夋喅鐟曚焦瑕嗛弻鎾扁偓浣哄缁?txt 閻ｆ瑦銆傞柊宥囩枂娑撳骸绠嶉幘顓熷复閺€韬测偓?
-- `sidepanel/update-service.js`閿涙矮鏅舵潏瑙勭埉閺囧瓨鏌婂Λ鈧弻銉︽箛閸斺槄绱濈拹鐔荤煑 GitHub Releases 閺屻儴顕楁稉搴ｅ閺堫剙鐫嶇粈鎭掆偓?
+- `sidepanel/hotmail-manager.js`：侧边栏 Hotmail 账号池管理器，负责列表、导入、验证、测试收信和批量操作。
+- `sidepanel/icloud-manager.js`：侧边栏 iCloud 隐私邮箱管理器，负责列表、筛选、保留、删除和批量操作。
+- `sidepanel/luckmail-manager.js`：侧边栏 LuckMail 管理器，负责邮箱列表、筛选、启停、保留与批量操作。
+- `sidepanel/sidepanel.css`：侧边栏样式文件。
+- `sidepanel/sidepanel.html`：侧边栏页面结构；当前步骤列表已改为动态容器，日志区标题下方预留账号运行历史摘要条带，且会加载 `managed-alias-utils.js`，把旧的“邮箱前缀”字段语义改为“别名基邮箱”。
+- `sidepanel/sidepanel.js`：侧边栏主入口脚本，负责 UI 状态同步、动态步骤渲染、按钮交互、账号运行历史摘要渲染、独立 txt 留档配置与广播接收；同时把 Gmail / 2925 的基邮箱输入、完整注册邮箱输入、自动生成按钮与兼容性校验统一接到共享别名逻辑上。
+- `sidepanel/update-service.js`：侧边栏更新检查服务，负责 GitHub Releases 查询与版本展示。
 
 ## `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 閺冭泛浠犲銏ゅ櫢瀵偓閵?
-- `tests/auto-step-random-delay.test.js`閿涙碍绁寸拠鏇″殰閸斻劏绻嶇悰灞绢劄闂傛潙娆㈡潻鐔剁瑢閺冄囧帳缂冾噣鏁崗鐓庮啇鐟欙絾鐎介妴?
-- `tests/background-auto-run-module.test.js`閿涙碍绁寸拠鏇″殰閸斻劏绻嶇悰灞惧付閸掕泛娅掑Ο鈥虫健瀹稿弶甯撮崗銉ょ瑬鐎电厧鍤銉ュ范閵?
-- `tests/background-account-run-history-module.test.js`閿涙碍绁寸拠鏇″閸欑柉绻嶇悰灞藉坊閸欏弶膩閸ф鍑￠幒銉ュ弳閵嗕礁顕遍崙鍝勪紣閸樺偊绱濋獮鎯板厴閸︺劋绗夐崥顖滄暏閺堫剙婀?helper 閺冭埖顒滅涵顔藉瘮娑斿懎瀵茬拋鏉跨秿閵?
-- `tests/background-account-history-settings.test.js`閿涙碍绁寸拠鏇″閸欑柉绻嶇悰灞藉坊閸欒尙娈戦悪顒傜彌闁板秶鐤嗘い鐟扮秺娑撯偓閸栨牭绱濇稉宥呭晙婢跺秶鏁?Hotmail 濡€崇础娴ｆ粈璐熼崥顖氫粻閺夆€叉閵?
-- `tests/background-generated-email-module.test.js`閿涙碍绁寸拠鏇犳晸閹存劙鍋栫粻杈窡閸斺晜膩閸ф鍑￠幒銉ュ弳娑撴柨顕遍崙鍝勪紣閸樺倶鈧?
-- `tests/background-icloud.test.js`閿涙碍绁寸拠?iCloud 閻╃鍙ч崥搴″酱缁绢垰鍤遍弫棰佺瑢閸掝偄鎮曢弨璺虹啲闁槒绶妴?
-- `tests/background-icloud-mail-provider.test.js`閿涙碍绁寸拠?iCloud 闁喚顔?provider 闁板秶鐤嗙憴锝嗙€介妴?
-- `tests/background-logging-status-module.test.js`閿涙碍绁寸拠鏇熸）韫?閻樿埖鈧焦膩閸ф鍑￠幒銉ュ弳娑撴柨顕遍崙鍝勪紣閸樺倶鈧?
-- `tests/background-luckmail.test.js`閿涙碍绁寸拠?LuckMail 閻╃鍙ч崥搴″酱闁槒绶敍灞筋洤鐠愵厺鎷遍妴浣割槻閻劊鈧焦鐖ｇ拋鏉垮嚒閻劋绗岄柌宥囩枂閵?
-- `tests/background-message-router-module.test.js`閿涙碍绁寸拠鏇熺Х閹垵鐭鹃悽杈侀崸妤€鍑￠幒銉ュ弳娑撴柨顕遍崙鍝勪紣閸樺倶鈧?
-- `tests/background-message-router-step2-skip.test.js`閿涙碍绁寸拠鏇燁劄妤?2 閻╁瓨甯撮拃钘夊煂妤犲矁鐦夐惍渚€銆夐弮鍓佹畱鐠鸿櫕顒炴稉搴ｅЦ閹椒绻氶幎銈夆偓鏄忕帆閵?
-- `tests/background-navigation-utils-module.test.js`閿涙碍绁寸拠鏇烆嚤閼割亜浼愰崗閿嬆侀崸妤€鍑￠幒銉ュ弳娑撴柨顕遍崙鍝勪紣閸樺倶鈧?
-- `tests/background-panel-bridge-module.test.js`閿涙碍绁寸拠鏇㈡桨閺夋寧藟閹恒儲膩閸ф鍑￠幒銉ュ弳娑撴柨顕遍崙鍝勪紣閸樺倶鈧?
-- `tests/background-signup-flow-module.test.js`閿涙碍绁寸拠鏇熸暈閸愬矂銆夋潏鍛И濡€虫健瀹稿弶甯撮崗銉ょ瑬鐎电厧鍤銉ュ范閵?
-- `tests/background-step-modules.test.js`閿涙碍绁寸拠鏇燁劄妤犮倖膩閸ф鏋冩禒鍫曞厴瀹歌尙鏁遍崥搴″酱閸忋儱褰涢崝鐘烘祰閵?
-- `tests/background-step5-submit-short-circuit.test.js`閿涙碍绁寸拠?Step 5 娴兼碍濡搁悽鐔稿灇婵傜晫娈戠挧鍕灐閻╁瓨甯存潪顒€褰傜紒娆忓敶鐎圭鍓奸張顒婄礉楠炴湹绶风挧鏍х暚閹存劒淇婇崣閿嬫暪鐏忎勘鈧?
-- `tests/signup-entry-diagnostics.test.js`：测试 Step 1 / Step 2 注册入口识别失败时的诊断快照摘要。
-- `tests/step3-direct-complete.test.js`锛氭祴璇?Step 3 浼氬厛鍥炰紶瀹屾垚杞借嵎锛屽啀寮傛瑙﹀彂琛ㄥ崟鎻愪氦锛岄伩鍏嶉〉闈㈣烦杞崱浣忎富娴佺▼銆?
-- `tests/background-step6-retry-limit.test.js`閿涙碍绁寸拠?Step 6 閻ㄥ嫭婀侀梽鎰板櫢鐠囨洑绗傞梽鎰剁礉娴犮儱寮?Step 7 閸ョ偞鏂侀弮璺哄讲鐠哄疇绻冮惂璇茬秿閸?Cookie 濞撳懐鎮婇妴?
-- `tests/background-step7-recovery.test.js`閿涙碍绁寸拠?Step 7 閸?CPA 濡€崇础娑撳绱伴崗鍫濇礀閺€?Step 6 閸愬秵褰佹禍銈囨瑜版洟鐛欑拠浣虹垳閿涘苯鑻熸稉?2925 閸忔娊妫撮柌宥呭絺闂傛挳娈ч妴?
-- `tests/background-step-registry.test.js`閿涙碍绁寸拠鏇炴倵閸欑増顒炴銈嗘暈閸愬矁銆冮崪灞藉彙娴滎偅顒炴銈呯暰娑斿鍑￠幒銉ュ弳閵?
-- `tests/background-tab-runtime-module.test.js`閿涙碍绁寸拠鏇熺垼缁涙崘绻嶇悰灞炬濡€虫健瀹稿弶甯撮崗銉ょ瑬鐎电厧鍤銉ュ范閵?
-- `tests/background-verification-flow-module.test.js`閿涙碍绁寸拠鏇㈢崣鐠囦胶鐖滃ù浣衡柤濡€虫健瀹稿弶甯撮崗銉ょ瑬鐎电厧鍤銉ュ范閵?
-- `tests/cloudflare-temp-email-provider.test.js`閿涙碍绁寸拠?Cloudflare Temp Email provider 閻ㄥ嫯鐤嗙拠顫瑢閻╊喗鐖ｉ柇顔绢唸闁瀚ㄩ柅鏄忕帆閵?
-- `tests/cloudflare-temp-email-utils.test.js`閿涙碍绁寸拠?Cloudflare Temp Email 瀹搞儱鍙跨仦鍌滄畱 URL閵嗕礁鐓欓崥宥冣偓渚€鍋栨禒鎯靶掗弸鎰扳偓鏄忕帆閵?
-- `tests/hotmail-api-mode.test.js`閿涙碍绁寸拠?Hotmail API 濡€崇础閻╃鍙ч弬鍥攳閸滃矂娉﹂幋鎰煙瀵繈鈧?
-- `tests/hotmail-cors-headers.test.js`閿涙碍绁寸拠?Microsoft token 鐠囬攱鐪伴惄绋垮彠 DNR 闁板秶鐤嗛妴?
-- `tests/hotmail-utils.test.js`閿涙碍绁寸拠?Hotmail 瀹搞儱鍙跨仦鍌滄畱鐠愶箑褰跨粵娑⑩偓澶堚偓渚€鐛欑拠浣虹垳閹绘劕褰囬崪灞剧Х閹垰灏柊宥夆偓鏄忕帆閵?
-- `tests/icloud-mail-content.test.js`閿涙碍绁寸拠?iCloud Mail 閸愬懎顔愰懘姘拱鐠囪褰囬柇顔绘濮濓絾鏋冮崪宀勨偓澶夎厬閻樿埖鈧線鈧槒绶妴?
-- `tests/icloud-utils.test.js`閿涙碍绁寸拠?iCloud 瀹搞儱鍙跨仦鍌滄畱 host閵嗕礁鍩嗛崥宥呭灙鐞涖劊鈧椒绻氶悾娆戝Ц閹椒绗岀粵娑⑩偓澶愨偓鏄忕帆閵?
-- `tests/luckmail-utils.test.js`閿涙碍绁寸拠?LuckMail 瀹搞儱鍙跨仦鍌滄畱鐠愵厺鎷辩拋鏉跨秿閵嗕線鍋栨禒韬测偓浣圭埗閺嶅洤鎷版宀冪槈閻礁灏柊宥夆偓鏄忕帆閵?
-- `tests/microsoft-email.test.js`閿涙碍绁寸拠?Microsoft 闁喕娆㈤幏澶婂絿娑撳酣鐛欑拠浣虹垳閹绘劕褰囬柅鏄忕帆閵?
-- `tests/sidepanel-hotmail-manager.test.js`閿涙碍绁寸拠鏇氭櫠鏉堣鐖?Hotmail 缁狅紕鎮婇崳銊δ侀崸妤佸复缁惧じ绗岀粚鐑樷偓浣硅閺屾挶鈧?
-- `tests/sidepanel-account-run-history.test.js`閿涙碍绁寸拠鏇氭櫠鏉堣鐖弮銉ョ箶閸栬桨绗呴弬鍦畱鐠愶箑褰挎潻鎰攽閸樺棗褰堕弶鈥崇敨缂佹挻鐎妴浣哄缁斿鏆€濡楋綁鍘ょ純顔藉付娴犳湹绗岄悩鑸碘偓浣稿瀻缁粯鎲崇憰渚€鈧槒绶妴?
-- `tests/sidepanel-icloud-manager.test.js`閿涙碍绁寸拠鏇氭櫠鏉堣鐖?iCloud 缁狅紕鎮婇崳銊δ侀崸妤佸复缁惧じ绗岀粚鐑樷偓浣硅閺屾挶鈧?
-- `tests/sidepanel-icloud-provider.test.js`閿涙碍绁寸拠鏇氭櫠鏉堣鐖?iCloud 閻ц缍嶉崷鏉挎絻鐟欙絾鐎介柅鏄忕帆閵?
-- `tests/sidepanel-luckmail-manager.test.js`閿涙碍绁寸拠鏇氭櫠鏉堣鐖?LuckMail 缁狅紕鎮婇崳銊δ侀崸妤佸复缁惧じ绗岀粚鐑樷偓浣硅閺屾挶鈧?
-- `tests/signup-page-tab-cleanup.test.js`閿涙碍绁寸拠鏇熸暈閸愬矂銆夐弶銉︾爱閺嶅洨顒烽惃鍕暱缁愪焦绔婚悶鍡涒偓鏄忕帆閵?
-- `tests/step-definitions-module.test.js`閿涙碍绁寸拠鏇炲彙娴滎偅顒炴銈呯暰娑斿膩閸ф寮锋笟褑绔熼弽蹇氬壖閺堫剙濮炴潪浠嬨€庢惔蹇嬧偓?
-- `tests/step5-direct-complete.test.js`閿涙碍绁寸拠?Step 5 閸︺劏绁弬娆撱€夐悙鐟板毊閹绘劒姘﹂崥搴ｇ彌閸楀啿鐣幋鎰秼閸撳秵顒炴銈冣偓?
-- `tests/step6-login-state.test.js`閿涙碍绁寸拠?Step 6 閻ц缍嶉悩鑸碘偓浣稿灲閺傤參鈧槒绶妴?
-- `tests/step8-callback-handling.test.js`閿涙碍绁寸拠?Step 8 閸ョ偠鐨熼崷鏉挎絻閹规洝骞忛柅鏄忕帆閵?
-- `tests/step8-debugger-stop.test.js`閿涙碍绁寸拠?Step 8 鐠嬪啳鐦崳銊у仯閸戣婀?Stop 閸︾儤娅欐稉瀣畱娑擃厽顒涚悰灞艰礋閵?
-- `tests/step8-state-timeout-retry.test.js`閿涙碍绁寸拠?Step 8 闁矮淇婇柨娆掝嚖閺勵垰鎯侀崣顖氬灲鐎规矮璐熼崣顖炲櫢鐠囨洏鈧?
-- `tests/step8-stop-cleanup.test.js`閿涙碍绁寸拠?Step 8 閸?Stop 閸氬氦鍏樺锝団€樺〒鍛倞閻╂垵鎯夐崳銊ょ瑢閹稿倽鎹ｉ悩鑸碘偓浣碘偓?
-- `tests/step9-cpa-mode.test.js`閿涙碍绁寸拠鏇熸拱閸?CPA Step 9 缁涙牜鏆愰崚銈嗘焽閵?
-- `tests/step9-localhost-cleanup-scope.test.js`閿涙碍绁寸拠?Step 9 娴犲懏绔婚悶鍡欑翱绾喖鎳℃稉顓犳畱 localhost callback 閸滃矁鐭惧鍕缂傗偓濞堝鏆€妞ょ偣鈧?
-- `tests/step9-status-diagnostics.test.js`閿涙碍绁寸拠?Step 9 缁墽鈥橀幋鎰閸掋倕鐣鹃妴浣哄閼规煡鏁婄拠顖涒偓浣界箖濠娿倧绱濇禒銉ュ挤閹存劕濮涘鑺ョ垼娑撳骸銇戠拹銉﹀絹缁€鍝勮嫙鐎涙ɑ妞傞惃鍕喘閸忓牏楠囬妴?
-- `tests/verification-stop-propagation.test.js`閿涙碍绁寸拠鏇㈢崣鐠囦胶鐖滃ù浣衡柤閸?Stop 閸︾儤娅欐稉瀣畱闁挎瑨顕ゆ导鐘虫尡娑撳簼绗夋稉顓⑩偓鏃堟缁狙佲偓?
-- `tests/verification-flow-polling.test.js`閿涙碍绁寸拠?2925 闂€鑳枂鐠囥垹寮弫甯礉娴犮儱寮锋宀冪槈閻焦褰佹禍銈嗙ウ缁嬪鑵戦惃?`beforeSubmit` 闁解晛鐡欓幍褑顢戞い鍝勭碍閵?
-## 2026-04 结构补充
-
-- `content/auth-page-recovery.js`
-  - 认证页共享恢复模块。
-  - 统一封装 `Try again / 重试` 页识别、点击重试、等待退出重试页。
-  - 当前由 Step 4 / Step 6 / Step 8 复用。
+- `tests/activation-utils.test.js`：测试内容脚本激活策略与平台回调可恢复错误判断。
+- `tests/auth-page-recovery.test.js`：测试认证页共享恢复层的重试页识别与恢复行为。
+- `tests/auto-run-fresh-attempt-reset.test.js`：测试自动运行在新一轮开始前会重置旧运行时上下文，并补充 `gmailBaseEmail` / `mail2925BaseEmail` 在 fresh reset 后仍被保留的回归验证。
+- `tests/auto-run-step6-restart.test.js`：测试自动运行在后半段授权链路遇错时会回到步骤 7 重开，并在命中 add-phone 时停止重开。
+- `tests/auto-step-random-delay.test.js`：测试自动运行步间延迟与旧配置键兼容解析。
+- `tests/background-auto-run-module.test.js`：测试自动运行控制器模块已接入且导出工厂。
+- `tests/background-account-run-history-module.test.js`：测试账号运行历史模块已接入、导出工厂，并能在不启用本地 helper 时正确持久化记录。
+- `tests/background-account-history-settings.test.js`：测试账号运行历史的独立配置项归一化，不再复用 Hotmail 模式作为启停条件。
+- `tests/background-generated-email-module.test.js`：测试生成邮箱辅助模块已接入且导出工厂。
+- `tests/background-icloud.test.js`：测试 iCloud 相关后台纯函数与别名收尾逻辑。
+- `tests/background-icloud-mail-provider.test.js`：测试 iCloud 邮箱 provider 配置解析。
+- `tests/background-logging-status-module.test.js`：测试日志 / 状态模块已接入且导出工厂。
+- `tests/background-luckmail.test.js`：测试 LuckMail 相关后台逻辑，如购买、复用、标记已用与重置。
+- `tests/background-message-router-module.test.js`：测试消息路由模块已接入且导出工厂。
+- `tests/background-message-router-step2-skip.test.js`：测试步骤 2 直接落到验证码页时的跳步与状态保护逻辑。
+- `tests/background-navigation-utils-module.test.js`：测试导航工具模块已接入且导出工厂。
+- `tests/background-panel-bridge-module.test.js`：测试面板桥接模块已接入且导出工厂。
+- `tests/background-signup-flow-module.test.js`：测试注册页辅助模块已接入且导出工厂。
+- `tests/background-signup-step2-branching.test.js`：测试在 Gmail / 2925 模式下，已有兼容别名邮箱时应直接复用，不应再次重生成。
+- `tests/background-step-modules.test.js`：测试步骤模块文件都已由后台入口加载。
+- `tests/background-step5-submit-short-circuit.test.js`：测试步骤 5 会把生成好的资料直接转发给内容脚本，并依赖完成信号收尾。
+- `tests/background-step6-retry-limit.test.js`：测试步骤 6 的 Cookie 清理，以及步骤 7 的有限重试上限。
+- `tests/background-step7-recovery.test.js`：测试步骤 8 在 CPA 模式下会先回放步骤 7 再提交登录验证码，并为 2925 关闭重发间隔。
+- `tests/background-step-registry.test.js`：测试后台步骤注册表和共享步骤定义已接入。
+- `tests/background-tab-runtime-module.test.js`：测试标签运行时模块已接入且导出工厂。
+- `tests/background-verification-flow-module.test.js`：测试验证码流程模块已接入且导出工厂。
+- `tests/cloudflare-temp-email-provider.test.js`：测试 Cloudflare Temp Email provider 的轮询与目标邮箱选择逻辑。
+- `tests/cloudflare-temp-email-utils.test.js`：测试 Cloudflare Temp Email 工具层的 URL、域名、邮件解析逻辑。
+- `tests/hotmail-api-mode.test.js`：测试 Hotmail API 模式相关文案和集成方式。
+- `tests/hotmail-cors-headers.test.js`：测试 Microsoft token 请求相关 DNR 配置。
+- `tests/hotmail-utils.test.js`：测试 Hotmail 工具层的账号筛选、验证码提取和消息匹配逻辑。
+- `tests/icloud-mail-content.test.js`：测试 iCloud Mail 内容脚本读取邮件正文和选中状态逻辑。
+- `tests/icloud-utils.test.js`：测试 iCloud 工具层的 host、别名列表、保留状态与筛选逻辑。
+- `tests/luckmail-utils.test.js`：测试 LuckMail 工具层的购买记录、邮件、游标和验证码匹配逻辑。
+- `tests/managed-alias-utils.test.js`：覆盖 Gmail / 2925 共享别名工具的解析、生成、兼容性判断。
+- `tests/microsoft-email.test.js`：测试 Microsoft 邮件拉取与验证码提取逻辑。
+- `tests/sidepanel-hotmail-manager.test.js`：测试侧边栏 Hotmail 管理器模块接线与空态渲染。
+- `tests/sidepanel-account-run-history.test.js`：测试侧边栏日志区下方的账号运行历史条带结构、独立留档配置控件与状态分类摘要逻辑。
+- `tests/sidepanel-icloud-manager.test.js`：测试侧边栏 iCloud 管理器模块接线与空态渲染。
+- `tests/sidepanel-icloud-provider.test.js`：测试侧边栏 iCloud 登录地址解析逻辑。
+- `tests/sidepanel-luckmail-manager.test.js`：测试侧边栏 LuckMail 管理器模块接线与空态渲染。
+- `tests/signup-entry-diagnostics.test.js`：测试注册入口诊断快照输出。
+- `tests/signup-page-tab-cleanup.test.js`：测试注册页来源标签的冲突清理逻辑。
+- `tests/step-definitions-module.test.js`：测试共享步骤定义模块及侧边栏脚本加载顺序。
+- `tests/step3-direct-complete.test.js`：测试步骤 3 在提交前先完成上报。
+- `tests/step5-direct-complete.test.js`：测试步骤 5 在资料页点击提交后立即完成当前步骤。
+- `tests/step6-login-state.test.js`：测试 OAuth 登录状态识别逻辑，当前对应步骤 7 链路。
+- `tests/step6-timeout-recovery.test.js`：测试 OAuth 登录超时报错页的可恢复结果构造，当前对应步骤 7 链路。
+- `tests/step8-callback-handling.test.js`：测试 localhost 回调地址捕获逻辑，当前对应步骤 9。
+- `tests/step8-debugger-stop.test.js`：测试调试器点击在 Stop 场景下的中止行为，当前对应步骤 9。
+- `tests/step8-retry-page-recovery.test.js`：测试 OAuth 同意页点击后的重试页恢复分支，当前对应步骤 9。
+- `tests/step8-state-timeout-retry.test.js`：测试认证页通信错误是否可判定为可重试，当前对应步骤 9。
+- `tests/step8-stop-cleanup.test.js`：测试 OAuth 确认流程在 Stop 后能正确清理监听器与挂起状态，当前对应步骤 9。
+- `tests/step9-cpa-mode.test.js`：测试本地 CPA 平台回调跳过策略判断，当前作用于步骤 10。
+- `tests/step9-localhost-cleanup-scope.test.js`：测试 localhost callback 与路径前缀残留页的精确清理范围，当前对应步骤 10 收尾。
+- `tests/step9-status-diagnostics.test.js`：测试平台回调成功判定、红色错误态过滤，以及成功徽标与失败提示并存时的优先级，当前对应步骤 10。
+- `tests/verification-stop-propagation.test.js`：测试验证码流程在 Stop 场景下的错误传播与不中途降级。
+- `tests/verification-flow-polling.test.js`：测试 2925 长轮询参数，以及验证码提交流程中的 `beforeSubmit` 钩子执行顺序。