用途:根据主题、正文和收件人构建 RFC 5322 草稿邮件,可按需将本地文件作为 MIME 附件加入,并通过 IMAP APPEND 追加到指定邮箱(默认草稿箱),保持未发送状态。
主要能力:可设置抄送、密送、发件人、内容类型(plain 或 html)、Message-ID、In-Reply-To、References;可指定目标邮箱与追加标志(默认 \Draft);支持每个附件的最大字节限制;支持 ID 信息、收件人计数和附件元数据等 JSON 输出,成功时给出 append_uidvalidity 和 append_uid。
使用方式:先配置 IMAP 环境变量(IMAP_HOST、IMAP_USERNAME、IMAP_PASSWORD 等),可参考 assets/config.example.env 与 references/env.md;用 check-config 校验配置,再用 append-draft 追加草稿,例如:
python3 scripts/imap_append.py append-draft --to reviewer@example.com --subject "Draft: quarterly update" --body "Please review this draft before sending."
支持 --mailbox、--flags、--content-type html、--attach 等参数。
输出契约:check-config 输出脱敏后的 JSON;append-draft 成功输出 type=status,失败向 stderr 输出 type=error 的 JSON。
适用场景:需要由智能体或脚本准备待审草稿而非直接发送的邮件工作流。
限制:必须提供有效 IMAP 凭据;不负责实际发送邮件;具体服务器兼容性与权限约束未在资料中说明。