核心用法
email-resend 是一套基于 Resend API 的邮件收发工具集,支持 outbound 发送、inbound 接收、cron 定时检查及附件下载四大场景。发送邮件使用 outbound.py,支持多附件;接收邮件通过 inbound.py 或配置 cron 每 15 分钟自动扫描,新邮件将推送到 Telegram 指定话题。回复邮件必须使用 draft-reply.py 工作流,自动提取原邮件 Message-ID 并设置 In-Reply-To/References 头,确保 Gmail 线程不中断。
显著优点
1. 线程安全:强制使用 draft-reply.py 维护邮件线程,避免回复变成新会话
2. 零配置启动:仅需 RESEND_API_KEY,其余参数从环境变量或 memory/email-preferences.md 自动发现
3. 多通道通知:支持 Telegram 话题(threadId)精准推送,支持高优先级标记(🔥/📅)
4. 附件完整:独立 download_attachment.py 支持按 ID 或批量下载
5. custody chain:完整 DAG 追踪邮件→通知→回复的全链路
潜在缺点/局限性
- 依赖外部服务:Resend API 可用性直接影响功能
- 回复审批流程严格:用户批准后必须立即执行
send命令,否则流程中断 - 内存文件耦合:Telegram 目标需写入
memory/email-preferences.md,多用户场景需隔离 - 无原生加密:邮件内容以明文形式通过 Resend 传输,敏感内容需自行加密
适合人群
- 需要自动化邮件通知的开发者/运维人员
- 依赖 Telegram 进行工作流提醒的团队
- 对邮件线程完整性有强需求的专业用户
常规风险
- API Key 泄露:
RESEND_API_KEY需妥善保管,建议最小权限创建 - 误用 outbound.py 回复:违反 threading 规则将导致邮件线程断裂且不可修复
- Cron 配置错误:
--session isolated为强制参数,遗漏会导致消息投递失败 - 权限边界模糊:
configure-cron.py会删除/重建同名 cron,多人共用环境可能冲突