🍪 微信聊天记录分析工具

一个运行在 Claude Code 里的 Skill：输入联系人的名字，自动生成双人聊天行为可视化 + AI 人格对比分析报告。无需 API Key，分析由 Claude Code 本地完成。

---

效果预览

所有内容整合为一份精美 HTML 报告，图表可直接截图发布。

---

使用要求

---

安装部署

克隆仓库，在目录内打开 Claude Code，即可使用。

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

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

想在任意目录都能用？ 在 Claude Code 里说： "帮我把 analyze-wechat 全局安装" Claude 会自动把命令文件复制到 ~/.claude/commands/。

---

快速开始

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

/analyze-wechat

或者自然语言：

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

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

---

需要手动完成的前置步骤

以下两步是一次性操作，完成后后续所有分析均全自动。

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

macOS 的 SIP 会阻止读取微信进程中的加密密钥，必须先在恢复模式中关闭一次。

详细步骤见 安装指南.md

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

密钥提取需要调试器权限（lldb），Claude Code 子进程不具备此权限，必须在系统 Terminal.app 中手动运行。

Skill 会给出完整命令，你复制粘贴到 Terminal.app 执行，然后在微信里依次点开几个聊天窗口触发密钥捕获即可。

完整操作说明见 安装指南.md

这两步只需做一次。完成后可以立刻重新开启 SIP，之后所有分析完全自动。

---

Skill 会问你哪些问题？

整个流程最多只会被问 3 次：

其余所有步骤均全自动完成，无需干预。

---

输出文件

分析完成后，所有文件保存在工具目录的 wechat_analysis_output/ 下（默认 ~/.claude/wechat-analyzer/wechat_analysis_output/）：

wechat_analysis_output/
├── report.html              ← 完整 HTML 报告（浏览器打开）
├── report.css               ← 报告样式文件（与 report.html 同目录）
├── personality_result.json  ← 自己的 AI 分析结果
├── partner_result.json      ← 对方的 AI 分析结果（双人模式）
├── personality_raw.json     ← 最终输出的分析原始数据
└── charts/
    ├── hourly.png           ← 24 小时发消息分布
    ├── monthly_trend.png    ← 月度消息趋势
    ├── weekday_bar.png      ← 星期分布
    ├── word_cloud_pair.png  ← 双人高频词词云（有对方数据时）
    ├── word_cloud.png       ← 单人词云（仅自己数据时）
    ├── length_dist.png      ← 消息长度分布
    └── radar.png            ← Big Five 雷达图（单人模式）

---

隐私说明

• 所有数据处理在本地完成
• AI 人格分析由 Claude Code 本身完成，不需要 Anthropic API Key，不向外部发送消息内容
• 不会收集或上传任何数据到其他地方
• 请勿用于分析他人设备上的数据

---

技术流程

见 SKILL.md

---

macOS 12+ · WeChat 4.x · Python 3.10+ · Claude Code