企业官网建设流程全解析

• 后端
• CLI
• MCP 服务
• 即时通讯
• RAG
• 人工智能
• AI 技能

📌Chatlog Alpha是一款面向微信 4.x 的本地聊天数据读取、查询与分析开源工具，支持数据库解密、跨库搜索、Web 仪表盘、HTTP API 与 MCP 服务。本文带你3 步在 Windows 上跑通 Chatlog Alpha，完成微信数据库解密，并快速上手聊天记录查询。

Chatlog Alpha 是什么？

Chatlog Alpha 是一个纯本地运行的微信数据工具：数据库解密、查询、缓存都在你自己的电脑上完成，聊天记录不会上传到任何服务器。核心能力一览：

运行前准备：Windows 环境要求

在开始之前，请确认你的环境满足以下条件：

• ✅ Windows 10/11（x64 优先，推荐windows_amd64构建）
• ✅ 已安装并登录微信 PC 版（4.x 系列）
• ✅ 建议以管理员身份运行 Chatlog（进程内存扫描需要读取微信进程）

⚠️ 注意：Windows 端通过读取微信进程内存提取数据库和图片密钥，目前仍处于实验阶段——微信更新后扫描模式可能发生变化。详见 internal/wechat/key/windows/scanner_windows.go。

三步在 Windows 运行 Chatlog Alpha

第 1 步：下载并解压 Windows 构建包

下载与你平台匹配的压缩包，Windows 下命名格式如下：

💡 若从源码构建，windows/amd64需要 MinGW GCC，windows/arm64使用非 CGO 构建，构建矩阵定义在 Makefile 中。

第 2 步：登录微信并以管理员身份启动

1. 先启动并登录微信 PC 版（保持在线，不要退出）。
2. 解压压缩包，右键chatlog-windows-amd64.exe→以管理员身份运行，或在 PowerShell 中执行：

.\chatlog-windows-amd64.exe

程序启动后会进入 TUI（终端交互界面）。Chatlog 会自动通过进程打开的数据库文件定位微信账号与数据目录，相关实现见 internal/wechat/process/windows/detector_windows.go。

TUI 基本按键：

第 3 步：按 TUI 流程获取数据库密钥

进入主界面后，依次执行以下菜单项（界面逻辑见 internal/chatlog/app.go）：

1. 切换账号：确认选择了正确的微信账号。
2. 重启并获取数据库密钥：程序会收集数据库 salt、扫描微信进程内存中的密钥候选，并逐库验证后写入all_keys.json（流程见 internal/wechat/key/windows/data_key_windows.go）。
3. 获取图片密钥（可选）：仅在需要查看部分加密图片时执行；执行期间请在微信里打开几张图片大图，用于生成可识别的扫描样本（见 internal/wechat/key/windows/image_key_windows.go）。
4. 解密数据：建立本地工作目录并验证密钥可用。
5. 启动 HTTP 服务：成功后浏览器访问 http://127.0.0.1:5030/。

解密完成后：开始查询微信聊天数据

Web 控制台浏览

打开 http://127.0.0.1:5030/ 即可使用图形化控制台：会话列表、历史消息、群聊对比、消息趋势、数据库浏览与全局搜索，还可以直接浏览并访问图片、视频、语音等媒体文件。

用命令行查询

不想开浏览器？CLI 可以直连内置 HTTP API（完整说明见 skills/chatlog-http-cli/SKILL.md）：

# 查看所有可用接口 .\chatlog-windows-amd64.exe http list # 查询指定会话的历史消息 .\chatlog-windows-amd64.exe http call ` --endpoint history ` --query chat=<会话ID> ` --query limit=100 ` --query format=json # 执行只读 SQL 查询 .\chatlog-windows-amd64.exe http call ` --path /api/v1/db/query ` --query group=message ` --query file=message_0.db ` --query "sql=SELECT count(*) AS total FROM MSG"

这些接口封装在 cmd/chatlog/cmd_http.go 中，/api/v1/sessions、/api/v1/history、/api/v1/contacts、/api/v1/db/search等常用端点都可以用同样方式调用。

需要脚本化提取密钥？

chatlog key子命令可单独完成密钥提取（命令定义见 cmd/chatlog/cmd_key.go）：

# 自动探测账号目录，提取数据密钥 .\chatlog-windows-amd64.exe key # 仅输出密钥十六进制，便于脚本处理 .\chatlog-windows-amd64.exe key --json

常用文件位置速查

默认工作目录的取值逻辑见 pkg/util/os.go。

Windows 使用注意事项 ⚠️

1. 实验性能力：数据库密钥提取依赖进程内存扫描，微信版本更新后可能失效；建议关注项目更新。
2. 架构匹配：Chatlog 与微信架构应一致，优先使用windows_amd64构建；arm64版本因非 CGO 构建，语音转 MP3 等能力会受限。
3. 管理员权限：以管理员身份运行可显著降低内存读取失败的概率。
4. 端口占用：若 5030 端口被占用，HTTP 页面将无法打开；请在配置中更换监听地址。
5. 安全合规：请只处理你有权访问的本地数据；all_keys.json含敏感密钥，切勿提交到 Git 或上传云端。

总结

至此，你已经完成了 Windows 上 Chatlog Alpha 的完整入门：

下载构建包 → 管理员身份启动 → TUI 三步获取密钥 → 解密数据 → 通过 Web 控制台或 CLI 查询聊天记录。

接下来你可以继续探索 MCP 接口（/mcp、/sse），让 Chatlog Alpha 成为 AI Agent 的聊天数据底座。🚀

• 后端
• CLI
• MCP 服务
• 即时通讯
• RAG
• 人工智能
• AI 技能