beepctl

核心用法

beepctl 是 Beeper Desktop API 的命令行封装，让用户在终端中操控多个即时通讯平台（Telegram、WhatsApp、Slack、iMessage 等）。主要功能包括：

• 账户管理：查看已连接的各平台账号状态
• 聊天浏览：按收件箱类型（主要/归档/低优先级）、未读状态、活跃度筛选聊天列表
• 消息搜索：支持全文检索，可按时间范围、聊天对象、媒体类型（图片/视频/链接/文件）、发送者等多维度过滤
• 消息发送：向指定聊天发送文本，支持别名快捷方式和回复指定消息
• 别名系统：为常用聊天 ID 创建短名称（如 work 代替冗长的 Matrix ID）
• 快捷操作：归档/取消归档聊天、设置提醒、搜索联系人、下载附件
• 界面联动：将 Beeper 应用唤起至前台，支持预填草稿和附件

显著优点

• 多平台统一：一次登录 Beeper，即可通过 CLI 操控十余种通讯服务
• 高效检索：时间表达式（1d ago、yesterday）和媒体过滤让历史消息定位更快
• 脚本化友好：纯文本输出便于与 shell 脚本、cron 任务集成
• 本地优先：通过本地 Beeper 客户端通信，无需将 API 密钥暴露给第三方云服务

潜在局限

• 依赖 Beeper Desktop：必须先运行 Beeper 桌面客户端并保持登录，CLI 本身不独立连接各平台
• 媒体发送限制：beepctl send 仅支持文本，发送图片/文件需借助 focus 预填草稿再手动确认
• Matrix ID 依赖：聊天 ID 为 Matrix 格式（!xxx:beeper.local），不直观，必须配合别名使用
• Token 管理：需手动配置 API token，无 OAuth 等自动化授权流程

适合人群

• 重度终端用户、开发者、运维人员
• 需要批量处理消息或自动化发送通知的场景
• 已使用 Beeper Desktop 且希望减少鼠标操作的用户

常规风险

• 误发消息风险：send 操作不可逆，文档明确警告需用户确认后方可执行
• Token 泄露：API token 以明文存储于本地配置文件，若设备被入侵可能导致消息数据泄露
• 隐私边界：搜索和浏览操作会将聊天内容暴露于终端历史记录和屏幕

核心用法

beepctl 是一个命令行工具，通过 Beeper Desktop API 统一管理 Telegram、WhatsApp、Slack、iMessage 等消息平台。本 skill 为纯 Markdown 文档型技能，提供完整的 CLI 使用指南，包括：

• 账户管理：查看已连接的各平台账户
• 聊天浏览：列表、搜索、筛选聊天（支持归档/低优先级/未读等过滤）
• 消息操作：发送消息、搜索历史、查看消息上下文、回复特定消息
• 别名系统：为常用聊天 ID 创建短别名，避免输入冗长的 Matrix ID
• 高级功能：设置提醒、下载附件、联系人搜索、将 Beeper 窗口置前

显著优点

1. 统一入口：单一 CLI 管理 10+ 消息平台，无需切换多个应用
2. 高效搜索：支持跨平台消息全文检索，可按时间、媒体类型、发送者等多维度过滤
3. 自动化友好：纯命令行界面，易于集成到脚本和工作流
4. 安全提示完善：文档明确强调"发送消息前必须获得用户显式确认"
5. 别名机制：通过 beepctl alias 简化长聊天 ID 的操作

潜在缺点与局限性

1. 功能边界：send 命令仅支持文本，发送媒体需通过 focus 预填草稿后手动确认
2. 外部依赖：实际功能完全依赖 beepctl NPM 包，skill 本身只是文档
3. 平台限制：需配合 Beeper Desktop 客户端运行，无法独立工作
4. T3 来源风险：维护者为个人开发者，无组织背书，更新可持续性存疑

适合人群

• 重度 CLI 用户，希望将消息管理整合到终端工作流
• 自动化需求者，需通过脚本批量处理消息或集成到其他系统
• Beeper 付费用户（Beeper 为订阅制服务）

常规风险

• 社交工程误用：send 功能若被自动化滥用可能导致消息误发，尽管文档已强制要求确认
• Token 泄露：API token 存储在本地，需确保设备安全
• 上游供应链：beepctl NPM 包的更新和安全状态需持续关注
• 隐私合规：搜索和消息拉取可能涉及跨平台数据聚合，需留意各平台 ToS