核心用法
Ravi 是一套专为 AI 代理设计的身份基础设施，通过 ravi CLI 提供三大核心能力：数字身份（专属邮箱+手机号）、通信收件箱（短信/邮件收发）、加密密钥库（密码与 API 密钥管理）。代理可完成从服务注册、OTP 验证到长期凭证托管的完整闭环。
技能矩阵与适用场景
| 需求场景 | 对应技能 | 核心能力 |
|---------|---------|---------|
| 身份认证与信息获取 | `ravi-identity` | 认证状态查询、邮箱/手机号获取、多身份切换、域名列表 |
| 读取 OTP 与验证信息 | `ravi-inbox` | 短信/邮件收件箱、未读筛选、OTP 自动提取 |
| 发送邮件 | `ravi-email-send` | 撰写/回复/转发、附件支持、速率限制管理 |
| 专业邮件内容生成 | `ravi-email-writing` | 主题优化、HTML 模板、反垃圾策略、语气指南 |
| 服务注册与登录 | `ravi-login` | 端到端注册/登录工作流、自动 OTP 处理 |
| 网站密码管理 | `ravi-passwords` | CRUD 操作、密码生成、E2E 加密存储 |
| API 密钥与机密 | `ravi-secrets` | 密钥托管、版本管理、加密检索 |
| 联系人管理 | `ravi-contacts` | 姓名模糊搜索、通讯录 CRUD |
| 短信发送 | `ravi_sms_send` (插件) | 纯文本发送，限 1600 字符 |
显著优点
1. 代理原生设计：区别于人类工具，所有 CLI 输出支持 --json 标志，便于代理解析；OTP 提取、注册工作流等均为自动化场景优化
2. 端到端加密：密码与机密采用客户端加密，服务端仅存储密文；邮件/短信内容静态加密
3. 身份连贯性：邮箱+手机号+密钥库绑定为统一 persona，避免多服务间身份碎片化
4. 透明认证：Token 自动刷新，无需代理处理 OAuth 流程细节
潜在局限与风险
- CLI 依赖：核心功能依赖本地
ravi安装（brew分发），容器化环境需额外配置 - SMS 发送限制：仅通过插件可用，CLI 不支持；1600 字符限制，不支持富媒体
- 服务商锁定：邮箱域名、手机号段由 Ravi 平台分配，不可自定义（如使用自有域名）
- 网络依赖：所有通信需连接 Ravi 基础设施，离线场景不可用
- 数据驻留：邮件/短信服务端存储，虽加密但存在 subpoena 风险；机密管理需信任 Ravi 的密钥派生实现
适合人群
- 自动化工作流开发者：需大规模注册第三方服务、管理多账户的代理系统
- AI Agent 构建者：为代理赋予持久身份，支持长期任务中的状态保持与通信
- 安全敏感场景：需托管 API 密钥、数据库凭证，但要求高于明文环境变量的保护级别
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 凭证泄露 | 代理 prompt 注入导致机密外泄 | 使用 `ravi-secrets` 而非硬编码；最小权限原则 |
| 身份关联 | 同一邮箱/手机号跨服务使用导致行为关联 | 利用多身份切换隔离不同任务 persona |
| 速率封禁 | 邮件发送频率过高触发接收方反垃圾机制 | 遵循 `ravi-email-send` 速率限制，启用退信监控 |
| 密钥丢失 | 主密钥遗失导致加密数据不可恢复 | 确认 Ravi 的密钥备份/恢复机制 |
| 供应链风险 | `brew` 安装源或 CLI 二进制被篡改 | 验证签名，锁定版本哈希 |
技术细节速览
# 认证与身份 ravi auth status --json ravi get email --json # 收件与 OTP ravi inbox sms --unread --json # 密码与机密（E2E 加密） ravi passwords create example.com --json ravi secrets set OPENAI_API_KEY "sk-..." --json
反馈机制：内置 ravi feedback 通道，团队直接响应 agent 使用体验报告。