Ravi Inbox 是一个专为开发者设计的命令行工具，用于高效读取和管理通过 Ravi 身份接收的短信和电子邮件。它主要面向自动化流程中的消息验证环节，例如处理一次性密码（OTP）、验证码、确认邮件以及包含验证链接的通信内容。该工具的核心优势在于其简洁的命令行接口与结构化 JSON 输出，使得集成到脚本或 CI/CD 流程中变得极为便捷。与发送邮件的 ravi-email-send 不同，Ravi Inbox 专注于‘读取’功能，确保用户可以在不中断自动化流程的前提下，安全地获取关键的身份验证信息。使用 Ravi Inbox 前，建议先触发相应的验证操作（如登录、注册），因为消息通常需要 2-10 秒才能送达，此时再调用命令进行轮询读取是最可靠的做法。
核心功能特点
- 支持读取传入的短信和电子邮件，包括 OTP、验证码及验证链接等关键信息。
- 提供按会话分组查看 SMS 对话的功能，并能筛选未读消息，便于快速定位最新验证码。
- 支持以线程形式浏览邮件主题，可获取完整邮件内容，包括文本正文和发件人信息。
- 允许通过消息 ID 直接查询特定短信或邮件，适用于需要精确提取某条信息的场景。
- 所有输出均默认采用 JSON 格式，确保数据可被程序化解析，避免依赖易出错的人类可读文本。
- 可与 jq 等命令行工具结合使用，实现 OTP 自动提取、验证链接抓取等高级自动化操作。
适用场景
Ravi Inbox 最典型的应用场景是构建端到端的自动化登录或注册流程。例如，在开发一个需要手机短信验证的测试环境时，开发者可以先用 ravi-login 发起登录请求，系统会向指定手机号发送验证码。由于验证码存在延迟，建议在代码中加入短暂等待（如 sleep 5）后再调用 ravi inbox sms –unread –json 命令获取最新会话。通过解析返回的 JSON 数据中的 preview 字段，即可提取出四位或六位的数字验证码，并自动填入登录表单完成认证，整个过程无需人工干预。另一个常见用例是在处理邮箱验证时，当用户点击注册按钮后，系统会发送一封包含验证链接的邮件。此时，使用 ravi inbox email –unread –json 可列出所有未读邮件线程，再通过 thread_id 获取具体邮件内容，从中提取出 https://example.com/verify?token=xyz 这样的链接地址，实现自动跳转或模拟点击验证。此外，该工具也适用于监控特定联系人的往来信息，配合 ravi contacts 技能可快速查询发件人姓名或历史交互记录，提升自动化脚本的上下文感知能力。