核心用法
mailgun-simple 是一款面向 AI Commander 的轻量级邮件发送技能，封装了 Mailgun 官方 JavaScript SDK，支持通过环境变量配置实现纯命令行调用。核心功能单一聚焦：向指定收件人发送纯文本邮件。
调用方式：
MAILGUN_API_KEY=xxx MAILGUN_DOMAIN=example.com MAILGUN_REGION=EU node scripts/send_email.js <to> <subject> <text> [from]
环境变量驱动设计确保不依赖外部 .env 文件，符合容器化/自动化部署的安全最佳实践。
显著优点
1. 官方 SDK 背书：基于 mailgun.js 官方库，接口稳定性与长期维护有保障
2. 双区域支持：内置 US/EU 区域切换，满足 GDPR 合规需求
3. 零配置依赖：纯环境变量注入，无配置文件泄露风险
4. 轻量化集成：仅依赖 Node.js 运行时，安装流程自动化（npm install mailgun.js form-data）
5. AI Commander 原生适配：由官方团队（Skippy & Lucas）维护，与平台深度集成
潜在局限
- 功能单一：仅支持纯文本邮件，无 HTML 模板、附件、批量发送等高级功能
- 无内置重试机制：网络异常需调用方自行处理
- 密钥管理责任：
MAILGUN_API_KEY需由调用方安全托管，技能本身无加密存储能力 - 发送域验证依赖：需预先完成 Mailgun 域验证，否则邮件进入沙箱模式
适合人群
- 需要快速接入邮件通知的自动化工作流开发者
- AI Commander 平台用户寻求官方维护的原生邮件能力
- 对 GDPR 合规有要求的欧盟业务场景
- 轻量级需求、无需复杂邮件模板的系统监控/告警场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| **密钥泄露** | API Key 通过环境变量传递，进程列表/日志可能暴露敏感信息 |
| **发送滥用** | 若密钥被盗，攻击者可利用 Mailgun 账户发送垃圾邮件，导致域名信誉受损 |
| **区域误配** | US/EU 区域配置错误可能导致 API 调用失败或数据合规问题 |
| **沙箱限制** | 未验证域名时，收件人地址需预先授权，影响自动化测试流程 |