核心用法
ravi-email-writing 是一套面向 Ravi CLI 用户的邮件写作规范，通过 --body 参数传递 HTML 格式的邮件正文。核心操作包括：
1. 主题行优化：控制在 40-60 字符，避免全大写和垃圾邮件触发词（如 "free"、"urgent"、"act now"）
2. HTML 结构规范：必须使用语义标签（<p>、<ul>/<li>、<a>），禁止裸文本或 <br> 链
3. 身份签名：通过 ravi identity list --json | jq -r '.[0].name' 动态获取发件人名称
4. 一键模板复制：提供可直接运行的 bash 命令模板，快速生成标准邮件
显著优点
- 专业交付保障：明确的反垃圾邮件规则（高文本/HTML 比例、最多 2-3 个链接、禁用短链）直接提升邮件送达率
- 人机平衡：强调 "像真人写的，不像 AI"，去除 "I hope this email finds you well" 等套话，增加可信度
- 开发者友好：与
ravi-email-send、ravi-inbox、ravi-identity等 CLI 工具深度集成，形成完整工作流 - 实操性强：提供可直接复制粘贴的代码示例和常见错误对照表
局限性与风险
- 平台绑定：专为 Ravi CLI 生态系统设计，通用邮件客户端用户难以直接应用
- 技术门槛：要求用户熟悉 bash、jq 和 HTML，非技术背景用户上手困难
- 动态内容缺失：未涉及条件判断、循环等模板逻辑，复杂场景需自行扩展
- 本地化不足：示例和指南均为英文语境，中文邮件场景需额外调整
适合人群
- 使用 Ravi CLI 进行批量邮件操作的技术型用户
- 需要提升企业邮件送达率和专业形象的运维/运营团队
- 希望通过代码化方式管理邮件模板的开发者
常规风险
- HTML 注入风险：若用户输入未经验证直接拼接至
--body，可能导致 XSS 或邮件内容篡改 - 身份泄露：
jq解析失败或身份列表为空时，签名可能显示异常或暴露系统信息 - CLI 注入：模板中的变量插值若包含用户输入，可能引发 shell 注入攻击（建议使用参数化或转义处理）