技能介绍

解决什么问题

私域运营里常见一类机械重复：同一批文件、少量文案要分别发到多个企业微信群。人工复制粘贴容易漏群、发错群、卡在大文件上传，而且换屏幕、换分辨率后 GUI 坐标又不可靠。这个技能把“按群发文件和文案”拆成可重复的桌面自动化流程：配置目录、执行批次、查看日志。

如何工作

核心思路是把本地文件夹映射为企业微信群：

根目录下每个子文件夹代表一个目标群，文件夹名即群名，要求与群名完全一致。
运行时使用 pyautogui 模拟企业微信界面操作，通过 OCR 识别搜索结果并校验目标群。
文件上传通过 Finder 或资源管理器中的 Cmd+A、Cmd+C、Cmd+V 完成，避免逐文件手动拖拽。
文案支持全局固定内容，也支持从群目录中的 .txt、.md、.docx 等“内容文字”文档自动提取，文档本身不发送。
首次使用需要 calibrate_gui.py 校准 UI 坐标，坐标写入 ~/.privateflow_coords.json，后续自动加载；更换显示器或窗口后可重新校准。
运行过程保留 CSV 日志、成功/失败清单与每步截图，并支持右上角浮窗停止当前批次。
配套 private-flow-mcp-server 提供 privateflow_dry_run、privateflow_send_batch、privateflow_get_status、privateflow_calibrate、privateflow_stop 等工具，便于通过对话预览、启动、查询和停止任务。

适用边界

它适合 macOS Apple Silicon / Intel 与 Windows 64-bit 下的企业微信桌面端批量操作，但不是通用消息网关。单文件建议不超过 500MB，群数量建议控制在 100 以内；默认每群间隔 10 秒、每 20 群暂停 180 秒用于降低风控风险。技能不处理验证码、滑块或人工限制，触发后需手动通过。群名不能包含 <>:"/\|?* 等非法字符，OCR 精度依赖 tesseract，中文识别建议安装中文语言包。