通过 wechat-cli 读取和分析微信聊天记录

SKILL.md 节选

# WeChat CLI — 微信聊天记录读取与分析

本技能通过 `wechat-cli` 命令行工具，帮助用户读取和分析本地微信的聊天记录、联系人、收藏等数据。支持会话浏览、消息搜索、聊天记录导出、统计分析等功能。

## 适用场景

- 查看最近会话列表 / 未读消息
- 查看指定联系人或群聊的聊天记录
- 按关键词搜索消息
- 导出聊天记录为 Markdown 或纯文本
- 聊天统计分析（消息数量、活跃度等）
- 查看微信收藏
- 获取增量新消息（断点续传）
- 对聊天记录进行分类总结、重点提取等分析任务

## 前置条件

### 系统支持
- Windows（Weixin.exe）
- macOS（WeChat）
- Linux（wechat）

### 必须满足
1. **使用指定版本的微信** — wechat-cli 仅兼容微信 4.0+ 新版架构，不支持 3.x 旧版。本 skill 附带了指定版本的微信安装包，详见下方"微信安装"
2. **微信客户端已安装并登录** — 工具读取本地微信数据库，微信必须已登录
3. **初始化时微信必须处于运行状态** — 密钥提取需要扫描微信进程内存
4. **Python 3.10+** — wechat-cli 是 Python 工具

### 微信安装（重要）

wechat-cli **仅支持微信 4.0 及以上版本**，不支持微信 3.x 旧版。

**为什么需要 4.0+：**
- 微信 4.0 采用了全新的跨平台架构，进程名从 `WeChat.exe` 变为 `Weixin.exe`（Windows），数据目录从 `WeChat Files` 变为 `xwechat_files`
- wechat-cli 的密钥提取逻辑针对 4.0 架构设计，无法识别 3.x 版本的进程和数据库

本 skill 附带了以下微信安装包（与 skill 目录同级）：

| 平台 | 文件 | 版本 | 说明 |
|------|------|------|------|
| Windows | `WeChatWin-4.0.1.30.zip` | 4.0.1.30 | 免安装绿色版，解压即用 |
| macOS | `WeChatMac-4.1.8.dmg` | 4.1.8 | DMG 安装镜像 |

#### Windows 安装指引

1. **解压安装包**：将 `WeChatWin-4.0.1.30.zip` 解压到任意目录（如 `C:\WeChat`）
2. **运行微信**：进入解压目录，双击 `Weixin.exe` 启动微信
3. **扫码登录**：用手机微信扫码登录
4. 确认微信已完全启动并登录后，再执行 `wechat-cli init`

> Windows 版本是免安装绿色版，无需运行安装程序，解压后直接双击 `Weixin.exe` 即可使用。

#### macOS 安装指引

**第一步：安装微信**

1. **打开 DMG 文件**：双击 `WeChatMac-4.1.8.dmg`，系统会挂载一个磁盘镜像
2. **安装微信**：在弹出的窗口中，将左侧的 **WeChat** 图标拖拽到右侧的 **Applications（应用程序）** 文件夹
3. **弹出 DMG**：安装完成后，在 Finder 侧边栏点击 DMG 磁盘旁的弹出按钮，卸载镜像

**第二步：重新签名 WeChat（必须）**

macOS 默认禁止读取其他进程内存，需要对微信进行 ad-hoc 重签名，wechat-cli 才能提取密钥。

1. **打开终端**：在「启动台」搜索「终端」或「Terminal」并打开
2. **提取微信原有权限**：
```bash
codesign -d --entitlements - --xml /Applications/WeChat.app > ~/wechat_ent.plist
```
3. **复制 WeChat 到用户目录**（推荐，最安全）：
```bash
rm -rf ~/Applications/WeChat.app
cp -R /Applications/WeChat.app ~/Applications/
```
4. **对副本进行签名**：
```bash
codesign --force --deep --sign - --entitlements ~/wechat_ent.plist ~/Applications/WeChat.app
```
5. **以后运行这个副本**：
```bash
open ~/Applications/WeChat.app
```

**第三步：登录并初始化**

1. **打开微信**：运行上一步签名后的副本（`~/Applications/WeChat.app`）
2. **处理安全提示**：首次打开可能提示"无法验证开发者"或"来自身份不明的开发者"：
   - 点击 **取消**
   - 进入 **系统设置 → 隐私与安全性**，找到关于 WeChat 的安全提示，点击 **仍要打开**
   - 再次打开 WeChat，点击 **打开**
3. **扫码登录**：用手机微信扫码登录
4. 确认微信已完全启动并登录后，执行初始化：
```bash
sudo wechat-cli init --force
```

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 10 个文件，合计 96.6 KiB