Agent Skills
返回列表
💻

MailDev 邮件测试服务器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/maildev-smtp-capture-and-email-testing-server。

技能介绍

这个技能解决什么问题

本地开发里凡是涉及邮件的功能——注册验证、密码重置、订单通知——都绕不开一个具体问题:邮件内容到底对不对。直接把开发环境的邮件发进真实收件箱,轻则污染数据、打扰同事,重则把测试邮件发给真实用户;而只靠 console.log 打印模板结果,又看不到附件、链接和 HTML 渲染效果。自动化流程同样尴尬:CI 用例跑完,邮件发了,却没有一个可以断言的地方。

MailDev 的做法是在本地起一个 SMTP 捕获服务器,把所有发往本地地址的邮件全部拦下来,让开发者和测试工作流都能安全地观察邮件本身。

它是如何工作的

  • SMTP 捕获:应用中的 SMTP 配置指向本地捕获端口,邮件不会进入任何真实收件箱,全部留在本地。
  • Web 界面:在浏览器里查看捕获到的每封邮件,包括正文、附件和原始内容。
  • REST API:agent 或测试工作流可以程序化地检查消息、附件以及转发行为,把邮件断言写进自动化用例。
  • 底层基于 Node.js 实现,SMTP 端口等配置可通过环境变量调整。

适用边界与注意点

  • 它只验证邮件的生成与投递路径,不能替代真实邮件服务商(ESP)的投递测试——到达率、垃圾邮件评分这类问题它回答不了。
  • 仅限开发与测试环境使用,不要把它当作生产环境的邮件中继。
  • 它验证的是应用实际生成的邮件内容,前提是应用通过 SMTP 协议发送邮件。

使用场景

  • 本地开发用户注册功能时,需要验证发出的HTML邮件在真实客户端中的排版与链接是否正常。
  • 编写CI流水线时,需通过REST API自动检查系统发出的密码重置邮件是否包含正确的附件。
  • 调试订单通知邮件的附件生成逻辑时,为避免发进真实收件箱,需将SMTP指向本地捕获服务进行拦截验证。
  • 测试邮件转发规则时,需要在本地Web界面观察消息被拦截后的实际流转行为而不影响外部系统。

适合人员

  • 后端工程师,需要验证应用生成的各类事务邮件内容,确保不向真实用户发送测试邮件。
  • 自动化测试工程师,需要编写CI用例来断言邮件附件和链接,验证系统通知的完整性。
  • 前端或全栈开发者,需要检查HTML邮件在不同客户端的渲染效果,排查样式错乱问题。
  • AI Agent开发者,需要构建能自动检查和回复邮件的测试工作流,需要一个安全的本地沙箱环境。