wechat

# 微信本地数据读取工具

安全读取微信本地 SQLite 数据库，获取联系人、聊天记录、收藏等信息。

⚠️ **重要声明**：本工具**仅读取**本地数据，不会修改任何文件。仅供用户查看自己的微信数据使用。

## 支持平台

- ✅ macOS (通过 ~/Library/Containers/com.tencent.xinWeChat/)
- ⚠️ Windows (通过自定义路径)
- ❌ iOS/Android (无法直接访问本地数据库)

## 前提条件

### 1. 确保微信在电脑上登录过

本工具读取的是电脑版微信的本地数据库文件。

### 2. 权限检查

```bash
# 检查是否有权限访问微信数据目录
ls -la ~/Library/Containers/com.tencent.xinWeChat/
```

如果权限不足，可能需要：
```bash
# 授予终端完全磁盘访问权限
# 系统设置 → 隐私与安全 → 完全磁盘访问权限 → 添加终端
```

## 使用方法

### 列出找到的数据库

```bash
python3 scripts/wechat.py list
```

### 查看联系人列表

```bash
python3 scripts/wechat.py contacts
```

输出示例：
```
👥 联系人列表 (50 个):

序号   昵称/备注              微信号
--------------------------------------------------
1      张三                   zhangsan123
2      李四(同事)             lisi_work
3      家人群                 chatroom_xxx
```

### 查看最近会话

```bash
python3 scripts/wechat.py sessions --limit 20
```

输出示例：
```
💬 最近会话 (20 个):

📌    家人群                  2024-01-15 20:30:15
      💬 [图片]

🔴 5  张三                    2024-01-15 19:45:22
      💬 明天见！
```

### 搜索消息内容

```bash
python3 scripts/wechat.py search "关键词" --limit 50
```

### 查看收藏内容

```bash
python3 scripts/wechat.py favorites --limit 20
```

### 查看统计数据

```bash
python3 scripts/wechat.py stats
```

输出示例：
```
📊 微信数据统计:

📁 contact: /Users/xxx/Library/.../Contact.sqlite
📁 session: /Users/xxx/Library/.../Session.sqlite
📁 chat: /Users/xxx/Library/.../Chat.sqlite

----------------------------------------
👥 联系人数量: 1234
💬 会话数量: 156
📨 消息数量: 45678
⭐ 收藏数量: 89
```

## 命令参考

| 命令 | 功能 | 示例 |
|------|------|------|
| `list` | 列出数据库文件 | `wechat.py list` |
| `contacts` | 联系人列表 | `wechat.py contacts --limit 50`...