docs: update README to reflect current architecture

- Temp Email API as recommended mail provider
- Duck email API-based generation (no page needed)
- Debugger removed, content script click instead
- Phone verification auto-skip
- Simplified and reorganized documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

README.md

@@ -1,373 +1,161 @@
-# Multi-Page Automation
+# Auto Register GPT Duck
 
-一个用于批量跑通 ChatGPT OAuth 注册/登录流程的 Chrome 扩展。
+批量自动完成 ChatGPT OAuth 注册/登录流程的 Chrome 扩展。
 
-当前版本基于侧边栏控制，支持单步执行、整套自动执行、停止当前流程、保存常用配置，以及通过 DuckDuckGo / QQ / 163 / Inbucket mailbox 协助获取验证码。
+通过侧边栏控制，支持单步执行、多轮自动运行、中途停止，以及多种验证码接收方式。
 
 ## 当前能力
 
 - 从 VPS 面板自动获取 OpenAI OAuth 授权链接
-- 自动打开 OpenAI 注册页并点击 `Sign up / Register`
-- 自动填写邮箱与密码
-- 支持自定义密码；留空时自动生成强密码
-- 自动显示当前使用中的密码，便于后续保存
+- 自动打开 OpenAI 注册页并点击 Sign up
+- 自动填写邮箱与密码（支持自定义或自动生成强密码）
 - 自动获取注册验证码与登录验证码
-- 支持 `QQ Mail`、`163 Mail`、`Inbucket mailbox`
-- 支持从 DuckDuckGo Email Protection 自动生成新的 `@duck.com` 地址
-- Step 5 同时兼容两种页面：
-  - 页面要求填写 `birthday`
-  - 页面要求填写 `age`
-- 支持 `Auto` 多轮运行
-- 支持中途 `Stop`
-- Step 8 会自动寻找 OAuth 同意页的“继续”按钮，并通过 Chrome debugger 输入事件发起点击，然后监听本地回调地址
-
+- 验证码来源支持：
+  - **Temp Email API**（推荐）— 通过 HTTP API 直接轮询，无需打开邮件页面
+  - QQ Mail / 163 Mail / Inbucket mailbox
+- DuckDuckGo Email Protection：
+  - 首次运行自动提取 access_token 并保存
+  - 后续运行直接调用 API 生成 `@duck.com` 地址，无需打开页面
+- Step 5 兼容 birthday 和 age 两种页面
+- Step 7 自动检测电话验证页面，跳过当前账号继续下一轮
+- Step 8 通过 content script 直接点击"继续"按钮，无需 debugger，不会触发浏览器"被控制调试"提示
+- 支持 Auto 多轮运行 + 中途 Stop
 
 ## 环境要求
 
-- Chrome 浏览器
-- 打开扩展开发者模式
-- 你自己的 VPS 管理面板，且页面结构与当前脚本适配
+- Chrome 浏览器，开启扩展开发者模式
+- 你自己的 VPS 管理面板（页面结构需与脚本适配）
 - 至少准备一种验证码接收方式：
+  - Temp Email API（推荐）
   - DuckDuckGo `@duck.com` + QQ / 163 / Inbucket 转发
-  - 手动填写一个可收信邮箱
-- 如果使用 `QQ` / `163` / `Inbucket`，对应页面需要提前能正常打开
 
 ## 安装
 
 1. 打开 `chrome://extensions/`
-2. 开启“开发者模式”
-3. 点击“加载已解压的扩展程序”
+2. 开启"开发者模式"
+3. 点击"加载已解压的扩展程序"
 4. 选择本项目目录
 5. 打开扩展侧边栏
 
-## 侧边栏配置说明
+## 侧边栏配置
 
-### `VPS`
+### VPS
 
-你的管理面板 OAuth 页面地址，例如：
+管理面板 OAuth 页面地址：
 
-```txt
+```
 http(s)://<your-host>/management.html#/oauth
 ```
 
 Step 1 和 Step 9 都依赖这个地址。
 
-### `Mail`
-
-支持三种验证码来源：
+### Mail
 
-- `163 Mail`
-- `QQ Mail`
-- `Inbucket`
+验证码来源，支持四种：
 
-说明：
+| 选项 | 说明 |
+|------|------|
+| **Temp Email API** | 通过 HTTP API 直接轮询邮件，粘贴完整 URL（含 JWT）即可，无需打开邮件页面 |
+| 163 Mail | 轮询 163 网页邮箱 |
+| QQ Mail | 轮询 QQ 网页邮箱 |
+| Inbucket | 通过自定义 host + mailbox 轮询 |
 
-- `QQ` 和 `163` 用于直接轮询网页邮箱
-- `Inbucket` 通过你在侧边栏里配置的 host 访问 `mailbox` 页面：`https://<your-inbucket-host>/m/<mailbox>/`
+#### Temp Email API（推荐）
 
-### `Mailbox`
+选择后会出现 API URL 输入框，粘贴完整地址即可：
 
-仅当 `Mail = Inbucket` 时显示。
-
-填写 Inbucket mailbox 名称，例如：
-
-```txt
-tmp-mailbox
 ```
-
-脚本会自动打开：
-
-```txt
-https://<your-inbucket-host>/m/<mailbox>/
+https://temp-email-api.xxx.cc/?jwt=eyJhbGci...
 ```
 
