Roadrunner（rr）是一款专为 Beeper Desktop 设计的命令行接口工具，旨在让用户能够通过本地 API 高效地管理聊天、消息、联系人及各类连接信息。它支持发送消息、搜索聊天记录、列出对话列表、设置提醒、聚焦应用窗口等常见操作，同时提供 WebSocket 事件监听和媒体文件下载等高级功能。该工具默认以只读模式运行，确保安全性，只有在用户明确请求修改操作时才会执行写入动作，从而有效防止误操作。通过简单的命令即可实现对 Beeper 桌面客户端的全面控制，特别适合需要自动化处理或快速访问聊天内容的技术用户。 Roadrunner 的设计注重安全性和可审计性，所有敏感操作均需显式授权，并支持多种输出格式如 JSON 和 JSON Lines，便于集成到脚本或自动化流程中。它还提供了详细的错误提示机制，当发生问题时可通过结构化信封（envelope）获取下一步操作建议。此外，工具内置了权限白名单功能（`–enable-commands`），允许限制可用命令范围，进一步增强安全性。对于开发者和系统管理员而言，Roadrunner 不仅是一个交互工具，更是一个可靠的自动化接口，可用于构建聊天机器人、监控通知或批量处理消息场景。
核心功能特点
- 支持发送、编辑、反应消息及上传附件
- 提供全局搜索与按条件过滤的消息/聊天查询
- 自动分页获取大量数据，支持 JSON 和 JSON Lines 输出
- 内置只读保护机制，防止意外修改
- 支持 WebSocket 实时事件监听与轮询模式
- 可配置账户、令牌和环境变量，适配多账号场景
适用场景
Roadrunner 特别适用于希望脱离图形界面、通过脚本或终端直接操作 Beeper 聊天的开发者和技术人员。例如，你可以编写一个 shell 脚本，在部署完成后自动向运维团队发送确认消息；或者创建一个定时任务，定期检查未读消息并生成摘要报告。由于其支持 `–dry-run` 和 `–no-input` 参数，它也常被用于 CI/CD 流水线中的测试验证环节，在不实际发送消息的情况下模拟操作流程。 对于需要频繁检索历史对话的用户，Roadrunner 的全文搜索能力非常实用——无论是查找包含特定关键词的消息，还是根据时间、发送者或媒体类型进行筛选，都能快速返回结果。结合 `–jsonl` 输出格式，可以轻松将搜索结果导入其他数据处理工具进行分析。另外，借助 `rr focus` 命令，用户还能快速唤醒 Beeper 窗口并预填充草稿内容，提升多任务切换效率。 在企业协作环境中，Roadrunner 还可用于集中监控多个工作群组的状态，比如统计各频道活跃度、归档长期不活跃对话，甚至自动清理过期提醒。只要 Beeper Desktop 保持运行状态，这些操作都可以通过本地 CLI 完成，无需额外服务器支持，既节省资源又保障隐私。