team-manage 核心功能全景解析:兑换码、Team 管理与自动邀请的 10 大能力

原创2026-10-15 06:12:161,378 阅读

team-manage 核心功能全景解析:兑换码、Team 管理与自动邀请的 10 大能力

team-manage 是一款基于 FastAPI 的 GPT Team 管理与兑换码自动邀请系统:管理员批量导入 ChatGPT Team 账号并生成兑换码,用户凭码自动入队,系统自动发送 Team 邀请邮件,全程无需人工值守。本文带你完整拆解它的 10 大核心能力,从 Docker 一键部署到库存预警 Webhook,一篇看懂。

team-manage GPT Team 管理系统项目图标

🚀 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️⃣ 兑换流程全自动:凭码即发邀请

这是整个系统的灵魂。用户只需输入邮箱 + 兑换码:

  1. 验证兑换码有效性,展示可用 Team 列表
  2. 手动挑选或点击「自动选择」Team
  3. 系统调用 ChatGPT API 自动向用户邮箱发送 Team 邀请
  4. 返回 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 集成)的开源范本。

登录后查看全文