wechat-auto-reply-toolkit

# 微信自动回复工具 ## 概览 使用这个 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](references/ocr-and-window-rules.md) 4. 需要决定回复口吻或代回风格：读 [references/reply-style-guide.md](references/reply-style-guide.md) 5. 需要确认环境、依赖、运行前提：读 [references/runtime-requirements.md](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/runtime-requirements.md) - 快速代回流程与提速策略： [references/fast-reply-workflow.md](references/fast-reply-workflow.md) - 微信窗口、滚动条、OCR 裁剪规则： [references/ocr-and-window-rules.md](references/ocr-and-window-rules.md) - 常见代回口吻与安全边界： [references/reply-style-guide.md](references/reply-style-guide.md) - 代回助手默认人设： [persona.md](persona.md)