Chatlog

🧠 Chatlog 是什么？

Chatlog 是一款开源的聊天记录工具，帮助用户提取、解密并高效使用本地微信聊天数据。它支持命令行操作、终端 UI 界面和 HTTP API，可在本地部署并与 AI 助手无缝集成，适用于个人合规使用场景。
🔗 GitHub 地址：sjzar/chatlog

🎯 Chatlog 的应用场景

• 数据检索：快速查询某天、某人、某群的聊天记录，替代繁琐的微信查找。
• AI 助手上下文加载：与 ChatGPT、Claude、Monica 等 AI 助手对接，作为上下文知识源。
• 聊天数据备份分析：对历史对话进行备份、解读、分类。
• 内容生成辅助：从已有对话中提取灵感，用于内容创作或知识提炼。

🔧 Chatlog 的主要功能

• 本地数据库读取：自动识别并导入微信聊天数据（支持 Windows/macOS）。
• 自动数据解密：无需手动提取密钥，简化解密流程。
• 多媒体支持：图片、语音（自动转码 MP3）、文件等多媒体消息可实时访问与解密。
• 终端 UI 操作：提供交互式界面，快捷解密与数据浏览。
• HTTP API 接口：通过接口访问联系人、群聊、会话、聊天内容。
• MCP 协议集成：与支持 MCP 协议的 AI 工具（如 ChatWise、Cherry）无缝连接。
• 多账号支持：可切换多个微信账号的数据环境。

👥 Chatlog 的目标用户

• 技术爱好者：熟悉命令行、关注隐私且希望控制数据使用方式的用户。
• AI 深度用户：希望加载自有聊天历史作为 AI 上下文的高级用户。
• 研究人员：用于行为分析、社交网络分析、对话系统研究。
• 个人记录管理者：希望备份、提取生活或工作聊天记录的普通用户。

🚀 如何使用 Chatlog？

1. 安装程序：可通过 Go 安装或下载预编译版本（见 GitHub Release）。
2. 运行 chatlog：启动 Terminal UI 界面或用命令行模式操作。

3. 解密数据：

   • Windows/macOS：根据平台提示完成密钥提取（macOS 需临时关闭 SIP）。

4. 启动 HTTP 服务：

   chatlog server

5. 访问 API 接口：默认地址为 http://127.0.0.1:5030，支持 chatlog 查询、多媒体访问、MCP 接入等功能。

💰 Chatlog 免费试用及收费方式

• 完全免费开源，遵循 Apache 2.0 许可证
• GitHub 开源地址：https://github.com/sjzar/chatlog
• 禁止用于非法用途，用户需确保使用数据拥有合法访问权限

🧪 Chatlog 效果评测

• ✅ 性能轻巧：Go 编写，运行高效，资源占用极低。
• ✅ 隐私控制：本地运行，无需上传聊天记录，确保数据安全。
• ✅ 扩展性强：通过 API/MCP 可对接各种外部系统。
• ✅ 界面友好：终端 UI 对新手较为友好，命令行适合高阶用户。

🔁 替代工具推荐

• WechatExporter：支持导出微信记录为 HTML、PDF 等格式，但无解密和 AI 对接能力。
• WX Backup Viewer：Windows 下的图形化微信备份查看器，缺乏 API 和自动解密能力。
• QPush Chat Export：侧重聊天导出到文本或 Markdown，适合内容整理，但不支持多媒体或命令行操作。

❓ 常见问题解答

Q: Chatlog 能查看别人的微信记录吗？
A: ❌不行，仅限处理您“本地拥有或授权访问”的聊天数据，严禁非法使用。

Q: macOS 无法提取密钥怎么办？
A: 需暂时关闭 SIP（系统完整性保护）并安装 Xcode 命令行工具。

Q: 解密后原始语音是 SILK 格式吗？
A: 是的，Chatlog 会自动实时转码为 MP3 格式，方便播放和分析。

Q: 可以与哪些 AI 助手对接？
A: 原生支持 ChatWise、Cherry Studio 等 MCP 协议工具。Claude Desktop、Monica 等需用 mcp-proxy 转接。

🧭 AI工具网点评

