SuperAPI AI 工具集

transactional-email

办公与效率

查看项目

更新于 10-16 09:50

技能介绍

用途:在 Cloudflare Workers 中编写并发送事务性邮件,例如欢迎邮件、首次部署通知、其他通知类邮件。资料强调邮件应像个人手写,而非营销团队设计,使用纯 HTML 模板字符串,通过 Cloudflare 的 send_email 绑定发送,并在发布前以明亮与暗色模式预览。

主要能力与规则:每封邮件必须设置 reply_to,因为发送子域名通常没有 MX 或 A 记录,对该地址的回复会静默退回,而邮件文案又鼓励回复。reply-to 地址由用户选择,不可猜测,确定后写入项目 AGENTS.md。写作风格要求:无标题(h1/h2)、无 logo 头部、无 URL 卡片、无 hr 分隔线、无品牌页脚;只用加粗、链接、列表、行内代码;以“Hey,”开头,以“If anything looks off, just reply to this email”结尾并署名;主题为普通句子。样式对齐 Gmail 默认,内容宽度最大 600px。需包含 color-scheme meta 和一个 prefers-color-scheme 块。

使用方式:用纯模板字符串构建 HTML,不用 React/JSX;对插值做 escapeHtml。通过 Cloudflare send_email 绑定发送(wrangler.jsonc 中配置 send_email,remote: true 用于本地开发)。邮件应尽力发送:用 waitUntil() 触发,包 try/catch,失败上报错误追踪,绝不阻塞响应路径也不抛出。也可用官方 cloudflare npm SDK 的 client.emailSending.send() 从 Node 脚本向特定用户发送一次性邮件,使用信号量限制并发为 10,并逐收件人记录 message_id。附件可直接用绑定 send() 的 attachments 字段。

限制:send_email 绑定的 from 域名需启用 Cloudflare Email Routing 并配置发件地址;SDK 中 from/reply_to 对象用 { address, name },不是 { email, name };发送前应用 curl 校验所有 URL 返回 200,并用脚本预览明暗模式截图检查;tmp/ 预览输出应被 gitignore。wrangler OAuth token 约 1 小时过期,401 时运行 wrangler whoami 刷新。其他限制资料未提供。