架构概览

三层分离架构

后端 Python API + 前端 Nuxt/Vue + 桌面端 Electron 解耦设计

技术栈

完整技术栈明细

每一层都选用成熟开源技术,源码全部开放

🐍

后端 · Python 3.11+

技术用途
FastAPI + uvicornAPI异步 Web API 框架
cryptography ≥41.0通用加密算法支持
pycryptodome ≥3.23PBKDF2 + SHA512 密钥派生
pywin32 / pymemWindows 进程内存读写
yara-python内存特征扫描(YARA 规则)
wx_key ≥2.0.1微信密钥提取核心组件
psutil进程管理与系统信息
loguru日志系统
pilk / pypinyin / jieba图片处理、中文分词
🖥️

前端 · Node.js + Vue

技术用途
Nuxt 4 + Vue 3SSR 前端框架
Tailwind CSS 3.4原子化 CSS 样式
Pinia状态管理
GSAP + OGL年度总结 WebGL 动画
AxiosHTTP 客户端
@vueuse/motionVue 动效库
Electron桌面端打包框架
electron-builderNSIS 安装包生成
接口服务

RESTful API + Swagger 文档

后端 API 默认端口 10392,内置 Swagger 文档

🔌 API 端点概览

GET http://localhost:10392/docs

Swagger UI 交互式 API 文档,可在浏览器直接测试所有端点

GET http://localhost:10392/api/contacts

获取微信联系人列表

GET http://localhost:10392/api/chats/{chat_id}/messages

获取指定会话的消息记录,支持分页

POST http://localhost:10392/api/export

导出聊天记录,可指定格式和范围

GET http://localhost:10392/api/mcp/token

获取 MCP 服务 Bearer Token,用于 AI 客户端认证

构建流程

EXE 安装包构建流程

Electron + PyInstaller + NSIS 一体化打包

1

nuxt generate

前端 Nuxt 项目静态站点生成,输出 dist/ 目录

2

拷贝静态资源

将前端 dist/ 拷贝到 Electron 资源目录

3

PyInstaller 打包后端

Python 后端代码打包为独立 Windows exe

4

electron-builder 生成安装包

NSIS 打包为 WeChatDataAnalysis.Setup.{version}.exe

5

发布到 GitHub Release

上传安装包到 GitHub Releases,共 66 个版本积累