wx-cli 用于从本地微信数据库查询聊天记录、联系人、会话、收藏、朋友圈和公众号文章，适合在终端或智能体流程中检索微信数据。
主要能力：wx sessions/unread/new-messages 查看会话与增量消息；wx history/search 按昵称、备注或微信 ID 查询聊天记录并支持时间范围与条数；wx contacts/members 查联系人与群成员；wx favorites 查收藏；wx sns-notifications/sns-feed/sns-search 处理朋友圈；wx biz-articles 查公众号文章；wx attachments 与 wx extract 提取聊天图片；wx stats 统计；wx export 导出 Markdown 或 JSON。命令默认输出 YAML，加 --json 便于程序解析。
使用方式：需 macOS、Linux 或 Windows，微信桌面版 4.x 已安装登录，Node.js >= 14 或 curl/源码构建。首次在本机 GUI 终端执行 sudo wx init（Windows 用管理员 PowerShell 执行 wx init），必要时用 sudo wx key extract --hook-seconds 90 补分片密钥。初始化后日常查询无需 sudo，daemon 首次调用自动启动。源码仓库 botiverse/wx-cli 当前为 private，推荐源码构建：git clone git@github.com:botiverse/wx-cli.git && cd wx-cli && cargo build --release，再复制到 ~/.local/bin/wx。
限制：macOS 无需关闭 SIP，默认不需重签微信；首次 init 需本机 GUI 终端，不要用 SSH。朋友圈只保存本地刷到过的内容；图片解码在 Linux 暂不支持 V2 image key 提取。默认输出条数不是硬上限，可用 -n 调整。密钥文件 all_keys.json 敏感，勿分享。