WeFlow is a fully local tool for viewing, analyzing, and exporting WeChat chat history in real time. It generates unique analysis reports based on your chat history.

Tip

如果导出聊天记录后，想深入分析聊天内容可以试试 ChatLab

If you want to analyze your exported chat content in depth, try ChatLab

Note

仅支持微信 4.0 及以上版本，确保你的微信版本符合要求

Only supports WeChat version 4.0 and above. Please ensure your WeChat version meets the requirements.

主要功能

本地实时查看聊天记录
朋友圈图片、视频、实况的预览和解密
统计分析与群聊画像
年度报告与可视化概览
导出聊天记录为 HTML 等格式
HTTP API 接口（供开发者集成）
查看完整能力清单：详细功能

Key Features

View chat history locally in real-time
Preview and decrypt Moments photos, videos, and Live Photos
Statistical analysis and group chat insights
Annual reports and visual overviews
Export chat history to HTML and other formats
HTTP API (for developer integration)
View complete feature list: Detailed Features

支持平台与设备

平台	设备/架构	安装包
Windows	Windows10+、x64（amd64）	`.exe`
macOS	Apple Silicon（M 系列，arm64）	`.dmg`
Linux	x64 设备（amd64）	`.AppImage`、`.tar.gz`

Supported Platforms & Devices

Platform	Device/Architecture	Package
Windows	Windows 10+, x64 (amd64)	`.exe`
macOS	Apple Silicon (M series, arm64)	`.dmg`
Linux	x64 devices (amd64)	`.AppImage`, `.tar.gz`

快速开始

若你只想使用成品版本，可前往 Releases 下载并安装。

ArchLinux 用户可以选择 yay -S weflow 快速安装

Quick Start

If you just want to use the pre-compiled application, go to Releases to download and install.

ArchLinux users can quickly install with yay -S weflow

详细功能清单

当前版本已支持以下能力：

功能模块	说明
聊天	解密聊天中的图片、视频、实况（仅支持谷歌协议拍摄的实况）；支持修改、删除本地消息；实时刷新最新消息，无需生成解密中间数据库
消息防撤回	防止其他人发送的消息被撤回
实时弹窗通知	新消息到达时提供桌面弹窗提醒，便于及时查看重要会话，提供黑白名单功能
私聊分析	统计好友间消息数量；分析消息类型与发送比例；查看消息时段分布等
群聊分析	查看群成员详细信息；分析群内发言排行、活跃时段和媒体内容
年度报告	生成按年统计的年度报告，或跨年度的长期历史报告
双人报告	选择指定好友，基于双方聊天记录生成专属分析报告
消息导出	将微信聊天记录导出为多种格式：JSON、HTML、TXT、Excel、CSV、PGSQL、ChatLab专属格式等
朋友圈	解密朋友圈图片、视频、实况；导出朋友圈内容；拦截朋友圈的删除与隐藏操作；突破时间访问限制
联系人	导出微信好友、群聊、公众号信息；尝试找回曾经的好友（功能尚不完善）
HTTP API 映射	将本地消息能力映射为 HTTP API，便于对接外部系统、自动化脚本与二次开发

Detailed Feature List

The current version supports the following capabilities:

Feature Module	Description
Chat	Decrypt images, videos, and Live Photos in chats (only supports Live Photos captured with Google protocol); supports modifying and deleting local messages; real-time refresh of latest messages without generating decrypted intermediate databases
Anti-Recall	Prevent messages sent by others from being recalled
Real-time Notifications	Desktop popup notifications when new messages arrive, convenient for timely viewing of important conversations, with blacklist/whitelist functionality
Private Chat Analysis	Statistics on message counts between friends; analysis of message types and sending ratios; view message time distribution, etc.
Group Chat Analysis	View detailed group member information; analyze group activity rankings, active periods, and media content
Annual Report	Generate annual reports by year, or long-term historical reports across years
Duo Report	Select a specific friend and generate an exclusive analysis report based on your mutual chat history
Message Export	Export WeChat chat history to multiple formats: JSON, HTML, TXT, Excel, CSV, PGSQL, ChatLab proprietary format, etc.
Moments	Decrypt Moments photos, videos, and Live Photos; export Moments content; intercept deletion and hiding operations in Moments; bypass time-based access restrictions
Contacts	Export WeChat friends, group chats, and official account information; attempt to recover deleted friends (work in progress)
HTTP API	Map local message capabilities to HTTP API for easy integration with external systems, automation scripts, and secondary development

HTTP API

Warning

此功能目前处于早期阶段，接口可能会有变动，请等待后续更新完善。

WeFlow 提供本地 HTTP API 服务，支持通过接口查询消息数据，可用于与其他工具集成或二次开发。

启用方式：设置 → API 服务 → 启动服务
默认端口：5031
访问地址：http://127.0.0.1:5031
支持格式：原始 JSON 或 ChatLab 标准格式

完整接口文档：点击查看

Warning

This feature is currently in its early stages, and the interface may change. Stay tuned for future updates.

WeFlow provides a local HTTP API service that supports querying message data through interfaces, which can be used for integration with other tools or secondary development.

Enable Method: Settings → API Service → Start Service
Default Port: 5031
Access Address: http://127.0.0.1:5031
Supported Formats: Raw JSON or ChatLab standard format

Complete API documentation: Click to view

面向开发者

如果你想从源码构建或为项目贡献代码，请遵循以下步骤：

# 1. 克隆项目到本地
git clone https://github.com/hicccc77/WeFlow.git
cd WeFlow

# 2. 安装项目依赖
npm install

# 3. 运行应用（开发模式）
npm run dev

For Developers

If you want to build from source or contribute code to the project, please follow these steps:

# 1. Clone the project locally
git clone https://github.com/hicccc77/WeFlow.git
cd WeFlow

# 2. Install project dependencies
npm install

# 3. Run the application (development mode)
npm run dev

致谢

密语 CipherTalk 为本项目提供了基础框架
WeChat-Channels-Video-File-Decryption 提供了视频解密相关的技术参考

Acknowledgments

CipherTalk provided the basic framework for this project
WeChat-Channels-Video-File-Decryption provided technical references for video decryption

支持我们

如果 WeFlow 确实帮到了你，可以考虑请我们喝杯咖啡：

TRC20 Address: TZCtAw8CaeARWZBfvjidCnTcfnAtf6nvS6

Support Us

If WeFlow has truly helped you, consider buying us a coffee:

TRC20 Address: TZCtAw8CaeARWZBfvjidCnTcfnAtf6nvS6

Star History

请负责任地使用本工具，遵守相关法律法规

Please use this tool responsibly and comply with relevant laws and regulations

README.md Unescape Escape

WeFlow