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

wx-cli + Claude Code 本地数据处理架构图
图：全本地处理链路——从微信数据库解密到 AI 摘要，数据不离开本机

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

wx-cli 从本地微信数据库解密并导出群聊记录
导出结果保存为本地文本文件
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 内存扫描解密原理图
图：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 点前

未解决问题

• （本段记录中无未解决问题）

重要信息

• 测试环境回归测试已完成（张工确认）
  整个过程耗时不超过 30 秒。如果群聊记录很长（500 条以上），可能需要 1-2 分钟，但不会更久。

进阶：做成每日自动导出脚本
如果你每天都需要总结同一批群，可以写个 shell 脚本，加到 crontab 里：

#!/bin/bash

~/scripts/wechat-daily-summary.sh

GROUPS=(“项目周例会群” “运营对接群” “技术交流群”)
DATE=$(date+OUTPU{T}_{D}IR=/wechat-summaries/$DATE

mkdir -p $OUTPUT_DIR

for GROUP in “${GROUPS[@]}”; do

导出今日记录（取最近 200 条）

wx export “$GROUP"--formatmarkdown-o"$OUTPUT_DIR/$GROUP.md"echo"✓已导出：$GROUP”
done

echo “导出完成，文件在 $OUTPUT_DIR”
加到 crontab，每天早上 8:55 自动跑：

crontab -e

加入这行：

55 8 * * 1-5 /bin/bash ~/scripts/wechat-daily-summary.sh
这样你 9 点打开电脑，各群的原始记录已经在本地等你了，打开 Claude Code 一条指令出摘要，5 分钟内搞定一天的群信息归总。

踩坑记录
坑一：wx-cli 报「无法连接到 WeChat 进程」

原因是微信没有运行，或者微信版本太老（低于 4.x）。wx-cli 依赖扫描运行中的微信进程内存来获取解密密钥。

解决：打开微信，确保登录状态，重新执行命令。

坑二：导出的记录里有乱码

这通常是消息里包含特殊格式（引用消息、文件分享、小程序卡片）。wx-cli 会尽力解析，但部分格式可能输出为 [引用消息] 或 [文件] 占位符。

对总结影响不大，AI 会自动跳过这些无内容的占位符。

坑三：Claude Code Skill 没有被识别

检查 Skill 文件路径是否正确：必须在 ~/.claude/skills//SKILL.md，注意大小写。文件保存后，在 Claude Code 里输入 / 可以看到已加载的 Skill 列表。

坑四：群名称有特殊字符导致导出失败

群名称里如果有括号、斜杠等字符，需要用引号包裹并转义：

wx export “前端 (技术) 交流群” --format markdown -o output.md
数据安全：给有顾虑的同学的一份技术说明
这套方案的数据流向如下图所示：

数据安全全本地处理流程图
图：数据始终在本地设备内流转，无外部网络请求

关键点逐一确认：

wx-cli 是离线工具，没有任何网络请求（可以用 lsof -i 在运行时确认没有外部连接）
解密密钥只存在于内存中，不写入磁盘，程序退出后消失
缓存目录 ~/.wx-cli/cache/ 是本地数据库缓存，不加密，但存在你的本机
Claude Code 使用本地执行模式（不是 claude.ai 的网页版），不发送任何网络请求到 Anthropic 服务器来处理你的聊天记录
需要注意的是：wx-cli 本身是开源且经过社区审计的，但你仍然应该从官方 npm 包或 GitHub Releases 下载，不要用第三方镜像。

常见问题
Q：wx-cli 支持 Windows 吗？

支持。wx-cli v0.3.0 支持 macOS、Linux 和 Windows，安装命令一样（npm install -g @jackwener/wx-cli）。Windows 上同样需要微信 4.x 处于运行状态。

Q：这套方案会影响微信正常使用吗？