For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/email.md (or send Accept: text/markdown).
电子邮件
事务模板、预览工具与提供商适配器。
阅读您的第一条本地消息，然后启用传送
事务性电子邮件是指由应用程序操作触发的消息，例如登录代码或任务结果。 Web 服务器运行时，将 EMAIL_PROVIDER=local 保留在 apps/web/.env.local. 中 完成数据库设置，在 /auth 请求登录代码，然后打开 /mail-preview 并检查最新消息。此处显示的本地消息不是发送到您的外部收件箱的电子邮件。
要发送真实消息，请选择一个电子邮件提供商，创建其帐户，验证您控制的域并遵循其专用指南。将名为API的密钥和发件人地址放入apps/web/.env.local中，保存并重新启动Web服务器。请求一个新的登录代码，然后检查提供商的传送日志和目标收件箱，包括垃圾邮件。域验证和发件人批准可能需要时间。
如果消息失败，请在重复请求之前检查传送错误和发件人验证。 /mail-preview 路由仅用于开发，在生产中返回 404。将营销推广活动与该交易发件人分开，以便时事通讯活动不会中断帐户验证邮件。
让事务性投递保持独立
邮件模块处理事务性产品消息，包括认证与任务完成通知。营销触达属于使用方产品自己的工作流，必须与这条事务性路径保持分离。
配置投递适配器
确定性测试用本地适配器。启用外部投递前，配置选定的生产适配器及其服务端凭证。绝不要把邮件供应商密钥放进客户端配置或日志。
独立记录投递结果
生成的结果与它的完成邮件是两个独立结果。在声称消息发送成功之前检查投递记录。测试投递失败时，不要把它当作生成失败，也不要重复提交模型工作。
安装与配置
EMAIL_PROVIDER=local 让开发期间的投递保持确定性。生产投递从已配置的适配器中选一个 —— Resend（RESEND_API_KEY）、AWS SES（AWS_REGION 加访问密钥）、Postmark、SendGrid、Mailgun、通用 SMTP 或 Brevo —— 并确认 EMAIL_FROM 与该供应商认可的发件身份一致。
所有模板位于 src/transactional-mail-templates.ts。仅开发可用的 /mail-preview 路由会渲染每个模板，让改动通过可视化审查，而不是靠真实发信。
EMAIL_PROVIDER=resend
EMAIL_FROM=Your Product <[email protected]>实现流程
认证代码、魔法链接、邀请、计费通知和任务完成邮件都通过同一个事务发送者,以已解析语言环境的文本发送。外展活动是独立的产品关注点,永远不会共享此路径。
在编辑文本或布局之前先在 mail-preview 中预览模板;让品牌值(名称、颜色、徽标拼块)来自配置,这样衍生产品可以在不 fork 模板的情况下重新设计样式。
验证与排障
在测试中对本地适配器记录的消息进行断言 —— 收件人、主题和渲染后的正文。发送失败应表现为投递结果,而不是崩溃的工作流。使用带 REAL_SMOKE_EMAIL_ALLOWED_DOMAIN 的可选 smoke 路径进行真实投递。