QQ邮箱管理器

解决什么问题

QQ 邮箱的命令行处理容易踩两个坑：一是 mail_id 只在单个文件夹内唯一，跨文件夹操作时如果只按编号去重，可能误删、误移或重复发送；二是删除、移动、发送属于破坏性动作，脚本如果没有确认与预览，很容易把错误结果直接执行掉。

如何工作

该技能把 QQ 邮箱管理收敛为一组明确脚本，覆盖 列出文件夹、浏览/搜索邮件、查看邮件详情、下载附件、标记已读/未读、移动/删除邮件 和 发送邮件。

• 唯一定位：所有操作都必须使用 folder + mail_id 组合定位邮件，不能只用 mail_id。
• 先预览再执行：删除、移动和发送前，先展示 folder、mail_id、主题、发件人、日期等关键信息，用户确认后再执行。
• 分页克制：每次只发起一次 search_emails，当结果 has_more=true 时提示用户是否翻页，而不是自动继续调用。
• 发送更稳：正文包含换行、引号、HTML 或内容较长时，优先使用 --body-file 与 --subject-file，减少命令行转义问题。

边界与注意

• 需要先在 QQ 邮箱开启 IMAP/SMTP，并配置邮箱地址与授权码，而不是登录密码。
• 删除邮件实际上是移至垃圾箱，不支持永久删除。
• 语义搜索只在用户明确提出语义搜索意图时调用；普通关键词、字段或日期筛选走 search_emails。
• 遇到脚本返回 error 或 partial 状态时，应停止后续破坏性操作并告知用户。