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/modules/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。将营销推广活动与该交易发件人分开，以便时事通讯活动不会中断帐户验证邮件。
让事务性投递保持独立
邮件模块处理事务性产品消息，包括认证与任务完成通知。营销触达属于使用方产品自己的工作流，必须与这条事务性路径保持分离。
配置投递适配器
确定性测试用本地适配器。启用外部投递前，配置选定的生产适配器及其服务端凭证。绝不要把邮件供应商密钥放进客户端配置或日志。
独立记录投递结果
生成的结果与它的完成邮件是两个独立结果。在声称消息发送成功之前检查投递记录。测试投递失败时，不要把它当作生成失败，也不要重复提交模型工作。