微信聊天记录分析工具：ginger_wechat_portrait 项目解析

在当今信息爆炸的时代，我们每天都在通过微信进行大量沟通。而这些聊天记录不仅是日常交流的痕迹，更可能隐藏着重要的行为模式、情感倾向和个性特征。今天要介绍的开源项目 ginger_wechat_portrait，就是一款基于 Claude Code 的微信聊天记录分析工具，它能够自动生成双人聊天行为可视化 + AI人格对比报告，无需 API Key，完全本地运行。

项目简介

项目名称：ginger_wechat_portrait
项目描述：一个运行在 Claude Code 中的 Skill，输入联系人的名字，即可自动分析并生成双人聊天行为可视化 + AI人格对比分析报告。
编程语言：Python
星标数：376
项目地址：https://github.com/Jiang59991/ginger_wechat_portrait

该项目的核心目标是帮助用户深入理解自己与他人的聊天行为模式，并通过 AI 技术对双方的人格进行对比分析，为用户提供有价值的洞察。

核心功能

1. 双人聊天行为可视化

• • 生成词云对比图，展示双方高频词汇。
• • 提供聊天频率热力图，分析消息发送的时间分布。
• • 展示消息长度分布图、月度趋势图、星期分布图等。

2. AI 人格对比分析

• • 基于聊天内容，利用 Claude Code 分析出双方的 Big Five 人格特征，并通过雷达图直观呈现。
• • 生成MBTI 推断图，分析双方的性格类型。
• • 输出AI 风格总结，从语气、用词等方面进行风格化描述。

3. 完全本地处理

• • 所有数据处理均在本地完成，不涉及隐私泄露风险。
• • 不需要任何 API Key，无需联网操作，安全可靠。

使用方法

系统要求

安装部署

git clone https://github.com/Jiang59991/ginger_wechat_portrait.git ~/wechat-analyzer
cd ~/wechat-analyzer
claude

仓库内置了 .claude/commands/analyze-wechat.md，Claude Code 在该目录下会自动识别，无需任何注册步骤。

如果希望在任意目录使用，可以在 Claude Code 中输入：
"帮我把 analyze-wechat 全局安装"

快速开始

在仓库目录中打开 Claude Code，直接运行：

/analyze-wechat

或者自然语言输入：

帮我分析和小明的聊天记录

Skill 会自动完成从安装依赖到生成报告的全部流程。

必要前置步骤

为了确保正常读取微信加密数据，需完成以下两步一次性操作：

步骤一：关闭 SIP（系统完整性保护）

• • 在 macOS 的恢复模式中关闭 SIP，允许程序访问微信进程中的加密密钥。
• • 详细步骤请参考 安装指南.md

步骤二：手动运行密钥提取脚本

• • 由于 Claude Code 子进程权限受限，需在 Terminal.app 中手动运行密钥提取脚本。
• • 项目会提供完整命令，你只需复制粘贴执行即可。

输出文件说明

分析完成后，所有结果保存在 wechat_analysis_output/ 目录中，包括：

• • report.html：完整的 HTML 报告（可直接在浏览器中打开）
• • report.css：样式文件
• • personality_result.json：自己的 AI 分析结果
• • partner_result.json：对方的 AI 分析结果（双人模式）
• • charts/：包含各类图表（如热力图、词云、雷达图等）

优势对比

总结

ginger_wechat_portrait 是一款功能强大且安全可靠的微信聊天记录分析工具，它不仅能够生成丰富的可视化图表，还能通过 AI 技术对聊天双方的人格进行深度分析。对于想要了解自己或他人沟通风格、情绪状态、行为模式的用户来说，这款开源项目无疑是一个绝佳的选择。

如果你对数据分析、人工智能或隐私保护感兴趣，不妨尝试一下这个 GitHub 项目，说不定你会发现一些意想不到的洞察！

🔗 项目地址：https://github.com/Jiang59991/ginger_wechat_portrait