全功能邮件管理助手

为什么需要它

在 Agent 或自动化脚本里处理邮件，常见做法是堆 requests 调各家 REST API，或引入较重的第三方库。本技能走另一条路：只用 Python 标准库 smtplib 与 imaplib，在本地脚本里完成 SMTP 发信与 IMAP 收信，不增加 requirements.txt 里的依赖项。

能力概览

发送侧（scripts/send_email.py）：纯文本或 HTML 正文（也可传 HTML 文件路径）、多附件、内嵌图片、多收件人与抄送/密送、回复/转发、高优先级；发送失败时可配置重试。

接收与管理侧（scripts/mail_client.py）：列出文件夹与邮件、分页、仅未读；按主题、发件人、收件人、日期、未读状态搜索；查看正文、HTML、附件列表与回复链；批量删除、标记已读/未读/星标、移动文件夹；单个或全部附件落盘；支持 JSON 输出便于下游程序消费。

配置识别（scripts/email_config.py）：根据邮箱域名自动匹配 SMTP/IMAP 主机与端口，覆盖 163、QQ、126、Gmail、Outlook、阿里云等 30+ 域名；详细表见 references/email_providers.md。

典型流程：先用配置脚本确认服务器参数 → 在网页邮箱开启 POP3/SMTP/IMAP 并拿到授权码/应用密码（多数厂商不接受登录密码）→ 再调用发送或 mail_client 子命令。

边界与注意点

• 认证失败多半是用了账户密码而非授权码；Gmail 等需两步验证下的应用密码。
• 端口与加密要一致：常见 465 用 SSL，587 用 STARTTLS。
• 163/126/Yeah：IMAP 可能报「Unsafe Login」；脚本内置 ID 命令缓解，仍失败时需网页端确认 IMAP 已开并授权。
• 文件夹名因服务商而异，移动或 select 前先用 folders 查看实际名称。