CodeX Register 是一个本地桌面化控制台，用于统一执行注册流程、邮箱池管理、SMS 接码、代理切换、本地账号库管理、以及云端账号运维。

本项目由 GPT-5.3-Codex 辅助完成。

• 前端：Vue 3 + Naive UI
• 后端：Python 本地 HTTP 服务
• 运行模式：window（pywebview）/ browser

• Issue: #7 — Graph 接口模式账号列表拉取优化。
• 优先使用开放列表接口 GET /api/open/accounts，避免预探测 /api/open/messages 造成取件级慢请求。
• 当上游返回未登录/会话过期时快速失败并给出明确提示，不再继续慢速扫描。

• Graph 接口模式账号备注更新切换为开放接口：PATCH /api/open/accounts/:id/remark。
• 备注更新请求体改为最小负载：{"remark":"已注册"}，不再依赖全量账号字段。
• 保持 token 鉴权与错误提示一致，注册链路中的“已注册账号”仍会自动回写备注。

• Issue: #7 — Graph 接口模式注册链路异常（区域限制误归因、已注册账号处理、邮箱 OTP 重试策略）。
• 新增 Graph 双模式配置：graph_accounts_mode=file/api，接口模式支持仅 graph_api_base_url + graph_api_token。
• 修复 Country, region, or territory not supported 归因，统一标记为 region_blocked 并停止无效补位重试。
• 遇到 Failed to register username 时先尝试登录换 token，并将上游账号 remark 更新为 已注册。

• 工作台：启动/停止任务、实时日志、成功率、重试原因、SMS 消耗与余额统计。
• 邮箱体系：支持 Cloudflare Temp Email、MailFree、CloudMail、Mail-Curl、Luckyous API、Gmail IMAP、Microsoft Graph。
• MailFree 域名配置：可在 UI 内读取 Cloudflare Zone、管理 CNAME、并将 DNS 子域名批量同步到 MailFree 域名池（/api/domains）。
• 代理能力：支持单代理或多代理轮换（逗号/空格/换行分隔）；支持 FlClash 动态切节点、延迟探测、自动跳过香港节点。
• 本地账号管理：SQLite（local_accounts.db）作为本地账号真源，支持导入、筛选、状态展示、导出与同步。
• 云端账号管理：支持 Sub2API 与 CLIProxyAPI 双模式，支持测活、刷新、删除、批量操作。
• 发布能力：推送 v* Tag 自动触发多平台 Release 打包。

.
├─ gui.py
├─ VERSION
├─ REPOSITORY
├─ gui_config.example.json
├─ codex_register/
│  ├─ gui_service.py
│  ├─ gui_server_runtime.py
│  ├─ gui_frontend_app_template.html
│  ├─ gui_frontend_app_setup.js
│  ├─ r_with_pwd.py
│  ├─ mail_services.py
│  ├─ mail_providers/
│  └─ ...
├─ scripts/
└─ .github/workflows/release.yml

• Python >= 3.10
• 依赖安装：

pip install requests curl_cffi pywebview

说明：

• window 模式依赖 pywebview，Windows 需安装 WebView2 Runtime。
• 前端资源通过 CDN 加载（unpkg.com）。

1. 复制示例配置

cp gui_config.example.json gui_config.json

PowerShell：

Copy-Item gui_config.example.json gui_config.json

2. 填写 gui_config.json 关键项（邮箱服务、代理、SMS、云端管理地址等）

3. 启动

python gui.py

说明：

• 大部分配置项可以在程序启动后直接在 GUI 中查看和修改，通常不需要手改 gui_config.json。

4. 可选参数

python gui.py --mode browser --host 127.0.0.1 --port 8765
python gui.py --mode browser --no-auto-open

• 配置“计划注册数/并发/冷却/代理”后点击开始。
• 日志区会实时显示每个线程的尝试、成功、失败和重试补位。

• 先选择 mail_service_provider。
• MailFree / Cloudflare Temp / CloudMail 可配置域名策略（随机域名、白名单、自定义 local-part）。
• Luckyous API 支持按项目编码自动下单邮箱并轮询验证码。
• Graph 支持文件模式与接口模式：文件模式使用账号文件；接口模式使用项目地址 + token。
• Graph 接口模式推荐对接 microsoft-account-manager：https://github.com/Msg-Lbo/microsoft-account-manager。
• Gmail 模式需使用应用专用密码（非登录密码）。

在“邮箱设置 -> MailFree -> 域名配置”中：

1. 填 Cloudflare API Token，点击“刷新域名”。
2. 选择 Zone 与 CNAME 指向域名。
3. 可查看/新增/编辑/批量删除 CNAME。
4. 勾选记录后可“批量同步MailFree”，会把完整域名写入 MailFree 的 /api/domains。

注意：同步到 MailFree 需要该 MailFree 账号具备严格管理员权限。

Cloudflare Token 要求（用于域名配置页读取 Zone 和管理 CNAME）：

• 令牌类型：API Token（不是 Global API Key）。
• 推荐权限：
  • Zone -> Zone -> Read
  • Zone -> DNS -> Read
  • Zone -> DNS -> Edit
• 资源范围：建议仅授权需要管理的 Zone（最小权限原则）。

• proxy 支持多条代理，格式可用逗号/空格/换行分隔，运行时按顺序轮换。
• 开启 FlClash 后，会在可用节点中切换（过滤香港节点，并做延迟检测）。
• 并发场景采用“波次切换”：每累计 flclash_rotate_every 次尝试后，等待当前波次结束再切下一节点。

• 本地账号页：按邮箱/备注/状态搜索，支持批量选择、删除、导入到 Sub2API/CPA、导出文件。
• 云端账号页：支持分组、测活、刷新、复活（Sub2API）、删除。
• 云端删除支持附加操作：可选同时删除本地数据库中对应账号。

以下与 codex_register/gui_config_store.py 的 DEFAULT_CONFIG 对应。

每行格式：

email----password----client_id----refresh_token

示例：

alice@outlook.com----pass123----xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx----0.AXEA...
bob@outlook.com----pass456----yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy----0.AXEA...

• IP 不切换：
  • 检查是否只配置了 1 条代理；
  • 多代理请使用逗号/空格/换行分隔；
  • FlClash 仅有 1 个可用非香港节点时无法切换。
• MailFree 域名同步失败：确认是严格管理员账号，且 MailFree 服务已升级到动态域名版本。
• Luckyous 下单失败：检查 API Key、项目编码与账户余额是否可用。
• invalid_auth_step 频繁：降低并发、提高代理质量、开启随机指纹。
• Gmail 登录失败：必须用应用专用密码。
• HeroSMS NO_BALANCE：充值或降低余额下限策略。

• 作者：Msg-Lbo（GitHub: https://github.com/Msg-Lbo）
• 协议文件：LICENSE
• 协议链接：https://github.com/Msg-Lbo/codeX-register/blob/main/LICENSE
• 允许学习研究与非商业自用；禁止商业售卖和二开后收费变现。