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 解密并推送，服务端提供全文搜索与媒体存储， 一切运行在你自己的硬件上。
全文搜索
消息内容 + 语音转文字结果全部纳入 FTS5 索引，支持中英文关键词检索。
图片解密 · 100% 命中
微信 .dat 加密图片全部解密可读。跨聊天室重复图片 SHA256 去重，只存一份。
语音转文字
语音消息自动提取并转录为可搜索文本，SenseVoice 模型，支持多语言识别。
本地托管 · 100% 自主
Docker 一键部署，Caddy 自动 HTTPS。数据留在你自己的 NAS 上，无需任何第三方服务。
高速同步
750 条/秒推送，增量断点续传，68 万+ 消息实测验证。
多账号 · 隔离
每台设备的微信账号独立 task，物理隔离。API Key + MCP Token 双重鉴权。
04 / DOWNLOADS
源码完全开放，
源码完全开放，
每版可追溯
每次发布生成独立版本包、SHA256 校验值与机器可读的更新清单。 下载后解压即可安装，无需注册或联网验证。
SHA256 将随版本文件一同提供
05 / GET STARTED
从源码开始
需要 Python 3.11+，微信客户端已登录。下载源码包后解压，按对应平台执行即可。
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 Desktop 或兼容客户端的 MCP 配置文件。Windows 用户将 command 改为 .venv\Scripts\python.exe。
mcp.json
{
"mcpServers": {
"wxark-agent": {
"command": "/绝对路径/wxark/.venv/bin/python",
"args": ["-m", "agent.mcp_server"],
"cwd": "/绝对路径/wxark"
}
}
}