Communitygithub.com

J-StaR-Films-Studios/VibeCode-Protocol-Suite

跨多个品牌产品复用单个Resend账户和一个已验证发件域名,特别适合独立开发者和免费用户。在向其他应用添加事务性邮件时,无需创建新的Resend账户或验证新域名,同时保持每个产品独立的身份标识、收件人、回复路由、模板、安全边界、投递可靠性以及对共享发送配额的感知。

VibeCode-Protocol-Suite 是什么?

该技能旨在帮助独立开发者或小规模项目组合在单个Resend账户和一个已验证发件域名的前提下,为多个品牌产品实现邮件发送功能。它优化了免费层级的资源利用,避免每个应用看起来像同一产品。核心模式是共享基础设施但保持产品身份独立:所有应用共享同一账户的配额和已验证域名的信誉,但每个应用拥有自己独立的显示名称、收件箱、回复路由、主题约定、品牌模板、部署环境变量和投递日志。支持的平台包括任何可安装Resend官方Node.js包并配置服务器端环境变量的框架(如Next.js、Express等)。该协议还定义了联系表单的双路消息路由(内部通知和访客确认)、品牌隔离策略、共享免费层的保护措施以及可靠的实现步骤(如验证API响应、处理异常、返回适当的HTTP状态码)。最终目标是让开发者无需为每个新应用重复验证域名或升级付费计划,即可快速、可靠地为多个产品添加事务性邮件功能。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/J-StaR-Films-Studios/VibeCode-Protocol-Suite/tree/HEAD/assets/.agent/skills/web-dev-standards/shared-resend-portfolio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

共享Resend作品集

为多个产品通过单个Resend账户和已验证域名实现邮件发送功能。面向独立开发者或小型项目组合,优化免费层级的资源利用率,避免每个应用看起来像同一产品。

核心模型

共享基础设施,而非产品身份:

一个Resend账户
└── 已验证的发件域名
    ├── 产品A发件身份
    ├── 产品B发件身份
    └── 产品C发件身份

每个应用保持独立的:

  • 发件显示名称
  • 目标收件箱
  • 回复路由
  • 主题约定
  • 品牌HTML和纯文本模板
  • 部署环境变量
  • 投递日志和失败处理

所有应用共享账户级别的免费层配额和已验证域名的信誉。

作品集发现

在实现之前:

  1. 检查目标应用以及任何已有Resend配置的同组应用。
  2. 确定规范的Resend账户和已验证域名。
  3. 确认产品显示名称、共享发件邮箱、内部收件人、支持回复收件箱以及预期的邮件类型。
  4. 确认目标部署是否已存在Resend API密钥。
  5. 除非现有账户无法满足明确的要求,否则不要要求用户创建新账户、验证新域名或购买套餐。

账户和密钥策略

复用同一个Resend账户和已验证域名。当账户允许时,优先为每个已部署的应用使用独立的API密钥;这可将泄露或轮换密钥的影响限制在单个应用上,同时保持在一个账户和配额下。仅在无法获得独立密钥或用户明确倾向于这种权衡时,才复用同一个密钥。

切勿将另一个存储库中的密钥复制到源码中。将选定的密钥直接添加到每个部署的环境变量中。

每产品配置

在可行的情况下,使用服务器端变量和产品特定的名称。从用户现有的Resend账户、已验证发件配置和预期产品收件箱中解析这些变量的值——切勿将示例身份复制到实现中。

变量角色用途
Resend API密钥认证服务器端提供者调用
产品发件身份将当前产品的显示名称与已验证域名上的地址组合
产品联系收件人接收该产品的内部通知
产品回复地址在联系人收件人之外,接收用户消息的回复

可见的显示名称提供产品身份;已有的已验证地址确保投递能力。切勿使用 NEXT_PUBLIC_ 或类似客户端暴露的变量存储API密钥。

联系表单路由

发送两条独立的消息:

内部通知
发件人:配置的产品发件身份
收件人:配置的内部产品收件箱
回复地址:访客提交的已验证地址

访客确认
发件人:配置的产品发件身份
收件人:访客提交的已验证地址
回复地址:配置的内部产品收件箱

不要将访客和内部收件箱放在同一个收件人列表中。独立的消息可避免地址暴露,并允许不同的内容。

将内部通知视为主要投递。仅当Resend接受内部通知并返回消息ID后,才返回表单提交成功。随后尝试发送访客确认;记录其失败,但不要声称主要查询丢失。

品牌隔离

为每个产品创建独特的模板外壳,同时保持提供者模块模式可复用。自定义:

  • 产品名称和描述符
  • 颜色、排版和页眉处理
  • 邮件预览文本
  • 主题和语气
  • 页脚所有权、支持地址和回复期望

使用表格布局、内联CSS、600–640px内容宽度、转义的用户值以及纯文本版本。不要仅因为发件基础设施是共享的,就复用另一个产品的视觉身份。

共享免费层保护措施

  • 检查当前的Resend免费层限制,而不是依赖记忆中的数字。
  • 记住每个应用都消耗同一个账户的配额。
  • 仅发送必要的事务性消息;避免重复的通知。
  • 保持公共表单的反垃圾控制:验证、长度限制、蜜罐以及适当情况下的限速。
  • 避免可能发送重复的循环重试。在存在有意义的重试风险的工作流中,使用持久化或幂等性。
  • 监控提供者拒绝和配额错误,但不记录敏感信息或不必要的个人数据。
  • 仅在实测量、隔离性、合规性或信誉要求证明合理时,才升级到另一个账户或付费计划。

可靠实现

  1. 在正确的工作区中安装官方的 resend 包。
  2. 将提供者调用放在服务器端模块中。
  3. 验证 result.data?.id 且 result.error 不存在。
  4. 捕获SDK和网络异常。
  5. 显式设置 replyTo。
  6. 当邮件未配置时返回 503,当主要投递失败时返回 502。
  7. 在UI中保留直接的电子邮件、电话或消息备用方案。
  8. 切勿将仅日志处理报告为成功投递。

验证

  • 确认在复用的Resend账户中已验证共享域名。
  • 确认产品特定的发件人、收件人和回复地址值。
  • 测试内部投递,然后测试访客确认,再测试双向回复。
  • 测试验证、蜜罐、缺少密钥、提供者拒绝和备用路径。
  • 运行存储库原生的类型检查、lint、测试和构建命令。
  • 确认部署包含其API密钥和产品变量。
  • 在声明实时投递有效之前,执行一次真实的提交。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能