1. 项目定位与用途
微信AI记忆库（WeChat AI Memory）是一款面向个人用户的本地优先微信聊天记录整理工具，核心目标是将散落在微信私聊、群聊中的对话转化为结构化、可追溯的个人上下文记忆，为AI Agent、大模型分析提供可信的上下文数据支撑。项目坚持开源免费、数据本地处理的原则，避免使用付费闭源导出工具，让用户完全掌控自己的聊天记忆资产。当前版本优先完成可靠的数据提取与归档能力，后续可在此基础上扩展语义检索、RAG、MCP与Agent工作流等能力。
项目档案应用项目
微信AI记忆库 - 本地优先的Windows微信聊天记录整理导出工具，支持PDF/Markdown/JSON导出
ikevss/wechat-ai-memory：微信AI记忆库是本地优先的Windows桌面应用，可读取本机微信4.x聊天记录，按会话/日期/关键词筛选后导出为PDF、Markdown、结构化本页整理它解决什么问题、适用场景、安装方式和使用方法。
219Star 于 2026年9月9日2026年9月10日 更新
AI 总结
微信AI记忆库是本地优先的Windows桌面应用，可读取本机微信4.x聊天记录，按会话/日期/关键词筛选后导出为PDF、Markdown、结构化JSON，全程数据不上传，为AI提供可追溯的个人上下文记忆。
中文项目介绍
微信AI记忆库是一款开源免费的本地优先Windows桌面应用，核心定位是将散落在微信私聊、群聊中的对话整理成可被AI读取的个人上下文记忆，解决聊天记录分散难归档、无法作为AI上下文的问题，替代付费闭源的微信导出工具，保障用户对聊天数据的完全掌控与隐私安全。
当前版本支持自动读取本机Windows微信4.x的账户数据，仅处理只读解密临时副本，可覆盖文本、图片、文件、语音、系统消息，支持V2/WXGF原图恢复、SILK语音本地转写，用户可按会话、日期范围、关键词筛选目标消息，最终导出为PDF、Markdown与规范化JSON格式，也可选择生成分页PNG。
项目坚持本地优先设计，全程无遥测、无远程API、无聊天内容上传，数据库密钥不会写入磁盘，临时文件会在数据源关闭时自动删除；采用分层架构，通过ChatSource协议屏蔽不同数据源差异，GUI桌面界面与命令行入口共享同一套导出编排能力，既支持普通用户解压即用，也支持开发者基于Python环境二次开发。
详细信息与使用说明
2. 解决的问题
项目主要解决三类核心问题：一是微信聊天记录分散在不同会话中，手动筛选归档效率极低，难以快速提取特定项目、事件相关的上下文信息；二是现有微信导出工具多为付费闭源产品，数据处理边界不透明，用户无法确认聊天数据是否被上传或滥用；三是散落的聊天记录无法直接作为AI的上下文输入，模型只能从不完整的信息中猜测，导致分析、总结、咨询等AI任务准确率低。项目通过本地优先的数据处理流程，从根源上规避隐私风险，同时输出AI可直接读取的结构化格式。
3. 适用场景
该工具适用于多类使用场景：一是项目/事件复盘场景，可整理特定时间段内与项目相关的群聊、私聊记录，生成可追溯的上下文档案，供团队成员或AI分析事件脉络、决策依据；二是个人记忆归档场景，可将重要的私人聊天、工作沟通记录导出为PDF/Markdown格式本地留存，避免微信本地数据丢失后无法找回；三是AI上下文准备场景，提取特定会话的聊天记录输出为结构化JSON，直接作为大模型、Agent的上下文输入，提升AI任务的理解准确率。仓库中未明确给出企业级批量处理场景的适配说明。
4. 安装方式
项目提供两种安装方式适配普通用户与开发者：普通用户可直接前往GitHub Release页下载预编译软件包，选择便携版EXE（双击即可运行，无需安装）或ZIP完整包（解压后运行目录内EXE，启动速度更快），软件包已内置Python、Qt、Frida等运行依赖，目标电脑无需额外安装开发环境。开发者需准备Windows 10/11 x64系统与Python 3.11+环境，克隆仓库后创建独立虚拟环境，执行pip install -e ".[gui,dev]"安装依赖，再运行app.py即可启动，完整开发、测试、打包流程可参考开发文档。
5. 使用方式
工具支持GUI桌面界面与命令行两种使用方式：GUI方式下，启动后自动检测本机Windows微信4.x账户目录，点击连接微信后微信会重启，需在5分钟内扫码或手机确认登录，之后可选择目标会话、日期范围、关键词筛选消息，可选读取聊天图片或转写语音消息，选择输出路径后点击生成即可获得PDF、Markdown、结构化JSON格式的记忆档案。命令行方式下，可通过wechat-context-exporter命令指定JSON数据源、会话ID、日期范围等参数直接导出，无需连接微信。仓库中未明确给出Mac/Linux系统的使用方式说明。
6. 实现特点与限制
项目核心实现特点包括：一是本地优先隐私设计，全程无遥测、无远程API、无聊天内容上传，数据库密钥不写入磁盘，临时解密副本与恢复图片仅存于系统临时目录，数据源关闭后自动删除；二是多格式支持，除PDF、Markdown、结构化JSON外，还支持V2/WXGF微信原图恢复、EXIF方向修正、300DPI高清独立图片页、SILK语音本地faster-whisper转写；三是分层架构设计，通过ChatSource协议屏蔽微信内部数据库与JSON数据源的差异，GUI与CLI入口共享同一套导出编排能力。当前版本为v0.3.7-alpha测试版，仅支持Windows微信4.x，微信版本升级后可能需要适配，暂未实现AI问答、RAG、OCR能力。
思维导图
微信AI记忆库
核心定位
本地优先
开源免费
AI上下文记忆整理
功能模块
消息筛选
图片处理
语音转写
记忆归档
数据源
Windows微信4.x
本地JSON文件
导出能力
PDF
Markdown
结构化JSON
分页PNG
隐私设计
无数据上传
无遥测
临时文件自动清理
密钥不落盘
使用入口
PySide6桌面GUI
命令行工具
常见问题
是否支持Mac或Linux系统？
当前版本仅支持Windows 10/11 x64系统，仓库中未明确给出其他操作系统的适配计划。
聊天数据会上传到服务器吗？
不会，项目坚持本地优先设计，全程无遥测、无远程API、无聊天内容上传，所有数据处理均在本地完成。
是否支持微信5.x或更高版本？
当前仅验证支持Windows微信4.x，微信版本升级可能改变内部数据格式，仓库中未明确给出对新版本的支持说明。
语音转写需要联网吗？
首次使用需联网下载约500MB的本地faster-whisper转写模型，模型下载完成后可离线使用，语音内容不会上传。
是否支持AI问答或语义检索功能？
当前版本暂未实现AI问答、RAG、OCR等能力，仓库中未明确给出相关功能的开发时间表。