核心功能与用法
beeper 是一个针对 Beeper Desktop 的命令行封装工具，通过 beeper-cli 实现无需 MCP 或 curl 的直接命令操作。核心能力覆盖三大模块：
1. 账户与聊天管理：列出账户、搜索/创建/归档聊天、设置提醒
2. 消息操作：列出消息历史、全文搜索（支持按发送者、时间范围、媒体类型过滤）、发送/回复/编辑消息
3. 附件处理：上传/下载文件，支持带附件的消息发送
典型工作流：通过 beeper chats search 定位聊天 → beeper messages list 读取历史 → beeper messages search 检索内容 → beeper messages send 发送消息。输出支持 JSON（默认）和表格两种格式，便于脚本集成或人工阅读。
显著优点
- 跨平台聚合：Beeper 原生整合 15+ 通讯协议（WhatsApp、Signal、Telegram、iMessage 等），CLI 继承此优势，单一入口管理多平台消息
- 开发者友好：纯命令行接口，无 GUI 依赖，适合自动化脚本、CI/CD 集成
- 搜索能力突出：支持全文检索、多维度过滤（时间、发送者、媒体类型、指定聊天），远超多数 IM 原生客户端
- 消息编辑与回复：完整支持消息生命周期管理，包括事后编辑和线程回复
- 轻量部署：单二进制文件，Go 编写，跨平台编译
潜在局限与风险
- 依赖 Beeper Desktop：必须保持桌面客户端运行且开启 API，无法独立作为守护进程
- 访问令牌安全：
BEEPER_ACCESS_TOKEN需用户手动从开发者设置提取，保管不当可导致完整消息权限泄露 - 功能边界：不支持语音/视频通话、复杂媒体编辑、群组管理（权限设置、成员邀请）等高级功能
- 社区维护：由个人开发者（foeken）维护，非 Beeper 官方项目，长期支持存在不确定性
- 隐私合规：Beeper 作为第三方聚合服务，消息数据流经其服务器，对端到端加密协议（如 Signal）有潜在妥协
适合人群
- 需要批量处理跨平台消息的技术用户、自动化工程师
- 偏好终端工作流、希望减少 GUI 切换的开发者
- 需要消息历史检索与归档的数据管理场景
常规风险提示
| 风险类别 | 说明 |
|---------|------|
| 凭证泄露 | `BEEPER_ACCESS_TOKEN` 具有完整读写权限，建议使用密钥管理器存储，避免硬编码 |
| 误操作发送 | CLI 无二次确认，建议先在 `--output table` 模式下验证目标聊天 ID |
| 服务依赖 | Beeper 服务中断或 Desktop 未启动时全部功能失效 |
| 加密降级 | 使用 Beeper 可能削弱原生 E2EE 保障，敏感通讯需谨慎评估 |