Roadrunner

roadrunner (rr) 是 Beeper Desktop 的非官方命令行接口，使用户能够在终端中直接操作 Beeper 的多账户聊天服务。核心功能包括：聊天列表与搜索、消息收发与搜索、联系人管理、提醒设置以及全局搜索。其显著优点在于提供了结构化的 JSON 输出、完善的只读模式保护（--readonly）、命令白名单机制（--enable-commands）以及信封式错误处理（--envelope），非常适合自动化脚本和 AI agent 集成。工具支持分页、媒体下载、消息追踪等高级功能，且通过 --agent 参数提供安全的默认配置。

潜在局限性包括：必须依赖 Beeper Desktop 本地运行，无法独立工作；消息搜索仅支持字面匹配而非语义搜索；联系人解析对模糊匹配严格失败；部分写操作（发送消息、创建聊天等）不具备幂等性，需配合 --request-id 和 --dedupe-window 防止重复。安全方面，工具通过环境变量 BEEPER_TOKEN 进行认证，要求用户自行保管令牌，不提供内置令牌管理。

适合人群主要为开发者、高级用户以及需要将 Beeper 集成到工作流中的自动化场景。常规风险包括：若令牌泄露可能导致账户被滥用；非幂等操作的重复执行可能造成消息重复发送；以及由于依赖本地 Beeper Desktop，桌面端崩溃或网络中断将直接导致 CLI 失效。建议生产环境使用只读模式，并对写操作添加明确的确认机制。

核心功能

roadrunner 是一个将 Beeper Desktop 本地 API 封装为命令行工具的智能体 Skill，让用户能够通过 rr CLI 与 Beeper 聊天平台交互。核心功能包括：

• 聊天管理：列出、搜索、创建聊天，支持按参与者、收件箱类型、未读状态筛选
• 消息操作：发送、编辑、搜索消息，支持媒体下载和附件上传
• 智能搜索：全局搜索、消息内容搜索、联系人解析，支持时间范围和媒体类型过滤
• 提醒功能：设置和清除聊天提醒
• 应用控制：焦点切换、草稿预填充、状态监控

安全机制

该 Skill 在设计上充分考虑了安全性：

• 只读优先：默认使用只读命令，突变操作需用户明确请求
• 安全模式：--agent 标志强制 JSON 输出、信封错误处理、无交互和只读模式
• 命令白名单：--enable-commands 限制允许的命令范围
• 凭证保护：明确禁止在对话中请求、粘贴或存储原始认证令牌

显著优点

1. 自动化友好：完整的 JSON 输出支持，适合脚本和智能体集成
2. 功能全面：覆盖 Beeper Desktop 的核心聊天功能，包括消息搜索、媒体处理、提醒管理
3. 分页支持：自动分页处理大量数据，支持游标导航
4. 错误处理：信封模式提供结构化错误信息和重试提示
5. 灵活配置：环境变量和命令行标志双重配置方式

潜在局限

1. 依赖本地环境：必须运行 Beeper Desktop 并配置 BEEPER_TOKEN
2. 语义搜索缺失：消息搜索为字面词匹配，不支持语义理解
3. T3 来源：个人开发者维护，长期维护承诺不确定
4. 平台限制：仅支持 Beeper Desktop，不兼容其他 Matrix 客户端
5. 命名解析严格：contacts resolve 在名称模糊时会失败

适合人群

• Beeper 重度用户，希望通过 CLI 自动化消息管理
• 需要将聊天数据集成到工作流的技术用户
• 智能体开发者，需要与 Beeper 平台交互的接口

常规风险

• 凭证泄露风险：BEEPER_TOKEN 暴露可能导致账户被盗
• 误操作风险：消息发送、编辑、归档等操作不可逆
• 本地 API 变更：Beeper Desktop 更新可能破坏兼容性
• 非幂等操作风险：发送消息等操作重复执行会导致重复发送