Beeper聊天记录查询

技能简介

该技能通过命令行工具读取本地Beeper桌面应用存储的SQLite数据库，提供聊天记录的只读访问能力。支持按时间范围列出对话线程、查看线程详情、检索消息内容，以及基于FTS5的全文搜索功能。

能做什么

• 列出近期活跃的消息线程，支持按天数和数量过滤
• 查看指定线程的元数据和参与者信息
• 获取线程内的消息列表，支持分页
• 对全部聊天记录执行全文搜索，支持短语匹配和邻近词搜索
• 导出搜索结果时附带上下文消息（前后若干条）
• 输出标准JSON格式，便于自动化处理

使用说明

前置条件：需先安装Beeper桌面版应用（用于生成本地数据库），并确保beeper-cli可执行文件在系统PATH中。

安装步骤：

1. 使用Go直接安装：go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest
2. 或从源码构建后移至PATH目录

基本用法：

• 列出最近7天线程：beeper-cli threads list --days 7 --limit 50 --json
• 搜索关键词：beeper-cli search '发票' --limit 20 --json
• 带上下文的搜索：beeper-cli search '会议' --context 6 --window 60m --json

数据库路径自动检测macOS默认位置，也可通过--db参数或BEEPER_DB环境变量手动指定。

输入与输出

见下方输入与输出表格。

风险提示

• 本工具为只读操作，不会发送或修改任何消息
• 直接访问本地数据库文件，需注意文件权限保护
• 搜索结果可能包含敏感对话内容，处理输出时应注意数据安全
• 依赖Beeper桌面版的数据库格式，若官方更新结构可能导致兼容问题

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/krausefx/beeper/SKILL.md
来源类型：GitHub仓库