Throwmail：智能体工作流中的邮件管理CLI工具

Throwmail是专为AI智能体工作流设计的命令行工具，旨在解决智能体处理邮件时的安全与自动化问题。它支持临时邮箱生命周期管理、邮件查询读取、智能等待及验证码/链接提取，适用于自动化测试、账号注册、API集成等场景。

在自动化测试、账号注册、API集成等场景中，AI智能体常需处理邮件（接收验证码、点击确认链接等）。但配置真实邮箱存在安全隐私风险，手动管理临时邮箱又违背自动化初衷。Throwmail由此应运而生，提供完整的临时邮箱生命周期管理。

Throwmail的核心功能包括：

1. 邮箱初始化：随机或指定名称创建临时邮箱（throwmail init或init --name），信息保存于~/.agent-email/。
2. 邮件查询与读取：列出所有邮件（list）、读取最新邮件（read latest）、查看数量（count）。
3. 智能等待与提取：等待特定发件人邮件（wait --timeout --from）、提取验证链接（extract-link）、提取验证码（extract-code）。这些命令支持智能体自主完成注册验证流程。

• 后端服务：使用公开临时邮箱服务1secmail.com，无需注册、支持任意收件箱名称，但邮件公开可访问（仅适合测试开发，不适合敏感信息）。
• 架构设计：采用适配器模式，src/adapters目录包含1secmail实现及未来扩展（mail.tm、SMTP）；commands实现CLI命令；state管理收件箱状态；utils提供提取和轮询工具。
• 开发命令：npm install（安装依赖）、npm run build（编译TS）、npm run dev（监视模式）、npm test（测试）、npm link（全局安装）。

1. 自动化账号注册：初始化邮箱→智能体填写注册表单→等待验证邮件→提取验证码→完成注册。
2. API密钥申请：初始化邮箱→提交申请→等待确认邮件→提取链接并访问。
3. 自动化测试：清理状态→触发邮件操作→验证邮件到达及内容。

• 安全性：1secmail邮件公开，不要接收敏感信息，简单邮箱名称可能导致验证码被截获，不适合生产环境。
• 邮件保留：1secmail邮件保留1-2小时，不适合长期存档。
• 发件人限制：部分服务可能标记1secmail域为临时邮箱，拒绝发送邮件。

Throwmail的适配器架构支持以下扩展：

1. 集成mail.tm等私密临时邮箱服务，提升安全性。
2. 支持SMTP/IMAP连接真实邮件服务器，适用于生产场景。
3. 增强内容解析能力（提取附件、解析HTML、识别模板）。
4. 与n8n、LangChain等编排工具集成，成为标准组件。

Throwmail填补了智能体工具链中邮件处理的缺口，虽基于公开服务且功能简单，但满足测试、开发及轻量级自动化需求。其清晰的架构为未来扩展奠定基础。随着AI智能体参与更多邮箱交互任务，Throwmail类工具将成为智能体基础设施的重要组成部分。