Source Code

Email Send

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

🚀 快速使用

# 发送简单邮件
python3 scripts/send_email.py \
  --to [email protected] \
  --subject "Meeting Tomorrow" \
  --body "Hi, let's meet at 2pm tomorrow."

# 发送 HTML 邮件
python3 scripts/send_email.py \
  --to [email protected] \
  --subject "Weekly Report" \
  --body "<h1>Report</h1><p>Here are the updates...</p>" \
  --html

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

# 指定使用 Resend
python3 scripts/send_email.py \
  --to [email protected] \
  --subject "Test" \
  --body "Hello" \
  --provider resend

⚙️ 配置

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

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

{
    "resend_api_key": "re_xxxxx",
    "resend_from": "[email protected]"
}

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

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

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

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

两个都配（自动 fallback）

{
    "resend_api_key": "re_xxxxx",
    "resend_from": "[email protected]",
    "host": "smtp.163.com",
    "port": 465,
    "user": "[email protected]",
    "password": "your-auth-code",
    "from": "[email protected]",
    "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：免费账户只能发给注册邮箱，需要验证域名才能发给其他人

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

smtp-send