WeFlow 4.3.0 完全本地微信聊天记录查看、分析与导出工具
一、WeFlow 是什么?
WeFlow是一款完全本地运行的微信聊天记录工具,支持实时读取、查看、分析并导出你的微信聊天数据。
与依赖云端服务的工具不同,WeFlow 的所有数据处理都在你自己的电脑上完成——聊天记录不会上传到任何第三方服务器,隐私边界清晰可控。
它面向以下场景:
- 想在电脑上更方便地浏览、检索微信聊天记录
- 需要把聊天内容导出为 HTML、Excel、JSON 等格式做备份或归档
- 想对私聊、群聊做统计分析,生成年度报告或双人专属报告
- 需要解密并预览聊天/朋友圈中的图片、视频、实况(Live Photo)
- 开发者希望通过本地 HTTP API 对接自己的脚本或系统
重要前提:仅支持微信4.0 及以上版本。
二、核心亮点
1. 完全本地,数据不出本机
WeFlow 直接读取本机微信数据库,在本地完成解密、展示、分析与导出。无需注册账号,无需联网上传聊天内容。
2. 实时同步,无需中间库
支持实时刷新最新消息,不需要额外生成一份「解密后的中间数据库」,占用更少、更新更快。
3. 功能全面,不止于「看聊天」
从聊天浏览、媒体解密,到私聊/群聊分析、年度报告、消息导出、朋友圈处理、联系人管理,再到 HTTP API 开放能力——WeFlow 已经是一套相对完整的微信数据本地工作台。
4. 跨平台支持
| 平台 | 架构 | 安装包格式 |
|---|---|---|
| Windows | Windows 10+,x64 | .exe安装包 |
| macOS | Apple Silicon(M 系列) | .dmg |
| Linux | x64 | .AppImage、.tar.gz |
Arch Linux 用户也可通过yay -S weflow安装。
三、功能详解
聊天模块
- 实时查看聊天记录,支持搜索与浏览
- 解密聊天中的图片、视频、实况(实况仅支持谷歌协议拍摄)
- 支持修改、删除本地展示的消息记录
- 消息防撤回:防止他人发送的消息被撤回后消失
- 新消息桌面弹窗提醒,支持黑白名单过滤
分析与报告
- 私聊分析:消息数量、类型占比、活跃时段分布等
- 群聊分析:成员信息、发言排行、活跃时段、媒体内容统计
- 年度报告:按年或跨年度生成可视化统计报告
- 双人报告:选定一位好友,基于双方聊天记录生成专属分析报告
消息导出
支持将聊天记录导出为多种格式:
- JSON
- HTML
- TXT
- Excel
- CSV
- PostgreSQL(PGSQL)
- ChatLab 专属格式
导出后还可配合 ChatLab 等工具做更深入的内容分析。
朋友圈
- 解密朋友圈图片、视频、实况
- 导出朋友圈内容
- 拦截朋友圈删除与隐藏操作
- 突破部分时间访问限制
联系人
- 导出好友、群聊、公众号信息
- 尝试找回曾经的好友(功能仍在完善中)
HTTP API(开发者向)
WeFlow 提供本地 HTTP API,可将消息能力映射为接口,便于自动化脚本与二次开发集成。
- 启用方式:设置 → API 服务 → 启动服务
- 默认地址:
http://127.0.0.1:5031 - 支持格式:原始 JSON 或 ChatLab 标准格式
- 接口文档:docs/HTTP-API.md
注意:HTTP API 目前处于早期阶段,接口可能会有变动。
四、首次配置指南(Windows)
首次使用需完成以下配置,才能正常连接微信数据:
步骤 1:确认微信版本
确保已安装并登录微信 4.0+。
步骤 2:设置数据库目录
选择微信数据根目录,一般为:
C:\Users\你的用户名\Documents\xwechat_files可点击「自动检测」,或手动选择目录。
注意:路径中不能包含中文字符,否则会校验失败。
步骤 3:设置缓存目录(可选)
可跳过,默认使用文档\WeFlow目录。
步骤 4:获取解密密钥
- 保持微信处于运行/登录状态
- 在 WeFlow 中点击「自动获取密钥」
- Windows 上若提示 Hook 安装成功,通常需要退出微信后重新登录一次
- 成功后自动识别微信账号(wxid)
步骤 5:获取图片密钥
数据库密钥获取成功后,图片密钥通常会自动计算;若失败,可尝试「从内存扫描」(需微信保持运行)。
步骤 6:安全防护(可选)
可设置应用访问密码,也可直接跳过。
完成以上步骤后,点击「完成并连接」,即可进入主界面。
六、技术架构简介
WeFlow 基于现代桌面应用技术栈构建:
| 层级 | 技术 |
|---|---|
| 桌面框架 | Electron |
| 前端界面 | React + TypeScript + Vite |
| 状态管理 | Zustand |
| 数据读取 | WCDB(微信数据库) |
| 媒体解密 | 原生 Node 模块 + WASM |
| 语音转写 | Sherpa-ONNX |
| 打包分发 | electron-builder |
整体采用「Electron 主进程 + React 渲染进程」架构:主进程负责数据库读取、解密、导出、API 服务等重计算任务;渲染进程负责 UI 展示与交互,通过 IPC 通信。
七、常见问题
Q1:检测不到微信数据目录?
- 确认微信 4.0+ 已安装且至少登录过一次
- 检查
Documents\xwechat_files是否存在 - 若微信安装在非默认位置,需手动选择数据目录
Q2:自动获取密钥失败?
- 确认微信进程正在运行且已完成登录
- Windows 上尝试退出微信后重新登录
- 以管理员权限运行 WeFlow(部分环境下 Hook 需要)
Q3:图片/视频无法显示?
- 确认图片密钥步骤已完成
- 保持微信运行后重试「从内存扫描」
Q4:支持哪些微信版本?
仅支持微信 4.0 及以上,更低版本无法使用。
Q5:数据安全吗?
WeFlow 在本地处理数据,不上传聊天记录。但仍建议:
- 妥善保管解密密钥
- 为 WeFlow 设置访问密码
- 不要将导出的聊天文件随意分享给他人
八、适用人群
| 人群 | 用途 |
|---|---|
| 普通用户 | 本地备份聊天、导出 HTML/Excel、查看朋友圈媒体 |
| 情侣/好友 | 生成双人专属聊天报告 |
| 社群运营者 | 群聊发言分析、活跃时段统计 |
| 数据爱好者 | 年度报告、可视化分析 |
| 开发者 | 通过 HTTP API 对接自动化工具 |
本地打包4.3.0版本资源:
通过网盘分享的文件:WeFlow.zip
链接: https://pan.baidu.com/s/1KHj6L_IZG7rFhfsWZOyacA?pwd=qvis 提取码: qvis
WeFlow —— 完全本地的微信聊天记录工具 🔒 ✅ 实时查看聊天,无需上传云端 ✅ 图片/视频/实况解密预览 ✅ 私聊群聊分析 + 年度报告 ✅ 导出 HTML / Excel / JSON 等 ✅ 支持 Windows / macOS / Linux 微信 4.0+ 可用 下载:https://github.com/hicccc77/WeFlow/releases 请负责任使用,遵守法律法规。