本文给第一次使用的用户看：按步骤操作即可跑起来。

1.下载

• 软件主体下载 https://t.me/bxgtools/340
• 升级器 下载 https://t.me/bxgtools/341
• 升级器与软件主体 放入同个目录 如下
• cre文件 下载 https://t.me/bxgtools/342

2. 这软件是做什么的？

本软件在本机启动一个 HTTP 服务，给外部脚本/注册机调用，完成两件事：

• 派发一条队列邮箱：GET /icloud（返回 icloud 和 link）
• 按别名取验证码：GET /get_otp?alias=xxx（返回 otp）

3. 必懂名词（非常重要）

• 别名（alias）：可以理解成「这把 Gmail 钥匙在本软件里的名字」。规定：填该邮箱 @ 前面的那一段。
  例：xiaoming@gmail.com 的别名就是 xiaoming。
• 邮箱队列：每行格式为 邮箱|别名。
  左边“邮箱”用于对外返回/展示（可以是变体），右边“别名”用于在本机找到对应 Gmail token 来取码（必须和 Gmail 账号页里保存的别名一致）。
• 账号冷却（秒）：同一个 Gmail 账号（按别名）两次被分配之间要间隔的时间，让账号“休息”。0 表示关闭。

4. 第一步：添加 Gmail 账号（保存 token）

1. 打开软件 → 进入「Gmail 账号」页
2. 选择你的 credentials.json（Google Cloud 下载）
3. 在“别名”输入框填写 @ 前缀（例：xiaoming）
4. 点击「浏览器登录并保存 token」完成授权
5. 刷新列表，看到该别名出现即成功

5. 第二步：准备邮箱队列 TXT（核心数据来源）

邮箱队列的 TXT 每行必须是：

邮箱|别名

示例：

xiaoming@gmail.com|xiaoming
lammychau7@gmail.com|lammychau7

然后在「邮箱队列」页点击「从 TXT 追加导入…」导入即可。

6. 变体生成（一定要说明清楚：只为了生成队列 TXT）

变体生成不是用来登录 Gmail 的，也不是用来“增加账号”的。

变体生成的唯一目的：输出一份给「邮箱队列」导入用的 TXT 文件，让队列里出现同一个邮箱的多种大小写写法（变体），方便下游填写/测试/批量跑任务。

6.1 变体生成会改哪里？

• 只改左边“邮箱”（例如大小写变化）
• 右边“别名”完全不变

举例：输入原始行：

xiaoming@gmail.com|xiaoming

输出可能包含（左边变体、右边别名不变）：

xiaoming@gmail.com|xiaoming
XiAoMiNg@gmail.com|xiaoming
XIAOMING@gmail.com|xiaoming

6.2 变体生成的使用流程

1. 在「变体生成」页选择 mail.txt（里面同样是 邮箱|别名 每行一条）
2. 选择输出文件路径
3. 点击「开始生成」
4. 把输出 TXT 拿到「邮箱队列」页导入

7. 第三步：启动 HTTP 服务（给脚本/注册机调用）

1. 进入「总览与设置」页
2. 点击「启动 HTTP 服务」
3. 复制页面显示的 URL 给脚本使用：
   • DIY_GET_EMAIL_ADDRESS：/icloud
   • DIY_GET_OPT_ADDRESS：/get_otp?alias=（注意是前缀，后面再拼 alias）

8. /icloud 与 /get_otp 返回说明（给外部调用接口人员看）

8.1 GET /icloud

正常返回（示例）：

{"status":200,"icloud":"xiaoming@gmail.com","link":"xiaoming","last_otp":"123456"}

可能返回“账号冷却中”（示例）：

{"status":"error","cooldown":true,"min_wait_seconds":12,"message":"..."}

脚本收到 cooldown=true 时，建议按 min_wait_seconds 等待后再重试，避免高频请求。

8.2 GET /get_otp?alias=xxx

正常返回（示例）：

{"otp":"123456"}

无新码/无匹配邮件（示例）：

{"otp":null}

token 失效（示例）：

{"otp":"die"}

9. Gmail 账号表格怎么看（重点列）

• 冷却至：该账号什么时候解冻（空表示不在冷却）
• 接码次数：只在 GET /get_otp 真正返回了验证码时才 +1（用于统计“这个账号究竟接码了多少次”）

10. 常见问题（小白排查）

10.1 一直拿不到邮箱

• 看「邮箱队列」是否为空
• 看是否全部处于账号冷却中（脚本会收到 cooldown=true 和 min_wait_seconds）
• 确认已启动 HTTP 服务、URL/端口填写正确

10.2 /get_otp 返回 die

含义：token 失效（不是“收不到邮件”）。
解决：回到「Gmail 账号」页重新 OAuth 授权并保存 token。

11. 使用效果，一个邮箱可以多次使用接码，从而节省邮箱费用