GPT Auto Manager

一个基于上游 wenfxl/openai-cpa 深度整理的 中文增强版 Web 控制台项目。

当前公开整理版本已选择性回补上游 v10.1.2 / v10.1.3 的关键注册与邮箱修复，并保留了已经在实际环境中验证过的增强能力，重点优化了：

• 中文使用体验与文档
• Web 面板可维护性
• Clash / Mihomo 代理池能力
• HTTP 动态代理池调度
• LuckMail 私有池 / 本地微软邮箱 / Temporam 兼容
• Fvia / Inboxes / TemporaryMail / Tmailor 邮箱接入
• CPA / Sub2API 仓管与巡检

当前仓库适合作为“可二次复用的公开源码基线”。 私有配置、账号、订阅、数据库、Token、邮箱凭据等敏感内容均不应提交到仓库。

1. 项目定位

这个项目不是单纯的脚本，而是一套围绕 Web 控制台 展开的自动化管理面板，核心用途包括：

• 邮箱接码 / 验证码收取
• 注册任务调度
• 代理池切换与测活
• Clash / Mihomo 多实例代理池管理
• CPA / Sub2API 仓库补货与巡检
• 本地账号库存管理
• Web 实时日志、统计、导出、删除

2. 本公开版相对上游保留/增强的能力

2.1 代理与网络

• Clash 订阅自助更新

  • 可在 Web 面板直接更新订阅
  • 可触发宿主机 Mihomo 代理池重载
  • 自动读取真实策略组
  • 自动给各实例分流不同节点
  • 自动把默认总路由组对齐到业务组
  • 自动识别并修正错误订阅入口（如原始订阅串自动补 ?flag=mihomo）
  • 错误订阅会在写入前被拦截，避免污染当前可用配置

• Clash 节点智能池

  • 支持单机模式与多实例独享池模式
  • 支持黑名单过滤
  • 支持随机切点 / 延迟优选
  • 测活日志会同时展示：
    • 当前业务组
    • 当前业务组真实节点
    • 默认总路由是否已对齐

• HTTP 动态代理池

  • 支持一个或多个 http://user:pass@host:port 动态网关
  • 适合“每次连接自动换出口 IP”的代理商
  • 多线程时自动按通道队列分发

2.2 邮箱与验证码

• LuckMail 私有上传邮箱池模式
• 本地微软邮箱库 / Graph 取码
• Temporam 支持
• Fvia / Inboxes / TemporaryMail / Tmailor 支持
• DuckMail / IMAP / freemail / cloudmail / mail_curl / Gmail OAuth 等多后端
• 多域名轮换与多级子域名生成

2.3 仓管与任务调度

• CPA 自动补货
• Sub2API 自动补货
• 独立测活
• 本地 SQLite 库存管理
• 选中导出 / 删除 / 推送
• 实时日志与统计

2.4 浏览器 / 古法插件模式

