为什么要自己搭，不用现成的 AI 总结 App？

市面上有几款声称能总结微信群的工具，但凡用过的人都会遇到一个绕不开的问题：你的聊天记录要先传到他们的服务器，AI 才能处理。

我做了 10 年后端，对这件事的感受比普通用户更直接——你以为只是上传了文字，实际上对方的系统里可能留着你们团队的产品细节、客户信息、内部决策。不是说所有服务都会拿来做坏事，但你根本不知道数据在对方那里会存多久、用来干什么。

本地方案的架构思路是这样的：

图：全本地处理链路——从微信数据库解密到 AI 摘要，数据不离开本机

三个环节全部在你的电脑上完成：

1. wx-cli 从本地微信数据库解密并导出群聊记录
2. 导出结果保存为本地文本文件
3. Claude Code 读取本地文件，在本地运行 Skill 生成摘要

没有网络请求，没有第三方 API（用的是 Claude Code 的本地执行模式，而不是 Web 版），没有账号登录。

wx-cli 是什么，它怎么读到你的聊天记录

wx-cli 是 GitHub 上 2.3k Star 的开源工具（截至 2026 年 5 月），用 Rust 写的，Apache-2.0 协议。核心功能是在你的电脑上读取微信本地数据库并导出聊天记录。

它的技术原理说起来不复杂：

微信 4.x 版本把本地数据存在 SQLCipher 加密的数据库里（加密算法是 AES-256-CBC + HMAC-SHA512）。数据库文件就在你的电脑上，但直接打开是乱码，因为需要密钥。

wx-cli 做的事情是：扫描运行中的微信进程内存，找到 SQLCipher 的解密密钥，然后用这个密钥在本地实时解密数据库、执行查询。整个过程没有任何数据发到外部。

图：wx-cli 从进程内存获取密钥，本地解密 SQLCipher 数据库的数据流

解密结果会被缓存在 ~/.wx-cli/cache/ 下，按文件修改时间做增量更新——第一次可能稍慢，之后每次查询都是毫秒级响应，v0.3.0 版本的热路径从原来约 120 秒压到了 1 秒以内。

微信数据库的位置（macOS）：

~/Library/Containers/com.tencent.xinwechat/Data/Library/Application Support/

wx-cli 会自动找到这个路径，你不需要手动指定。

第一步：安装 wx-cli

确保微信处于运行状态（wx-cli 需要扫描微信进程内存来获取解密密钥）。

npm install -g @jackwener/wx-cli

安装完成后验证：

wx --version

macOS 用户的一个坑：首次运行可能遇到「开发者无法验证」的提示。需要执行 ad-hoc 代码签名：

# 找到 wx-cli 的安装路径
which wx

# 对二进制文件做 ad-hoc 签名（用 - 表示自签）
sudo codesign --force --deep --sign - $(which wx)

签名之后重新运行即可，不会再弹提示。

验证工具正常工作：

# 列出最近的会话（确认能读到数据）
wx sessions

如果看到你的微信会话列表输出，说明一切正常。

第二步：导出群聊记录

确认可以读到会话后，导出目标群的聊天记录：

# 导出最近 200 条记录为 Markdown 格式
wx export "项目周例会群" --format markdown -o ~/group-chat.md

# 如果需要更多历史记录
wx history "项目周例会群" --limit 500

--format markdown 会把每条消息格式化成「发送者：内容」的结构，适合直接丢给 AI 读。

导出内容示例（已脱敏）：

[2026-05-15 09:23] 张工：今天的发布计划确认了吗？
[2026-05-15 09:25] 李姐：确认了，下午 3 点灰度，晚上 8 点全量
[2026-05-15 09:26] 王哥：测试环境没问题，回归测试今早已跑完
[2026-05-15 09:30] 张工：好，3 点前大家准备好回滚脚本

这个文件现在只在你本地，没有任何上传操作。

第三步：创建 Claude Code 总结 Skill

这是整个方案最关键的部分。Claude Code 支持自定义 Skill——你可以把「读取本地群聊记录并生成摘要」这个动作封装成一条可复用的指令。

先确认 Claude Code 已安装：

claude --version

没有的话：npm install -g @anthropic-ai/claude-code

Skill 文件存放位置：

~/.claude/skills/wechat-summarizer/SKILL.md

创建目录并写入 Skill 定义：

mkdir -p ~/.claude/skills/wechat-summarizer

# WeChat Group Summarizer Skill

## 触发方式
当用户输入 `/wechat-summary` 或要求「总结群聊」时激活本 Skill。

## 执行步骤

1. 读取参数中指定的本地文件路径，或默认读取 `~/group-chat.md`
2. 分析聊天记录，识别以下内容：
   - 今日核心决策（有明确结论的讨论）
   - 待办事项（有人被点名、有 deadline 的任务）
   - 未解决的问题（讨论中途中断、结论不明确的）
   - 重要信息（发布计划、版本号、链接）
3. 输出结构化摘要，格式如下：

## 输出格式

群聊摘要：[群名称] [日期]

核心决策

• [决策内容] — 由 [谁] 确认

待办事项

• [任务内容] — 负责人：[谁]，截止：[时间]

未解决问题

• [问题描述] — 需要 [谁] 跟进

重要信息

• [关键信息条目]

## 约束
- 所有输入来自本地文件，不调用任何网络接口
- 摘要语言与群聊语言一致（中文群输出中文）
- 摘要控制在 300 字以内，超出则优先保留决策和待办

Skill 文件保存后，无需重启 Claude Code，直接可以使用。

第四步：一条命令跑出摘要

在 Claude Code 里执行：

claude

进入交互界面后输入：

/wechat-summary ~/group-chat.md

或者直接说：

帮我总结一下 ~/group-chat.md 这个群聊记录，用结构化格式输出

Claude Code 会读取本地文件，在本地执行 Skill 逻辑，输出类似这样的结果：

## 群聊摘要：项目周例会群 2026-05-15

### 核心决策
- 今日发布计划确认：下午 3 点灰度，晚上 8 点全量 — 由李姐确认

### 待办事项
- [ ] 准备回滚脚本 — 负责人：所有人，截止：下午 3 点前