GoToEmail

绑定流程

第一步：确认邮箱类型

⚡ 推荐（授权码方式）
  1. 163邮箱 / 126邮箱 / yeah.net
  2. QQ邮箱 / Foxmail

其他方式
  3. Gmail              — App 密码
  4. 雅虎邮箱 (Yahoo)   — App 密码
  5. 企业邮箱           — 自定义 IMAP/SMTP

❌ 不支持：Outlook / M365 / iCloud（OAuth 类，请在宿主应用中配置）

第二步：引导获取授权码

授权码/App密码获取步骤见 references/providers.md 的「授权码获取指南」节。

第三步：收集凭据

• 163 / QQ / Yahoo / Gmail：邮箱地址 + 授权码/App密码
• 企业邮箱：额外收集 IMAP服务器、IMAP端口（默认993）、SMTP服务器、SMTP端口（默认465）

第四步：测试连接

通过 stdin 传入 JSON 运行脚本：

echo '{"email":"user@163.com","password":"授权码"}' | python scripts/test_connection.py

企业邮箱需额外传入自定义服务器：

echo '{"email":"user@corp.com","password":"pass","imap_host":"imap.corp.com","smtp_host":"smtp.corp.com"}' | python scripts/test_connection.py

• 返回 {"ok":true,...} → 绑定成功，告知用户并保存配置
• 返回 {"ok":false,"error":"..."} → 根据错误信息排查（见 references/providers.md 错误处理节）

邮件操作

获取邮件列表

echo '{"email":"...","password":"...","imap_host":"imap.163.com","imap_port":993,"folder":"INBOX","limit":20,"unread_only":false}' | python scripts/list_emails.py

返回字段：uid、subject、from、date、unread

读取单封邮件

echo '{"email":"...","password":"...","imap_host":"imap.163.com","uid":"1234","mark_as_read":true}' | python scripts/read_email.py

返回字段：subject、from、to、date、body（纯文本）、attachments

发送邮件

echo '{"email":"...","password":"...","smtp_host":"smtp.163.com","smtp_port":465,"to":"收件人@example.com","subject":"主题","body":"正文内容"}' | python scripts/send_email.py

to 接受字符串或列表；可选字段：cc、bcc、html_body

服务器快速参考

企业邮箱：用户自定义，全程 SSL/TLS。

👉 完整授权码获取步骤与错误排查见 references/providers.md