核心用法
beeper 是一个围绕 Beeper Desktop API 的 CLI 包装器技能，通过调用外部 beeper-cli 工具实现消息管理功能。用户需先安装 Beeper Desktop 并启用开发者 API，获取访问令牌后配置环境变量即可使用。
主要功能模块包括：账户管理（列出账户信息）、聊天管理（搜索、创建、归档、设置提醒）、消息操作（列表、搜索、发送、编辑、回复）、附件处理（上传下载文件）以及全局搜索和窗口聚焦。所有命令支持 JSON 和表格两种输出格式，便于脚本集成或人工阅读。
典型工作流程为：先通过 beeper chats search 定位目标聊天，使用 beeper messages list 或 beeper messages search 查阅历史内容，最后用 beeper messages send 发送消息。支持带附件的消息和回复线程，满足日常沟通自动化需求。
显著优点
1. 统一多平台消息管理：Beeper 本身聚合了 WhatsApp、Telegram、Signal、iMessage 等 15+ 聊天平台，该技能让用户能通过单一 CLI 入口管理所有渠道的消息。
2. 无 MCP 依赖的轻量设计：相比需要 Model Context Protocol 的复杂集成，此技能直接调用本地 CLI，架构简单、延迟低、故障点少。
3. 完整的搜索与自动化能力：支持按关键词、时间范围、发送者、媒体类型等多维度搜索消息，便于构建消息归档、关键词监控、自动回复等自动化工作流。
4. 输出格式灵活：JSON 输出方便与 jq、Python 等工具链集成，表格输出适合快速人工查阅，兼顾脚本化和交互式使用场景。
潜在缺点与局限性
1. 外部依赖较重：技能本身仅为文档包装，核心功能完全依赖第三方 beeper-cli 工具，用户需自行处理 Go 环境、版本兼容和更新维护。
2. T3 来源可信度：beeper-cli 由个人开发者维护（foeken），非 Beeper 官方出品，长期维护承诺、安全审计和漏洞响应存在不确定性。
3. 平台限制：必须保持 Beeper Desktop 运行且 API 启用，无法独立工作；不支持移动端 Beeper，使用场景局限于桌面环境。
4. 功能边界：不支持语音/视频通话、部分平台的端到端加密消息可能有访问限制，复杂交互（如投票、位置共享）未覆盖。
适合的目标群体
- 已深度使用 Beeper Desktop 整合多平台消息的技术用户
- 需要批量处理消息归档、客服记录提取、合规审计的数据工程师
- 希望将消息通知接入自建自动化系统（如 n8n、Huginn）的极客用户
- 习惯终端工作流、追求效率的开发者群体
使用风险
1. 令牌泄露风险：BEEPER_ACCESS_TOKEN 拥有完整消息读写权限，若硬编码在脚本或日志中泄露，攻击者可获取全部聊天历史并冒充发送消息。
2. 外部工具供应链风险：beeper-cli 通过 go install 从 GitHub 直接安装，存在仓库被劫持、发布恶意版本的可能，建议锁定特定版本并校验校验和。
3. 误操作风险：CLI 缺乏图形界面的二次确认机制，批量发送或删除操作一旦执行难以撤回，脚本中应加入显式确认步骤。
4. 性能与稳定性：大规模消息搜索可能触发 Beeper API 速率限制；Beeper Desktop 未运行时所有命令失败，不适合高可用性要求的生产场景。