项目概述

WeChat CLI 是一款跨平台命令行工具，用于从本地微信客户端数据库中查询和导出数据。所有操作均在本地完成，使用 SQLCipher 即时解密，数据不会离开本机。它默认输出 JSON，便于作为 LLM Agent 工具调用。

主要特性

• 零配置安装：npm install -g 或 pip install，无需额外 Python 环境。
• 11 个命令：sessions、history、search、contacts、members、stats、export、favorites、unread、new-messages、init。
• AI-first：默认 JSON 输出，专为 LLM Agent 工具调用设计。
• 完全本地：SQLCipher 即时解密，数据不上传。
• 丰富分析：Top 发送者、消息类型分布、24 小时活跃曲线。
• 灵活导出：Markdown 或纯文本，可按时间段筛选。

安装方式

npm install -g @canghe_ai/wechat-cli
# 或
pip install wechat-cli

技术栈

• Python（核心逻辑，跨平台 SQLite/SQLCipher 解密）
• npm 分发（macOS arm64 预编译二进制）
• JavaScript（CLI 包装）
• C（SQLCipher 相关绑定）