wx-cli

在微信成为生活与工作核心的今天，其封闭的数据生态往往让自动化处理变得困难。wx-cli 是一款基于 Rust 开发的命令行工具，允许用户通过终端直接查询、搜索、统计和导出本地微信数据。

不同于传统截图或手动复制，wx-cli 通过扫描进程内存提取解密密钥，结合后台 Daemon 缓存机制，实现毫秒级响应与完全本地化的数据访问。更令人兴奋的是，它原生支持作为 AI Agent Skill 集成到 Claude Code、Cursor 等智能体中，让 AI 能够实时读取你的聊天上下文，打造真正的“微信记忆”助手。

核心亮点：极速、本地、AI 原生

1. 毫秒级响应与智能缓存

• Daemon 架构：采用 wx (CLI) + wx-daemon (后台进程) 模式，通过 Unix Socket 通信。
• mtime 感知复用：首次解密后将数据库缓存至 ~/.wx-cli/cache/。若文件修改时间（mtime）未变，直接复用缓存，无需重复解密，实现极速查询。
• 增量获取：支持 wx new-messages 获取上次检查后的新消息，避免全量扫描。

2. 完全本地化，隐私安全第一

• 数据不出机：所有数据处理均在本地完成，实时解密，无需上传云端。
• 内存提取密钥：通过 macOS Mach VM API 或 Linux /proc/<pid>/mem 扫描微信进程内存，提取 SQLCipher 解密密钥，无需破解文件或注入代码。
• 零依赖安装：单一 Rust 二进制文件，一行命令即可在全平台部署。

3. AI Agent 原生集成

• Skill 一键安装：通过 npx skills add jackwener/wx-cli 即可将工具注册为 Claude Code、Cursor、Codex 等 Agent 的技能。
• 结构化输出：默认输出 YAML 格式，节省 Token 且易读；支持 --json 切换，方便 jq 处理或 AI 解析。
• 上下文增强：让 AI 能够直接读取聊天记录、联系人信息，实现基于真实对话历史的智能回复或总结。

4. 全维度数据覆盖

• 会话与消息：查询最近会话、未读消息、历史记录，支持按时间范围、关键词搜索。
• 朋友圈 (SNS)：独立区分“通知”与“帖子”，支持搜索朋友圈正文、查看互动通知及媒体元数据。
• 联系人与群组：列出联系人、搜索好友、获取群成员列表。
• 收藏与统计：管理收藏夹（支持类型筛选），生成聊天统计数据（如消息数量、活跃时间段）。
• 灵活导出：支持导出为 Markdown（适合阅读归档）或 JSON（适合数据分析）。

快速开始

1. 安装

npm (推荐，全平台):

npm install -g @jackwener/wx-cli

macOS / Linux (curl):

curl -fsSL https://raw.githubusercontent.com/jackwener/wx-cli/main/install.sh | bash

Windows (PowerShell, 管理员运行):

irm https://raw.githubusercontent.com/jackwener/wx-cli/main/install.ps1 | iex

2. 初始化 (仅需一次)

macOS:
由于系统保护，需对微信进行 ad-hoc 签名以允许内存扫描：

# 1. 签名 (微信更新后需重做)
codesign --force --deep --sign - /Applications/WeChat.app

# 2. 重启微信并登录
killall WeChat && open /Applications/WeChat.app

# 3. 初始化 (需 sudo 以访问内存)
sudo wx init

Linux / Windows:

# Linux
sudo wx init

# Windows (管理员 PowerShell)
wx init

3. 验证与使用

# 查看最近会话
wx sessions

# 搜索关键词
wx search "会议" --in "工作群" --since 2026-01-01

# 导出聊天记录为 Markdown
wx export "张三" --format markdown -o chat_with_zhangsan.md

# AI Agent 友好输出
wx history "李四" -n 10 --yaml

4. 集成 AI Agent

在 Cursor 或 Claude Code 中：

npx skills add jackwener/wx-cli

安装后，Agent 将自动读取 SKILL.md，你只需自然语言指令如：“帮我查一下昨天‘产品群’里关于‘上线时间’的讨论”，Agent 即可自动调用 wx-cli 获取并总结内容。

架构原理

1. 密钥提取：微信使用 SQLCipher 加密数据库。wx-cli 扫描微信进程内存，匹配 WCDB 缓存的 raw key 格式 (x'<64hex_key><32hex_salt>')。
2. 解密与缓存：Daemon 进程利用提取的密钥解密数据库，并将结果缓存至本地。
3. 增量更新：通过监测数据库文件的 mtime，仅在文件变更时重新解密，否则直接读取缓存，确保高性能。