QQ Mail Manager

通过 Python 脚本，使用标准 IMAP/SMTP 协议管理 QQ邮箱。

前提条件

用户需在 QQ 邮箱设置中启用 IMAP/SMTP 服务，并获取授权码（授权码）：

1. 登录 mail.qq.com → 设置（设置）→ 账户（账户）
2. 启用 IMAP/SMTP 服务
3. 生成授权码（授权码）——该授权码 不是 QQ 密码

配置

该功能从环境变量读取凭据：

• QQMAIL_USER — QQ 邮箱地址（例如：123456789@qq.com）
• QQMAIL_AUTH_CODE — QQ 邮箱设置中生成的授权码（授权码）

支持的操作

读取最近的邮件

python3 {baseDir}/scripts/qqmail.py inbox --limit 10

显示：发件人、主题、日期，以及每封邮件的纯文本预览内容。

按索引读取指定邮件

python3 {baseDir}/scripts/qqmail.py read --index 1

显示整封邮件的完整内容（纯文本正文）。

发送邮件

python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Hello" --body "Email content here"

带附件发送邮件

python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Report" --body "See attached" --attachment "/path/to/file.pdf"

搜索邮件

python3 {baseDir}/scripts/qqmail.py search --subject "keyword"
python3 {baseDir}/scripts/qqmail.py search --from "sender@example.com"
python3 {baseDir}/scripts/qqmail.py search --since "2026-01-01"
python3 {baseDir}/scripts/qqmail.py search --subject "meeting" --since "2026-02-01" --limit 5

列出邮箱文件夹

python3 {baseDir}/scripts/qqmail.py folders

从指定文件夹读取邮件

python3 {baseDir}/scripts/qqmail.py inbox --folder "Sent Messages" --limit 5

错误处理

• 若认证失败：请确认 QQMAIL_USER 和 QQMAIL_AUTH_CODE 已正确设置。
• 若 IMAP 未启用：请引导用户前往 QQ 邮箱设置中启用 IMAP 服务。
• 连接错误可能表示存在网络问题或需要配置代理。

说明

• QQ 邮箱 IMAP 服务器：imap.qq.com:993（SSL）
• QQ 邮箱 SMTP 服务器：smtp.qq.com:465（SSL）
• 所有脚本仅依赖 Python 3 标准库（无需执行 pip install）。
• 邮件内容采用自动字符集检测解码，确保中文正常显示。