-并且只检索未读邮件：
-
-- 只匹配 `.message-list-entry.unseen`
-- 第 2 次轮询开始会自动点击 mailbox 页面上的刷新按钮
-- 识别到验证码后会尝试删除当前邮件，减少重复命中
-
-### `Inbucket`
-
-仅当 `Mail = Inbucket` 时显示。
-
-这里填写 Inbucket host，支持两种格式：
+API 需要支持以下端点：
+- `GET /api/mails?limit=N&offset=0`（Authorization: Bearer JWT）
+- 返回格式：`{ results: [{ id, source, raw, created_at }] }`
 
-- `your-inbucket-host`
-- `https://your-inbucket-host`
+#### Inbucket
 
-脚本会自动规范化成 origin 后再拼接 mailbox URL。
+需要填写 host 和 mailbox 名称，脚本会打开 `https://<host>/m/<mailbox>/` 轮询。
 
-### `Email`
+### Email
 
-Step 3 使用的注册邮箱。
-
-来源有两种：
+Step 3 使用的注册邮箱：
 
 - 手动粘贴
-- 点击 `Auto` 从 DuckDuckGo Email Protection 自动获取一个新的 `@duck.com`
-
-注意：
+- 点击 Auto — 通过 DuckDuckGo API 自动生成 `@duck.com` 地址
 
-- 当前 `Auto` 按钮只负责 DuckDuckGo 地址获取
-- 如果你使用 Inbucket，它只是验证码收件箱，不会自动生成 Inbucket 地址
+首次使用 Auto 需要打开 DuckDuckGo 页面提取 token，之后直接调 API 生成。
 
-### `Password`
+### 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`
+- 手动输入：使用自定义密码
+- 可通过 Show/Hide 切换显示
+
+## 工作流（9 步）
+
+| 步骤 | 名称 | 说明 |
+|------|------|------|
+| 1 | Get OAuth Link | 从 VPS 面板获取 OAuth 授权链接 |
+| 2 | Open Signup | 打开授权链接，点击注册 |
+| 3 | Fill Email/Password | 填写邮箱和密码，提交注册 |
+| 4 | Get Signup Code | 轮询邮箱获取注册验证码并填入 |
+| 5 | Fill Name/Birthday | 随机生成姓名和生日/年龄并填写 |
+| 6 | Login via OAuth | 用注册账号登录 OAuth |
+| 7 | Get Login Code | 轮询邮箱获取登录验证码并填入 |
+| 8 | OAuth Auto Confirm | 点击 OAuth 同意页"继续"，捕获 localhost 回调 |
+| 9 | VPS Verify | 回到 VPS 面板提交回调 URL，等待认证成功 |
 
 ### 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
+点击 Auto 后自动执行完整流程，支持多轮运行。每轮：
 
-随机生成人名与生日。
+1. 获取 OAuth 链接 + 打开注册页
+2. 自动生成 Duck 邮箱（API 方式，无需开页面）
+3. 执行 Step 3 ~ Step 9
+4. 失败自动跳到下一轮，手动 Stop 才会终止
 
-当前脚本支持两种页面结构：
-
-- 页面要求 `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` 地址
+采用两阶段策略：
 
-这个功能会被：
+1. **首次运行**：打开 DuckDuckGo Email Protection 设置页，通过 content script 调用 dashboard API 提取 `access_token`，保存到持久化存储
+2. **后续运行**：直接调用 `quack.duckduckgo.com/api/email/addresses` 生成新地址，不再打开页面
 
-- 侧边栏 `Email` 旁边的 `Auto` 按钮使用
-- `Auto Run` 流程优先尝试使用
+token 失效时会自动回退到页面方式重新提取。
 
 ## 停止机制
 
-扩展内置了停止当前流程的能力：
-
-- 侧边栏点击 `Stop`
-- Background 会广播 `STOP_FLOW`
-- 各 content script 会在等待、轮询、sleep、元素查找中尽量中断
-
-适合以下场景：
-
-- 卡在某一步
-- 邮件迟迟不来
-- 页面结构变化导致等待超时
-
-## 状态与数据
-
-主要使用 `chrome.storage.session` 保存运行时状态：
-
-- 当前步骤
-- 每一步状态
-- OAuth 链接
-- 当前邮箱
-- 当前密码
-- localhost 回调地址
-- 账号记录
-- tab 注册信息
-- 自定义设置
-
-特点：
-
-- 浏览器会话级存储
-- 扩展运行期间可在多个步骤之间共享
-- 代码里已启用 `storage.session` 对 content script 的访问
+- 侧边栏点击 Stop
+- Background 广播 STOP_FLOW
+- 各 content script 在等待、轮询、sleep 中尽量中断
 
 ## 项目结构
 
-```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/duck-mail.js       Duck 邮箱获取 + token 提取
 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 的旧文案还未完全统一，但代码行为以实际实现为准
+- 运行时状态使用 `chrome.storage.session`
+- VPS 地址、邮件配置、Duck token 等持久化到 `chrome.storage.local`
+- 所有数据仅存在本地浏览器中，无外部上报
 
 ## 调试建议
 
-- 打开扩展侧边栏看日志
-- 查看 Service Worker 控制台
-- 查看目标页面的 content script 控制台日志
-- 当某一步频繁失败时，优先检查当前页面选择器是否仍然匹配
-
-## 安全说明
-
-- 所有状态仅保存在浏览器会话中
-- 没有硬编码你的 VPS 地址、密码或账户
-- 自定义密码只存在当前会话存储中
-- 邮箱和密码会被记录到本轮 `accounts` 中，便于追踪本次运行结果
+- 侧边栏 Console 区域查看实时日志
+- Service Worker 控制台查看 background 日志
+- 目标页面的 DevTools Console 查看 content script 日志
+- 某一步频繁失败时，优先检查页面选择器是否匹配