mirror of
https://github.com/hicccc77/WeFlow.git
synced 2026-03-24 23:06:51 +00:00
141 lines
5.2 KiB
Markdown
141 lines
5.2 KiB
Markdown
# WeFlow
|
||
|
||
WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析与导出工具。它可以实时获取你的微信聊天记录并将其导出，还可以根据你的聊天记录为你生成独一无二的分析报告
|
||
|
||
---
|
||
|
||
<p align="center">
|
||
<img src="app.png" alt="WeFlow" width="90%">
|
||
</p>
|
||
|
||
---
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/hicccc77/WeFlow/stargazers">
|
||
<img src="https://img.shields.io/github/stars/hicccc77/WeFlow?style=flat-square" alt="Stargazers">
|
||
</a>
|
||
<a href="https://github.com/hicccc77/WeFlow/network/members">
|
||
<img src="https://img.shields.io/github/forks/hicccc77/WeFlow?style=flat-square" alt="Forks">
|
||
</a>
|
||
<a href="https://github.com/hicccc77/WeFlow/issues">
|
||
<img src="https://img.shields.io/github/issues/hicccc77/WeFlow?style=flat-square" alt="Issues">
|
||
<img src="https://gh-down-badges.linkof.link/hicccc77/WeFlow/" alt="Downloads" />
|
||
</a>
|
||
<a href="https://t.me/weflow_cc">
|
||
<img src="https://img.shields.io/badge/Telegram%20频道-0088cc?style=flat-square&logo=telegram&logoColor=0088cc&labelColor=white" alt="Telegram">
|
||
</a>
|
||
</p>
|
||
|
||
|
||
> [!TIP]
|
||
> 如果导出聊天记录后，想深入分析聊天内容可以试试 [ChatLab](https://chatlab.fun/)
|
||
|
||
> [!NOTE]
|
||
> 仅支持微信 **4.0 及以上**版本，确保你的微信版本符合要求
|
||
|
||
## 主要功能
|
||
|
||
- 本地实时查看聊天记录
|
||
- 朋友圈图片、视频、**实况**的预览和解密
|
||
- 统计分析与群聊画像
|
||
- 年度报告与可视化概览
|
||
- 导出聊天记录为 HTML 等格式
|
||
- HTTP API 接口（供开发者集成）
|
||
- 查看完整能力清单：[详细功能](#详细功能清单)
|
||
|
||
## 支持平台与设备
|
||
|
||
|
||
| 平台 | 设备/架构 | 安装包 |
|
||
|------|----------|--------|
|
||
| Windows | Windows10+、x64（amd64） | `.exe` |
|
||
| macOS | Apple Silicon（M 系列，arm64） | `.dmg` |
|
||
| Linux | x64 设备（amd64） | `.AppImage`、`.tar.gz` |
|
||
|
||
|
||
## 快速开始
|
||
|
||
若你只想使用成品版本，可前往 [Releases](https://github.com/hicccc77/WeFlow/releases) 下载并安装。
|
||
|
||
> ArchLinux 用户可以选择 `yay -S weflow` 快速安装
|
||
|
||
## 详细功能清单
|
||
|
||
当前版本已支持以下能力：
|
||
|
||
| 功能模块 | 说明 |
|
||
|---------|------|
|
||
| **聊天** | 解密聊天中的图片、视频、实况（仅支持谷歌协议拍摄的实况）；支持**修改**、删除**本地**消息；实时刷新最新消息，无需生成解密中间数据库 |
|
||
| **实时弹窗通知** | 新消息到达时提供桌面弹窗提醒，便于及时查看重要会话，提供黑白名单功能 |
|
||
| **私聊分析** | 统计好友间消息数量；分析消息类型与发送比例；查看消息时段分布等 |
|
||
| **群聊分析** | 查看群成员详细信息；分析群内发言排行、活跃时段和媒体内容 |
|
||
| **年度报告** | 生成按年统计的年度报告，或跨年度的长期历史报告 |
|
||
| **双人报告** | 选择指定好友，基于双方聊天记录生成专属分析报告 |
|
||
| **消息导出** | 将微信聊天记录导出为多种格式：JSON、HTML、TXT、Excel、CSV、PGSQL、ChatLab专属格式等 |
|
||
| **朋友圈** | 解密朋友圈图片、视频、实况；导出朋友圈内容；拦截朋友圈的删除与隐藏操作；突破时间访问限制 |
|
||
| **联系人** | 导出微信好友、群聊、公众号信息；尝试找回曾经的好友（功能尚不完善） |
|
||
| **HTTP API 映射** | 将本地消息能力映射为 HTTP API，便于对接外部系统、自动化脚本与二次开发 |
|
||
|
||
## HTTP API
|
||
|
||
> [!WARNING]
|
||
> 此功能目前处于早期阶段，接口可能会有变动，请等待后续更新完善。
|
||
|
||
WeFlow 提供本地 HTTP API 服务，支持通过接口查询消息数据，可用于与其他工具集成或二次开发。
|
||
|
||
- **启用方式**：设置 → API 服务 → 启动服务
|
||
- **默认端口**：5031
|
||
- **访问地址**：`http://127.0.0.1:5031`
|
||
- **支持格式**：原始 JSON 或 [ChatLab](https://chatlab.fun/) 标准格式
|
||
|
||
完整接口文档：[点击查看](docs/HTTP-API.md)
|
||
|
||
|
||
## 面向开发者
|
||
|
||
如果你想从源码构建或为项目贡献代码，请遵循以下步骤：
|
||
|
||
```bash
|
||
# 1. 克隆项目到本地
|
||
git clone https://github.com/hicccc77/WeFlow.git
|
||
cd WeFlow
|
||
|
||
# 2. 安装项目依赖
|
||
npm install
|
||
|
||
# 3. 运行应用（开发模式）
|
||
npm run dev
|
||
|
||
```
|
||
|
||
## 致谢
|
||
|
||
- [密语 CipherTalk](https://github.com/ILoveBingLu/miyu) 为本项目提供了基础框架
|
||
- [WeChat-Channels-Video-File-Decryption](https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption) 提供了视频解密相关的技术参考
|
||
|
||
## 支持我们
|
||
|
||
如果 WeFlow 确实帮到了你，可以考虑请我们喝杯咖啡：
|
||
|
||
|
||
> TRC20 **Address:** `TZCtAw8CaeARWZBfvjidCnTcfnAtf6nvS6`
|
||
|
||
|
||
## Star History
|
||
|
||
<a href="https://www.star-history.com/#hicccc77/WeFlow&type=date&legend=top-left">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=hicccc77/WeFlow&type=date&theme=dark&legend=top-left" />
|
||
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=hicccc77/WeFlow&type=date&legend=top-left" />
|
||
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=hicccc77/WeFlow&type=date&legend=top-left" />
|
||
</picture>
|
||
</a>
|
||
|
||
<div align="center">
|
||
|
||
---
|
||
|
||
**请负责任地使用本工具，遵守相关法律法规**
|
||
|
||
</div>
|