基于 StepFlow-Duck 改造的 Chromium 扩展，用于自动化完成 ChatGPT OAuth 注册与验证流程。

本项目将原方案中的 DuckDuckGo Email Protection 改为 33mail 转发方案：

• 使用 163 邮箱或QQ 邮箱注册 33mail
• 在 33mail 中获取对应的自定义域名后缀
• 将该域名填写到扩展中，对应生成随机别名邮箱用于注册
• OpenAI 验证码仍然回收到你登录中的 163/QQ 邮箱，由扩展自动轮询并回填

• 操作系统：macOS
• 浏览器：Microsoft Edge

当前版本主要基于 macOS + Edge 环境开发和测试。理论上其他 Chromium 浏览器也可尝试加载，但未作为本仓库的主要验证环境。

• Auto 一键全自动跑完整个 OAuth 注册流程
• 支持 163 Mail / QQ Mail 双分组配置，各自保存独立 33mail 域名
• 支持在 163 和 QQ 之间快速切换当前收码邮箱
• 自动生成随机邮箱别名和强密码
• 自动读取 163/QQ 邮箱验证码并回填
• 支持失败后 Retry / Skip / Stop 人工接管
• 自动保存账号，可单独复制邮箱、复制 email:password，或导出 JSON
• 浏览器关闭后会自动清空会话状态

相比原版 StepFlow-Duck，本项目的核心变化是：

1. 不再依赖 DuckDuckGo Email Protection 生成 @duck.com 地址。
2. 改为使用 33mail 的自定义别名能力生成注册邮箱。
3. 邮箱收码端改为你自己的 163 / QQ 邮箱，便于长期使用和切换。
4. 面板中新增 163 / QQ 分组域名配置，适合双账号轮换。
5. 原版 README 中是 9 步流程，当前版本收敛为 7 步流程。

原项目中第 6、7 步分别是：

1. OAuth 登录
2. 获取登录验证码

开发者在 macOS + Edge 的实际测试过程中，始终没有遇到 add-phone 分流，因此没有进入原版那套额外的 OAuth 登录验证码流程。基于这一测试结果，当前版本直接跳过原项目的第 6、7 步，将整体流程简化为现在的 7 步。

如果后续你的环境中实际出现 add-phone 或额外登录验证流程，需要再针对该分支单独适配。

使用本项目前，请先准备好以下环境：

1. Microsoft Edge 或其他 Chromium 浏览器，并开启开发者模式加载扩展。
2. 可正常使用的 StepFlow / Codex 管理面板地址。
3. 至少一个已登录的收件邮箱：163 或 QQ。
4. 使用该 163/QQ 邮箱注册好的 33mail 账号。
5. 对应 33mail 账号可用的域名后缀。

建议同时准备一套 163 + 33mail 和一套 QQ + 33mail。

原因是 33mail 同一个账号可以无限创建自定义别名，但30 分钟内最多创建 6 个。本项目支持在 163 / QQ 两组配置之间快速切换，实战更方便。

以 Edge 为例：

1. 打开 edge://extensions/
2. 开启右上角“开发者模式”
3. 点击“加载解压缩的扩展”
4. 选择当前项目目录
5. 点击浏览器工具栏中的扩展图标，打开侧边栏

如果你使用 Chrome，也可以在 chrome://extensions/ 里按同样方式加载。

打开侧边栏后，按下面方式配置：

1. 在 VPS 输入框中填入管理面板 OAuth 页面地址 示例格式：http://ip:port/management.html#/oauth
2. 在 163 Mail 分组中填入 163 对应的 33mail 域名后缀
3. 在 QQ Mail 分组中填入 QQ 对应的 33mail 域名后缀
4. 点击某个 Mail 分组，将它设为当前收码邮箱
5. 确保对应的 163/QQ 邮箱网页已经登录
6. 设置运行次数后，点击 Auto

Domain 请按 33mail 实际分配格式填写。 示例：@xxxx.33mail.com

