AutoTeam

AutoTeam 是一款专为 ChatGPT Team 用户设计的开源工具，旨在解决多账号管理、额度监控、自动轮转以及与 CLIProxyAPI (CPA) 同步认证的痛点。它通过自动化脚本和 Web 面板，实现了从账号注册、OAuth 认证到智能轮转的全流程管理，极大提升了团队协作和个人多号使用的效率。

核心功能亮点

1. 全流程自动化

• 自动注册：集成 CloudMail 临时邮箱服务与 Playwright 浏览器自动化，可批量注册新账号。
• Codex OAuth 自动登录：支持自动完成 Codex 的 OAuth 认证流程。若无密码，可自动通过邮箱验证码登录。
• 智能轮转：实时监控账号额度，当主账号额度不足时，自动将其移出并替换为备用账号；旧账号恢复后优先复用，实现“永不停机”的服务体验。

2. 与 CLIProxyAPI (CPA) 双向同步

• 无缝集成：AutoTeam 能与流行的代理工具 CLIProxyAPI 深度联动。
• 双向同步：
  • 上传：将本地获取的最新 auth.json 自动上传至 CPA，确保代理端使用最新凭证。
  • 下拉：支持从 CPA 反向导入认证文件，方便多设备或多实例间的数据对齐。

3. 强大的 Web 管理面板

启动 API 服务后，可通过浏览器访问直观的仪表盘：

• 📊 仪表盘：实时展示账号统计、状态表格，支持一键登录、移出、删除或同步。
• 👥 成员管理：查看和管理 Team 中的所有成员（含外部邀请成员）。
• 🔄 同步中心：一键执行账号同步、CPA 同步及拉取操作。
• 🔐 OAuth 登录助手：生成认证链接，支持 localhost 自动回调或手动粘贴 URL，简化登录步骤。
• 📜 任务历史与日志：详细记录后台任务的执行状态、参数、耗时及结果，支持实时日志查看，便于排查问题。

4. 灵活的 CLI 命令

提供丰富的命令行接口，适合脚本化调用和高级用户：

• uv run autoteam api：启动 Web 面板 + HTTP API。
• uv run autoteam rotate [N]：智能轮转，确保账号池中有 N 个可用账号（默认 5 个）。
• uv run autoteam status：快速查看当前所有账号的状态。
• uv run autoteam manual-add：手动添加账号，支持打开链接登录后粘贴回调 URL。
• uv run autoteam sync / pull-cpa：手动触发与 CPA 的双向同步。

快速开始

环境要求

• Python 3.10+
• uv (推荐用于依赖管理)
• Playwright (用于浏览器自动化)

安装步骤

Linux:

bash setup.sh
# 或手动安装
uv sync && uv run playwright install chromium

Windows / macOS:

uv sync
uv run playwright install chromium

启动服务

推荐方式：启动 Web 面板

uv run autoteam api

访问 http://localhost:8787 即可进入管理界面。首次启动会自动引导配置 CloudMail、CPA 地址及 API Key。

仅运行轮转任务

uv run autoteam rotate

Docker 部署

适合希望长期后台运行且隔离环境的用户。

1. 克隆仓库：

   git clone https://github.com/cnitlrt/AutoTeam.git && cd AutoTeam
   

2. 准备配置：

   mkdir -p data
   cp .env.example data/.env
   # 编辑 data/.env 填入必要配置（如 CloudMail API Key, CPA URL 等）
   

3. 启动容器：

   docker compose up -d
   

典型应用场景

1. 团队共享池管理：为小团队维护一个 ChatGPT Team 账号池，AutoTeam 自动检测哪个账号有额度，并将其分配给当前请求者。
2. 个人多号防封/减负：个人拥有多个账号，通过 AutoTeam 轮转使用，避免单个账号因高频使用被限制，同时最大化利用免费/订阅额度。
3. CI/CD 集成：在自动化测试或开发流程中，通过 CLI 命令动态获取可用的 Auth Token，确保构建过程不因 API 限额而中断。
4. 无缝对接代理网关：对于使用 CLIProxyAPI 的用户，AutoTeam 确保了底层的认证文件始终最新，无需手动复制粘贴 auth.json。

⚠️ 注意事项

• 合规性：请遵守 OpenAI 的服务条款。自动注册和大规模轮转可能触及平台风控，建议合理使用。
• 安全性：auth.json 包含敏感认证信息，请妥善保管 Docker 卷数据或本地配置文件，不要泄露给他人。
• 依赖稳定性：由于依赖网页自动化（Playwright），OpenAI 登录页面的结构变更可能导致脚本暂时失效，需关注项目更新。