通过IMAP/SMTP协议统一管理邮件收发，支持Gmail、Outlook、网易系等主流邮箱，提供完整的邮件查询、下载附件、标记状态及发送功能。
说明：
## 核心用法
**imap-smtp-email** 是一款基于Node.js的邮件管理工具，通过标准IMAP/SMTP协议实现邮件的全生命周期管理。IMAP模块负责接收端操作：检查新邮件、按条件搜索（发件人、主题、时间范围、已读状态）、获取完整邮件内容、下载附件、标记已读/未读状态，以及列出邮箱文件夹。SMTP模块负责发送端：支持纯文本/HTML邮件、多收件人（To/CC/BCC）、附件上传，并提供连接测试功能。
配置采用.env文件或环境变量，支持TLS/SSL加密连接，内置国内常用邮箱（163/126/188/vip/yeah.net）及Gmail、Outlook的服务器参数对照表。
### 显著优点
1. **协议原生支持**：不依赖各厂商API，通用性强，理论上兼容任何标准IMAP/SMTP服务器
2. **功能完整度高**：覆盖邮件管理的核心场景——收发、搜索、附件处理、状态标记，无需多工具切换
3. **批量操作友好**：UID支持多参数传递，附件下载支持全量/指定文件双模式
4. **搜索能力灵活**：支持时间切片（recent）、日期区间、发件人/主题关键词组合过滤
5. **国内邮箱深度适配**：明确标注网易系邮箱需使用”授权码”而非密码，并提供完整服务器配置表
### 潜在缺点与局限性
1. **无OAuth支持**：仅支持密码/授权码认证，Gmail需开启”安全性较低的应用访问”或使用App Password，微软账号需类似处理
2. **实时性依赖轮询**：无推送机制，需主动调用check/search命令检测新邮件
3. **附件处理无沙箱**：下载附件直接写入指定目录，无内置病毒扫描或文件类型白名单
4. **HTML渲染受限**：仅支持发送HTML，阅读端无渲染能力，需外部工具查看富文本
5. **无邮件线程/对话视图**：UID为粒度，不自动关联Re:主题的邮件链
### 适合人群
– 需要统一管理多邮箱（尤其国内企业邮箱+海外Gmail/Outlook混合场景）的开发者/DevOps
– 构建邮件自动化工作流（如定时抓取附件、监控特定主题邮件触发后续处理）的技术团队
– 对API调用频率受限或需离线/内网环境运行的邮件集成场景
### 常规风险
– **凭证泄露风险**：.env文件若未加入.gitignore易误提交；多用户环境下环境变量可能暴露
– **中间人攻击**：若关闭`REJECT_UNAUTHORIZED`使用自签名证书，TLS连接可被劫持
– **邮件误操作**：mark-read/unread无二次确认，批量UID操作可能误标重要邮件
– **发送合规风险**：SMTP无内置退信处理、发送频率限制，大量邮件可能被服务商限流或标记为垃圾邮件
会员专属
