WeChat CLI：一个本地微信数据查询工具，专为 AI Agent 设计
项目概述
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 install -g 一键安装
- 📦 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 安装：pip install wechat-cli
常用命令
| 命令 | 说明 |
|---|---|
| sessions | 列出远够会话 |
| history "名称" | 读取聊天记录 |
| search "关键词" | 搜索消息 |
| contacts | 搜索联系人 |
| unread | 显示未读会话 |
| members "群名" | 列出群成员 |
| stats "聊天名" | 聊天统计 |
| favorites | 查看收藏 |
技术原理
微信存储 SQLCipher 加密的 SQLite 数据库，通过扫描进程内存提取密钥、即时解密并本地查询。
AI Agent 集成
在 CLAUDE.md 中添加 WeChat CLI 设置，即可让 AI 助手查询微信数据。
使用注意
- 只读不写
- 数据不出本机
- 风险自担
项目源规: [https://github.com/huohuoer/wechat-cli]