基于 UI 自动化的 QQ 群消息自动转发工具

在日常使用 QQ 进行社群管理、信息同步时，我们经常需要将一个群的重要消息、图片实时转发到另一个群，手动操作不仅繁琐还容易遗漏。今天给大家分享一款基于 Python UI 自动化技术开发的 QQ 群消息自动转发工具，无需修改 QQ 客户端、无封号风险，纯模拟人工操作，支持文本消息过滤、图片自动转发，稳定高效完成消息同步工作。

一、工具核心功能

这款工具主打轻量化、无侵入、易配置，核心功能如下：

1. 精准群消息监听：指定单个源群，仅监听目标群聊消息，不干扰其他窗口
2. 双向内容转发：支持纯文本消息、图片消息自动识别与转发
3. 智能消息过滤：自动过滤时间戳、日期、群主名称等冗余信息
4. 防重复转发：通过消息 ID 哈希去重，避免重复发送
5. 稳定运行机制：窗口自动重连、异常捕获，长期运行不崩溃

二、技术栈与原理

核心依赖库

实现原理

工具通过Windows UI 自动化接口遍历桌面窗口，定位指定的 QQ 群聊窗口；递归获取消息列表中的文本内容，识别图片 / 文本消息类型；通过模拟人工操作（右键复制图片、Ctrl+V 粘贴文本、回车发送），将源群消息无缝转发到目标群，全程模拟人工行为，安全可靠。

三、完整代码与配置说明

核心配置（零代码修改）

工具最核心的就是顶部配置区，只需修改 3 个参数即可使用：

# ========== 配置区域 ==========
# 源群名称（A群）- 只监听这个群的消息
SOURCE_GROUP = "测试群"
# 目标群名称（B群）- 转发消息到这个群，不监听
TARGET_GROUP = "测试群2"
# 群主名称 - 文字消息中的群主名称将被替换为空
GROUP_OWNER_NAME = "程序员老狼"
# ========== 配置区域结束 ==========

• SOURCE_GROUP：填写你要监听消息的源 QQ 群名称
• TARGET_GROUP：填写你要转发到的目标 QQ 群名称
• GROUP_OWNER_NAME：需要过滤的群主昵称，转发时自动删除

四、使用步骤

1. 环境准备

1. 安装 Python 环境（3.8 + 版本）
2. 安装依赖库：

pip install uiautomation pyautogui pyperclip psutil

2. 运行前设置

1. 打开电脑端 QQ，将源群和目标群的窗口单独打开（不要最小化到托盘）
2. 修改代码顶部配置参数，填写正确的群名称和过滤名称
3. 以管理员身份运行 Python 脚本（必须管理员权限，否则无法定位窗口）

3. 运行效果

启动后工具会自动扫描窗口，提示「已找到源群 / 目标群窗口」，随后进入监听状态：

• 收到文本消息：自动过滤冗余内容，实时转发
• 收到图片消息：自动右键复制图片，粘贴发送
• 控制台实时打印转发日志，方便查看运行状态

五、核心代码解析

1. 窗口定位与消息获取

findWindowByName 函数递归遍历 Windows 桌面窗口，精准匹配 QQ 群聊窗口；getMessageList 函数定位「消息列表」元素，为后续获取消息做准备。

2. 消息识别与过滤

• isImageMessage：通过文本特征识别图片消息
• 正则表达式自动过滤时间、日期、星期等无效消息
• 文本替换功能删除群主名称、「群主」关键词，净化转发内容

3. 防重复机制

通过hashlib对消息文本 + 元素 ID生成 MD5 唯一标识，用集合存储已转发消息 ID，彻底避免重复转发。

4. 模拟人工操作

• 图片：右键点击消息 → 复制 → 切换窗口 → 粘贴发送
• 文本：复制文本 → 切换窗口 → 粘贴 → 回车发送 全程模拟人工操作，符合 QQ 使用规范，无安全风险

六、注意事项

1. 必须管理员运行：否则 uiautomation 无法获取窗口权限
2. 窗口保持打开：源群和目标群窗口不要最小化到托盘，正常打开即可
3. 分辨率适配：工具默认适配主流分辨率，若图片复制失败，可微调copyImageToClipboard中的点击坐标
4. 长期运行：工具自带异常捕获和窗口重连，可 24 小时稳定运行
5. 合规使用：仅用于个人消息同步，请勿用于商业或违规用途