一个聊天记录工具，旨在帮助用户轻松使用自己的聊天数据。

chatlog

一个聊天记录工具，旨在帮助用户轻松使用自己的聊天数据。

Github地址

https://github.com/sjzar/chatlog

下载地址

https://github.com/sjzar/chatlog/releases

项目功能

• • 数据获取与支持：
• • 支持从本地数据库文件获取聊天数据。
• • 支持Windows和macOS系统。
• • 支持微信3.x和4.0版本。
• • 用户界面：
• • 提供Terminal UI界面，用户可以通过终端操作界面进行交互。
• • 提供命令行工具，用户可以通过命令行进行操作。
• • HTTP API服务：
• • 提供HTTP API服务，支持查询聊天记录、联系人、群聊、最近会话等信息。
• • 支持MCP SSE协议，可与支持MCP的AI助手无缝集成。

使用方法

• • 操作流程：
1. 1. 下载并安装微信客户端。
2. 2. 在手机微信上操作“我 - 设置 - 通用 - 聊天记录迁移与备份 - 迁移 - 迁移到电脑”，将手机中的聊天记录传输到电脑上。
3. 3. 下载chatlog预编译版本或从源码安装。
4. 4. 运行chatlog，按照提示进行操作，解密数据并开启HTTP服务后，即可通过浏览器或AI助手访问聊天记录。
• • macOS版本提示：
• • macOS用户在获取密钥前，需要确认已经关闭SIP并安装Xcode。
• • 关闭SIP的方法：
1. 1. 进入恢复模式。Apple Intel Mac：关机后，按住Command + R键开机，直到出现苹果标志和进度条。Apple Silicon Mac：关机后，按住开机键不松开，直到出现苹果标志和进度条。
2. 2. 打开终端。选项 - 实用工具 - 终端。
3. 3. 输入csrutil disable命令关闭SIP。
4. 4. 重启系统。
• • 目前的macOS版本方案依赖lldb工具，所以需要安装Xcode，可以从App Store进行下载。
• • 仅获取数据密钥步骤需要关闭SIP；获取数据密钥后即可重新打开SIP，不影响解密数据和HTTP服务的运行。
• • Terminal UI模式：
• • 启动程序：运行./chatlog。
• • 使用界面操作：
• • 使用方向键导航菜单。
• • 按Enter选择菜单项。
• • 按Esc返回上一级菜单。
• • 按Ctrl+C退出程序。
• • 命令行模式：
• • 获取微信数据密钥：运行./chatlog key。
• • 解密数据库文件：运行./chatlog decrypt。

HTTP API接口

• • 聊天记录：
• • 请求方式：GET
• • 请求地址：/api/v1/chatlog?time=2023-01-01&talker=wxid_xxx&limit=100&offset=0&format=json
• • 参数说明：
• • time：时间范围，格式为YYYY-MM-DD或YYYY-MM-DD~YYYY-MM-DD。
• • talker：聊天对象的ID，不知道ID的话也可以尝试备注名、昵称、群聊ID等。
• • limit：返回记录数量限制。
• • offset：分页偏移量。
• • format：输出格式，支持json、csv或纯文本。
• • 联系人列表：
• • 请求方式：GET
• • 请求地址：/api/v1/contact
• • 群聊列表：
• • 请求方式：GET
• • 请求地址：/api/v1/chatroom
• • 会话列表：
• • 请求方式：GET
• • 请求地址：/api/v1/session