用途：在命令行查询本机微信的本地数据，包括会话、聊天记录、联系人、群成员、收藏、未读消息与统计，默认输出 JSON，面向 LLM/智能体工具调用设计。数据全部留在本机，运行时进行 SQLCipher 解密，工具为只读，不发送或修改消息。
安装：npm 全局安装 npm install -g @canghe_ai/wechat-cli（目前附带 macOS arm64 二进制，其他平台可用 pip）。pip 安装 pip install wechat-cli，需 Python>=3.10。源码安装：git clone https://github.com/freestylefly/wechat-cli.git，cd wechat-cli，pip install -e .。
初始化：使用前须先初始化以提取微信加密密钥。macOS/Linux 需 sudo wechat-cli init，Windows 需在管理员终端运行。要求微信正在运行；macOS 终端需授予“完全磁盘访问权限”。init 会自动检测数据目录、扫描进程内存中的密钥，并把配置保存到 ~/.wechat-cli/。若 macOS 出现 task_for_pid failed，工具会自动重签名微信，需按提示完全退出并重新登录微信后再运行 sudo init。
主要命令：sessions 列出最近会话（--limit、--format text）；history 读取聊天消息（支持 --limit、--offset、--start-time、--end-time、--type、--format）；search 搜索消息（可按 --chat 指定一个或多个会话、--type、时间范围）；contacts 搜索或查看联系人详情（--query、--detail，可用昵称或 wxid）；members 列出群成员；stats 查看聊天统计（消息总量、类型分布、前10发送者、24小时活跃分布）；export 导出会话（markdown 或 txt，可 --output 指定文件）；favorites 查看收藏（可按 --type、--query）；unread 查看未读会话；new-messages 增量获取新消息，状态存于 ~/.wechat-cli/last_check.json，删除可重置，适合 cron 自动化。
过滤与类型：--type 支持 text、image、voice、video、sticker、location、link、file、call、system。
智能体集成：所有命令默认 JSON，加 --format text 输出可读文本。可在 CLAUDE.md 中说明可用命令供 Claude Code 调用，例如查询未读、按关键词搜索项目更新、统计群活跃度、导出重要会话等。
配置与重置：配置存于 ~/.wechat-cli/（config.json、keys.json、last_check.json）。切换账号可再次运行 init 选择；重置可删除该目录后重新 init。
限制与系统要求：macOS>=10.15、微信 Mac<=4.1.8.100、pip 安装需 Python>=3.10、npm 安装需 Node.js。macOS Apple Silicon 附带 arm64 二进制；Intel、Windows、Linux 可通过 pip/源码使用，初始化在 macOS/Linux 需 sudo、Windows 需管理员权限。常见问题包括找不到数据目录、密钥提取失败（需重新 init）、数据库解密失败（版本变化需重新 init）、会话名需精确匹配、权限不足等。收费、价格与更详细平台支持暂未提供。