wx-cli

wx-cli 直接读取 macOS 上微信的本地数据库，让用户和 AI Agent 都能访问聊天记录、联系人、群聊和媒体消息。数据默认留在本机，无需上传或依赖云端导出。 核心能力包括： 1. 数据库解密：通过 LLDB hook 捕获 PBKDF2 调用提取原始密钥，支持整库解密和增量解密，覆盖所有微信数据库。 2. 消息查询与搜索：按联系人、群聊、时间范围、消息类型查询历史消息；支持跨所有会话的全局关键词搜索；可按时间范围一次性读取所有会话消息（timeline），适合记忆补全和批处理。 3. 实时订阅：命令行持续监听新消息，或通过 SSE（/api/v1/events）将新消息实时推送给 Agent 和其他程序。 4. 导出与媒体处理：会话可导出为 JSON 或文本；支持解密图片、提取语音（需 ffmpeg）、解密视频号视频。 5. Agent 集成：自带可通过 npx skills add 安装的 Agent Skill，Claude Code、Codex、Cursor 等工具安装后可直接理解 wx-cli 的能力并调用。 6. REST API 服务：长驻服务复用已打开的数据库，提供 sessions、contacts、messages、timeline、search、media、events 等端点，支持 token 认证和远程访问。查询命令在服务运行时自动复用 API。 7. 隐私控制：可按账号隐藏指定联系人、群聊或带特定标签的联系人，查询和订阅时自动过滤（全文搜索除外）。 平台要求为 macOS（arm64 / Apple Silicon），微信版本 4.1.7 及以上。密钥提取需要关闭 SIP（System Integrity Protection），并启用 DevToolsSecurity 和开发者组权限。项目用 Rust 编写，提供预编译二进制和源码编译两种安装方式。 项目结构包含核心解密库、密钥提取与存储、CLI 入口、数据库查询、媒体解密、实时监控、账号上下文解析和平台路径管理等独立 crate。