核心功能
Beeper CLI 提供只读访问本地 Beeper 聊天历史的工具能力。Beeper 作为聚合聊天应用，统一整合了 WhatsApp、Telegram、Signal、iMessage、Discord 等平台的聊天记录。该技能允许用户浏览线程、搜索消息并提取对话数据，完全基于本地 SQLite 数据库操作，不涉及网络通信或消息发送。
显著优点
- 全平台聚合搜索：一次性检索跨多个即时通讯平台的历史记录，解决多应用信息分散痛点
- FTS5 高性能检索：利用 Beeper 内置的全文索引，支持短语搜索、邻近词搜索（NEAR/N）等高级语法
- 结构化输出：通过
--json参数确保机器可读输出，便于自动化处理 - 上下文回溯：支持
--context参数获取匹配消息的前后文，配合--window时间窗口实现精准定位 - 零网络依赖：纯本地数据库读取，无云端交互，隐私可控
潜在局限
- 依赖 Beeper Desktop：必须安装官方桌面应用才能获取数据库文件
- 只读限制：无法发送消息或修改历史，仅适用于信息检索场景
- macOS 路径预设：自动检测路径主要针对 macOS，Linux/Windows 需手动指定
--db - 桥接数据库依赖：DM 名称解析依赖可选的桥接数据库，部分场景需禁用
--no-bridge - Go 生态依赖：安装需要 Go 环境，对非开发者不够友好
适合人群
- 需要跨平台聊天记录统一检索的高级用户
- 信息归档、合规审计或数字取证场景
- 自动化工作流构建者（结合
jq等工具链）
常规风险
- 隐私敏感：虽为本地读取，但聊天记录包含高度敏感个人信息，输出日志需妥善管理
- 数据库锁定：Beeper 运行时可能锁定数据库，建议关闭应用后操作或使用副本
- FTS5 查询注入：复杂搜索语法需谨慎构造，避免意外匹配过量数据