核心功能与用法
QQ Mail Manager 是一款基于 Python 标准库实现的命令行邮箱管理工具，通过 IMAP/SMTP 协议与 QQ 邮箱服务器通信。用户需先在 QQ 邮箱网页端开启 IMAP/SMTP 服务并获取授权码（非登录密码），配置 QQMAIL_USER 和 QQMAIL_AUTH_CODE 环境变量后即可使用。
主要操作包括：
- 收件管理：读取收件箱、查看指定邮件全文、列出所有文件夹
- 发件功能：发送纯文本邮件，支持附件上传
- 智能搜索：可按主题、发件人、日期范围组合筛选邮件
- 中文支持：内置字符集检测，确保中文邮件内容正确解码
显著优点：
1. 零依赖部署：仅依赖 Python 3 标准库，无需 pip 安装第三方包
2. 跨平台兼容：支持 Windows、Linux、macOS
3. 协议标准：采用成熟的 IMAP/SMTP 协议，非私有 API，稳定性高
4. 安全认证：使用授权码机制，避免明文存储 QQ 主密码
潜在局限与风险：
- 网络依赖：QQ 邮箱服务器对境外 IP 或代理环境可能存在连接限制
- 功能边界：不支持 HTML 邮件编辑、邮件标记/移动、通讯录同步等高级功能
- 认证流程：首次配置需用户手动登录网页端开启服务并获取授权码，门槛较高
- 授权码时效：QQ 邮箱授权码长期有效，但用户主动修改密码或安全设置后会失效
适合人群：
- 需要自动化处理 QQ 邮箱的技术人员、开发者
- 偏好命令行工具、追求轻量级方案的用户
- 需在服务器环境批量发送通知邮件的场景
常规风险提示：
授权码需妥善保管，避免硬编码在脚本中；建议通过环境变量或密钥管理服务注入。IMAP 操作仅读取邮件，不会自动删除或修改服务器数据，但发送邮件操作不可逆。