wechat-reply-ai

Windows 本地微信自动回复与消息处理工具。用于 Codex 需要在已登录的 PC 微信上执行联系人定位、OCR 读取最新消息、生成并发送中文回复、发送图片/视频/文件、截图最新图片预览、或启动常驻守护进程加速代回时。适用于“回 xxx”“查看微信最新消息”“帮我发图片/视频”“把微信代回流程固化成快路径”等场景。

微信自动回复工具

概览

使用这个 skill 处理 Windows 本地 PC 微信的聊天读取、消息发送和高频代回。

优先复用 scripts/wechat_send.py 与 scripts/wechat_assistant_daemon.py，不要重复重写窗口定位、OCR、滚动到底、中文发送编码和守护进程逻辑。

快速选择

1. 单次读取、单次回复、单次发送媒体文件：直接用 scripts/wechat_send.py
2. 连续多轮代回、想减少冷启动时间：先启动 scripts/wechat_assistant_daemon.py
3. 需要排查微信窗口、OCR 抓取、滚动到底、截图范围：先读 references/ocr-and-window-rules.md
4. 需要决定回复口吻或代回风格：读 references/reply-style-guide.md
5. 需要确认环境、依赖、运行前提：读 references/runtime-requirements.md

标准工作流

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/wechat_assistant_daemon.py --start --exe "D:\app\Weixin\Weixin.exe"
python scripts/wechat_assistant_daemon.py --read-latest-incoming --contact "mike--"
python scripts/wechat_assistant_daemon.py --send-message "收到，我来处理。" --contact "mike--"

执行规则

• 优先走最快本地路径，不要在同一轮里重复搜索联系人、重复拖动滚动条、重复 OCR 同一块区域。
• 使用守护进程时，把“读消息”和“发消息”都交给 scripts/wechat_assistant_daemon.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