技能介绍

要解决什么问题

在 Agent 或终端环境里，你往往需要的是可脚本化的邮件操作：查未读、按条件搜索、拉取正文与附件、标记已读，以及用 SMTP 发出带抄送和附件的邮件——而不是打开网页客户端点来点去。本技能面向标准 IMAP/SMTP 协议，覆盖 Gmail、Outlook、网易系（163/126/188 等）、QQ 邮箱及自建服务器，并支持多账号在同一套配置里用 --account 切换。

核心能力怎么组织

收信（IMAP） 侧提供 check（未读/时间窗/--unseen）、fetch（按 UID 取全文）、search、mark-read / mark-unread、list-mailboxes，以及 download 拉取附件（可指定目录或单个文件）。文档建议 Agent 在 fetch 后按业务语义标出可能需要你立刻处理的邮件（账单、合同、待审批、高优先级等），终端里以 [!] 前缀便于扫读。

发信（SMTP） 侧用 send：必填 --to 与 --subject（或 --subject-file），正文可用 --body / --body-file，HTML 用 --html / --html-file，另有 --cc、--bcc、--attach 与 test 自检连接。

配置写在 ~/.config/mail-skills/.env（与 caldav-sync 共用，技能更新不丢）；若存在旧路径 ~/.config/imap-smtp-email/.env 会优先使用，可用 setup.sh 迁移。多账号通过在变量名前加大写前缀（如 WORK_PROVIDER）区分；ALLOWED_READ_DIRS / ALLOWED_WRITE_DIRS 为全局共享。

适用边界与注意点

Gmail 不能用登录密码，需开启两步验证并生成 App Password 作为 IMAP_PASS / SMTP_PASS。
163.com 等网易邮箱需先在网页开启 IMAP/SMTP，密码栏填授权码，不是登录密码。
连接失败时对照主机/端口与 IMAP_TLS、SMTP_SECURE；自签证书可设 IMAP_REJECT_UNAUTHORIZED=false 等（需自行权衡风险）。
配置文件权限应为 600，避免凭据泄露。