mirror of
https://github.com/hicccc77/WeFlow.git
synced 2026-05-13 15:10:05 +00:00
更新readme
This commit is contained in:
102
README.md
102
README.md
@@ -2,6 +2,8 @@
|
|||||||
|
|
||||||
WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析与导出工具。它可以实时获取你的微信聊天记录并将其导出,还可以根据你的聊天记录为你生成独一无二的分析报告。
|
WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析与导出工具。它可以实时获取你的微信聊天记录并将其导出,还可以根据你的聊天记录为你生成独一无二的分析报告。
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="app.jpg" alt="WeFlow 应用预览" width="90%">
|
<img src="app.jpg" alt="WeFlow 应用预览" width="90%">
|
||||||
</p>
|
</p>
|
||||||
@@ -18,91 +20,109 @@ WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析
|
|||||||
|
|
||||||
> [!TIP]
|
> [!TIP]
|
||||||
> 如果导出聊天记录后,想深入分析聊天内容可以试试 [ChatLab](https://chatlab.fun/)
|
> 如果导出聊天记录后,想深入分析聊天内容可以试试 [ChatLab](https://chatlab.fun/)
|
||||||
|
>
|
||||||
|
> If you want to analyze your exported chat content in depth, try [ChatLab](https://chatlab.fun/)
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> 仅支持微信 **4.0 及以上**版本,确保你的微信版本符合要求
|
> 仅支持微信 **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 等格式
|
- 导出聊天记录为 HTML 等格式 | Export chat history to HTML and other formats
|
||||||
- HTTP API 接口(供开发者集成)
|
- HTTP API 接口(供开发者集成)| HTTP API interface (for developer integration)
|
||||||
- 查看完整能力清单:[详细功能](#详细功能清单)
|
- 查看完整能力清单:[详细功能](#详细功能清单--detailed-feature-list) | View complete feature list: [Detailed Features](#详细功能清单--detailed-feature-list)
|
||||||
|
|
||||||
## 支持平台与设备
|
## 支持平台与设备 | Supported Platforms & Devices
|
||||||
|
|
||||||
| 平台 | 设备/架构 | 安装包 |
|
| 平台 Platform | 设备/架构 Device/Architecture | 安装包 Package |
|
||||||
|------|----------|--------|
|
|------|----------|--------|
|
||||||
| Windows | Windows10+、x64(amd64) | `.exe` |
|
| Windows | Windows10+、x64(amd64) | `.exe` |
|
||||||
| macOS | Apple Silicon(M 系列,arm64) | `.dmg` |
|
| macOS | Apple Silicon(M 系列 M series,arm64) | `.dmg` |
|
||||||
| Linux | x64 设备(amd64) | `.AppImage`、`.tar.gz` |
|
| Linux | x64 devices (amd64) | `.AppImage`、`.tar.gz` |
|
||||||
|
|
||||||
## 快速开始
|
## 快速开始 | Quick Start
|
||||||
|
|
||||||
若你只想使用成品版本,可前往 [Releases](https://github.com/hicccc77/WeFlow/releases) 下载并安装。
|
若你只想使用成品版本,可前往 [Releases](https://github.com/hicccc77/WeFlow/releases) 下载并安装。
|
||||||
|
|
||||||
> ArchLinux 用户可以选择 `yay -S weflow` 快速安装
|
If you just want to use the pre-compiled application, go to [Releases](https://github.com/hicccc77/WeFlow/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** | 解密聊天中的图片、视频、实况(仅支持谷歌协议拍摄的实况);支持**修改**、删除**本地**消息;实时刷新最新消息,无需生成解密中间数据库<br>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** | 防止其他人发送的消息被撤回<br>Prevent messages sent by others from being recalled |
|
||||||
| **实时弹窗通知** | 新消息到达时提供桌面弹窗提醒,便于及时查看重要会话,提供黑白名单功能 |
|
| **实时弹窗通知 Real-time Notifications** | 新消息到达时提供桌面弹窗提醒,便于及时查看重要会话,提供黑白名单功能<br>Desktop popup notifications when new messages arrive, convenient for timely viewing of important conversations, with blacklist/whitelist functionality |
|
||||||
| **私聊分析** | 统计好友间消息数量;分析消息类型与发送比例;查看消息时段分布等 |
|
| **私聊分析 Private Chat Analysis** | 统计好友间消息数量;分析消息类型与发送比例;查看消息时段分布等<br>Statistics on message counts between friends; analysis of message types and sending ratios; view message time distribution, etc. |
|
||||||
| **群聊分析** | 查看群成员详细信息;分析群内发言排行、活跃时段和媒体内容 |
|
| **群聊分析 Group Chat Analysis** | 查看群成员详细信息;分析群内发言排行、活跃时段和媒体内容<br>View detailed group member information; analyze group activity rankings, active periods, and media content |
|
||||||
| **年度报告** | 生成按年统计的年度报告,或跨年度的长期历史报告 |
|
| **年度报告 Annual Report** | 生成按年统计的年度报告,或跨年度的长期历史报告<br>Generate annual reports by year, or long-term historical reports across years |
|
||||||
| **双人报告** | 选择指定好友,基于双方聊天记录生成专属分析报告 |
|
| **双人报告 Duo Report** | 选择指定好友,基于双方聊天记录生成专属分析报告<br>Select a specific friend and generate an exclusive analysis report based on your mutual chat history |
|
||||||
| **消息导出** | 将微信聊天记录导出为多种格式:JSON、HTML、TXT、Excel、CSV、PGSQL、ChatLab专属格式等 |
|
| **消息导出 Message Export** | 将微信聊天记录导出为多种格式:JSON、HTML、TXT、Excel、CSV、PGSQL、ChatLab专属格式等<br>Export WeChat chat history to multiple formats: JSON, HTML, TXT, Excel, CSV, PGSQL, ChatLab proprietary format, etc. |
|
||||||
| **朋友圈** | 解密朋友圈图片、视频、实况;导出朋友圈内容;拦截朋友圈的删除与隐藏操作;突破时间访问限制 |
|
| **朋友圈 Moments** | 解密朋友圈图片、视频、实况;导出朋友圈内容;拦截朋友圈的删除与隐藏操作;突破时间访问限制<br>Decrypt Moments photos, videos, and Live Photos; export Moments content; intercept deletion and hiding operations in Moments; bypass time-based access restrictions |
|
||||||
| **联系人** | 导出微信好友、群聊、公众号信息;尝试找回曾经的好友(功能尚不完善) |
|
| **联系人 Contacts** | 导出微信好友、群聊、公众号信息;尝试找回曾经的好友(功能尚不完善)<br>Export WeChat friends, group chats, and official account information; attempt to recover deleted friends (work in progress) |
|
||||||
| **HTTP API 映射** | 将本地消息能力映射为 HTTP API,便于对接外部系统、自动化脚本与二次开发 |
|
| **HTTP API 映射 HTTP API** | 将本地消息能力映射为 HTTP API,便于对接外部系统、自动化脚本与二次开发<br>Map local message capabilities to HTTP API for easy integration with external systems, automation scripts, and secondary development |
|
||||||
|
|
||||||
## HTTP API
|
## HTTP API
|
||||||
|
|
||||||
> [!WARNING]
|
> [!WARNING]
|
||||||
> 此功能目前处于早期阶段,接口可能会有变动,请等待后续更新完善。
|
> 此功能目前处于早期阶段,接口可能会有变动,请等待后续更新完善。
|
||||||
|
>
|
||||||
|
> This feature is currently in its early stages, and the interface may change. Stay tuned for future updates.
|
||||||
|
|
||||||
WeFlow 提供本地 HTTP API 服务,支持通过接口查询消息数据,可用于与其他工具集成或二次开发。
|
WeFlow 提供本地 HTTP API 服务,支持通过接口查询消息数据,可用于与其他工具集成或二次开发。
|
||||||
|
|
||||||
- **启用方式**:设置 → 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.
|
||||||
- **默认端口**:5031
|
|
||||||
- **访问地址**:`http://127.0.0.1:5031`
|
|
||||||
- **支持格式**:原始 JSON 或 [ChatLab](https://chatlab.fun/) 标准格式
|
|
||||||
|
|
||||||
完整接口文档:[点击查看](docs/HTTP-API.md)
|
- **启用方式 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](https://chatlab.fun/) standard format
|
||||||
|
|
||||||
## 面向开发者
|
完整接口文档 Complete API documentation:[点击查看 Click to view](docs/HTTP-API.md)
|
||||||
|
|
||||||
|
## 面向开发者 | For Developers
|
||||||
|
|
||||||
如果你想从源码构建或为项目贡献代码,请遵循以下步骤:
|
如果你想从源码构建或为项目贡献代码,请遵循以下步骤:
|
||||||
|
|
||||||
|
If you want to build from source or contribute code to the project, please follow these steps:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 1. 克隆项目到本地
|
# 1. 克隆项目到本地 | Clone the project locally
|
||||||
git clone https://github.com/hicccc77/WeFlow.git
|
git clone https://github.com/hicccc77/WeFlow.git
|
||||||
cd WeFlow
|
cd WeFlow
|
||||||
|
|
||||||
# 2. 安装项目依赖
|
# 2. 安装项目依赖 | Install project dependencies
|
||||||
npm install
|
npm install
|
||||||
|
|
||||||
# 3. 运行应用(开发模式)
|
# 3. 运行应用(开发模式)| Run the application (development mode)
|
||||||
npm run dev
|
npm run dev
|
||||||
```
|
```
|
||||||
|
|
||||||
## 致谢
|
## 致谢 | Acknowledgments
|
||||||
|
|
||||||
- [密语 CipherTalk](https://github.com/ILoveBingLu/miyu) 为本项目提供了基础框架
|
- [密语 CipherTalk](https://github.com/ILoveBingLu/miyu) 为本项目提供了基础框架 | provided the basic framework for this project
|
||||||
- [WeChat-Channels-Video-File-Decryption](https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption) 提供了视频解密相关的技术参考
|
- [WeChat-Channels-Video-File-Decryption](https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption) 提供了视频解密相关的技术参考 | provided technical references for video decryption
|
||||||
|
|
||||||
## 支持我们
|
## 支持我们 | Support Us
|
||||||
|
|
||||||
如果 WeFlow 确实帮到了你,可以考虑请我们喝杯咖啡:
|
如果 WeFlow 确实帮到了你,可以考虑请我们喝杯咖啡:
|
||||||
|
|
||||||
|
If WeFlow has truly helped you, consider buying us a coffee:
|
||||||
|
|
||||||
> TRC20 **Address:** `TZCtAw8CaeARWZBfvjidCnTcfnAtf6nvS6`
|
> TRC20 **Address:** `TZCtAw8CaeARWZBfvjidCnTcfnAtf6nvS6`
|
||||||
|
|
||||||
## Star History
|
## Star History
|
||||||
@@ -121,4 +141,6 @@ npm run dev
|
|||||||
|
|
||||||
**请负责任地使用本工具,遵守相关法律法规**
|
**请负责任地使用本工具,遵守相关法律法规**
|
||||||
|
|
||||||
|
**Please use this tool responsibly and comply with relevant laws and regulations**
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
Reference in New Issue
Block a user