myemail 小白使用说明
本文给第一次使用的用户看：按步骤操作即可跑起来。
[image: 1775811706465-55ca8c09-4c7f-4a0e-a137-610fa45969a8-image.jpeg]
[image: 1775811799664-043d9f60-2be6-40cd-b30c-05000a86fce5-image.jpeg]
1.下载
软件主体下载 https://t.me/bxgtools/340
升级器 下载 https://t.me/bxgtools/341
升级器与软件主体 放入同个目录 如下
cre文件 下载 https://t.me/bxgtools/342
[image: 1775307234111-980c2ee6-19a2-445f-a65d-b0059f04f8a2-image.jpeg]
2. 这软件是做什么的？
本软件在本机启动一个 HTTP 服务，给外部脚本/注册机调用，完成两件事：
派发一条队列邮箱：GET /icloud（返回 icloud 和 link）
按别名取验证码：GET /get_otp?alias=xxx（返回 otp）
[image: 1775811810198-25af1c30-6052-4687-8811-4fb60eec4101-image.jpeg]
3. 必懂名词（非常重要）
别名（alias）：可以理解成「这把 Gmail 钥匙在本软件里的名字」。规定：填该邮箱 @ 前面的那一段。
例：
[email protected] 的别名就是 xiaoming。
邮箱队列：每行格式为 邮箱|别名。
左边“邮箱”用于对外返回/展示（可以是变体），右边“别名”用于在本机找到对应 Gmail token 来取码（必须和 Gmail 账号页里保存的别名一致）。
账号冷却（秒）：同一个 Gmail 账号（按别名）两次被分配之间要间隔的时间，让账号“休息”。0 表示关闭。
4. 第一步：添加 Gmail 账号（保存 token）
打开软件 → 进入「Gmail 账号」页
选择你的 credentials.json（Google Cloud 下载）
在“别名”输入框填写 @ 前缀（例：xiaoming）
点击「浏览器登录并保存 token」完成授权
刷新列表，看到该别名出现即成功
[image: 1775811859577-f61224af-08b4-4a84-bdff-c8b0c335081d-image.jpeg]
5. 第二步：准备邮箱队列 TXT（核心数据来源）
邮箱队列的 TXT 每行必须是：
邮箱|别名
示例：
[email protected]|xiaoming
[email protected]|lammychau7
然后在「邮箱队列」页点击「从 TXT 追加导入…」导入即可。
[image: 1775811889553-c53f7260-a2de-4ad8-b230-a7188bda96a8-image.jpeg]
6. 变体生成（一定要说明清楚：只为了生成队列 TXT）
变体生成不是用来登录 Gmail 的，也不是用来“增加账号”的。
变体生成的唯一目的：输出一份给「邮箱队列」导入用的 TXT 文件，让队列里出现同一个邮箱的多种大小写写法（变体），方便下游填写/测试/批量跑任务。
6.1 变体生成会改哪里？
只改左边“邮箱”（例如大小写变化）
右边“别名”完全不变
举例：输入原始行：
[email protected]|xiaoming
输出可能包含（左边变体、右边别名不变）：
[email protected]|xiaoming
[email protected]|xiaoming
[email protected]|xiaoming
6.2 变体生成的使用流程
在「变体生成」页选择 mail.txt（里面同样是 邮箱|别名 每行一条）
选择输出文件路径
点击「开始生成」
把输出 TXT 拿到「邮箱队列」页导入
[image: 1775811930307-198f49c8-d30f-4ec5-800d-af29f24d779d-image.jpeg]
[image: 1775812777724-88ba8bbd-f96c-4142-926c-a1839d079bb4-image.jpeg]
7. 第三步：启动 HTTP 服务（给脚本/注册机调用）
进入「总览与设置」页
点击「启动 HTTP 服务」
复制页面显示的 URL 给脚本使用：
DIY_GET_EMAIL_ADDRESS：/icloud
DIY_GET_OPT_ADDRESS：/get_otp?alias=（注意是前缀，后面再拼 alias）
[image: 1775811988210-c9316d1a-fb0a-4c84-bdae-086dc3526023-image.jpeg]
[image: 1775812003947-2923601f-38ff-479a-8b3c-487668185803-image.jpeg]
8. /icloud 与 /get_otp 返回说明（给外部调用接口人员看）
8.1 GET /icloud
正常返回（示例）：
{"status":200,"icloud":"
[email protected]","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（用于统计“这个账号究竟接码了多少次”）
[image: 1775812060819-04bfbf01-6c99-4443-bd22-3279088b90e6-image.jpeg]
10. 常见问题（小白排查）
10.1 一直拿不到邮箱
看「邮箱队列」是否为空
看是否全部处于账号冷却中（脚本会收到 cooldown=true 和 min_wait_seconds）
确认已启动 HTTP 服务、URL/端口填写正确
10.2 /get_otp 返回 die
含义：token 失效（不是“收不到邮件”）。
解决：回到「Gmail 账号」页重新 OAuth 授权并保存 token。
11. 使用效果，一个邮箱可以多次使用接码，从而节省邮箱费用
[image: 1775812642199-858ae8d5-210e-469c-9735-883b9ae4a9ca-image.jpeg]
