核心用法
ravi-inbox 是 Ravi 身份体系的官方消息收件工具，覆盖 SMS 短信 和 Email 邮件 两大通道，专为自动化工作流设计。命令结构遵循 ravi inbox <channel> 和 ravi message <channel> 两种模式：前者按对话/线程聚合展示，适合查看上下文；后者平铺单条消息，适合精准定位。
关键命令：
ravi inbox sms --json— 列出所有短信会话ravi inbox email <thread_id> --json— 查看完整邮件线程内容及验证链接ravi message sms --unread --json— 仅获取未读短信（适合轮询 OTP）
OTP/验证链提取： 文档提供 jq + grep 管道示例，可从短信预览中提取 4-8 位数字验证码，或从邮件正文提取 HTTPS 验证 URL，直接集成到自动化脚本。
显著优点
1. 身份绑定安全 — 与 ravi.app 身份体系原生集成，消息隔离于个人 Ravi 号码/邮箱，避免与真实手机号/主邮箱混用
2. 结构化数据优先 — 所有输出强制 --json，字段完备（conversation_id、thread_id、is_read、created_dt 等），机器解析友好
3. 双模式检索 — 聚合视图（inbox）适合人工查阅，平铺视图（message）适合程序化轮询，覆盖不同场景
4. 生态闭环 — 与 ravi-login、ravi-email-send、ravi-email-writing 形成完整工作流：注册 → 收 OTP → 登录 → 回复邮件
潜在缺点与局限性
- 仅读权限 — 明确禁止发信，需切换至
ravi-email-send，操作链路断裂 - 轮询依赖 — 需自行实现
sleep 5轮询逻辑，无推送/WebSocket 机制 - 无内容过滤 — 需外部
jq/grep提取关键信息，无内置 OTP 正则或链接解析 - Ravi 生态锁定 — 仅适用于 Ravi 分配的身份，无法读取用户自有手机号或邮箱
适合人群
- 自动化测试/CI 流程开发者（需要验证短信/邮件的 E2E 测试）
- 需要批量注册、管理多个线上身份的用户
- 希望隔离主邮箱、使用临时身份的隐私敏感用户
常规风险
- 消息延迟 — 文档提示 2-10 秒延迟，关键流程需设计超时重试
- ID 格式依赖 —
conversation_id含特殊字符（1_+1555...），拼接时需注意 shell 转义 - 隐私泄露 — JSON 输出包含完整消息内容，日志管道需避免明文持久化