imap-email

核心用法

IMAP Email Reader 是一款基于 Node.js 的邮件管理技能，通过标准 IMAP 协议与邮件服务器通信。用户可通过命令行工具执行多项操作：check 命令快速检查未读邮件并返回摘要列表；fetch 命令获取指定 UID 的完整邮件内容（包括文本和 HTML）；search 命令支持多维度筛选，包括发件人、主题、时间范围、已读状态等；mark-read/mark-unread 可批量标记邮件状态；list-mailboxes 则用于查看账户下的所有文件夹。

配置过程支持快速和手动两种模式。针对 ProtonMail Bridge 用户，提供一键 setup 脚本；其他服务如 Gmail 则需配置环境变量，包括主机地址、端口、凭据及 TLS 设置。该技能特别支持 Cron 集成，可设置定时任务实现自动邮件检查与摘要推送，适合构建"晨间邮件简报"或"紧急邮件提醒"等自动化工作流。

显著优点

协议兼容性强：不仅支持 Gmail、Outlook 等主流邮箱，还特别适配 ProtonMail Bridge，满足隐私敏感用户需求。本地化安全架构：凭证仅存储于本地 .env 文件，不上传至第三方服务器，且已预配置 .gitignore 防止误提交。灵活的搜索能力：支持时间范围（如最近 2 小时、7 天）、发件人、主题等多条件组合搜索，便于快速定位关键邮件。轻量无侵入：仅依赖 imap-simple、mailparser 等成熟开源库，无重型框架，启动迅速。自动化友好：命令行接口设计清晰，返回标准 JSON 格式，便于与 Clawdbot 等自动化平台集成，支持定时任务与消息推送。

潜在缺点与局限性

依赖本地 Bridge：使用 ProtonMail 时必须保持 Bridge 桌面端持续运行，增加了本地资源占用。配置门槛：需要用户理解 IMAP 协议基础概念（如 TLS、STARTTLS、端口区别），对非技术用户不够友好。无写回功能：仅能标记已读/未读状态，不支持发送邮件、移动文件夹、删除邮件等完整邮箱管理功能。错误处理局限：网络超时或认证失败时的错误提示较为技术化，缺乏面向终端用户的友好引导。平台限制：目前仅提供 Node.js 实现，无 Python、Go 等其他语言版本，生态系统相对单一。

适合的目标群体

该技能特别适合开发者与 DevOps 工程师，需要构建邮件自动化工作流或集成邮件通知到 CI/CD 流程；隐私意识强的用户，通过 ProtonMail Bridge 实现端到端加密邮件的自动化处理；效率工具爱好者，希望设置定时任务进行邮件摘要、自动分类或重要邮件筛选；以及小型团队管理员，需要监控特定邮箱（如 support@company.com）并自动分发工单。

使用风险

凭证管理风险：尽管有 .gitignore 保护，用户仍可能误将包含明文密码的 .env 文件提交到公共仓库。传输安全风险：若禁用 TLS 或错误配置端口，密码将以明文传输；虽然支持自签名证书，但禁用 REJECT_UNAUTHORIZED 可能遭受中间人攻击。服务稳定性：依赖第三方 IMAP 服务器可用性，Gmail 等服务商可能随时调整"低安全性应用"策略导致连接中断。资源占用：高频轮询（如每 5 分钟检查一次）可能被邮件服务商限流或封禁 IP。邮件内容安全：获取的邮件内容包含 HTML，调用方需自行处理 XSS 防护，避免恶意邮件脚本执行。