名称： beeper
描述： 搜索与浏览本地 Beeper 聊天记录（会话、消息、全文搜索）。
主页： https://github.com/krausefx/beeper-cli
元数据： {"clawdbot":{"emoji":"🛰️","os":["darwin","linux"],"requires":{"bins":["beeper-cli"]},"install":[{"id":"go","kind":"go","pkg":"github.com/krausefx/beeper-cli/cmd/beeper-cli","bins":["beeper-cli"],"label":"安装 beeper-cli (go install)"}]}}

Beeper CLI

Beeper 是一款通用聊天应用，可将来自 WhatsApp、Telegram、Signal、iMessage、Discord 等平台的消息统一收纳在一个收件箱中。

本技能提供对本地 Beeper 聊天记录的只读访问功能。您可以浏览会话、搜索消息，并提取对话数据。

要求

• 已安装 Beeper 桌面应用（提供 SQLite 数据库）
• beeper-cli 二进制文件位于 PATH 环境变量中

数据库路径

CLI 会自动检测以下路径：
- ~/Library/Application Support/BeeperTexts/index.db (macOS)
- ~/Library/Application Support/Beeper/index.db (macOS)

可通过以下方式覆盖默认路径：
- --db /path/to/index.db
- BEEPER_DB=/path/to/index.db

命令

列出会话

beeper-cli threads list --days 7 --limit 50 --json

显示会话详情

beeper-cli threads show --id "!abc123:beeper.local" --json

列出会话中的消息

beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json

搜索消息（全文）

# 简单搜索
beeper-cli search 'invoice' --limit 20 --json

# 短语搜索
beeper-cli search '"christmas party"' --limit 20 --json

# 邻近搜索
beeper-cli search 'party NEAR/5 christmas' --limit 20 --json

# 附带上下文窗口（匹配消息前后的消息）
beeper-cli search 'meeting' --context 6 --window 60m --json

数据库信息

beeper-cli db info --json

注意事项

• 只读工具：此工具从不发送消息
• JSON 输出：始终使用 --json 参数以生成代理可解析的结构化输出
• FTS5 搜索：利用 Beeper 内置的全文索引（FTS5）实现快速搜索
• 私聊名称解析：可选择通过桥接数据库解析私聊名称（使用 --no-bridge 可禁用此功能）

安装

选项 1：Go Install（推荐）

go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest

选项 2：从源码构建

git clone https://github.com/krausefx/beeper-cli.git
cd beeper-cli
go build ./cmd/beeper-cli
# 将 beeper-cli 移至 PATH 路径，例如 /usr/local/bin

使用示例

搜索上周与工作相关的消息：

beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))'
beeper-cli search 'project deadline' --limit 10 --json

查找关于发票的消息（附带上下文）：

beeper-cli search 'invoice' --context 3 --json