feat: add support for Inbucket mailbox configuration and dynamic host input

README.md

@@ -1,40 +1,373 @@
 # Multi-Page Automation
 
-ChatGPT OAuth 批量注册自动化 Chrome 扩展。
+一个用于批量跑通 ChatGPT OAuth 注册/登录流程的 Chrome 扩展。
 
-## 前提
+当前版本基于侧边栏控制，支持单步执行、整套自动执行、停止当前流程、保存常用配置，以及通过 DuckDuckGo / QQ / 163 / Inbucket mailbox 协助获取验证码。
 
-- 注册 [DuckDuckGo Email Protection](https://duckduckgo.com/email/)，获取 @duck.com 邮箱地址，转发目标设为 163 或 QQ 邮箱
-- Chrome 浏览器，开发者模式加载本扩展
-- 提前登录好 VPS 管理面板和对应的邮箱（163 或 QQ）
+## 当前能力
+
+- 从 VPS 面板自动获取 OpenAI OAuth 授权链接
+- 自动打开 OpenAI 注册页并点击 `Sign up / Register`
+- 自动填写邮箱与密码
+- 支持自定义密码；留空时自动生成强密码
+- 自动显示当前使用中的密码，便于后续保存
+- 自动获取注册验证码与登录验证码
+- 支持 `QQ Mail`、`163 Mail`、`Inbucket mailbox`
+- 支持从 DuckDuckGo Email Protection 自动生成新的 `@duck.com` 地址
+- Step 5 同时兼容两种页面：
+  - 页面要求填写 `birthday`
+  - 页面要求填写 `age`
+- 支持 `Auto` 多轮运行
+- 支持中途 `Stop`
+- Step 8 会自动寻找 OAuth 同意页的“继续”按钮，并通过 Chrome debugger 输入事件发起点击，然后监听本地回调地址
+
+
+## 环境要求
+
+- Chrome 浏览器
+- 打开扩展开发者模式
+- 你自己的 VPS 管理面板，且页面结构与当前脚本适配
+- 至少准备一种验证码接收方式：
+  - DuckDuckGo `@duck.com` + QQ / 163 / Inbucket 转发
+  - 手动填写一个可收信邮箱
+- 如果使用 `QQ` / `163` / `Inbucket`，对应页面需要提前能正常打开
 
 ## 安装
 
-1. 打开 `chrome://extensions/`，开启「开发者模式」
-2. 点击「加载已解压的扩展程序」，选择本项目文件夹
-3. 点击浏览器工具栏的扩展图标，打开侧边面板
+1. 打开 `chrome://extensions/`
+2. 开启“开发者模式”
+3. 点击“加载已解压的扩展程序”
+4. 选择本项目目录
+5. 打开扩展侧边栏
 
-## 执行流程
+## 侧边栏配置说明
 
-在侧边面板填入 VPS 管理面板地址，选择邮箱类型，设置运行次数，点击 Auto：
+### `VPS`
 
-1. **获取 OAuth 链接** — 自动打开 VPS 面板，点击登录拿到 OpenAI 授权链接
-2. **打开注册页** — 用授权链接打开 OpenAI 注册页，自动点击 Sign up
-3. ⏸️ **暂停等待** — 面板弹出橙色提示，**手动粘贴一个新的 @duck.com 邮箱地址**，点击 Continue
-4. **填写注册信息** — 自动将 @duck.com 地址填入注册表单，自动生成随机密码，提交
-5. **获取注册验证码** — 自动切到邮箱轮询收件箱，提取 6 位验证码，填回注册页
-6. **完善资料** — 自动随机生成英文姓名和生日，提交完成注册
-7. **登录** — 重新打开 OAuth 链接，用刚注册的账号自动登录
-8. **获取登录验证码** — 再次轮询邮箱拿验证码，自动填入
-9. **完成 OAuth 授权** — 自动点击授权页「继续」；如果页面不接受普通 DOM 点击，会自动切换到更强的点击兜底并继续捕获回调地址
-10. **VPS 回调验证** — 自动将回调地址提交到 VPS 面板，完成认证
+你的管理面板 OAuth 页面地址，例如：
 
-> 全程仅需在第 3 步手动粘贴一次邮箱地址，其余全自动。
-> 支持设置 N 次连续批量运行，每轮在第 2 步后暂停等待粘贴新邮箱。
+```txt
+http(s)://<your-host>/management.html#/oauth
+```
+
+Step 1 和 Step 9 都依赖这个地址。
+
+### `Mail`
+
+支持三种验证码来源：
+
+- `163 Mail`
+- `QQ Mail`
+- `Inbucket`
+
+说明：
+
+- `QQ` 和 `163` 用于直接轮询网页邮箱
+- `Inbucket` 通过你在侧边栏里配置的 host 访问 `mailbox` 页面：`https://<your-inbucket-host>/m/<mailbox>/`
+
+### `Mailbox`
+
+仅当 `Mail = Inbucket` 时显示。
+
+填写 Inbucket mailbox 名称，例如：
+
+```txt
+tmp-mailbox
+```
+
+脚本会自动打开：
+
+```txt
+https://<your-inbucket-host>/m/<mailbox>/
+```
+
+并且只检索未读邮件：
+
+- 只匹配 `.message-list-entry.unseen`
+- 第 2 次轮询开始会自动点击 mailbox 页面上的刷新按钮
+- 识别到验证码后会尝试删除当前邮件，减少重复命中
+
+### `Inbucket`
+
+仅当 `Mail = Inbucket` 时显示。
+
+这里填写 Inbucket host，支持两种格式：
+
+- `your-inbucket-host`
+- `https://your-inbucket-host`
+
+脚本会自动规范化成 origin 后再拼接 mailbox URL。
+
+### `Email`
+
+Step 3 使用的注册邮箱。
+
+来源有两种：
+
+- 手动粘贴
+- 点击 `Auto` 从 DuckDuckGo Email Protection 自动获取一个新的 `@duck.com`
+
+注意：
+
+- 当前 `Auto` 按钮只负责 DuckDuckGo 地址获取
+- 如果你使用 Inbucket，它只是验证码收件箱，不会自动生成 Inbucket 地址
+
+### `Password`
+
+- 留空：自动生成强密码
+- 手动输入：使用你自定义的密码
+- 可通过 `Show / Hide` 按钮切换显示
+
+扩展会把本轮实际使用的密码同步回侧边栏，便于查看和复制。
+
+### `Auto`
+
+整套流程自动跑。
+
+支持多轮运行，运行次数由右上角数字框决定。
+
+## 工作流
+
+### 单步模式
+
+侧边栏共有 9 个步骤按钮，可逐步执行：
+
+1. `Get OAuth Link`
+2. `Open Signup`
+3. `Fill Email / Password`
+4. `Get Signup Code`
+5. `Fill Name / Birthday`
+6. `Login via OAuth`
+7. `Get Login Code`
+8. `Manual OAuth Confirm`
+9. `VPS Verify`
+
+### Auto 模式
+
+点击右上角 `Auto` 后，后台会按顺序跑完整流程。
+
+当前 Auto 逻辑是：
+
+1. Step 1 获取 VPS OAuth 链接
+2. Step 2 打开 OpenAI 注册页
+3. 尝试自动获取 Duck 邮箱
+4. 如果 Duck 自动获取失败，暂停并等待你在侧边栏填写邮箱后点击 `Continue`
+5. 继续执行 Step 3 ~ Step 9
+
+也就是说：
+
+- 如果 Duck 邮箱可自动获取，整套流程更接近全自动
+- 如果不能自动获取，Auto 会在邮箱阶段暂停
+
+## 详细步骤说明
+
+### Step 1: Get OAuth Link
+
+通过 `content/vps-panel.js`：
+
+- 打开 VPS OAuth 面板
+- 等待 `Codex OAuth` 卡片出现
+- 点击“登录”
+- 读取页面里的授权链接
+
+结果会保存到侧边栏的 `OAuth` 字段。
+
+### Step 2: Open Signup
+
+通过 `content/signup-page.js`：
+
+- 打开授权链接
+- 查找 `Sign up / Register / 创建账户` 按钮
+- 自动点击进入注册流程
+
+### Step 3: Fill Email / Password
+
+- 自动填写邮箱
+- 如页面先要求邮箱，再进入密码页，会自动切页继续填写
+- 使用自定义密码或自动生成密码
+- 提交注册表单
+
+实际使用的密码会写入会话状态，并同步到侧边栏显示。
+
+### Step 4: Get Signup Code
+
+根据 `Mail` 配置，轮询邮箱并提取 6 位验证码。
+
+支持：
+
+- `content/qq-mail.js`
+- `content/mail-163.js`
+- `content/inbucket-mail.js`
+
+邮件匹配规则以以下关键词为主：
+
+- 发件人：`openai`、`noreply`、`verify`、`auth`、`duckduckgo`、`forward`
+- 标题：`verify`、`verification`、`code`、`验证`、`confirm`
+
+### Step 5: Fill Name / Birthday
+
+随机生成人名与生日。
+
+当前脚本支持两种页面结构：
+
+- 页面要求 `birthday`
+- 页面要求 `age`
+
+如果页面是生日模式，会填写年月日；如果页面上存在 `input[name='age']`，则直接填写年龄。
+
+### Step 6: Login via OAuth
+
+重新打开 OAuth 链接，使用刚注册的账号登录。
+
+支持：
+
+- 邮箱 + 密码登录
+- 提交后进入验证码验证流程
+
+### Step 7: Get Login Code
+
+与 Step 4 类似，但会使用稍微不同的关键词组合去找登录验证码邮件。
+
+### Step 8: Manual OAuth Confirm
+
+虽然按钮名称还是 `Manual OAuth Confirm`，但当前代码已经做了自动尝试：
+
+- 在授权页定位“继续”按钮
+- 等待按钮可点击
+- 获取按钮坐标
+- 通过 Chrome `debugger` 的输入事件点击该按钮
+- 同时监听 `chrome.webNavigation.onBeforeNavigate`
+- 一旦捕获本地回调地址，就把结果保存到 `Callback`
+
+注意：
+
+- 这一步仍然是最容易因页面变化而失效的一步
+- 如果 120 秒内没有捕获到 localhost 回调，会报错超时
+- README 中的按钮名称沿用了旧文案，但代码行为是“自动尝试点击”
+
+### Step 9: VPS Verify
+
+回到 VPS 面板：
+
+- 自动填写 localhost 回调地址
+- 自动点击“提交回调 URL”
+- 等待“认证成功”状态
+
+## Duck 邮箱自动获取
+
+通过 `content/duck-mail.js`：
+
+- 打开 DuckDuckGo Email Protection Autofill 设置页
+- 查找当前私有地址
+- 如需要，点击 `Generate Private Duck Address`
+- 读取新的 `@duck.com` 地址
+
+这个功能会被：
+
+- 侧边栏 `Email` 旁边的 `Auto` 按钮使用
+- `Auto Run` 流程优先尝试使用
+
+## 停止机制
+
+扩展内置了停止当前流程的能力：
+
+- 侧边栏点击 `Stop`
+- Background 会广播 `STOP_FLOW`
+- 各 content script 会在等待、轮询、sleep、元素查找中尽量中断
+
+适合以下场景：
+
+- 卡在某一步
+- 邮件迟迟不来
+- 页面结构变化导致等待超时
+
+## 状态与数据
+
+主要使用 `chrome.storage.session` 保存运行时状态：
+
+- 当前步骤
+- 每一步状态
+- OAuth 链接
+- 当前邮箱
+- 当前密码
+- localhost 回调地址
+- 账号记录
+- tab 注册信息
+- 自定义设置
+
+特点：
+
+- 浏览器会话级存储
+- 扩展运行期间可在多个步骤之间共享
+- 代码里已启用 `storage.session` 对 content script 的访问
+
+## 项目结构
+
+```txt
+background.js              后台主控，编排 1~9 步、Tab 复用、状态管理
+manifest.json              扩展清单
+data/names.js              随机姓名、生日数据
+content/utils.js           通用工具：等待元素、点击、日志、停止控制
+content/vps-panel.js       VPS 面板步骤：Step 1 / Step 9
+content/signup-page.js     OpenAI 注册/登录页步骤：Step 2 / 3 / 5 / 6 / 8
+content/duck-mail.js       Duck 邮箱自动获取
+content/qq-mail.js         QQ 邮箱验证码轮询
+content/mail-163.js        163 邮箱验证码轮询
+content/inbucket-mail.js   Inbucket mailbox 验证码轮询
+sidepanel/                 侧边栏 UI
+```
+
+## 常见使用建议
+
+### 1. 先单步验证，再开 Auto
+
+推荐先手动跑通一次：
+
+1. Step 1
+2. Step 2
+3. Step 3
+4. Step 4
+
+确认邮箱和验证码链路稳定后，再使用 `Auto`。
+
+### 2. Inbucket 建议使用专用 mailbox
+
+当前 Inbucket 逻辑只看未读邮件，但还是建议：
+
+- 给脚本准备一个相对独立的 mailbox
+- 避免收件箱里混入过多无关邮件
+
+### 3. Duck 自动获取失败时直接手填
+
+如果 Duck 页面打不开、未登录或按钮变化：
+
+- 直接在 `Email` 输入框中粘贴邮箱
+- 再继续执行 Step 3 或 Auto Continue
+
+### 4. Step 8 失败时重点检查
+
+- OAuth 同意页 DOM 是否变化
+- “继续”按钮是否变成了别的文案
+- localhost 回调是否真的触发
+- 浏览器是否允许 debugger 附加
+
+## 已知限制
+
+- Step 8 对页面结构较敏感
+- Duck 自动获取依赖 Duck 页面真实 DOM
+- VPS 面板 DOM 也需要和当前脚本选择器匹配
+- `Auto` 按钮名称和 Step 8 的旧文案还未完全统一，但代码行为以实际实现为准
+
+## 调试建议
+
+- 打开扩展侧边栏看日志
+- 查看 Service Worker 控制台
+- 查看目标页面的 content script 控制台日志
+- 当某一步频繁失败时，优先检查当前页面选择器是否仍然匹配
 
 ## 安全说明
 
-- VPS 地址在面板中以密码框显示，不会明文泄露
-- 每次注册自动生成随机强密码（14位，含大小写+数字+符号）
-- 所有状态存储在 `chrome.storage.session`，浏览器关闭即清除
-- 代码中无硬编码的密码、IP 地址等敏感信息
+- 所有状态仅保存在浏览器会话中
+- 没有硬编码你的 VPS 地址、密码或账户
+- 自定义密码只存在当前会话存储中
+- 邮箱和密码会被记录到本轮 `accounts` 中，便于追踪本次运行结果