• 恢复古法浏览器插件模式主控链路
• 前端模式切换与后端 /api/ext/* 配套恢复
• 启动前等待 WORKER_READY 与节点心跳
• create-account 异常页自动重试
• Cloudflare 安全验证归类为 pwd_blocked
• 每轮任务结束后自动清理 OpenAI / Auth 站点数据

3. 当前整理版本

当前公开整理基线：

• 上游对齐范围：v11.0.0 高价值改动（未接入上游 Clash 部署管理 / 云端数据库方案）
• 当前公开热修版本：v11.0.0-bfansye-hotfix1

本轮整理额外完成：

• 回补上游 v10.1.2 的注册主流程强化

• 修复 takeover 场景 password_verify / login_ctx 传递链路

• 新增创建阶段命中 /add-phone 时的 HeroSMS 补救逻辑

• 识别 identity_provider_mismatch 并自动转 takeover / OAuth OTP 路径

• 识别 been deleted or deactivated 与 Failed to create account 的更细归因

• 回补上游 v10.1.3 的微软邮箱 service abuse mode 自动停用逻辑

• 新增 Sub2API 测活验证模型配置 test_model

• 新增 HeroSMS 创建阶段接码配置 verify_on_register

• 恢复古法浏览器插件模式主控链路

• 增强 create-account 异常页自动重试

• 识别 Cloudflare 全页安全验证并归类为 pwd_blocked

• 每轮古法任务结束后自动清理 OpenAI / Auth 站点数据

• 古法启动前等待 WORKER_READY 与心跳，避免误报“插件节点未连接”

• 修正浏览器插件安装提示：必须加载解压后的插件目录

• 修复 Sub2API 测活模型配置值大小写不规范问题，统一归一化为兼容的模型 ID（如 gpt-5.2 / gpt-5.3-codex / gpt-5.4）

• 回补上游 v10.1.5 的注册主流程优化，新增创建阶段手机风控重试与部分接管场景补全账号资料逻辑

• 优化邮箱显示脱敏与 Graph 轮询日志展示

• 选择性回补上游 v11.0.0 的注册流程强化、微软邮箱旧验证码/401 缓解、Sub2API 代理提交与日志上限功能

详见：CHANGELOG.md

4. 目录说明

.
├── assets/                # 界面截图
├── data/                  # 运行时数据目录（不提交）
├── luckmail/              # LuckMail 相关客户端
├── routers/               # FastAPI 路由
├── static/                # 前端 JS / 静态资源
├── utils/                 # 核心逻辑、代理、邮箱、仓管
├── config.example.yaml    # 配置模板
├── docker-compose.yml     # 公开版示例编排
├── Dockerfile             # 本地构建镜像
├── DEPLOY.md              # 详细部署说明
├── CHANGELOG.md           # 变更记录
└── wfxl_openai_regst.py   # 启动入口

5. 快速开始（推荐 Docker）

5.1 克隆仓库

git clone https://github.com/BFanSYe/GPT-Auto-Manager.git
cd GPT-Auto-Manager

5.2 启动

docker compose up -d --build

默认 docker-compose.yml 已包含一键自动更新所需的源码目录挂载、HOST_PROJECT_PATH 与 docker.sock 配置； 当你的 GitHub Release 发布新版本后，面板会按你的仓库版本提醒，并支持一键自动更新。

5.3 访问面板

默认访问地址：

http://127.0.0.1:18000

首次启动时如果 data/config.yaml 不存在，系统会自动根据 config.example.yaml 生成默认配置。

默认 Web 密码：

admin

首次登录后请立即修改 Web 密码与关键密钥。

6. 首次配置建议顺序

建议第一次使用时按下面顺序配置：

1. 邮箱配置
   • 先确认你选择的邮箱后端能正常收码
2. 网络代理
   • 先决定使用：
     • 普通单代理
     • HTTP 动态代理池
     • Clash / Mihomo 节点池
3. 手机接码
   • 如果使用 HeroSMS，先确认余额、价格和国家策略
4. 并发与系统
   • reg_threads 不建议一开始开太高
5. 中转管仓
   • 如果启用 CPA / Sub2API，再配置补货逻辑

7. Clash / Mihomo 使用说明

7.1 什么时候用 Clash 订阅自助更新

当你有一套宿主机维护的 Mihomo 多实例代理池，并且希望在 Web 面板中：

• 一键替换订阅
• 自动重载代理池
• 自动识别业务组
• 自动把不同实例分流到不同节点
• 自动检查默认总路由是否对齐

就使用这一套功能。

7.2 这套功能依赖什么

宿主机需要提供一个目录（默认约定为 /opt/mihomo-pool），其中至少包含：

• pool.env
• update_pool.sh
• status_pool.sh
• config_1/config.yaml ... config_n/config.yaml

容器需要挂载：

• /opt/mihomo-pool:/opt/mihomo-pool
• /var/run/docker.sock:/var/run/docker.sock
• /usr/bin/docker:/usr/local/bin/docker:ro

7.3 现在已经内置的自动防呆

• 自动清洗订阅链接中的空格 / 换行
• 自动探测原始链接是不是 Mihomo YAML
• 如果不是，会自动尝试补成 ?flag=mihomo
• 错误订阅会在写入前被拦截
• 更新后会自动检查：
  • 策略组是否存在
  • 默认总组是否能到达业务组
  • 各实例是否已分配不同节点
  • 当前运行态是否全部对齐

8. HTTP 动态代理池与 Clash 池怎么选

用 HTTP 动态代理池的情况

适合你拿到的是这种代理：

http://user:[email protected]:10000

并且代理商本身就支持“每次连接自动换出口”。

用 Clash 节点池的情况

适合你已经有：

• Mihomo / Clash 控制器
• 策略组
• 节点订阅
• 多实例多端口池

并且你需要：

• 指定业务组
• 节点筛选
• 延迟优选
• 默认总组对齐
• 多实例不同出口

9. 本地源码运行（非 Docker）

9.1 Python 版本

建议：

• Linux / macOS：Python 3.11
• Windows：Python 3.12

9.2 安装依赖

pip install -r requirements.txt

9.3 启动

python wfxl_openai_regst.py

默认监听：

http://127.0.0.1:8000

10. Docker Compose 示例说明

仓库自带的 docker-compose.yml 默认采用 本地源码构建，更适合公开仓库直接复用。

如果你暂时不需要 Clash 订阅自助更新，只保留：

• ./data:/app/data

即可。

如果需要 Clash 订阅自助更新，再额外挂载：

• /opt/mihomo-pool:/opt/mihomo-pool
• /var/run/docker.sock:/var/run/docker.sock
• /usr/bin/docker:/usr/local/bin/docker:ro

详细步骤见：DEPLOY.md

11. 升级建议

推荐升级流程：

git pull
docker compose up -d --build

如果你使用了宿主机反向代理，通常不需要改 Nginx，只需要重建容器即可。

12. 公共仓库使用注意

请不要提交以下内容：

• data/
• .env
• credentials.json
• token.json
• 真实邮箱账号 / 密码
• 真实订阅链接
• 真实 API Key / TG Token / Chat ID
• 真实数据库备份

建议你只提交：

• 代码
• 文档
• 示例配置
• 脱敏截图

13. 截图预览

14. 上游来源与说明

本仓库基于：

• 上游项目：https://github.com/wenfxl/openai-cpa

当前仓库的目标不是“完全替代上游”，而是提供一个：

• 更适合中文用户直接部署
• 更适合公开分享复用
• 保留已验证增强特性的整理版基线

15. 相关文档

• 部署说明 DEPLOY.md
• 变更记录 CHANGELOG.md
• 示例配置 config.example.yaml

16. English Summary

This repository is a Chinese-enhanced public-ready fork of wenfxl/openai-cpa, focused on practical web-based operations, Clash/Mihomo proxy-pool management, HTTP dynamic proxy pooling, mailbox backends, and CPA/Sub2API inventory workflows.