eMail manager lite

核心用法

Portable Email Manager 是一款基于 Node.js 的独立邮件管理工具，通过命令行提供完整的邮件收发与管理功能。核心操作包括：

• 发送邮件：./scripts/email.js send <收件人> <主题> <正文>，支持标准 SMTP 发送
• 读取邮件：read [数量] 命令获取近期邮件，含发件人、主题、日期、附件信息及正文预览
• 高级搜索：支持 --from（发件人）、--subject（主题关键词）、--since/--before（日期范围）、--seen/--unseen（已读状态）、--body（正文内容，较慢）等多维度过滤
• 文件夹管理：folders 列出所有 IMAP 文件夹树，move <uid> <文件夹> 实现邮件归档与分类

显著优点

1. 完全自包含：依赖仅 nodemailer、imap-simple、mailparser 三个 npm 包，无外部云服务或 API
2. 多服务商兼容：默认支持 Zoho，通过简单配置即可适配 Gmail、Outlook、iCloud 及任意 IMAP/SMTP 服务器
3. 服务器端过滤：发件人、主题、日期等搜索由 IMAP 服务器执行，本地仅接收匹配结果，性能高效
4. 隐私优先：凭证仅通过环境变量传入，不落地存储；全链路 TLS/SSL 加密

潜在缺点与局限性

• 正文搜索性能差：--body 需下载邮件内容逐行匹配，大邮箱操作缓慢
• 无图形界面：纯 CLI 工具，对非技术用户门槛较高
• 附件仅检测不下载：可显示文件名、MIME 类型、大小，但不提供下载功能
• 单次操作单封移动：批量归档需脚本循环调用，无原生批量操作
• 无本地缓存：每次查询重新连接 IMAP，高频使用可能触发服务商限流

适合人群

• 隐私敏感、倾向自托管方案的技术用户
• 需自动化邮件处理（筛选、归档、触发工作流）的开发者
• 多邮箱统一管理需求的运维或自由职业者
• 避免使用第三方邮件客户端的开源偏好者

常规风险

1. 凭证泄露：环境变量若被进程导出或日志记录可能暴露；建议配合专用 App Password 而非主密码
2. 误操作数据丢失：move 命令不可逆，错误 UID 或文件夹名将导致邮件位置混乱（虽不会删除）
3. 服务商封禁：高频 IMAP 连接或大量搜索可能触发 Gmail/Outlook 的安全限制
4. 依赖维护风险：imap-simple 等包更新缓慢，未来 Node 版本兼容性需关注

核心用法

portable-email-manager 是一款面向技术用户的命令行邮件管理 Skill，通过标准 IMAP/SMTP 协议实现收发邮件、高级搜索、文件夹管理及附件检测等功能。支持 Gmail、Outlook、Zoho 等主流邮箱及自建服务器。

主要功能模块：

• 发送邮件：send <收件人> <主题> <正文>，支持纯文本快速发送
• 读取邮件：read [数量]，显示 UID、发件人、主题、附件信息及正文预览
• 高级搜索：多维度组合筛选（发件人 --from、主题 --subject、日期范围 --since/--before、已读状态 --seen/--unseen、正文 --body），支持 --limit 限制结果
• 文件夹管理：folders 列出层级目录，move <uid> <文件夹> 移动邮件
• 附件检测：自动识别附件并显示文件名、MIME 类型、格式化大小

使用流程：配置环境变量 EMAIL_USER / EMAIL_PASS（推荐使用 App Password）→ 选择邮件服务商 → 执行 CLI 命令完成操作。

---

显著优点

1. 协议原生支持：基于标准 IMAP/SMTP，无厂商锁定，兼容任何支持协议的邮件服务
2. 零外部依赖：核心功能自包含，依赖均为成熟 npm 生态库（nodemailer、imap-simple、mailparser）
3. 搜索能力突出：支持服务器端过滤的多条件组合查询，响应速度快于本地遍历
4. 自动化友好：UID 驱动的邮件操作便于脚本化，适合批量归档、自动分类等场景
5. 隐私优先：凭证仅通过环境变量注入，不持久化存储，无遥测数据收集

---

潜在缺点与局限性

| 局限类型 | 具体说明 |

|---------|---------|

| **TLS 安全风险** | 代码中硬编码 `tlsOptions: { rejectUnauthorized: false }`，禁用证书验证，存在中间人攻击风险 |

| **无图形界面** | 纯 CLI 工具，非技术用户学习成本高 |

| **正文搜索性能** | `--body` 参数需下载完整邮件内容解析，大邮箱场景下响应缓慢 |

| **配置灵活性** | 切换邮件服务商需手动修改源码中的 host/port，不支持多账户并发配置 |

| **T3 来源风险** | 个人开发者维护，无公开仓库溯源，更新可持续性不确定 |

---

适合人群

• 开发者/DevOps：需要自动化邮件处理（告警分发、日志投递、CI/CD 通知）
• 系统管理员：批量管理服务器告警邮箱、自动化归档旧邮件
• 效率工具爱好者：偏好终端工作流，希望用脚本替代 Web 邮件客户端的重复操作
• 隐私敏感用户：不愿将邮件数据托管给第三方 SaaS，倾向本地可控的工具

不适合：需要富文本编辑、联系人管理、日历集成的普通办公用户。

---

常规风险

1. 网络安全风险：TLS 证书验证禁用为最严重隐患，建议在受信任内网或修复配置后使用
2. 凭证泄露风险：环境变量方式需用户自行确保不被 shell 历史或日志记录
3. 误操作风险：move 命令基于 UID 执行，文件夹名称大小写敏感，操作前建议先用 folders 确认名称
4. 依赖供应链风险：虽当前依赖无 CVE，但需持续关注 nodemailer/imap-simple 等库的安全公告
5. 数据完整性风险：IMAP 操作直接作用于服务器端邮件，无本地备份机制，大批量移动前建议谨慎验证