01
⌕
微信数据，全部可查
消息搜索、图片浏览、语音转文字、群聊成员、朋友圈、收藏、位置与文件。全部 10 种消息类型完整覆盖。
LOCAL-FIRST · AGENT NATIVE
把微信聊天记录
开放给Agent
本地解密读取，NAS 安全备份，释放电脑空间。
让你的 AI 检索、分析和回忆曾经发生的一切。
v0.5.4
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.4.0 → v0.5.4）
v0.5.4 · 远程打开记忆库不再弹密码框 8 月 11 日
- 修好「远程免密打开失效」：远程连接 NAS 时，从托盘一键打开记忆库控制台本应免密直达；但切换过本地/远程模式后，注入的钥匙会错成本地的，NAS 拒绝后弹出密码框。现在远程钥匙单独保管、互不覆盖，无论怎么切换，远程控制台都保持免密直达。
- 生效方式：重启本机常驻 agent 即生效，NAS 镜像无需升级。
v0.5.2 – v0.5.3 · 媒体查询提速，朋友圈图片能取回了 8 月 10 – 11 日
- 查询媒体不再卡住：记录积累很多之后，用 AI 查图片、语音、文件，以前可能卡住超过一分钟没响应；现在几乎瞬间返回。
- 朋友圈图片能取回了：以前无论本地还是远程模式，朋友圈的图片基本都取不到——微信保存缓存的时机和发帖时间对不上、图片尺寸对不上，导致匹配失败。现在按真实规律匹配，近期浏览过的朋友圈图片都能正常取回，同步时自动补全。
- 诚实说明：太老的帖子，如果微信本地缓存早已被清理，图片在任何机器上都拿不回来——这是微信的数据现实，不是备份失败。
- 生效方式：查询提速在 NAS 端，执行 upgrade.sh 升级镜像；朋友圈修复两端都要动——NAS 升级镜像 + 重启本机常驻 agent，重启后近期浏览过的朋友圈图片会在同步时自动补回。
v0.4.0 – v0.5.1 · 备份更完整：新格式不漏备、朋友圈可查、远程媒体可下载 8 月 5 – 10 日
- 微信新图片格式不再漏备：新版微信把新收到的图片存成新格式（wxgf / HEVC），以前会显示「未备份」、概览却显示「备份完成」；现在能识别这些格式，并自动把之前漏掉的补回来。
- 朋友圈也能备份了：帖子、评论、点赞、图片都存进记忆库，AI 能查全部历史——搜内容、看互动、找图片。
- 远程查询媒体可直接下载：远程连 NAS 时，查到的图片、语音会返回网络下载地址和缩略图小样；语音转成通用格式，点开就能听。
- 存储空间管理面板（MacOS 风格）：按账号、按媒体类型看占用，展开可看各聊天的分布；删除功能预览中。
- MCP 接入体验升级：集成页三种方式并列引导；通用 JSON 配置适用于所有 MCP 客户端；远程 NAS 也可用；撤销的令牌 30 天自动清理。
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_你的令牌"
}
}
}
}