项目概述
WeChat CLI 是由开发者 huohuoer 创建的命令行工具，用于查询本地微信数据，专为 LLM Agent 集成设计。
- GitHub: https://github.com/huohuoer/wechat-cli
- npm: https://www.npmjs.com/package/@canghe_ai/wechat-cli
- 许可证: Apache License 2.0
- 平台条件: 仓库列出 macOS、Windows、Linux 支持；npm 分发包目前以 macOS arm64 为主，其他环境需核对 pip 依赖、微信版本和进程访问权限，不能等同于所有平台开箱即用。
核心特性
- 🚀 安装入口 - npm 或 pip；查询前还需初始化和权限配置
- 📦 11 个命令 - sessions、history、search、contacts、members、stats、export、favorites、unread、new-messages、init
- 🤖 AI 优先 - 默认 JSON 输出
- 🔒 全程本地 - SQLCipher 即时解密
- 📊 丰富统计 - 发言排行、消息类型分布
- 📝 灵活导出 - Markdown 或纯文本
安装方式
npm install -g @canghe_ai/wechat-cli
其他平台可先按官方安装说明评估 pip 路径，要求 Python 3.10+：
pip install wechat-cli
安装完成不代表已取得数据库访问权限。init 会扫描微信进程提取密钥；macOS 可能需要完全磁盘访问权限，部分情况下会触发重新签名客户端。重新签名会改变应用安全属性，也可能影响更新，不能承诺“无风险”或“不会封号”。普通查询不应长期以管理员身份运行。
常用命令
| 命令 | 说明 |
|---|---|
| sessions | 列出最近会话 |
| history "名称" | 读取聊天记录 |
| search "关键词" | 搜索消息 |
| contacts | 搜索联系人 |
| unread | 显示未读会话 |
| members "群名" | 列出群成员 |
| stats "聊天名" | 聊天统计 |
| favorites | 查看收藏 |
技术原理
微信存储 SQLCipher 加密的 SQLite 数据库，通过扫描进程内存提取密钥、即时解密并本地查询。
AI Agent 集成
在 CLAUDE.md 中说明查询工具和允许访问的会话范围，可以帮助 AI 助手使用它；文件本身不会安装工具、授予系统权限或建立隐私隔离。先用少量非敏感数据测试，再决定允许哪些查询。
使用注意
- 对消息数据库的目标操作是只读查询；初始化、密钥保存、缓存和导出仍会在本机产生文件。
- CLI 的本地查询与 Agent 的数据流要分开看：查询结果交给云端模型、同步盘或远程日志后，数据就可能离开本机。
- 只访问自己有权处理的数据，保护
~/.wechat-cli/中的密钥、配置和导出；联系人隐私不因数据在自己的电脑上就自动消失。
资料核对：2026-10-13，依据官方 README、Python 配置和Apache-2.0 许可证。本次未重新安装或实测微信客户端兼容性。