Beeper 桌面端智能命令行管家

roadrunner 是 Beeper Desktop 的官方 CLI 封装，支持聊天管理、消息收发、全局搜索等操作，默认只读模式保障安全，适合需要自动化消息工作流的高级用户。

基本信息

• 技能名称?roadrunner
• 中文名称?Beeper 桌面端智能命令行管家
• 作者?johntheyoung
• 分类?专业技能
• 版本?v0.17.0
• 标签?productivity, automation, customer-support, content-media, api, backend

使用方法

使用说明
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 实现安全重试。