标准工作流

1. 1. 确认Windows已打开并登录PC微信，目标聊天可以在当前账号中搜索到。
2. 优先尝试复用当前聊天会话；如果聊天头部OCR已匹配目标联系人，不要再次搜索联系人。
3. 优先读取最新消息而非整屏聊天；除非需要上下文，否则不要重复运行OCR。
4. 即时代回时，不要额外联网；仅当用户明确要求查证联网确认按最新资料回复时再上网。
5. 生成回复后，优先通过--message-file或守护进程发送，避免中文在终端链路中变成乱码或???。
6. 如果用户仅说回mike--这类短指令，完成发送后只向用户展示最终回复内容，不展开思考过程。
7. 检测到Esc按键时，立即中断调试或长轮询操作。

快速命令

单次读取最新可见消息

powershell
python scripts/wechat_send.py --contact mike-- --read-latest --history-lines 10 --exe D:\app\Weixin\Weixin.exe

单次读取最新来消息

powershell
python scripts/wechat_send.py --contact mike-- --read-latest-incoming --exe D:\app\Weixin\Weixin.exe

通过UTF-8文件发送中文回复

powershell
python scripts/wechat_send.py --contact mike-- --message-file D:\temp\reply.txt --exe D:\app\Weixin\Weixin.exe

发送图片、视频或任意文件

powershell
python scripts/wechat_send.py --contact mike-- --image D:\pics\a.jpg --video D:\videos\b.mp4
python scripts/wechat_send.py --contact mike-- --file D:\docs\report.pdf

截取最新图片预览

powershell
python scripts/wechat_send.py --contact mike-- --capture-latest-image --preview-output D:\temp\latest.png

启动常驻助手并复用会话

powershell
python scripts/wechatassistantdaemon.py --start --exe D:\app\Weixin\Weixin.exe
python scripts/wechatassistantdaemon.py --read-latest-incoming --contact mike--
python scripts/wechatassistantdaemon.py --send-message 收到，我来处理。 --contact mike--

执行规则

• - 优先走最快本地路径，不要在同一轮中重复搜索联系人、重复拖动滚动条、重复OCR同一块区域。
• 使用守护进程时，将读消息和发消息都交给scripts/wechatassistantdaemon.py，避免每次重新初始化OCR。
• 微信窗口识别优先使用uiautomation + pywinauto的现有逻辑，避开托盘图标窗口和无效白屏窗口。
• 如需读取图片内容，先抓取预览图，再决定是否进行OCR或视觉识别；不要将聊天区中的[图片]占位符误当成真实图像内容。
• 对于高风险场景的代回，例如医疗、法律、财务，回复要谨慎、具体、不过度承诺；必要时提醒用户及时联系线下专业人士。

资源导航

• - 环境要求与依赖：references/runtime-requirements.md
• 快速代回流程与提速策略：references/fast-reply-workflow.md
• 微信窗口、滚动条、OCR裁剪规则：references/ocr-and-window-rules.md
• 常见代回口吻与安全边界：references/reply-style-guide.md
• 代回助手默认人设：persona.md