MCPcopy
hub / github.com/hicccc77/WeFlow

github.com/hicccc77/WeFlow @v5.0.1 sqlite

repository ↗ · DeepWiki ↗ · release v5.0.1 ↗
4,413 symbols 13,164 edges 213 files 314 documented · 7%
README

WeFlow 应用预览

WeFlow

WeFlow 是一个完全本地的微信实时聊天记录查看、分析与导出工具。

它可以获取你的微信聊天记录并将其导出，还可以根据你的聊天记录为你生成独一无二的数据与年度报告。

Stargazers Forks Downloads

Telegram Channel Star History Rank

[!TIP] 仅支持微信 4.0 及以上版本

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

主要功能

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

支持平台与设备

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

快速开始

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

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

详细功能清单

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

HTTP API

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

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

完整接口文档：点击查看

面向开发者

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

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

# 2. 安装项目依赖
npm install

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

致谢

推广与合作

如果您对 WeFlow 有兴趣，或者希望与我们展开深度合作，欢迎随时通过邮件取得联系。我们非常期待与各位创作者、开发者及合作伙伴共同探索。

联系方式

欢迎发送邮件至：

Protonmail

合作伙伴

我们非常欢迎优秀的开源社区项目团队或其他团队与我们建立长期合作关系。期待与 WeFlow 携手并进，共同建设更开放的生态！

贡献者

感谢所有做出贡献的开发者！

Contributors

Star History

<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=hicccc77/WeFlow&type=date&legend=top-left" />

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

Extension points exported contracts — how you extend this code

WorkerMessage (Interface)
* Worker 消息接口
electron/services/wcdbService.ts
WorkerConfig (Interface)
(no doc)
electron/annualReportWorker.ts
ChatHistoryPayloadEntry (Interface)
(no doc)
electron/main.ts
WorkerConfig (Interface)
(no doc)
electron/dualReportWorker.ts
WorkerParams (Interface)
(no doc)
electron/transcribeWorker.ts
ExportWorkerConfig (Interface)
(no doc)
electron/exportWorker.ts
ChatStatistics (Interface)
(no doc)
src/types/analytics.ts
ChatAnalysisHeaderProps (Interface)
(no doc)
src/components/ChatAnalysisHeader.tsx

Core symbols most depended-on inside this repo

push
called by 616
electron/services/chatService.ts
get
called by 503
electron/services/config.ts
set
called by 332
electron/services/config.ts
get
called by 322
electron/utils/LRUCache.ts
has
called by 311
electron/utils/LRUCache.ts
set
called by 259
electron/utils/LRUCache.ts
add
called by 221
electron/services/chatService.ts
extractXmlValue
called by 170
electron/services/export/parsers/xmlExtractor.ts

Shape

Method 2,026
Function 1,818
Interface 441
Class 126
Enum 2

Languages

TypeScript100%

Modules by API surface

electron/services/chatService.ts357 symbols
src/services/config.ts260 symbols
electron/assets/wasm/wasm_video_decode.js225 symbols
electron/services/export/core/ExportContext.ts215 symbols
electron/services/wcdbCore.ts173 symbols
src/pages/ChatPage.tsx158 symbols
electron/services/imageDecryptService.ts139 symbols
src/pages/SettingsPage.tsx128 symbols
electron/services/httpService.ts116 symbols
electron/main.ts107 symbols
electron/services/wcdbService.ts98 symbols
electron/services/messagePushService.ts88 symbols

Dependencies from manifests, versioned

@electron/rebuild4.0.2 · 1×
@types/react19.1.0 · 1×
@types/react-dom19.1.0 · 1×
@vitejs/plugin-react6.0.3 · 1×
@vscode/sudo-prompt9.3.2 · 1×
echarts6.0.0 · 1×
echarts-for-react3.0.2 · 1×
electron41.1.1 · 1×
electron-builder26.8.1 · 1×
electron-store11.0.2 · 1×
electron-updater6.3.9 · 1×
esbuild0.28.1 · 1×

For agents

$ claude mcp add WeFlow \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact