SimpleAuthFlow

一个围绕自动化注册和授权流程的 Chrome 扩展。

项目简介

SimpleAuthFlow 是一个用于简化 ChatGPT OAuth 注册和授权流程的浏览器自动化扩展，目标是尽可能降低使用门槛，让整套流程更直接、更省事。

这个版本最核心的特点只有一个：

开箱即用，无需任何额外配置。

不需要你手动准备自己的邮箱，不需要额外填写手机号，也不需要再改一堆插件配置。
装好之后就可以直接开始，尽量把使用门槛降到最低。

使用前提

本项目的使用前提只有两个：

1. 装好 CPA
2. 装好本插件

完成后即可开始使用，不需要你额外填写自己的邮箱和手机号。

安装和使用方式

1. 打开 chrome://extensions/
2. 开启“开发者模式”
3. 点击“加载已解压的扩展程序”
4. 选择本项目文件夹
5. 点击浏览器工具栏中的扩展图标，打开侧边面板
6. 将形如“http://127.0.0.1:5174/#/oauth”的 CPA 鉴权地址填入 VPS 中
7. 点击 auto 开始运行

为什么做这个版本

在实际使用过程中发现，DuckDuckGo 相关邮箱方案最近可能使用人数较多，经常出现以下问题：

• 验证码很久才收到
• 验证码根本收不到
• 导致鉴权过期
• 导致自动化流程中断

因此，这个版本主要围绕“更直接、更省心的个人使用体验”进行调整，目标不是复杂配置，而是尽量减少额外准备和中断情况。

项目定位

本项目主打个人使用，能够满足个人日常的 Codex 使用需求。
它并不是为大规模操作场景设计的工具，整体思路更偏向轻量、直接、够用。

在默认不额外修改配置的情况下，平均大约一分钟可以完成一个流程。
如果完全不改任何东西，按当前设置，一天大约可以稳定处理 5 次左右。

目前限制主要来自邮箱获取方式：同一天内可能会将同一请求环境判定为同一台机器，因此默认每天限制约 5 次。
如果某天确实需要更多次数，通常更换一个梯子节点即可继续使用。

从目前的现象看，目标站点大概率至少结合了请求头与 IP 地址进行判定，但这里只是基于实际使用过程的初步观察，没有进一步做更细的验证。

主要改动

本项目基于开源项目 StepFlow-Duck 的 v1.0 版本，以及“寸铁”所做的二次修改版本继续调整而来。
当前这一版属于三次修改版本，在继承前面成果的基础上，继续围绕“个人使用”“开箱即用”“减少配置”做了进一步优化。

当前版本的主要改动包括：

1. 去掉原有个人配置依赖

删除了原插件中需要用户手动配置的邮箱、Duck 等相关内容，改为安装后即可直接使用，尽量减少前置准备。

2. 强化开箱即用体验

这个版本的重点就是：
不折腾配置，装好就跑。

因为主要面向个人使用，可以直接本地运行 CPA 并本地配合使用，因此整体流程尽量围绕本地直接可用来设计，减少额外配置步骤和人工介入。

3. 简化本地 CPA 场景下的回调与验证过程

因为主要为个人使用，可以直接本地运行 CPA 并配合使用。
因此将原有最后的回调与验证过程做了适配调整：

• 支持原有条件下的验证方式
• 也支持在出现授权完成页时继续处理
• 同时兼容本地上传和服务器回调两种方式

4. 提高邮箱发送流程容错

在注册过程中，偶尔会出现邮件没有正常发出的情况。
现在会在检测到异常时自动返回重新触发发送，再继续等待验证码。

当前逻辑为：

• 自动重试最多 3 次
• 连续失败后才判定为失败

实际使用中，大多数情况下第一次即可成功，整体成功率相对稳定。

5. 增加 OpenAI 协议确认场景的自动化处理

实际使用时，OpenAI 有时候会突然跳一个“需要同意协议”或者“继续使用确认”的页面。
这种情况以前很容易把流程卡住。

现在这一类情况也加了自动化处理，检测到相关页面后会自动继续，尽量避免因为额外弹窗导致整套流程中断。

6. 增加邮箱安全验证等待与继续机制

在使用 Burner Mailbox 的过程中，可能会在以下几个环节遇到网站的人机验证：

• 注册前自动获取邮箱
• 第一次进入邮箱查看注册验证码
• 第二次进入邮箱查看登录验证码

以前一旦遇到这一类验证页面，流程就很容易停住，用户还需要自己判断当前到底是哪里出了问题。

现在针对这一类情况增加了专门的等待与继续处理：

• 检测到安全验证页面后，会明确提示用户先去邮箱页完成人机验证
• 用户完成验证后点击继续，流程会自动等待页面恢复正常
• 页面恢复后会直接继续后续获取邮箱或拉取验证码流程

这样可以尽量避免因为 Burner Mailbox 临时触发安全验证而导致整套自动化流程直接中断。

设计目标

SimpleAuthFlow 不追求复杂的能力堆叠，而是更偏向下面几个方向：

• 开箱即用
• 无需任何额外配置
• 少手动操作
• 少中断
• 尽量本地即可跑通
• 更适合个人长期自用

致谢

感谢开源项目 StepFlow-Duck 提供的基础版本。
同时感谢“寸铁佬”在二次修改中的思路和贡献。

本项目也受 LINUX DO 社区启发和支持。

License

This project is licensed under the MIT License.

It includes code derived from:

• StepFlow-Duck
• Copyright (c) 2026 whwh1233