team-manage 核心功能全景解析:兑换码、Team 管理与自动邀请的 10 大能力
team-manage 核心功能全景解析:兑换码、Team 管理与自动邀请的 10 大能力
team-manage 是一款基于 FastAPI 的 GPT Team 管理与兑换码自动邀请系统:管理员批量导入 ChatGPT Team 账号并生成兑换码,用户凭码自动入队,系统自动发送 Team 邀请邮件,全程无需人工值守。本文带你完整拆解它的 10 大核心能力,从 Docker 一键部署到库存预警 Webhook,一篇看懂。
🚀 Docker 一键部署:3 分钟跑起 GPT Team 管理系统
team-manage 支持 Docker Compose 一键部署,无需手动配置 Python 环境(项目要求 Python 3.10+,见 requirements.txt):
git clone https://gitcode.com/gh_mirrors/te/team-manage
cd team-manage
cp .env.example .env
docker compose up -d
修改 .env 中的 SECRET_KEY 和 ADMIN_PASSWORD 后即可访问:
| 入口 | 地址 |
|---|---|
| 用户兑换页面 | http://localhost:8008/ |
| 管理员登录 | http://localhost:8008/login |
| 管理员控制台 | http://localhost:8008/admin |
默认管理员账号 admin / admin123,首次登录后建议修改。数据文件 team_manage.db 已自动映射到宿主机,容器删除后数据依然存在。
✨ 10 大核心能力全景解析
1️⃣ 智能导入 Team 账号:任意格式 Token 自动识别
进入「Team 管理 → 导入 Team」,支持单个导入和批量导入。无论粘贴的是纯 AT Token,还是「邮箱,AT,RT,ST,ClientID」格式的文本,系统都会用正则自动识别并提取 AT Token、邮箱、Account ID(解析逻辑见 app/utils/token_parser.py)。
更贴心的是,导入支持 3 种认证方式任选:直接提供 AT、用 Session Token 自动刷新 AT、用 Refresh Token + Client ID 刷新(实现见 app/services/chatgpt.py),批量导入接口文档参考 integration_docs.md。
2️⃣ Team 信息自动同步与状态监控
导入后系统会自动拉取并同步 Team 的名称、订阅计划、到期时间、当前成员数与待接受邀请数。每个 Team 都有清晰的状态标记:active / full / expired / banned / error,连续报错还会累计 error_count,方便快速定位问题账号(数据模型见 app/models.py)。
3️⃣ 兑换码生成与全生命周期管理
在「兑换码管理」中可单个或批量生成兑换码,支持自定义兑换码内容和自定义有效期,按未使用 / 已使用 / 已过期筛选,一键导出为文本文件,也可删除未使用的码、批量修改属性(app/routes/admin.py)。兑换码还内置质保字段 has_warranty 和 warranty_days,为后续的质保能力打底(app/models.py)。
4️⃣ 兑换流程全自动:凭码即发邀请
这是整个系统的灵魂。用户只需输入邮箱 + 兑换码:
- 验证兑换码有效性,展示可用 Team 列表
- 手动挑选或点击「自动选择」Team
- 系统调用 ChatGPT API 自动向用户邮箱发送 Team 邀请
- 返回 Team 名称、到期时间等兑换结果
底层做了严格的工程化设计:按兑换码加锁防并发、行级 FOR UPDATE 锁、失败自动重试 3 次、Team 满员自动标记 full 并换队重试、用户已在队内则幂等视为成功(核心逻辑见 app/services/redeem_flow.py)。
5️⃣ Team 成员精细管理
管理员可查看任意 Team 的成员与待接受邀请列表、手动添加成员、删除成员、撤销邀请,还能一键开启设备代码身份验证(批量开启也在管理端提供)。相关路由集中在 app/routes/admin.py,服务端实现见 app/services/team.py。
6️⃣ 质保兑换码:被封号也能免费再入队
使用质保兑换码加入的 Team 若被 OpenAI 封号,用户在质保期内(默认 30 天)可以重复使用原兑换码再次入队,相当于给账号上了「保险」。用户还能在兑换页的「质保查询」入口,凭兑换码或邮箱随时查询质保状态与 Team 健康状况(app/services/warranty.py、app/routes/warranty.py)。
7️⃣ 使用记录多维查询与统计
「使用记录」页面支持按邮箱、兑换码、Team ID、日期范围组合筛选,分页展示(每页 20 条),并自动统计总数、今日、本周、本月兑换数据,支持对单条记录执行撤回操作(app/routes/admin.py),运营情况一目了然。
8️⃣ 库存预警 Webhook:库存不足自动通知补货
当所有活跃 Team 的总剩余车位 ≤ 阈值(默认 10)时,系统自动向配置的 Webhook 地址发送 low_stock 事件(含 current_seats、threshold 等字段,实现见 app/services/notification.py)。第三方程序收到通知后可携带 X-API-Key 调用导入接口自动补货,实现「卖完自动进货」的无人值守闭环,完整对接示例参考 integration_docs.md。
9️⃣ 安全加密与代理配置
- AT / RT / Session Token 均用 AES-256-GCM 加密存储(app/services/encryption.py),即使数据库泄露 Token 也安全
- Session 认证 + bcrypt 密码哈希,会话有效期 14 天
- 内置 HTTP / SOCKS5 代理配置与日志级别动态调整,AT 过期可自动刷新
- 使用 curl-cffi 模拟浏览器指纹,可绕过 Cloudflare 防护
🔟 Docker 部署与数据持久化
除 Dockerfile 与 docker-compose.yml 外,应用启动时自动建表并执行增量数据库迁移(app/db_migrations.py)、初始化管理员密码(app/main.py),还提供 /health 健康检查端点,适合挂在 NAS 或 VPS 上长期运行。
📁 项目目录结构速查
team-manage/
├── app/
│ ├── main.py # FastAPI 入口:中间件、路由注册、生命周期
│ ├── config.py # 环境变量配置
│ ├── models.py # Team / 兑换码 / 使用记录 数据模型
│ ├── routes/ # 路由层:admin / user / redeem / warranty / api
│ ├── services/ # 业务层:team / redemption / redeem_flow / warranty
│ ├── utils/ # JWT 解析、Token 正则提取
│ ├── templates/ # Jinja2 页面(管理员面板 + 用户兑换页)
│ └── static/ # CSS / JS 静态资源
├── init_db.py # 数据库初始化脚本
├── docker-compose.yml # 容器编排
└── integration_docs.md # Webhook 与自动导入对接文档
💡 新手常见问题
- 数据存在哪里? 默认的 SQLite 文件
team_manage.db,Docker 部署时已映射到宿主机,备份它即可。 - 导入 Team 失败怎么办? 检查 AT Token 是否过期、是否有 Team 管理权限;网络受限就配置代理。
- NAS 上构建报
exclude-patterns非 ASCII 错误? 用git pull && docker compose build --no-cache && docker compose up -d更新即可,详见 README.md 故障排除章节。
⚠️ 本项目仅供学习和研究使用,请遵守 OpenAI 服务条款,合法合规使用。
一句话总结:team-manage = 批量导入 + 兑换码 + 自动邀请 + 质保兜底 + 库存预警,一个把 ChatGPT Team 账号运营流程全部自动化的轻量系统,非常适合作为学习 FastAPI 全栈架构(路由 / 服务分层 / 并发控制 / Webhook 集成)的开源范本。