WeChat Sender Pro
Windows 微信自动发送工具。支持搜索微信联系人并发送文字、图片、文件。通过 GUI 自动化控制微信窗口，无需微信开放接口。
触发场景： 离开电脑时，远程指令OpenClaw发送图片/文件给微信联系人。条件： 微信打开并登录（允许最小化）。举例：1、把桌面上的龙虾图片发送给张三（默认微信发送）；2、查找D盘最新的报价单Excel表并发送给李四（默认微信发送）。
核心流程
找窗口 → 恢复最小化 → 激活 → 搜索联系人 → 进入聊天 → 发送内容
发送文件时的完整流程（人工触发）
用户说「发 xxx 文件给 “张三”」时，必须先搜索确认，再发送：
1. 调用 find_file.py --name 关键词 --dirs 搜索目录 搜索文件
2. 根据结果数量选择策略：
├─ 0 个 → 告知未找到，请提供完整路径或换关键词
├─ 1 个 → 告知文件信息，询问「确认发送？」
├─ 2~15 个 → 单行列表，让用户选择序号
└─ >15 个 → 按目录分组摘要，让用户缩小范围
3. 用户确认后，调用 send_file.py 发送
4. 反馈发送结果
搜索参数说明：
- --name：关键词（模糊匹配，不区分大小写）
- --dirs：搜索目录，逗号分隔（默认桌面/下载/文档/Workspace）
- --depth：递归深度，默认3
- --ext：限定扩展名（如 xlsx、pdf）
- --limit：最多返回条数，默认50
快速使用
发送文字消息
python scripts/send_message.py --contact "联系人名字" --message "消息内容"
发送图片
python scripts/send_image.py --contact "联系人名字" --image "图片路径"
发送文件
python scripts/send_file.py --contact "联系人名字" --file "文件路径"
批量搜索+发送（推荐：batch_send.py）
推荐使用 batch_send.py，一个脚本搞定搜索→确认→发送全流程：
# 搜索并交互式发送（脚本会展示文件列表，等待用户回复序号）
python scripts/batch_send.py --keyword "报价单" --contact "张三"
# 指定目录和深度
python scripts/batch_send.py --keyword "报价单" --dirs "D:/" --depth 4 --contact "张三"
# 限定扩展名
python scripts/batch_send.py --keyword "报价单" --ext xlsx --contact "张三"
# 直接发送指定序号（跳过交互确认，用于 agent 自动化）
python scripts/batch_send.py --keyword "报价单" --contact "张三" --indices "1,3"
# 干跑测试（只展示文件，不实际发送）
python scripts/batch_send.py --keyword "报价单" --contact "张三" --dry-run
交互流程示例：
$ python scripts/batch_send.py --keyword "报价单" --contact "张三"
找到 32 个匹配文件，已按项目分类：
📁 目录1
• [1] 报价单1.xlsx
• [2] 报价单2.xlsx
• [3] 报价单3.xlsx
• [4] 报价单4.xlsx
📁 目录2
• [5] 报价单5.xlsx
...
• [32] 报价单6.pdf
回复序号选择发送（多个序号用逗号分隔，如 1,3,5）
请回复序号：3
发送 [3] 报价单3.xlsx → 张三 ...
✅ 发送成功
搜索文件（发送前确认用）
# 搜索名字包含"日报"的文件
python scripts/find_file.py --name "日报"
# 指定目录和扩展名
python scripts/find_file.py --name "报价单" --dirs "C:/Users/admin/Desktop" --ext xlsx
# 输出 JSON（供程序解析）
python scripts/find_file.py --name "日报" --json
Python API 调用
from scripts.wechat_sender import WeChatSender
# 初始化
sender = WeChatSender()
# 发送文字
sender.send_message("张三", "你好，这是测试消息")
# 发送图片
sender.send_image("张三", r"C:\path\to\image.jpg")
# 发送文件
sender.send_file("张三", r"C:\path\to\file.xlsx")
脚本说明
| 脚本 | 功能 | 参数 |
|---|---|---|
find_file.py |
搜索文件，返回匹配列表 | --name, --dirs, --ext, --limit, --json |
batch_send.py |
集成搜索+确认+发送（推荐） | --keyword, --contact, --dirs, --ext, --depth, --indices, --dry-run |
send_message.py |
发送文字消息 | --contact, --message |
send_image.py |
发送图片 | --contact, --image |
send_file.py |
发送文件 | --contact, --file |
wechat_sender.py |
核心类库 | - |
关键要点
- 必须用 EnumWindows：pygetwindow.getAllWindows() 找不到最小化窗口
- 恢复最小化必须在坐标筛选之前：最小化窗口的
GetWindowRect返回负坐标(-32000)，如果先按坐标筛选会误排除真正的微信主窗口，选到隐藏的辅助窗口（症状：只弹表情包按钮）。正确流程：先对所有候选窗口IsIconic+ShowWindow(9)恢复，等坐标变为正后再筛选面积最大的可见窗口。用ShowWindow(hwnd, 9)(SW_RESTORE)，不能用ShowWindow(hwnd, 5)(SW_SHOW) - 关闭子窗口：通过类名
Chrome_WidgetWin找到并关闭公众号弹窗等子窗口 - 两次回车：第一次确认选择联系人，第二次进入聊天窗口
- 点击输入框：进入聊天后必须点击输入框区域才能粘贴内容
- 清空残留搜索词：点击输入框后，必须 Ctrl+A → Delete → Ctrl+A 清空残留内容（搜索联系人后输入框可能残留搜索词如"YHD"，光 Ctrl+A 有时选不全）
- 不要按 ESC：ESC 会关闭微信窗口导致焦点丢失
- 中文编码：Python 脚本开头加
sys.stdout.reconfigure(encoding='utf-8') - 图片格式：微信只接受 BMP/DIB 格式，必须转换
- 前台切换必须用 AttachThreadInput：单独调用
SetForegroundWindow或SetWindowPos(HWND_TOPMOST)均不可靠。Windows 只允许前台进程的线程切换前台窗口，必须用以下组合：
python foreground_thread = user32.GetWindowThreadProcessId(user32.GetForegroundWindow(), None) wechat_thread = user32.GetWindowThreadProcessId(hwnd, None) user32.AttachThreadInput(foreground_thread, wechat_thread, True) # 附加线程 user32.keybd_event(0x12, 0, 0, 0) # 模拟 Alt 键（欺骗 Windows） user32.keybd_event(0x12, 0, 2, 0) user32.SetForegroundWindow(hwnd) user32.AttachThreadInput(foreground_thread, wechat_thread, False) # 取消附加
环境要求
- Windows 操作系统
- Python 3.x
- 依赖包:
pip install "pyautogui>=0.63.0,<1.0.0" "pyperclip>=1.8.0,<2.0.0" "pywin32>=306,<310" "Pillow>=10.0.0,<13.0.0" - 微信 PC 客户端已登录
- 目标联系人在微信搜索中可找到
安装依赖
pip install "pyautogui>=0.63.0,<1.0.0" "pyperclip>=1.8.0,<2.0.0" "pywin32>=306,<310" "Pillow>=10.0.0,<13.0.0"
详细文档
- reference.md - 详细技术文档和故障排查
- examples.md - 更多使用示例
注意事项
⚠️ 重要：
- 本工具通过 GUI 自动化实现，不使用微信官方接口
- 请确保微信已打开且能正常使用
- 发送大量消息时请适当增加延时，避免被限制
- 建议先在测试账号上验证流程
更新日志
v1.0.5 (2026-05-13)
- 修复最小化状态下窗口激活失败：
find_wechat_window()在窗口恢复前按坐标筛选，最小化窗口坐标为负(-32000)被排除，选到隐藏辅助窗口，导致激活时只触发表情包按钮 - 修复方案：先对所有候选窗口调用
IsIconic+ShowWindow(9)恢复，再按正坐标筛选面积最大的可见窗口
v1.0.4 (2026-05-13)
- 修复搜索框点击不可靠问题：
search_contact()中 Ctrl+F 后点击搜索框在 cron 环境下可能失败（点击打偏），导致联系人名字输入到错误位置、消息发给错误的人 - 修复方案：去掉点击搜索框步骤，Ctrl+F 后搜索框已自动聚焦，直接
typewrite(contact_name)输入即可
v1.0.3 (2026-05-11)
- 修复搜索词残留问题：搜索联系人后输入框可能残留搜索词（如"YHD"），光 Ctrl+A 有时选不全
- 新增 Delete 键强制清空：点击输入框后执行 Ctrl+A → Delete → Ctrl+A 三步清空，确保消息无残留前缀
- 修复 send_message 返回逻辑：成功后正确返回 True，失败后正确返回 False
v1.0.2 (2026-04-30)
- 添加自动重试机制：前台切换失败时自动重试最多 2 次，每次等待 2 秒
activate_window验证失败时返回 False，让调用者感知失败- 解决浏览器占前台时定时任务发送失败的问题
v1.0.1 (2026-04-24)
- 修复微信窗口被其他窗口遮挡时无法切换到前台的问题
activate_window方法改用AttachThreadInput + keybd_event(Alt) + SetForegroundWindow组合，确保微信窗口必定切换到前台
v1.0.0 (2026-04-16)
- 初始版本
- 支持发送文字、图片、文件
- 完整的错误处理和日志
