用途:email-skill 是统一邮件编排入口,通过一个脚本暴露全部邮件能力,支持平台公邮(platform)与个人邮箱 IMAP/SMTP(personal)两种通道并存,由用户按场景自主选择。
主要能力:platform 为消息推送通道,无需配置 SMTP/IMAP,开箱即用,可检查绑定、发送验证码、校验绑定、发送纯文本邮件;但仅能发给用户本人有登录权限的邮箱,不支持 HTML、收件检索、附件、抄送密送。personal 使用个人邮箱凭据,可发给任意收件人,支持 SMTP 发信(含抄送、密送、附件)、IMAP 收信/检索/读取详情、附件下载、状态管理与文件夹枚举。
使用方式:macOS/Linux 入口为 scripts/unix/email_gateway.sh,Windows 为 scripts\windows\email_gateway.cmd。查看能力用 capabilities;发信用 send,platform 需 --provider platform --email --subject --body --content_type "text",personal 用 --provider personal --to --subject --body。公邮发信前必须先 bind-check,未绑定再执行 bind-send-code 与 bind-verify。personal 需进入 imap-smtp-email 目录执行 npm install,并运行 setup-personal 生成 .env。收件能力命令包括 inbox-check、inbox-search、inbox-fetch、inbox-download。
适用场景:platform 适合把天气、报告、汇总推送到自己邮箱;personal 适合发给同事客户、收件管理、附件与抄送密送需求。
限制:platform 不能发给他人、不支持 HTML 与收件;personal 需本机 node 与 .env 配置。脚本依赖 node 和 curl,macOS/Linux 优先 jq,不可用时回退 node。定时发信任务须提前完成绑定。公邮额度耗尽时可自动切换 personal。公邮主题与正文优先使用 UTF-8。