qqmail

QQ Mail Manager是一款专为QQ邮箱设计的自动化管理工具，通过标准IMAP/SMTP协议实现邮件的全面管理。用户只需在QQ邮箱设置中开启IMAP服务并获取授权码，配置环境变量后即可通过命令行高效处理邮件事务。

核心用法涵盖完整的邮件生命周期管理：支持读取收件箱最新邮件并预览内容，查看指定索引的完整邮件详情；发送功能不仅支持纯文本邮件，还允许添加附件，满足办公文档传输需求；强大的搜索功能可按主题、发件人或日期范围精准定位历史邮件；同时支持查看所有文件夹列表及指定文件夹的邮件读取，实现多邮箱分类管理。

该技能的显著优势体现在安全架构与轻量设计的完美结合。采用纯Python标准库实现（imaplib、smtplib等），零外部依赖避免了第三方包的安全风险与版本冲突。通信全程使用SSL/TLS加密，确保邮件内容传输安全。凭据管理采用环境变量注入方式（QQMAIL_USER与QQMAIL_AUTH_CODE），杜绝硬编码密码的安全隐患，且具备完善的错误处理机制，不会因异常而暴露敏感信息。

然而，该技能也存在一定局限性。首先，作为T3来源（社区/个人开发者）项目，虽经安全审查但仍建议用户自行审查代码。其次，功能仅限于QQ邮箱生态，不支持其他邮件服务商。配置门槛方面，用户必须手动开启QQ邮箱的IMAP/SMTP服务并理解"授权码"与登录密码的区别，对非技术用户存在一定学习成本。此外，频繁发送邮件可能触发QQ邮箱的反垃圾机制。

该工具最适合需要自动化处理QQ邮箱的技术从业者、开发者及办公效率爱好者。特别是需要定期备份邮件、批量发送通知、自动化邮件归档的场景。对于依赖QQ邮箱作为主要工作邮箱，且希望在命令行或自动化工作流中集成邮件功能的用户价值显著。

使用风险主要包括：授权码作为敏感信息需妥善保管，避免泄露导致邮箱被非法访问；发送附件时需仔细核对文件路径，防止误发敏感文件；由于使用标准IMAP协议，大量频繁操作可能导致IP被临时限制；建议定期更换授权码以维持账户安全。

核心功能

QQ Mail Manager 是一款通过标准 IMAP/SMTP 协议管理 QQ 邮箱的自动化工具。该 Skill 基于 Python 标准库实现，无需安装任何第三方依赖，支持完整的邮件生命周期管理：读取收件箱、发送邮件（含附件）、按主题/发件人/日期搜索邮件、浏览文件夹结构等操作。

显著优点

安全架构设计优异：凭据管理采用环境变量注入机制（QQMAIL_USER + QQMAIL_AUTH_CODE），完全避免硬编码密码风险；网络连接严格限定于腾讯官方服务器（imap.qq.com:993、smtp.qq.com:465），全程 SSL/TLS 加密传输，无第三方数据泄露风险。

零依赖供应链安全：仅使用 Python 3 标准库（imaplib、smtplib、email、ssl 等），彻底消除第三方包供应链攻击隐患，部署简单且可审计性强。

中文环境适配：内置 Windows 控制台 UTF-8 编码自动修复，确保中文邮件内容正确显示；支持自动字符集检测解码，兼容多种邮件编码格式。

潜在局限

输入验证待加强：附件发送功能仅检查文件存在性，未限制文件类型、大小或读取权限，存在误读系统文件的理论风险（实际危害低）。

错误反馈粒度不足：IMAP/SMTP 错误统一返回通用提示，未细分网络故障、认证失败、服务器异常等场景，故障排查效率受限。

许可证信息缺失：元数据未声明开源协议，用户权利边界不明确。

适用人群

• 需要自动化处理 QQ 邮箱的国内用户
• 重视供应链安全、拒绝第三方依赖的企业环境
• 中文邮件处理场景占比高的工作流

常规风险提示

需使用 QQ 邮箱「授权码」而非登录密码，首次配置需在网页端开启 IMAP/SMTP 服务；建议设置单文件大小限制（如25MB）防止异常附件传输；环境变量凭据需妥善保管，避免在共享环境明文暴露。