用户使用 team-manage 兑换 ChatGPT Team 全流程图解:从输入兑换码到接收邀请
用户使用 team-manage 兑换 ChatGPT Team 全流程图解:从输入兑换码到接收邀请
team-manage 是一款基于 FastAPI 的 GPT Team 管理与兑换码自动邀请系统:管理员导入 Team 账号并批量生成兑换码,用户只需输入 邮箱 + 兑换码,系统就会自动完成验证、分配可用 Team,并向该邮箱发送 ChatGPT Team 邀请。本文面向新手,逐步图解用户端从打开兑换页面、填写兑换码,到最终查收邀请邮件的完整流程,并附上常见报错处理与质保自助修复说明。
🧭 一图看懂:team-manage 兑换全流程
整个用户兑换过程可以概括为下面 5 个环节:
① 打开兑换页面 → ② 填写邮箱+兑换码 → ③ 系统自动验证并分配 Team
→ ④ 查看兑换结果 → ⑤ 查收邮件并接受 Team 邀请
| 环节 | 你做什么 | 系统做什么 |
|---|---|---|
| ① 打开页面 | 访问部署地址根路径 | 展示剩余可兑换车位 |
| ② 填写信息 | 输入邮箱和兑换码,点击验证 | 校验兑换码有效性 |
| ③ 自动分配 | 无需操作(等待几秒) | 挑选有空位的 Team,调用 API 发送邀请 |
| ④ 查看结果 | 确认成功提示与 Team 信息 | 记录兑换、锁定兑换码 |
| ⑤ 接受邀请 | 打开邮箱,点击邀请链接 | 你正式成为 Team 成员 |
📍 第1步:打开用户兑换页面
在浏览器访问部署地址的根路径,例如 http://你的服务器:8008/。
- 页面标题为 GPT Team 兑换,副标题为“使用兑换码加入 ChatGPT Team”;
- 如果系统中还有可兑换席位,页面顶部会显示一个 “剩余车位: N” 的徽标,帮助你快速判断当前是否有库存。
页面由路由 app/routes/user.py 渲染,界面模板见 app/templates/user/redeem.html。
✍️ 第2步:填写邮箱与兑换码
页面表单只有两个必填项:
- 邮箱地址:填写你要接受邀请的账号邮箱。⚠️ 邀请邮件会发送到这个邮箱,请确保它是可正常收信的 ChatGPT/OpenAI 账号邮箱。
- 兑换码:标准格式为
XXXX-XXXX-XXXX-XXXX(大写字母 + 数字,不含易混淆的 0/O、1/I)。
填写完成后点击 “验证兑换码” 按钮,按钮会变为“正在兑换...”。此时系统会在后台自动完成校验和 Team 分配,你无需再手动选择 Team(自动分配会优先挑选已占用席位最少的 Team,相当于负载均衡)。
前端交互逻辑位于 app/static/js/redeem.js。
⚙️ 第3步:系统自动验证与 Team 分配(幕后过程)
点击验证后,后端会依次执行以下操作(无需你干预,了解即可):
- 校验兑换码:检查兑换码是否存在、状态是否为未使用(或质保期内可复用)、是否超过首次兑换截止时间;
- 自动选择 Team:从状态为
active且有剩余席位的 Team 中,挑选占用席位最少的一个; - 实时同步席位:拉取该 Team 最新的成员数量,确认仍有空位;
- 发送邀请:调用 ChatGPT 官方 API 向你的邮箱下发 Team 邀请;
- 自动重试:若目标 Team 恰好已满,系统会自动换一个 Team 重试(最多 3 次)。
核心流程实现在 app/services/redeem_flow.py,对外接口定义在 app/routes/redeem.py。
✅ 第4步:查看兑换结果
兑换成功时,页面会显示绿色成功页,包含:
- 提示文案:“兑换成功!邀请链接已发送至您的邮箱,请及时查收。”
- Team 名称、你的邮箱地址、Team 到期时间
- 若超过 1-5 分钟仍未收到邮件,页面提供 “前往质保查询 / 自助修复” 按钮
兑换失败时,页面会直接显示具体报错原因,并提供“返回重试”和“重新开始”两个按钮。常见报错速查:
| 报错信息 | 常见原因 | 建议操作 |
|---|---|---|
| 兑换码不存在 | 输入有误或码无效 | 核对是否有拼写、漏位 |
| 兑换码已使用 | 该码已被兑换过 | 质保码可去“质保查询”复用,普通码需联系管理员 |
| 兑换码已过期(超过首次兑换截止时间) | 超过了码的有效期 | 联系管理员重新发放 |
| 该 Team 已满 | 当前 Team 无空位 | 直接重试,系统会自动换 Team |
| 没有可用的 Team | 所有 Team 均无空位 | 稍后再试或联系管理员补货 |
✉️ 第5步:查收邮件并接受邀请
- 兑换成功后 1-5 分钟内,打开你填写的邮箱(记得查看垃圾邮件箱);
- 找到 ChatGPT Team 的邀请邮件,点击邮件中的链接;
- 按邮件指引登录并接受邀请,你即正式成为该 Team 的成员,即可使用 Team 额度。
💡 如果一直收不到邮件:先确认邮箱地址没有填错,再点击结果页的“前往质保查询 / 自助修复”按钮,系统会自动检测并尝试修复(例如检测到“兑换成功但邀请未下发”的异常情况时,会引导你复制原兑换码重新兑换)。
🛡️ 附加功能:质保查询与自助修复
如果你拿到的是质保兑换码,页面下方提供“质保查询”区域:
- 查询方式:输入原兑换码或邮箱,点击“查询质保状态”;
- 查看内容:当前质保是否有效、质保到期时间、历史兑换记录,以及所在 Team 的状态(正常 / 已满 / 封号 / 异常 / 过期);
- 一键换车:若你所在的 Team 被封号、且质保仍在有效期内(默认 1 个月),可以直接点击“一键换车”,系统自动用原兑换码把你分配到新的 Team;
- 质保查询接口定义在 app/routes/warranty.py。
❓ 新手常见问题 FAQ
Q1:提示兑换成功,但一直没收到邀请邮件? 等待 1-5 分钟并检查垃圾邮件箱;仍未收到就使用“质保查询 / 自助修复”,系统会检测是否为“虚假成功”并引导重兑。
Q2:普通兑换码可以换另一个邮箱再兑一次吗? 不可以。普通码兑换后状态变为已使用,且记录首次兑换邮箱,只能由该邮箱使用。
Q3:Team 到期时间怎么看? 兑换成功结果页会直接显示该 Team 的到期时间;之后也可通过质保查询页面在“我的兑换记录”中查看。
📚 延伸阅读
- README.md:项目完整说明、Docker 一键部署与管理员操作流程
- integration_docs.md:库存预警 Webhook 与第三方自动导入 Team 的对接文档
至此,你就完成了从输入兑换码到接收 Team 邀请的全过程——正常情况下全程只需不到 2 分钟,剩下的工作只是打开邮箱点一下“接受邀请”啦 🎉