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.

主要功能 | 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
导出聊天记录为 HTML 等格式 | Export chat history to HTML and other formats
HTTP API 接口（供开发者集成）| HTTP API interface (for developer integration)
查看完整能力清单：详细功能 | View complete feature list: Detailed Features

支持平台与设备 | Supported Platforms & Devices

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

快速开始 | Quick Start

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

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

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

ArchLinux users can quickly install with yay -S weflow

详细功能清单 | 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	将微信聊天记录导出为多种格式：JSON、HTML、TXT、Excel、CSV、PGSQL、ChatLab专属格式等 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 映射 HTTP API	将本地消息能力映射为 HTTP API，便于对接外部系统、自动化脚本与二次开发 Map local message capabilities to HTTP API for easy integration with external systems, automation scripts, and secondary development

HTTP API

Warning

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

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

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

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 服务 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

面向开发者 | 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

致谢 | Acknowledgments

密语 CipherTalk 为本项目提供了基础框架 | provided the basic framework for this project
WeChat-Channels-Video-File-Decryption 提供了视频解密相关的技术参考 | provided technical references for video decryption

支持我们 | Support Us

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

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