Email Send

发送邮件，支持 SMTP 和 Resend API 两种方式。

🚀 快速使用

# 发送简单邮件
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Meeting Tomorrow" \
  --body "Hi, let's meet at 2pm tomorrow."

# 发送 HTML 邮件
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Weekly Report" \
  --body "<h1>Report</h1><p>Here are the updates...</p>" \
  --html

# 发送带附件的邮件
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Documents" \
  --body "Please find the attached files." \
  --attachments report.pdf,data.csv

# 指定使用 Resend
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Test" \
  --body "Hello" \
  --provider resend

⚙️ 配置

在 ~/.smtp_config 中配置（二选一或两个都配）：

方式 1: Resend API（推荐，更简单）

{
    "resend_api_key": "re_xxxxx",
    "resend_from": "you@your-domain.com"
}

获取 API key: https://resend.com

注意：免费账户只能发给注册邮箱，要发给其他人需要验证域名。

方式 2: SMTP（163/QQ/Gmail 等）

{
    "host": "smtp.163.com",
    "port": 465,
    "user": "your-email@163.com",
    "password": "your-auth-code",
    "from": "your-email@163.com",
    "use_ssl": true
}

两个都配（自动 fallback）

{
    "resend_api_key": "re_xxxxx",
    "resend_from": "you@your-domain.com",
    "host": "smtp.163.com",
    "port": 465,
    "user": "your-email@163.com",
    "password": "your-auth-code",
    "from": "your-email@163.com",
    "use_ssl": true
}

配置完后设置权限：

chmod 600 ~/.smtp_config

📋 参数

| 参数 | 必填 | 说明 | |------|------|------| | --to | ✅ | 收件人邮箱 | | --subject | ✅ | 邮件标题 | | --body | ✅ | 邮件内容 | | --html | ❌ | 以 HTML 格式发送 | | --attachments | ❌ | 附件路径，多个用逗号分隔 | | --provider | ❌ | auto/smtp/resend（默认 auto） |

🔄 Provider 选择逻辑

• auto（默认）：优先 Resend，失败则 fallback 到 SMTP
• smtp：强制使用 SMTP
• resend：强制使用 Resend API

📧 常见 SMTP 配置

| 邮箱 | Host | Port | SSL | |------|------|------|-----| | 163 | smtp.163.com | 465 | true | | QQ | smtp.qq.com | 465 | true | | Gmail | smtp.gmail.com | 587 | false | | Outlook | smtp.office365.com | 587 | false |

注意：163/QQ/Gmail 都需要使用授权码而非登录密码。

🔐 安全

• 凭据存储在 ~/.smtp_config，权限应设为 600
• API key 和密码不会出现在命令行参数中
• 配置文件不应提交到版本控制

🐛 常见问题

认证失败：检查授权码是否正确，是否开启了 SMTP 服务

Resend 403：免费账户只能发给注册邮箱，需要验证域名才能发给其他人

连接超时：检查网络，或者端口是否被防火墙拦截