技能介绍

要解决什么问题

在 Agent 或 Gateway 里，你往往只想用一句话完成「查收件箱」「给某人发通知」「按主题搜邮件」或「把附件落到本地」，而不是每次打开网页邮箱或手写一套 IMAP/SMTP 脚本。本技能把常见邮箱操作封装成可对话触发的流程，底层仍是标准 IMAP / SMTP 协议，不依赖网页登录。

核心能力怎么工作

配置：交互向导或手写 .env，按邮箱类型填写主机、端口与账号；Gmail 需 App Password，163/QQ 等需 授权码（不是网页登录密码）。
收信与检索：通过 node imap.js check 查看最近或未读邮件，可用 --recent 2h 限定时间；search 支持按发件人、主题等条件查找；fetch 拉取单封正文。
发信：node smtp.js send 支持纯文本、HTML（--html）、多收件人（逗号分隔）及 --attach 附件。
本地管理：download 将指定邮件附件写入允许目录（需在 ALLOWED_WRITE_DIRS 中配置）；mark-read 标记已读。

自然语言侧可用「查收件箱」「发邮件给 xxx」「搜索 xxx 的邮件」「下载附件」「配置邮箱」等说法唤醒，由技能映射到上述 CLI。

边界与注意点

必须在邮箱服务商处开启 IMAP/SMTP；不支持仅靠网页会话登录。
不支持定时发送、发送后删除对方邮件、营销式千人千面群发；附件大小受各厂商限制（如 Gmail 约 25MB）。
连接失败时优先核对主机/端口、是否用对密码类型，以及国内邮箱开启服务后可能需要等待数分钟生效。可与 html-mail-goose 搭配生成 HTML 正文后再发送。