AutoTeam 是一个自动化管理 ChatGPT Team 账号轮转的工具，主要面向需要批量维护 Team 成员账号、监控 Codex 额度的使用场景。
用途
AutoTeam 的核心用途是自动管理 ChatGPT Team 账号的轮转：自动注册账号、获取 Codex OAuth 认证、监控额度余量、在额度低时智能切换账号，并将认证文件同步到 CLIProxyAPI（CPA）。适合需要持续维持一定数量可用账号、并希望减少人工干预的用户。
主要能力
- 账号轮转：检查额度，低于阈值时移出当前账号、验证备用账号额度并加入 Team，或在无备用账号时注册新账号。
- 额度监控：查看所有账号状态和额度，支持按阈值判断并触发轮转。
- 账号补充与清理：补满成员到目标数量，或清理多余成员。
- 认证同步：将认证文件同步到 CLIProxyAPI。
- 自动巡检：可配置开启巡检、间隔时间与额度阈值。
- 账号状态机：覆盖 new、registering、registered、codex_auth、active、low_quota、removed、failed 等状态。
使用方式
前置条件为 Python 3.10+、uv 包管理器和 Chromium（由 Playwright 管理）。可通过 setup.sh 一键安装，或手动执行 uv sync 与 uv run playwright install chromium，然后复制 .env.example 到 data/.env 并填写配置。
环境变量包括 CloudMail 临时邮箱服务、CPA 连接信息、AutoTeam API 鉴权、ChatGPT Team 管理员账号、额度阈值、Team 目标成员数和 Web 面板端口。首次启动可通过 uv run autoteam api 进入配置向导，自动引导配置并验证连通性。
CLI 命令包括：uv run autoteam api（启动 Web 面板与 HTTP API）、rotate（智能轮转）、status（查看账号状态）、check（检查额度）、add（手动添加账号）、fill（补满成员）、cleanup（清理成员）、sync（同步认证到 CPA）、admin-login（管理员登录）。
也支持 Docker 部署，通过 docker compose up -d 启动，使用数据卷持久化配置、数据库与认证文件。HTTP API 需携带 Authorization: Bearer $AUTOTEAM_API_KEY 鉴权头，核心端点涵盖账号列表、轮转、检查、补满、清理、同步、任务历史、实时日志以及巡检配置的获取与更新。Web 管理面板提供仪表盘、Team 成员、操作与任务、日志、设置等页面。
适用场景
适用于需要维护 ChatGPT Team 账号池、监控 Codex 额度、自动补充和清理成员、以及同步认证文件到 CLIProxyAPI 的场景。可通过 Python 脚本结合 HTTP API 实现自动化巡检与批量同步。
限制
- IP 风险：VPS IP 容易被 OpenAI/Cloudflare 标记，建议使用住宅代理。
- 并发限制：同一时间只允许一个 Playwright 操作，避免竞态。
- 服务条款：使用本工具可能违反 OpenAI 服务条款，风险自担。
- 验证码时效：OpenAI 验证码有效期极短，高延迟网络下成功率低。