wechat-favlink-exporter

KO | EN

gitlite — search

#javascript #typescript #llm #golang #go #rust #deep-learning #linux #docker #java #cli #awesome-list #mcp #open-source

wechat-favlink-exporter

(★ 11)

微信收藏链接批量导出工具 - 自动从 Windows 微信收藏夹中逐条导出所有链接

wechat-favlink-exporter Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WeChat FavLink Exporter

**微信收藏链接批量导出工具** — 自动从 Windows 微信收藏夹中逐条导出所有链接。

适用于微信 Windows 桌面版 4.1.8.67。

## 为什么做这个工具

你的微信收藏夹里是不是也躺着成百上千条"稍后再看"的链接？

**Read it later，最后变成了 Read it never。**

现在有越来越多的 AI Agent 可以帮我们对内容进行分析、整理和沉淀。但第一步得先把这些链接从微信里捞出来——然而微信偏偏没有提供批量导出功能。

这个工具就是来解决这个问题的。它通过模拟鼠标键盘操作，自动逐条打开收藏中的链接、复制链接地址、保存到本地文件。把链接导出之后，剩下的交给你喜欢的 AI 就好。

- 公众号文章：获取短链接（`https://mp.weixin.qq.com/s/...`）
- 外部链接：直接保存原始 URL
- 自动去重，支持断点续传
- 支持数千条规模的批量导出

## 使用前须知

由于工具运行时会自动控制鼠标、键盘和剪贴板，**导出过程中电脑无法进行其他操作**。每条链接的处理耗时约 6-8 秒，1000 条大约需要 2 小时。建议找个不用电脑的时间段挂着跑，比如午饭或睡前。

## 工作原理

由于微信桌面版没有开放 UI 自动化接口（UIAutomation 树中收藏列表不可见），本工具采用 **坐标定位 + 模拟操作** 的方案：

1. 首次使用时通过交互式校准记录关键 UI 元素的坐标
2. 运行时自动执行：单击打开条目 → 点击「...」菜单 → 键盘导航到「复制链接」 → 点击 X 关闭窗口
3. 使用 Windows API（`ctypes.windll.user32.mouse_event`）发送滚轮事件滚动列表
4. 通过链接去重判断是否到了新条目

## 环境要求

- **操作系统**：Windows 10/11
- **微信版本**：Windows 桌面版 4.x（在 4.1.8.67 上测试通过）
- **Python**：3.8+

## 安装

```bash
pip install -r requirements.txt
```

依赖库：

| 库 | 用途 |
|---|---|
| `pyautogui` | 鼠标键盘模拟 |
| `pyperclip` | 剪贴板读写 |
| `Pillow` | pyautogui 的依赖 |

## 使用步骤

### 1. 校准

首次使用必须先校准，让脚本知道微信界面中各个按钮的位置。

```bash
python wechat_fav_exporter.py --calibrate
```

校准流程共 6 步，脚本会引导你完成：

| 步骤 | 内容 | 说明 |
|------|------|------|
| 1/6 | 标记收藏条目的点击位置 | 列表第一条的中心 |
| 2/6 | 标记收藏列表的滚动区域 | 列表左侧边缘空白处 |
| 3/6 | 标记文章窗口的「...」菜单按钮 | 需要先手动打开一篇文章并调整窗口位置 |
| 4/6 | 标记文章窗口的关闭(X)按钮 | 文章窗口仍然打开着 |
| 5/6 | 确认「复制链接」在菜单中的位置 | 脚本自动弹出菜单供你确认 |
| 6/6 | 校准滚轮滚动精度（可选） | 测试滚动一条需要几个 tick |

**关于窗口位置**：步骤 3 中需要把文章窗口挪到主窗口上方，使文章窗口右上角的按钮落在收藏列表的空白区域上。这样脚本点击「...」和 X 按钮时不会误触收藏列表中的条目。

### 2. 测试

```bash
python wechat_fav_exporter.py --test
```

测试模式默认处理 5 条，会显示每条获取到的链接。确认结果正确后再进行批量导出。

### 3. 批量导出

```bash
python wechat_fav_exporter.py --run
```

运行前会询问本次要导出多少条（直接回车则不限制）。导出过程中请不要操作鼠标和键盘。

### 4. 断点续传

```bash
python wechat_fav_exporter.py --run --resume
```

使用断点续传时，请先手动将微信收藏列表滚动到上次停止的位置附近。脚本会通过去重自动跳过已导出的链接。

## 其他命令

```bash
python wechat_fav_exporter.py --position   # 实时显示鼠标坐标（调试用）
python wechat_fav_exporter.py --config     # 显示当前配置
```

## 安全机制

| 机制 | 触发方式 | 效果 |
|------|----------|------|
| 紧急停止 | 将鼠标快速移到屏幕左上角 (0,0) | 立即停止，保存进度 |
| 安全中断 | 按 Ctrl+C | 安全停止，保存进度 |
| 自动停止 | 连续 10 次未获取到新链接 | 切换到下移模式，最多再尝试 5 次后停止 |

## 输出文件

| 文件 | 说明 |
|------|------|
| `exported_links.txt` | 导出的链接，每行一条 |
| `export_progress.json` | 断点续传进度文件 |
| `fav_exporter_config.json` | 校准配置文件 |
| `export_log.txt` | 运行日志 |

## 常见问题

**Q：校准后微信窗口大小/位置变了怎么办？**

重新运行 `--calibrate` 即可。校准只需要一两分钟。

**Q：为什么不用 UIAutomation / pywinauto？**

微信桌面版 4.x 的收藏列表在 UIAutomation 树中不可见，无法通过常规自动化框架访问。经过实际测试验证，坐标定位是目前最可靠的方案。

**Q：滚动不生效怎么办？**

本工具使用 `ctypes.windll.user32.mouse_event` 发送滚轮事件，绕过了 `pyautogui.scroll()` 在某些环境下失效的问题。如果仍然不生效，请确认鼠标光标确实在收藏列表区域内。

**Q：可以导出非链接类型的收藏吗？**

目前只支持链接类型（文章和网页）。图片、文件、笔记等类型不支持。建议在微信收藏中先点击左侧分类的「链接」进行筛选。

## 配置参数

校准配置保存在 `fav_exporter_config.json` 中，高级用户可以手动调整时间参数：

| 参数 | 默认值 | 说明 |
|------|--------|------|
| `wait_article_open` | 1.0s | 等待文章窗口打开 |
| `wait_menu_popup` | 0.5s | 等待菜单弹出 |
| `wait_after_copy` | 0.3s | 复制链接后等待 |
| `wait_after_close` | 0.5s | 关闭窗口后等待 |
| `wait_after_scroll` | 0.3s | 滚动后等待 |
| `key_interval` | 0.03s | 键盘按键间隔 |
| `scroll_per_tick` | 3 | 滚动一条需要的 tick 数 |
| `item_height_px` | 127 | 条目像素高度（下移模式用） |

## License

[MIT](LICENSE)

wechat-favlink-exporter

wechat-favlink-exporter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

wechat-favlink-exporter

wechat-favlink-exporter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README