roadrunner

roadrunner（rr）是一款面向 Beeper Desktop 用户的命令行工具封装 Skill，旨在通过本地 API 实现聊天、消息、搜索和提醒的自动化管理。其核心用法围绕 rr CLI 展开，支持列出和搜索聊天、发送与编辑消息、管理联系人、设置提醒、上传下载附件等丰富功能。Skill 特别强调安全模式的使用，推荐通过 --agent 参数启用 JSON 输出、信封错误处理和只读限制，或通过 --readonly 和 --enable-commands 进行细粒度权限控制。

该 Skill 的显著优点在于其完善的安全设计：默认只读行为防止误操作，变更操作需用户明确请求；支持多种安全模式（agent、readonly、enable-commands）适应不同场景；文档详尽，涵盖输入验证、命令注入防护、敏感数据处理等最佳实践。此外，功能覆盖全面，从基础查询到高级操作如消息轮询（tail）、等待特定消息（wait）、草稿预填充（focus）等，满足自动化工作流需求。

潜在缺点包括：依赖外部二进制 rr 和 Beeper Desktop 运行环境，增加了部署复杂度；消息搜索仅支持字面匹配而非语义搜索；部分操作（如联系人解析）在名称模糊时会严格失败，需要额外的搜索步骤；bash/zsh 用户需注意 ! 历史扩展问题。此外，非幂等写操作（如消息发送）需要手动处理重试和去重逻辑。

适合的目标群体为：Beeper Desktop 重度用户、需要自动化消息处理的技术团队、开发运维人员（用于告警通知、状态监控）、以及希望将聊天数据集成到工作流中的效率工具爱好者。不适合普通即时通讯用户或缺乏命令行基础的用户。

使用风险方面，主要涉及：外部依赖的维护（需保持 rr 版本更新）、本地认证令牌的安全存储（尽管遵循 XDG 规范，仍需防范配置文件泄露）、以及消息发送等变更操作的不可逆性。建议生产环境优先使用 --readonly 模式，变更操作配合 --request-id 和 --dedupe-window 实现安全重试。