GoToEmail#

绑定流程#

第一步：确认邮箱类型#

text

⚡ 推荐（授权码方式）
  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 运行脚本：

bash

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

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

bash

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 错误处理节）

---

邮件操作#

获取邮件列表#

bash

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

读取单封邮件#

bash

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

发送邮件#

bash

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

---

服务器快速参考#

提供商IMAP 服务器:端口SMTP 服务器:端口163邮箱imap.163.com:993smtp.163.com:465126邮箱imap.126.com:993smtp.126.com:465QQ邮箱imap.qq.com:993smtp.qq.com:465Gmailimap.gmail.com:993smtp.gmail.com:465雅虎imap.mail.yahoo.com:993smtp.mail.yahoo.com:465

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

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