核心用法
ravi-inbox 是 Ravi 生态中专用的入站消息读取工具,用于获取绑定至 Ravi 身份的手机号码和邮箱地址接收到的短信与邮件。该技能采用只读设计,严格区分于发件功能(ravi-email-send)和凭证管理功能(ravi-passwords/ravi-vault)。
短信功能:支持按发件人分组查看对话列表、筛选未读消息、查看完整对话内容。返回结构化数据包含发件号码、预览内容、消息计数及时间戳。
邮件功能:支持邮件线程列表查询、未读筛选、完整线程内容获取,返回包含发件人、主题、纯文本内容及完整链接的结构化数据。
独立消息模式:提供扁平化消息接口 ravi message sms|email,支持按消息ID精准查询,适用于不需要对话聚合的场景。
自动化集成:内置与 jq、grep 结合的实用范例,可一键提取 4-8 位数字验证码和 HTTPS 验证链接,适合 CI/CD 流水线或自动化测试场景。
显著优点
1. 只读安全设计:明确禁止发送操作,从根本上杜绝误操作导致的邮件外发风险
2. 结构化数据优先:--json 标志强制输出机器可读格式,消除解析不确定性
3. 双通道整合:短信与邮件统一接口,降低多工具学习成本
4. 隐私隔离:Ravi 身份体系实现消息接收与个人主号的物理隔离
潜在局限
- 异步延迟:官方提示需等待 2-10 秒才能获取消息,实时性有限
- 无推送机制:需主动轮询(
sleep 5+ 重试),非事件驱动架构 - 内容限制:仅支持纯文本提取,HTML 邮件需自行解析
- 无历史归档:未明确说明长期存储策略,疑似短期缓存机制
适合人群
- 自动化测试工程师:需要程序化获取 2FA 验证码
- DevOps/SRE:CI 流水线中集成邮箱验证环节
- 隐私敏感用户:希望隔离主号码/邮箱的注册验证场景
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据泄露 | 低 | 仅读取本人Ravi身份消息,无横向访问 |
| 误操作 | 极低 | 只读设计,无写操作风险 |
| 依赖风险 | 中 | 轮询依赖Ravi服务可用性,无本地降级方案 |