wx-cli:本地跑、不上传——用 AI 检索总结微信全部聊天记录(2026 年 10 月)

周店瑟谷 1 阅读 AI 工具与智能体
微信聊天记录是大多数人最完整的「人生数据库」:十年的对话、承诺、转账、地址、链接全在里面,但它一直是个「只进不出」的黑盒。开源工具 wx-cli 的思路是:在本地读取 Mac 端微信数据库并导出,交给 AI 检索和总结,全程不上传隐私数据到第三方服务器。

一、工具核心信息

  • 项目:wx-cli,开源命令行工具;
  • 平台:macOS(Mac 端微信客户端数据库);
  • 能力:读取微信全部聊天记录 → 按联系人、按时间段检索 → 图片、语音消息可一并导出;
  • 隐私架构:本地运行,数据不出机器;AI 总结环节可对接本地模型或自选 API。

二、它能回答什么问题(使用场景)

一旦聊天记录变成可检索的数据,应用场景立刻浮现:

1. 「那个人当时说了什么?」——合同口头承诺、借条性质对话、时间线证据链,按联系人一键检索;

2. 「我上个月和谁聊过什么?」——按时间段生成会话摘要,做周报/月度复盘的素材库;

3. 图片与语音再利用——群里发过的文件、名片、截图,按时间导出归档;

4. 接 AI 之后:把导出的记录投喂给本地部署的模型,问「帮我总结和 XX 的合作历史」「找出所有提到某个项目名称的对话」——把回忆变成检索。

三、技术与合规边界(必读)

这类工具的能力与风险同样真实:

  • 原理:微信本地数据库(SQLite)是加密存储的,此类工具在本地内存中完成解密读取,不做网络传输;
  • 只读自己的数据:工具读取的是你自己设备上的、你本人的聊天记录,这在多数司法辖区属于用户对自身数据的正当访问;
  • 不要越界:导出他人对话内容用于公开传播、商业用途或证据提交前,注意个人信息保护法(PIPL)对「处理他人个人信息」的要求——私下检索自己设备上的记录没问题,公开传播就有问题;
  • 安装来源:只从 GitHub 官方仓库下载,警惕二次打包的「魔改版」(聊天记录解密工具是恶意软件重打包的高发区)。

四、阅读收获与实操路径

上手三步:

1. GitHub 搜索 wx-cli(开发者 jackwener,Rust 实现的二进制工具,npm 即可安装);

2. 在 Mac 上登录微信客户端,运行 CLI 按提示完成数据库读取与导出(先小范围测试单个联系人);

3. 导出为 Markdown/JSON 后,接本地模型(如 Ollama)或你信任的 AI 服务做检索总结。

三个务实提醒:

  • 先备份再操作:对微信数据目录做一次完整备份(Time Machine 或手动拷贝);
  • Windows 用户:同类需求可关注 WeChatMsg(留痕)等项目,生态更成熟;
  • 企业微信/工作账号慎用:工作账号的聊天记录可能涉及雇主商业秘密与合规要求,先确认公司政策。

五、延伸阅读

  • wx-cli 开源仓库:https://github.com/ (GitHub 站内搜索「wx-cli」获取最新仓库)
  • WeChatMsg(留痕)——Windows 侧同类项目:https://github.com/sjzar/chatlog (同类生态可对照参考)
  • 对照阅读:本库《MarkItDown:给 AI 喂料的正确姿势》——导出后的数据如何高效投喂 AI
  • 注:视频源为微信视频号「科技前沿AI」;工具功能与安装方式以官方 README 为准。