如何3分钟上手wechat-cli零门槛安装与初始化实战指南npm/pip/源码三方式【免费下载链接】wechat-cliA CLI tool to query your local WeChat data — chat history, contacts, sessions, favorites, and more. Designed for LLM integration.项目地址: https://gitcode.com/gh_mirrors/wech/wechat-cliwechat-cli 是一款命令行微信数据查询工具专为 AILLM集成设计。它可以在本地直接读取你的微信聊天记录、联系人、会话、收藏、群成员和聊天统计数据全程不出本机。本文带你用 3 分钟完成 wechat-cli 的安装与初始化覆盖 npm、pip、源码三种安装方式零基础也能跑通第一条查询命令。 wechat-cli 能做什么命令功能示例sessions查看最近会话wechat-cli sessions --limit 10history查询聊天记录wechat-cli history 张三 --limit 20search全局/指定聊天搜索wechat-cli search 截止日期 --chat 项目组contacts搜索联系人及详情wechat-cli contacts --query 李members列出群成员wechat-cli members AI交流群stats聊天统计发言排行、活跃分布wechat-cli stats AI交流群export导出为 Markdown/纯文本wechat-cli export 张三 --format markdownfavorites查询微信收藏wechat-cli favorites --type articleunread/new-messages未读会话 / 增量新消息wechat-cli unread所有命令默认输出结构化JSON非常适合接入 Claude Code、MCP 等 AI 工具这也是 wechat-cli 最大的特色。️ 先确认系统要求macOS≥ 26.3.1微信 Mac 版 ≤ 4.1.8.100Apple Silicon / Intel 均支持Windows通过读取 Weixin.exe 进程内存提取密钥Linux读取 /proc/pid/mem需要 root 权限 开始前请确保微信正在运行初始化时需要从微信进程内存中提取数据库密钥。 三种安装方式任选其一方式一npm 安装推荐 macOS 用户一键安装无需 Python 环境npm install -g canghe_ai/wechat-cli当前 npm 包内置macOS arm64 二进制升级版本只需npm update -g canghe_ai/wechat-cli方式二pip 安装跨平台通用需要Python ≥ 3.10依赖声明见 pyproject.tomlpip install wechat-cli方式三从源码安装开发者推荐git clone https://gitcode.com/gh_mirrors/wech/wechat-cli cd wechat-cli pip install -e .安装完成后运行wechat-cli --help确认命令可用 偷懒方案让 AI 帮你装如果你在用 Claude Code 等 AI 终端工具直接把这句话发给它即可帮我配置并安装npm install -g canghe_ai/wechat-cliAI 会自动执行安装并验证版本 关键一步初始化init安装只是第一步。wechat-cli 的核心原理是微信把聊天数据存在 SQLCipher 加密的 SQLite 数据库中init命令会自动检测微信数据目录、从进程内存提取加密密钥并保存到~/.wechat-cli/。相关逻辑在 wechat_cli/commands/init.py密钥扫描实现位于 wechat_cli/keys/ 目录。# macOS / Linux需要 sudo 权限 sudo wechat-cli init # Windows在权限足够的终端中直接运行 wechat-cli init终端会提示你输入系统密码以获取权限⚠️ macOS 特别注意先开完全磁盘访问权限执行init之前请先为终端开启该权限否则无法访问微信数据目录打开系统设置 → 隐私与安全性 → 完全磁盘访问权限添加你使用的终端Terminal、iTerm2 或 IDE 内置终端开启后重启终端登录了多个微信账号需要选择一份数据如果你本地登录过多份微信init会列出所有数据目录让你选择。请选择当前正在登录的账号默认第一个不确定哪个是当前账号打开数据文件夹按修改日期排序最新修改的就是正在使用的账号下图中高亮的wxid_xjt0x...文件夹遇到task_for_pid failed怎么办个别 macOS 系统上即使用了sudoinit也可能报此错误。这是 macOS 安全策略限制了进程内存访问wechat-cli 会自动尝试重新签名微信来修复保留原有权限按提示操作即可等待工具自动重新签名微信完全退出微信不是最小化重新打开微信并登录再次执行sudo wechat-cli init重新签名是安全的不会导致封号但可能影响微信自动更新如有异常直接从微信官网重新下载安装即可无需重新执行 init。✅ 30 秒验证跑通你的前三条命令初始化成功后提示提取到 N 个数据库密钥依次执行wechat-cli sessions # 最近会话 wechat-cli history 张三 --limit 20 # 查看聊天记录 wechat-cli search 截止日期 --chat 项目组 # 搜索消息能返回 JSON 结果说明 wechat-cli 已经完全可用 更多参数时间范围过滤、消息类型过滤--type、纯文本输出--format text可在主入口 wechat_cli/main.py 的帮助文档中查看。 参考资料完整命令说明与平台支持表README_CN.md初始化逻辑wechat_cli/commands/init.py配置与状态目录管理wechat_cli/core/config.py项目依赖声明pyproject.toml温馨提示wechat-cli 是纯只读工具数据只在本机处理、不上传任何服务器也不干扰微信正常运行请放心使用。【免费下载链接】wechat-cliA CLI tool to query your local WeChat data — chat history, contacts, sessions, favorites, and more. Designed for LLM integration.项目地址: https://gitcode.com/gh_mirrors/wech/wechat-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考