Chatlog 是一个兼具实用性与技术深度的开源工具。它填补了“个人聊天记录结构化管理+AI 集成”这类高需求却少见的功能空白。尤其对于 AI 深度用户来说，Chatlog 可以将你的微信历史转化为 AI 上下文知识源，是“AI 私有知识库”建设的利器之一。

以下是为您精心整理的 Chatlog 使用手册与部署文档，适合初学者到高级用户的完整指南，确保您能顺利部署、解密数据并对接 AI 助手。

📘 Chatlog 使用手册与部署文档

🧠 Chatlog 是一个开源微信聊天记录工具，支持数据解密、本地 API 查询、多媒体解析，并能与 AI 助手集成使用。

✅ 环境准备

🖥️ 系统要求

• 支持 Windows 10+ 和 macOS（Intel / Apple Silicon）

• 推荐使用带终端的环境：

  • Windows：Windows Terminal
  • macOS：Terminal 或 iTerm2

🧰 所需工具

• ✅ Go 环境（仅源码编译用户）
• ✅ Git（可选，拉取源代码）
• ✅ 微信桌面版 数据文件

🚀 安装方式

方式一：下载预编译版本（推荐）

1. 访问 GitHub Releases 页面：
   🔗 https://github.com/sjzar/chatlog/releases
2. 下载对应系统的压缩包（例如：chatlog-macos-amd64.tar.gz）
3. 解压后，将 chatlog 文件放入系统路径或项目文件夹

方式二：通过 Go 安装（需已安装 Go）

go install github.com/sjzar/chatlog@latest

安装完成后，chatlog 会出现在 $GOPATH/bin 路径中。

📂 微信数据准备

数据路径（默认）

数据不全？手机迁移方法：

1. 打开微信手机端 → 我 → 设置 → 通用 → 聊天记录迁移
2. 选择“迁移到电脑” → 扫码连接桌面版微信，完成迁移

🔐 数据解密

Windows 用户

直接运行以下命令：

chatlog key       # 获取密钥
chatlog decrypt   # 解密数据库

macOS 用户

1. 暂时关闭 SIP（系统完整性保护）：

# 进入恢复模式：
# Intel Mac：重启按 Command + R
# Apple Silicon：重启长按电源键

csrutil disable  # 在恢复终端中执行

2. 安装开发工具：

xcode-select --install

3. 获取密钥并解密：

chatlog key
chatlog decrypt

4. 解密完成后可重新启用 SIP：

csrutil enable

🖥️ 使用方式

方法一：Terminal UI 界面

chatlog

操作方式：

• ↑ / ↓：选择菜单项
• Enter：确认选择
• Esc：返回上级
• Ctrl+C：退出程序

方法二：命令行模式

chatlog key       # 获取密钥
chatlog decrypt   # 解密数据库
chatlog server    # 启动 HTTP 服务

🌐 启动本地 HTTP API 服务

chatlog server

默认服务地址：http://127.0.0.1:5030

🔎 HTTP API 接口文档

返回格式支持：JSON / CSV / 文本格式（通过 format 参数指定）

🤖 与 AI 助手集成（MCP 协议）

Chatlog 支持 Model Context Protocol（MCP），可将聊天记录作为上下文集成到 AI 工具中。

启用 SSE 服务：

chatlog server

MCP SSE 地址：

http://127.0.0.1:5030/sse

支持平台：

🧪 示例 Prompt 用法

帮我查看我和 wxid_abc 从2022年开始的所有聊天中提到“合同”或“报价”的内容。

总结我和群聊“产品组”这两周的沟通重点，关注 deadline、需求变更、版本上线。

Prompt 可嵌入 ChatGPT 或其他助手中与 Chatlog 数据结合使用。

⚠️ 注意事项与免责声明

• 本项目仅供学习、研究、自有数据处理使用
• 严禁用于任何非法用途或查看他人数据
• 使用需遵守 Apache 2.0 许可协议
• 所有风险由用户自行承担，作者不负任何责任

📌 附加资源

• 🔗 GitHub 项目主页：https://github.com/sjzar/chatlog
• 📖 MCP 协议文档：MCP Spec
• 🎓 常见问题解答：GitHub Discussions