StepFlow 33mail

基于 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