Chatlog 概述：微信聊天记录的本地化结构性管理利器

Chatlog 是一款由 sjzar 基于 Go 语言开发的开源跨平台项目，其核心定位是“把散落在本地数据库里的微信聊天记录，变成可搜索、可调用的结构化数据”。它完美支持 Windows 与 macOS 操作系统，并且兼容微信 3.x 与 4.0 版本客户端。更重要的是，它无需 Root 或越狱即可读取并解密消息文件。Chatlog 启动后，您既可以在直观的 Terminal UI 中浏览记录，也能通过 CLI（命令行界面）与 HTTP API 对外提供服务，方便脚本或第三方应用调用，实现聊天记录的高级管理与利用。

Chatlog 功能亮点

• 本地数据自动发现 Chatlog 会智能扫描系统默认路径，并自动识别多个微信账号的数据目录。用户只需在简洁的界面中轻松点选，即可完成绑定与账号切换，管理多个微信 ID 的聊天记录。

• 全流程解密与多媒体处理 该工具内置了密钥（key）提取与数据库解密逻辑，确保能够安全、完整地读取您的聊天数据。图片、语音、视频等加密附件在请求时会实时解码，并以可直接浏览的文件流形式返回，极大方便了多媒体内容的管理。

• HTTP API + SSE 双栈输出 Chatlog 提供了强大的数据输出能力：

  • REST API：允许您查询单条消息、联系人信息、群聊列表、最近会话等结构化数据，满足各种查询需求。

  • SSE Endpoint：按照 MCP (Model Context Protocol) 标准推送增量数据，可与支持 MCP 的 AI 助手无缝对接，实现对话上下文的即取即用，为 AI 应用提供实时语境。

• 双界面交互

  • Terminal UI：支持键盘操作，提供类似邮件客户端的阅读体验，让浏览聊天记录更加舒适高效。

  • 命令行模式：完美适配自动化脚本与 DevOps 场景，便于开发者进行集成与批量操作。

• 多账号与安全模式 Chatlog 支持同时登录并管理多个微信 ID，实现一键切换，极大提升了多账号用户的管理效率。针对 macOS 用户，在提取密钥前可能需要临时关闭 SIP (System Integrity Protection)，以保障数据完整读取；Windows 用户若遇到排版错位问题，建议使用 Windows Terminal 解决显示兼容性。

Chatlog 快速上手

• 安装：您可以访问 GitHub 发行页下载预编译包，或在终端执行 go install github.com/sjzar/chatlog@latest 进行安装。

• 启动：在终端执行 chatlog 命令，默认会进入 TUI 界面。

• 解密：在菜单中选择“解密数据”，软件会自动拉取并解析 key.sqlite 文件，完成数据解密。

• 开启服务：选中“开启 HTTP 服务”，默认监听 127.0.0.1:8080，即可对外提供数据服务。

• 访问数据：

  • REST API：使用 GET /message?id=... 查询特定消息。

  • SSE：使用 GET /sse 获取增量数据流。

  • 多媒体：通过 GET /image/{id} / voice/{id} / file/{id} 访问图片、语音、文件等附件。

• 数据迁移：如您的桌面端聊天记录不全，可在微信电脑版中执行“从手机迁移聊天记录”功能，补全本地数据库。

Chatlog 应用场景

• 个人知识管理：将多年微信聊天记录打包进本地搜索系统，或集成到 Obsidian、Logseq 等笔记工具中，实现语义检索与深度数据洞察，将聊天记录转化为个人知识资产。

• 团队审计与合规：在遵守合规前提下，快速拉取业务群组中的谈判记录、售后纠纷记录等，生成可归档的 PDF 或报表，便于团队进行审计或总结。

• AI 对话扩展：借助 MCP SSE 功能，将实时聊天流无缝送入 ChatGPT、Claude 等大型语言模型 (LLM)，打造“即时语境”助手，实现自动纪要生成、情绪分析或智能回复等高级 AI 应用。

Chatlog 以其开源、本地化、高灵活性等特点，为用户提供了前所未有的微信聊天记录管理与利用方式。

附件内容