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]