01
⌕
微信数据，全部可查
消息搜索、图片浏览、语音转文字、群聊成员、朋友圈、收藏、位置与文件。全部 10 种消息类型完整覆盖。
LOCAL-FIRST · AGENT NATIVE
把微信聊天记录
开放给Agent
本地解密读取，NAS 安全备份，释放电脑空间。
让你的 AI 检索、分析和回忆曾经发生的一切。
v0.2.0
macOS · Windows · Linux
W
AGENT QUERY
“找出去年我们讨论
产品命名的那次对话”
SEARCH RESULT
找到 14 条相关消息
跨 3 个会话 · 0.18s
◇
31.2304° N
121.4737° E
DATA ROUTE仅在本地
不联网不改代码不触发风控
MCP 原生自托管
01 / CAPABILITIES
不只是备份。
不只是备份。
是你的长期记忆层
WxArk 将散落在微信里的对话、关系和媒体，变成 AI 可以理解和调用的个人数据基础设施。
02
隐私留在本地
直接读取本机微信数据库，不模拟登录，不触碰微信服务端。断网也能完整检索。
03
长期数据沉淀
全量加增量同步，SQLite 索引与 SHA256 媒体去重。跨设备、跨时间分析，聊天记录不再是孤岛。
04
一套数据，多种入口
MCP 连接 Claude 等 AI Agent；CLI 用于脚本和自动化；Docker 服务端承担备份和远程访问。按需组合，互不冲突。
WECHAT DB→WXARK→
MCPCLINAS
02 / HOW IT WORKS
不联网、不改代码、
不联网、不改代码、
不触发风控
WxArk 从微信进程内存读取数据库密钥。不注入代码、不修改微信文件、不 Hook 任何 API。这是操作系统级的合法内存访问，与正常调试工具原理相同，不会引发微信安全风控。
内存提取密钥
从已登录微信的进程空间中读取数据库加密密钥，一次提取，持续使用。不修改微信任何文件，不注入第三方代码。
纯本地解密
SQLCipher 流式解密，全程离线运行。读取消息、联系人、图片、语音——不联网、不写入、不修改原数据。
Agent 直接调用
通过 MCP 协议接入 Claude 等 AI。Agent 像读本地文件一样读取你的聊天记录，数据不经过任何云端服务。
03 / SELF-HOSTED BACKUP
NAS 备份，
NAS 备份，
数据自己管
将微信聊天记录同步到自己的群晖或其他 Docker 主机。 本地 Agent 解密并推送，服务端提供全文搜索与媒体存储， 一切运行在你自己的硬件上。
朋友圈备份
帖子、评论、点赞、图片完整备份。AI 也能查朋友圈——搜内容、看互动、找图片。
全文搜索 · 中文友好
消息、语音转写、朋友圈内容统一检索，中文支持部分匹配，找聊天更快。
聊天图片视频解密
聊天中的加密图片、视频全部解密可读。重复图片自动去重，只存一份。
语音转文字
NAS 记忆库支持语音自动转录成文字，可搜索、可回看，支持多语言。
数据保留策略
图片、语音、视频可按 90 天 / 半年 / 1 年 / 3 年自动管理。删除前先出预演清单，不会误删。
增量同步 · 自动补全
只同步新增内容，越用越快；错过或后来的媒体会自动补传，不丢东西。
多账号 · 独立授权
每个微信账号独立备份、独立授权给 AI 查询，互不串号。
本地托管 · 100% 自主
Docker 一键部署，Caddy 自动 HTTPS。数据留在你自己的 NAS 上，无需任何第三方服务。
04 / DOWNLOADS
源码完全开放，
源码完全开放，
每版可追溯
每次发布生成独立版本包、SHA256 校验值与机器可读的更新清单。 下载后解压即可安装，无需注册或联网验证。
SHA256 将随版本文件一同提供📋 这次更新了什么？（v0.2.1 → v0.4.1）
v0.4.1 · 更快、更全、更好查 8 月 5 日
- 朋友圈同步变快了：以后只同步新增内容，不再每次重复扫描全部记录
- 朋友圈图片会自动补全：当时没同步上的图片，之后会自动补上
- 修复了一个问题：用 AI 查朋友圈时个别帖子查不到，现在每一篇都能查到
v0.4.0 · 朋友圈来了 8 月 5 日
- 新增朋友圈备份：帖子内容、评论、点赞、图片都能存进记忆库（NAS 也可以）
- AI 现在能查朋友圈：让 Claude 帮你搜朋友圈、看评论、找图片
- 多个微信账号时，每个账号可单独授权给 AI 查询，互不串号
v0.3.x · 更稳、更快、更好看 7 月
- 聊天记录更完整：修复了早期记录可能缺失的问题，历史消息补全
- 同步速度大幅提升，几十万条消息也能顺畅备份
- 聊天界面升级：谁发的消息一目了然，群聊显示发言人
- 图片、视频、语音、表情、位置、名片、应用卡片都有专属展示
- 语音消息可以直接播放，还能转成文字供搜索
- 中文搜索更聪明：支持部分匹配，找聊天更方便
- 新增数据保留设置：图片、语音、视频等可按 90 天 / 半年 / 1 年 / 3 年自动管理
- 备份进度显示更准确，不再“卡住不动”
- 修复了语音、图片串到别的聊天或错误时间的问题
05 / GET STARTED
从源码开始
需要 Python 3.11+，微信客户端已登录。下载源码包后解压，按对应平台执行即可。
⚠️ 微信版本支持边界：当前支持微信至 4.1.9.58。更新版微信可能改变数据库/密钥结构导致不可用，使用前请先降级回 4.1.9.58 或以下；升级微信前建议先备份并确认兼容。
QUICK START · macOS
# 1. 在解压后的 wxark 目录中安装
$ python3 --version # 必须是 3.11 或更高
$ python3 -m venv .venv
$ .venv/bin/python -m pip install -e .
# 2. 保持微信运行，提取密钥到 ~/.wxark/
$ sudo env HOME="$HOME" "$(pwd)/.venv/bin/python" -m agent.extract_keys
# 3. 看到最近会话即表示安装可用
$ .venv/bin/python -m agent.main cli sessions
06 / CONNECT
接入你的AI Agent
安装后运行一次同步，然后在托盘菜单点「配置 Claude 查询」（或执行
python -m agent.main mcp-token），把输出的配置粘贴到
Claude Desktop / Claude Code 或兼容客户端的 MCP 配置即可。配置指向本地记忆库的
HTTP MCP 端点，Token 自动签发。
mcp.json（示例，Token 请用实际签发值）
{
"mcpServers": {
"wxark": {
"type": "http",
"url": "http://127.0.0.1:8788/mcp",
"headers": {
"Authorization": "Bearer mcp_你的令牌"
}
}
}
}