osascript-email

通过 Mail.app 使用 AppleScript 发送邮件。无需密码或 API 密钥 — 认证由 Mail.app 自动处理。

前提条件

• 已安装 Mail.app 的 macOS 系统
• Mail.app 中至少已配置一个电子邮件账户
• 请确认发件人地址与 Mail.app 中已配置的账户一致
• 授权说明：本能力通过 Mail.app 静默发送邮件。仅可在获得用户明确同意的前提下使用；严禁在用户不知情的情况下代其发送邮件。

快速发送（exec）

使用 exec 执行内联 osascript 命令。下方脚本为标准模板 — 请完整复制，再替换对应字段值。

osascript << 'APPLESCRIPT'
tell application "Mail"
  set m to make new outgoing message with properties {subject:"YOUR SUBJECT", content:"YOUR BODY", visible:false}
  tell m
    make new to recipient with properties {address:"recipient@example.com"}
    make new to recipient with properties {address:"cc@example.com"}
  end tell
  send m
end tell
return "sent"
APPLESCRIPT

转义规则：

• 主题（subject）或正文（content）中如含双引号，需转义： "
• 反斜杠需写为两个： \
• 正文中如需换行，请使用 n（AppleScript 将字符串中的字面换行符视为正文内容）

Python 辅助函数（适用于 agent 脚本）

当从 Python 定时任务脚本或 agent 工作流中发送邮件时使用。请直接复制 scripts/send_email.py 中的函数 — 不要自行重写。

from scripts.send_email import send_email

send_email(
    subject="Daily Report — 2026-01-01",
    body="Here is the summary...",
    to="primary@example.com",
    cc="secondary@example.com",       # 可选
    sender="your-mail-app-account@icloud.com"  # 必须与 Mail.app 中配置的账户一致
)

完整实现请参见 scripts/send_email.py。

多收件人

在 tell m 代码块内添加额外的 make new to recipient 行即可：

make new to recipient with properties {address:"a@example.com"}
make new to recipient with properties {address:"b@example.com"}

故障排查

限制

• 仅支持纯文本格式（不支持 HTML、不支持内嵌图片）
• 可添加附件，但需额外 AppleScript 代码 — 具体请参见 references/attachments.md
• 发送频率：Mail.app 会排队并异步发送；不适用于批量发送（超过 10 封）
• 发件人必须是 Mail.app 中已配置的有效账户 — 不支持伪造任意发件地址