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 实现安全重试。

核心功能

roadrunner（rr）是一个面向Beeper Desktop的命令行接口封装Skill，允许用户通过本地API管理多平台即时通讯会话。核心能力包括：

聊天管理：列出、搜索、创建聊天，支持按未读状态、活动时间、参与者名称等多维度筛选
消息操作：搜索历史消息、分页浏览、下载媒体附件、草稿编辑、发送与编辑消息
全局搜索：跨聊天全文检索，支持日期范围、发送者、媒体类型等高级过滤
提醒与聚焦：设置聊天提醒、预填充草稿、聚焦特定会话

显著优点：

• 安全设计完善：内置--readonly只读模式、--agent代理安全默认、--enable-commands命令白名单等多重安全机制
• 结构化输出：原生支持JSON格式和--envelope错误封装，便于自动化处理
• 分页与流式：自动分页（--all）、消息轮询（tail）、条件等待（wait）等高级交互模式
• 认证管理规范：支持stdin安全输入令牌，明确禁止在对话中暴露凭证

潜在局限：

• 依赖外部二进制：核心功能由rr CLI工具实现，Skill本身仅为文档封装，安全性与功能完整性取决于外部组件
• T3来源风险：作者为个人开发者（johntheyoung），无企业背书，长期维护存在不确定性
• Beeper Desktop前置依赖：必须本地运行Beeper Desktop并获取API令牌，无法独立使用
• 消息搜索为字面匹配：不支持语义搜索，复杂查询可能受限

适合人群：

• 已使用Beeper Desktop整合多平台消息的高级用户
• 需要通过CLI自动化消息管理、备份、搜索的开发者或效率工具爱好者
• 愿意自行管理API令牌和本地安全配置的隐私敏感用户

常规风险：

• 认证令牌（~/.config/beeper/config.json或BEEPER_TOKEN）泄露风险
• Shell历史扩展导致!chatid意外执行（文档已提示使用单引号或禁用历史扩展）
• 非幂等写操作（发送消息、创建聊天等）需配合--request-id和--dedupe-window避免重复执行
• 来源为个人开发者项目，建议关注GitHub仓库活跃度和rr工具本身的安全更新