点击 Auto 后，扩展会按以下 7 步运行：

1. Get OAuth Link 打开管理面板，自动获取 OAuth 授权链接。
2. Open OAuth 打开 OpenAI / ChatGPT 注册授权页面。
3. Generate Email / Password 使用当前分组绑定的 33mail 域名生成随机别名邮箱，并自动填写邮箱和密码。
4. Get Signup Code 打开当前选中的 163 或 QQ 邮箱页面，轮询验证码邮件并自动回填。
5. Fill Name / Birthday 自动生成姓名和生日并填写资料。
6. Complete OAuth 自动点击授权页面的“继续”，捕获 localhost 回调地址或直接识别认证成功页面。
7. VPS Verify 将回调地址回填到管理面板，完成账号验证。

• 163 和 QQ 最好各注册一个 33mail 账号，对应填写不同的域名后缀。
• 当单个 33mail 账号触发 30 分钟 6 个别名限制时，直接切换到另一组继续跑。
• 跑流程前，尽量保持以下页面已登录：
  • 管理面板
  • 33mail 对应的 163/QQ 邮箱
• 如果验证码较慢，优先检查邮箱是否掉登录、验证码是否进了垃圾箱，或当前 IP 是否异常。

除 Auto 外，也可以点击每个步骤右侧按钮单独执行：

• 适合断点续跑
• 适合调试某一步是否失效
• 失败后可以配合 Retry / Skip / Stop 继续处理

扩展会自动保存本次生成过的账号信息，支持：

• 复制邮箱
• 复制 email:password
• 导出为 JSON
• 清空全部账号记录

账号默认按时间倒序展示，最新生成的排在最上面。

• VPS 地址在面板中以密码框显示，不直接明文暴露
• 每次自动生成随机强密码
• 运行状态保存在 chrome.storage.session
• 浏览器关闭后会自动清空会话数据
• 项目代码中不包含硬编码密码、域名或 IP

因为本项目当前内置的是 163 邮箱和QQ 邮箱收码流程。33mail 负责生成别名和转发，真正接收验证码的是你已经登录的 163 / QQ 邮箱。

填写你在 33mail 中可用的自定义域名后缀。

示例格式：

• @xxxx.33mail.com

请以你自己的 33mail 实际可用域名为准。

因为 33mail 单账号虽然支持无限注册自定义别名，但有 30 分钟内最多 6 个 的频率限制。两套配置可以显著提高连续注册效率。

因为开发者在 macOS + Edge 测试环境里从未遇到 add-phone，所以没有进入原版那套额外的 OAuth 登录和登录验证码流程，当前版本因此直接跳过这两步。

扩展会自动暂停，并提供：

• Retry：重试当前步骤
• Skip：跳过当前步骤
• Stop：停止本次流程

如果长时间无法通过，通常优先检查：登录状态、域名配置、邮箱到信情况、网络环境和 IP 质量。

.
├── background.js            # 后台流程调度
├── manifest.json            # Chromium 扩展配置
├── content/
│   ├── signup-page.js       # OpenAI 注册/授权页自动化
│   ├── mail-163.js          # 163 邮箱收码
│   ├── qq-mail.js           # QQ 邮箱收码
│   ├── vps-panel.js         # 管理面板交互
│   ├── duck-email.js        # 原版遗留文件，当前 33mail 方案不再使用
│   └── utils.js             # 通用工具
└── sidepanel/
    ├── sidepanel.html       # 侧边栏 UI
    ├── sidepanel.css        # 侧边栏样式
    └── sidepanel.js         # 侧边栏逻辑

本项目基于 StepFlow-Duck 修改而来，并继承其 MIT License 授权方式。

• 原项目版权声明与许可声明已保留在 LICENSE
• 本仓库对原项目进行了 33mail 方案适配、流程调整与 README 重写
• 如继续分发或二次修改本项目，请一并保留原始版权声明与 MIT 许可文本

• 原项目：StepFlow-Duck
• 社区支持：LINUX DO