#邮件配置

V1 支持两种发件方式：Resend 与 MailPort。二选一配置即可。

#选择规则

1. 显式设置 MAIL_PROVIDER=resend 或 MAIL_PROVIDER=mailport → 使用指定的
2. 未设置时：只配了 Resend → 用 Resend；只配了 MailPort → 用 MailPort；两套都配 → 默认 Resend
3. 两套都不完整 → /api/health 为 degraded，提交评论返回 mail_not_configured

若 MODERATION_REQUIRED=false，所有发件变量都会被忽略，系统不发任何邮件。

#Resend

RESEND_API_KEY=re_xxxxxxxx
RESEND_FROM=GitPigeon <noreply@yourdomain.com>

1. 在 Resend 注册并添加发件域名
2. 完成 DNS 验证（SPF / DKIM）
3. 创建 API Key
4. RESEND_FROM 的域名必须是已验证域名，否则发信会被拒

#MailPort

MAILPORT_BASE_URL=https://mail.yourdomain.com
MAILPORT_PID=a1b2c3
MAILPORT_API_KEY=<32 位密钥>

1. 部署一份 MailPort
2. 在控制台创建发件商，拿到 pid
3. 为发件商生成 32 位 API 密钥
4. 把博客审核邮箱加入该发件商的收件域名白名单

MailPort 的 from 在发件商控制台配置，V1 不会透传 from 字段。

#审核邮件内容

• 主题：[评论待审] <文章> · <昵称>
• 正文：文章、昵称、时间、评论内容
• 一个「查看并批准」链接，凭据放在 URL fragment 中，7 天有效

#邮件可达性

审核邮件能否进收件箱取决于发件域名信誉。建议：

• 使用自有域名而不是免费邮箱地址
• 完成 SPF / DKIM / DMARC
• 首次部署先给自己发一封测试

#V2 方向

V2 计划支持通过一个 JSON 数组配置多个发件方式，按顺序轮询，一个失败换下一个，并支持 MailPort 透传 from。V1 不读取该配置。