命令行全能邮件管家

轻量级自托管邮件管理器，支持多服务商IMAP/SMTP、高级搜索过滤、文件夹管理及附件检测，零外部依赖运行。

基本信息

• 技能名称?eMail manager lite
• 中文名称?命令行全能邮件管家
• 作者?jorgermp
• 分类?专业技能
• 版本?1.0.1
• 标签?email, imap, smtp, cli, privacy, self-hosted, automation, zoho, gmail, outlook, nodemailer

使用方法

使用说明
核心用法
Portable Email Manager 是一款基于 Node.js 的独立邮件管理工具，通过命令行提供完整的邮件收发与管理功能。核心操作包括：
发送邮件 ： ./scripts/email.js send ，支持标准 SMTP 发送
读取邮件 ： read [数量] 命令获取近期邮件，含发件人、主题、日期、附件信息及正文预览
高级搜索 ：支持 --from （发件人）、 --subject （主题关键词）、 --since / --before （日期范围）、 --seen / --unseen （已读状态）、 --body （正文内容，较慢）等多维度过滤
文件夹管理 ： folders 列出所有 IMAP 文件夹树， move 实现邮件归档与分类
显著优点

1. 完全自包含 ：依赖仅 nodemailer、imap-simple、mailparser 三个 npm 包，无外部云服务或 API
2. 多服务商兼容 ：默认支持 Zoho，通过简单配置即可适配 Gmail、Outlook、iCloud 及任意 IMAP/SMTP 服务器
3. 服务器端过滤 ：发件人、主题、日期等搜索由 IMAP 服务器执行，本地仅接收匹配结果，性能高效
4. 隐私优先 ：凭证仅通过环境变量传入，不落地存储；全链路 TLS/SSL 加密
   潜在缺点与局限性
   正文搜索性能差 ： --body 需下载邮件内容逐行匹配，大邮箱操作缓慢
   无图形界面 ：纯 CLI 工具，对非技术用户门槛较高
   附件仅检测不下载 ：可显示文件名、MIME 类型、大小，但不提供下载功能
   单次操作单封移动 ：批量归档需脚本循环调用，无原生批量操作
   无本地缓存 ：每次查询重新连接 IMAP，高频使用可能触发服务商限流
   适合人群
   隐私敏感、倾向自托管方案的技术用户
   需自动化邮件处理（筛选、归档、触发工作流）的开发者
   多邮箱统一管理需求的运维或自由职业者
   避免使用第三方邮件客户端的开源偏好者
   常规风险
5. 凭证泄露 ：环境变量若被进程导出或日志记录可能暴露；建议配合专用 App Password 而非主密码
6. 误操作数据丢失 ： move 命令不可逆，错误 UID 或文件夹名将导致邮件位置混乱（虽不会删除）
7. 服务商封禁 ：高频 IMAP 连接或大量搜索可能触发 Gmail/Outlook 的安全限制
8. 依赖维护风险 ：imap-simple 等包更新缓慢，未来 Node 版本兼容性需关注