wxauto-bot-v4

微信自动化机器人 - 支持微信4.x (mmui框架)

📋 项目简介

基于wxauto库的微信自动化机器人，支持：

• ✅ 定时消息发送（文本+图片混合）
• ✅ 消息监听和自动回复
• ✅ 消息转发
• ✅ 奇数/偶数日期任务切换
• ✅ 多群组管理

🎯 核心功能

1. 定时任务系统

支持每日多个时间段自动发送消息序列：

任务组	时间	说明
A7_30	7:30	奇数日期
A12_30	12:30	奇数日期
A19_30	19:30	奇数日期
B7_30	7:30	偶数日期
B12_30	12:30	偶数日期
B19_30	19:30	偶数日期

2. 消息监听

• 监听指定群组的新消息
• 根据关键词自动回复
• 支持消息转发

3. 智能发送

• 窗口预切换，避免重复切换
• 消息间隔控制
• 自动重试机制（最多3次）

🚀 快速开始

环境要求

Python 3.11+
Windows 10/11
微信 4.x 版本

安装依赖

pip install -r requirements.txt

配置

编辑 config.toml 文件：

# 监听列表
listen_list = ['群名称1', '群名称2']

# 定时任务
[[message_sequences.message_sequences_A7_30]]
room = '目标群名称'

[[message_sequences.message_sequences_A7_30.steps]]
type = 'text'
content = '消息内容'

[[message_sequences.message_sequences_A7_30.steps]]
type = 'image'
content = '图片文件名.jpg'

运行

# 启动机器人
python wechat_auto_bot_env_v4.py

# 测试所有定时任务
# 修改 main() 中调用 execute_all_scheduled_tasks()

📁 项目结构

wxauto-bot-v4/
├── wechat_auto_bot_env_v4.py    # 主程序
├── config.toml                   # 配置文件
├── requirements.txt              # 依赖列表
├── wxauto/                       # 本地wxauto库（适配微信4.x）
│   └── wxauto/
│       ├── wx.py                # API层
│       ├── ui/                  # UI操作层
│       ├── uia/                 # UIAutomation封装
│       └── msgs/                # 消息类型
├── wxauto文件/                   # 图片资源目录
│   ├── gf7-1.jpg
│   ├── gf7-2.jpg
│   └── ...
├── logs/                         # 日志目录（自动生成）
├── CHANGELOG.md                  # 更新日志
└── README.md                     # 本文档

⚙️ 核心配置

消息序列配置

[[message_sequences.message_sequences_A7_30]]
room = '目标群名称'

# 文本消息
[[message_sequences.message_sequences_A7_30.steps]]
type = 'text'
content = '''多行文本
内容示例'''

# 图片消息
[[message_sequences.message_sequences_A7_30.steps]]
type = 'image'
content = 'image1.jpg'

监听和回复配置

# 监听的群组列表
listen_list = ['群名称1', '群名称2']

# 自动回复规则
[[auto_replies]]
room = '群名称1'
keywords = ['关键词1', '关键词2']
reply_text = '自动回复内容'

📊 日志说明

日志文件位置：logs/wechat_bot_YYYYMMDD.log

日志级别：

• INFO - 正常运行信息
• WARNING - 警告信息（如重试）
• ERROR - 错误信息
• DEBUG - 调试信息（需手动开启）

查看日志

# Windows
type logs\wechat_bot_20251110.log

# 实时查看
Get-Content logs\wechat_bot_20251110.log -Wait -Tail 50

🔧 性能优化

发送速度

• 窗口预切换：每个群组只切换一次
• 消息间隔：文本0.5秒，图片1秒，消息间隔1秒
• 重试机制：失败自动重试，确保送达

性能对比

场景	旧方案	新方案	提升
1文本+4图片	30-40秒	10-12秒	60%+

⚠️ 注意事项

1. 微信版本

• ✅ 支持：微信 4.x (mmui框架)
• ❌ 不支持：微信 3.x 或更早版本

2. Windows讲述人

使用UIAutomation需要开启Windows讲述人：

设置 → 辅助功能 → 讲述人 → 开启

3. 图片文件

• 图片存放在 wxauto文件/ 目录
• 支持格式：jpg, png
• 文件名在config.toml中配置

4. 运行环境

• 需要保持微信登录状态
• 建议在稳定的网络环境下运行
• 不建议在微信主窗口操作时运行定时任务

🐛 故障排查

问题1：无法发送消息

原因：窗口切换失败或焦点丢失 解决：

1. 确保微信在前台或最小化（不要完全关闭）
2. 检查群名称是否正确
3. 查看日志中的错误信息

问题2：图片发送失败

原因：文件路径错误 解决：

1. 确认图片在 wxauto文件/ 目录
2. 检查文件名是否匹配
3. 确认图片格式是jpg或png

问题3：定时任务不执行

原因：配置文件错误或日期不匹配 解决：

1. 检查config.toml语法
2. 确认日期（奇数/偶数）
3. 查看日志确认调度是否正常

📝 更新日志

查看 CHANGELOG.md 了解详细更新历史。

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可

本项目仅供学习和研究使用。

📞 联系方式

如有问题，请查看日志文件或提交Issue。

---

最后更新：2025-11-10