1. 项目概述：微信自动化工具的职场刚需
在快节奏的现代职场中，重复性工作消耗着大量精力。每天固定时间的微信报岗、周期性工作汇报、节假日客户问候...这些看似简单的任务却形成了典型的"时间黑洞"。LeafAuto正是为解决这类痛点而生的轻量化工具，它通过模拟人工操作实现微信消息的自动化发送，特别适合需要高频重复发送固定内容场景的用户群体。
这个工具的核心价值在于将机械操作转化为自动化流程。以常见的销售日报为例，传统方式需要每天手动打开微信→寻找联系人→输入固定格式内容→点击发送，整个过程至少消耗3-5分钟。而使用自动化工具后，只需预先配置一次，后续即可实现无人值守的定时发送，长期下来可节省数百小时的工作时间。
2. 核心功能解析
2.1 定时消息发送机制
系统采用分层式定时架构设计：
- 基础定时层：基于系统级定时任务服务
- 容错处理层：网络中断自动重试机制
- 执行监控层：消息状态实时日志记录
具体实现上，通过Windows任务计划程序与Python自动化脚本的组合，实现了分钟级精度的定时控制。在实测中，即使在系统休眠状态下，也能通过硬件唤醒触发任务执行。
2.2 联系人匹配方案
针对微信不断变化的UI结构，系统采用三重定位策略：
- 通讯录搜索优先：通过拼音首字母快速定位
- 聊天记录辅助：最近会话列表二次确认
- 图像识别兜底：联系人头像特征匹配
这种组合式方案在微信v3.9.5版本测试中，联系人识别成功率达到98.7%。对于特殊场景（如重名联系人），系统会弹出确认对话框进行人工干预。
2.3 消息内容编排
支持三种内容输入模式：
- 固定文本：适合标准化汇报场景
- 变量替换：支持{date}、{time}等动态标记
- 外部导入：从Excel/CSV读取数据生成消息
高级功能中还包含消息队列功能，可以实现多条消息的序列化发送，满足复杂场景需求。
3. 技术实现细节
3.1 自动化控制方案
系统基于PyAutoGUI库实现GUI自动化操作，核心控制流程包括：
- 微信窗口激活与聚焦
- 快捷键组合调用（Ctrl+Alt+W）
- 控件定位与点击模拟
- 输入延迟优化（300-500ms间隔）
为避免操作冲突，系统会检测鼠标当前位置，在自动化执行期间锁定输入设备。
3.2 异常处理机制
完善的错误恢复系统包含：
- 窗口丢失检测：自动重新启动微信客户端
- 消息发送超时：默认30秒超时重试
- 内容校验失败：自动截图保存现场
所有异常事件都会记录到本地日志文件，方便后续排查分析。
3.3 安全防护设计
为确保账号安全，系统实现了：
- 无密码存储：不记录微信登录凭证
- 操作间隔保护：防止频率过高触发风控
- 人工验证中断：遇到安全验证自动暂停
系统运行期间会保持微信在前台可见状态，所有操作透明可监控。
4. 典型应用场景
4.1 销售日报自动化
配置示例：
code复制时间：每日17:30
内容："【销售日报】{date}
今日拜访：{count}家
明日计划：{plan}"
通过对接CRM系统API，可自动填充{count}和{plan}变量。
4.2 项目进度提醒
适用于敏捷开发团队，每天站会前自动发送：
code复制"【{project}】今日任务：
1. {task1} - {owner1}
2. {task2} - {owner2}
阻塞问题：{blocker}"
数据来源可以是Jira或TAPD等项目管理工具。
4.3 客户关怀场景
节假日自动发送定制化祝福：
code复制"尊敬的{name}：
值此{holiday}之际，
祝您节日快乐！
{company} {sales}"
支持插入个性化称呼和公司logo图片。
5. 实操配置指南
5.1 环境准备
硬件要求：
- Windows 10/11系统
- 显示器分辨率≥1366×768
- 保持微信客户端常驻
软件依赖：
- Python 3.8+运行环境
- 微信官方客户端（≥v3.7.0）
- 必要的Python包（自动安装）
5.2 基础配置流程
-
创建新任务：
- 命名任务（如"晨会提醒"）
- 设置执行周期（每天/每周/单次）
-
选择联系人：
- 输入微信备注名
- 或从最近聊天记录选择
-
编辑消息内容：
- 支持文本/图片/文件
- 可使用变量模板
-
测试运行：
- 立即执行测试
- 检查发送结果
5.3 高级功能配置
变量使用示例：
code复制{date:%Y年%m月%d日} → 2023年08月15日
{time:%H:%M} → 14:30
{weekday} → 星期二
条件发送设置：
- 工作日过滤（排除节假日）
- 成功率阈值（低于90%报警）
- 依赖任务（前置任务成功才执行）
6. 常见问题排查
6.1 消息未发送
可能原因及解决方案：
| 现象 | 排查步骤 | 解决方法 |
|---|---|---|
| 微信未启动 | 检查进程列表 | 设置自动启动微信 |
| 窗口被遮挡 | 查看截图日志 | 调整窗口位置 |
| 控件识别失败 | 更新定位配置 | 手动标注控件 |
6.2 定时不准确
时间漂移常见原因：
- 系统时间不同步（启用NTP服务）
- 电脑休眠中断（修改电源设置）
- 任务堆积延迟（优化执行间隔）
建议配置Windows时间服务自动同步：
powershell复制w32tm /resync
6.3 内容错乱
模板变量问题处理：
- 检查花括号匹配
- 验证变量名拼写
- 确认数据源可用性
特殊字符转义规则：
- 换行符 → \n
- 花括号 → {{ }}
- 百分号 → %%
7. 安全使用建议
7.1 账号安全防护
重要预防措施：
- 不在他人电脑保存配置
- 定期检查登录设备
- 开启微信登录提醒
- 避免高频发送相同内容
7.2 敏感信息处理
内容安全准则：
- 不存储客户隐私数据
- 关键信息脱敏处理
- 加密保存配置文件
- 定期清理日志文件
7.3 合规使用提醒
注意遵守平台规则：
- 单日消息总量控制在50条内
- 相同内容间隔大于5分钟
- 避免深夜时段发送（22:00-8:00）
- 重要通知建议人工二次确认
实际使用中，建议先在小范围测试运行1-2周，确认稳定性后再扩大应用范围。对于关键业务场景，仍需保留人工确认环节作为安全保障。