myemail 小白使用说明
本文给第一次使用的用户看:按步骤操作即可跑起来。


1.下载

2. 这软件是做什么的?
本软件在本机启动一个 HTTP 服务,给外部脚本/注册机调用,完成两件事:
- 派发一条队列邮箱:
GET /icloud(返回 icloud 和 link)
- 按别名取验证码:
GET /get_otp?alias=xxx(返回 otp)

3. 必懂名词(非常重要)
- 别名(alias):可以理解成「这把 Gmail 钥匙在本软件里的名字」。规定:填该邮箱
@ 前面的那一段。
例:[email protected] 的别名就是 xiaoming。
- 邮箱队列:每行格式为
邮箱|别名。
左边“邮箱”用于对外返回/展示(可以是变体),右边“别名”用于在本机找到对应 Gmail token 来取码(必须和 Gmail 账号页里保存的别名一致)。
- 账号冷却(秒):同一个 Gmail 账号(按别名)两次被分配之间要间隔的时间,让账号“休息”。0 表示关闭。
4. 第一步:添加 Gmail 账号(保存 token)
- 打开软件 → 进入「Gmail 账号」页
- 选择你的
credentials.json(Google Cloud 下载)
- 在“别名”输入框填写
@ 前缀(例:xiaoming)
- 点击「浏览器登录并保存 token」完成授权
- 刷新列表,看到该别名出现即成功

5. 第二步:准备邮箱队列 TXT(核心数据来源)
邮箱队列的 TXT 每行必须是:
邮箱|别名
示例:
[email protected]|xiaoming
[email protected]|lammychau7
然后在「邮箱队列」页点击「从 TXT 追加导入…」导入即可。

6. 变体生成(一定要说明清楚:只为了生成队列 TXT)
变体生成不是用来登录 Gmail 的,也不是用来“增加账号”的。
变体生成的唯一目的:输出一份给「邮箱队列」导入用的 TXT 文件,让队列里出现同一个邮箱的多种大小写写法(变体),方便下游填写/测试/批量跑任务。
6.1 变体生成会改哪里?
- 只改左边“邮箱”(例如大小写变化)
- 右边“别名”完全不变
举例:输入原始行:
[email protected]|xiaoming
输出可能包含(左边变体、右边别名不变):
[email protected]|xiaoming
[email protected]|xiaoming
[email protected]|xiaoming
6.2 变体生成的使用流程
- 在「变体生成」页选择
mail.txt(里面同样是 邮箱|别名 每行一条)
- 选择输出文件路径
- 点击「开始生成」
- 把输出 TXT 拿到「邮箱队列」页导入


7. 第三步:启动 HTTP 服务(给脚本/注册机调用)
- 进入「总览与设置」页
- 点击「启动 HTTP 服务」
- 复制页面显示的 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":"[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(用于统计“这个账号究竟接码了多少次”)

10. 常见问题(小白排查)
10.1 一直拿不到邮箱
- 看「邮箱队列」是否为空
- 看是否全部处于账号冷却中(脚本会收到
cooldown=true 和 min_wait_seconds)
- 确认已启动 HTTP 服务、URL/端口填写正确
10.2 /get_otp 返回 die
含义:token 失效(不是“收不到邮件”)。
解决:回到「Gmail 账号」页重新 OAuth 授权并保存 token。
11. 使用效果,一个邮箱可以多次使用接码,从而节省邮箱费用
