Chatlog 解析微信聊天记录
环境要求
- 操作系统: Windows 10
- 微信版本: 4.0.3.36（重要：必须使用此版本或更低版本）
- Go 版本: 1.25.2
- GCC 版本: 10.3.0（注意：不要使用 GCC 15，会导致编译失败）
下载源码
⚠️ 重要提示: 原仓库
https://github.com/sjzar/chatlog已删除，请使用以下 fork 仓库：
git clone https://github.com/imldy/chatlog.git
cd chatlog安装依赖
1. 安装 Go
-
访问 Go 官网 下载适合 Windows 的 Go 安装包
-
下载并安装 Go 1.25.2 或更高版本
-
验证安装：
go version
2. 安装 GCC
本项目需要 C 编译环境（cgo 依赖），必须使用 GCC 10.3.0。
⚠️ 重要提示: 使用 GCC 15 会导致编译运行失败！如果遇到编译问题，请降级到 GCC 10.3.0。
推荐安装方式：
-
访问 TDM-GCC
-
下载并安装 GCC 10.3.0 版本
-
安装时确保添加到系统 PATH 环境变量
-
验证安装：
gcc --version
编译运行
基本运行
go run main.go
编译运行后，程序会启动交互式界面，控制台会显示菜单选项：
- 获取密钥
- 解密数据
- 启动 HTTP 服务
验证服务运行
- 选择
3. 启动 HTTP 服务 - 等待服务启动完成
- 在浏览器中打开
http://127.0.0.1:5030查看 Web 界面，确认服务正常运行
编译打包成可执行程序 exe
go build -tags="sqlite_omit_load_extension" -ldflags="-w -s" -o ./bin/chatlog.exe .这样就会在 bin 文件夹里生成 chatlog.exe，以便直接运行
常见问题
问题 1: 无法获取密钥
症状: 运行"获取密钥"功能时失败或无法获取到密钥
原因: 微信版本更新后，程序代码与新版微信不匹配。项目已不再维护，无法适配新版微信。
解决方案:
使用旧版微信 4.0.3.36（Windows 最后一个可获取密钥的版本）
下载地址:
- https://github.com/iibob/WechatWindowsVersionHistory/releases/tag/v4.0 ustions](https://github.com/sjzar/chatlog/issues) 中查找类似问题
- 参考 issue #197: https://github.com/sjzar/chatlog/issues/197
问题 2: 阻止微信自动更新
如果需要长期保持在低版本且不让微信自动更新，可以使用以下方法：
方法 1: 微信设置
- 打开微信 → 设置 → 通用设置 → 取消勾选"有更新时自动升级微信"
方法 2: 修改 hosts 文件
-
以管理员权限打开
C:\Windows\System32\drivers\etc\hosts -
添加以下内容：
127.0.0.1 dldir1.qq.com 127.0.0.1 dldir1v6.qq.com
问题 3: GCC 版本不兼容
症状: 编译时出现错误或运行时崩溃
解决方案:
- 卸载当前 GCC 版本
- 重新安装 GCC 10.3.0
- 确保 PATH 环境变量中指向正确的 GCC 版本
与 AI 助手集成
Cherry Studio 集成
💡 推荐使用: Cherry Studio 能够完整执行所有步骤，而 Cursor 可能存在分批处理导致执行不完整的问题。
LLM 模型选择建议:
- 推荐使用智普清言 GLM-4.5
- 免费版本 GLM-4.5-flash 也可使用，但有时总结可能不够到位
- 避免使用推理过强的模型，以免每个步骤过度推理浪费 token 和时间
配置步骤:
-
启动
chatlog并开启 HTTP 服务（确认http://127.0.0.1:5030可访问） -
打开 Cherry Studio，进入
设置→MCP→添加 -
填写配置信息：
- 名称:
CHATLOG（可以自定义） - 类型:
sse - URL:
http://127.0.0.1:5030/sse
- 名称:
-
点击保存，然后在
工具标签中可以看到有 5 个可用工具：query_contact- 查询联系人query_chat_room- 查询群聊query_recent_chat- 查询最近会话query_chat_log- 查询聊天记录current_time- 获取当前时间
-
使用示例：询问 AI 助手 "总结XX聊天记录"，系统会自动调用相关工具进行分析
其他 AI 助手
如果使用其他支持 MCP 协议的 AI 助手，可以参考 MCP 集成指南 进行配置。
使用示例
配置完成后，你可以向 AI 助手提出以下类型的请求：
- "总结今天的聊天记录"
- "查询与XXX的聊天记录"
- "查找群聊'工作群'中关于项目的讨论"
- "列出最近的联系人"
- "查看某个时间段的所有聊天记录"
AI 助手会自动调用相应的工具来获取和分析聊天记录，为你生成总结或回答你的问题。
注意事项
- 数据安全: 所有数据处理均在本地进行，不会上传到任何服务器
- 微信版本: 必须使用微信 4.0.3.36 或更低版本才能获取密钥
- GCC 版本: 必须使用 GCC 10.3.0，其他版本可能导致编译失败
- 项目状态: 原项目已停止维护，如遇问题可在 fork 仓库或原仓库的 issues 中查找解决方案
相关链接
- 原仓库（已删除）: https://github.com/sjzar/chatlog
- Fork 仓库: https://github.com/imldy/chatlog.git
- 常见问题: https://github.com/sjzar/chatlog/issues/197
- TDM-GCC: https://jmeubank.github.io/tdm-gcc/
- 微信 4.0.3.36 下载: