Wechat Sender

核心用法

WeChat Sender 是一套基于视觉理解的微信自动化发送方案，通过组合 peekaboo 窗口操作工具与 Agent-Eye 屏幕捕获服务，实现对微信客户端的 GUI 自动化控制。

关键能力组合：

• 窗口操控：聚焦微信窗口并调整至 1200×900 分辨率，绕过防录屏限制
• 视觉感知：Agent-Eye 提供实时截图（100px 网格+鼠标准星），结合内置 image 工具进行界面理解
• 联系人查找：双模式策略——推荐 Cmd+F 搜索（高效），备选 Shift+方向键列表滑动
• 消息发送：剪贴板粘贴文本 + Cmd+Return 快捷键触发发送

典型执行流：聚焦窗口 → 调整大小 → 搜索/定位联系人 → 截图确认 → 粘贴消息 → 发送 → 二次截图验证气泡出现。

显著优点

1. 非侵入式架构：不依赖微信 API 或协议破解，纯 GUI 层模拟，降低账号风控概率
2. 视觉反馈闭环：每次关键操作后截图确认，避免盲目执行导致的误发
3. 灵活策略选择：搜索模式适合已知姓名场景，列表滑动适合顺序固定的批量场景
4. 网格坐标辅助：100px 网格叠加降低定位误差，便于精确点击

潜在缺点与局限性

• 外部依赖重：必须同时启动 eye-server + Python Agent 两个服务，部署门槛较高
• 延迟敏感：截图-分析-决策链条长，单次发送耗时数秒至数十秒，不适合高并发
• UI 脆弱性：微信版本更新可能导致界面元素位置偏移，需维护坐标映射
• 平台锁定：当前方案基于 macOS（screencapture、cmd 键），跨平台需适配

适合人群

• 需要低频、个性化微信触达的自动化场景（如定时问候、状态通知）
• 具备本地服务部署能力的技术用户
• 无法接受 API 方案封号风险，愿牺牲效率换取稳定性的场景

常规风险

• 隐私泄露：屏幕捕获服务截取完整桌面内容，需确保运行环境隔离敏感信息
• 误发风险：视觉理解错误可能导致消息发送至错误联系人，建议关键操作前人工复核
• 服务可用性：Agent-Eye 服务崩溃将导致整个链路中断，缺乏降级机制
• 微信风控：频繁自动化操作仍可能触发客户端行为检测，建议控制发送频率

核心用法

WeChat Sender 是一套基于视觉理解的微信消息自动化发送方案，通过组合 peekaboo 窗口操作工具与 Agent-Eye 屏幕捕获服务，实现无需 API 的微信消息自动发送。

执行流程：
1. 环境准备：启动微信并保持登录，启动 Agent-Eye 服务（eye-server --port 8080）
2. 窗口操作：聚焦微信窗口并调整大小（peekaboo window focus/set-bounds）
3. 查找联系人：推荐 Cmd+F 搜索，或滑动列表选择
4. 视觉确认：通过 The-Eye 截图 + image 工具分析界面状态
5. 消息发送：粘贴文字（peekaboo paste）+ 快捷键发送（cmd+return）
6. 结果验证：再次截图确认消息气泡出现

关键原子能力：

• 窗口聚焦/调整、截图（The-Eye 实时流或 screencapture）、图像理解（OpenClaw 内置 image 工具）
• 快捷键模拟（搜索、切换联系人、发送）、剪贴板粘贴

显著优点

• 零侵入：不依赖微信 API 或协议破解，纯视觉驱动，账号安全风险极低
• 直观可控：每步操作可截图验证，流程透明，失败可重试
• 灵活组合：原子能力可自由组合，适应不同场景（已知联系人直接搜索，未知则滑动列表）
• 绕过防录屏：通过窗口聚焦+调整大小（1200×900）解决微信等应用的防录屏限制
• 实时反馈：100px 网格叠加和鼠标准星坐标辅助精确定位界面元素

潜在缺点与局限性

• 依赖链复杂：需同时维护微信、Agent-Eye 服务、peekaboo 工具三个组件
• 性能开销：截图-分析-操作的循环延迟（建议操作间隔 0.3 秒），不适合高并发场景
• UI 脆弱性：微信界面更新可能导致坐标定位失效，需重新适配
• 平台限制：Agent-Eye 和 peekaboo 的窗口操作主要面向 macOS，Windows/Linux 支持不确定
• 无状态保持：每次发送需完整走流程，无法维持长期会话状态

适合人群

• 需要低频、可控微信自动化操作的个人用户
• 对账号安全敏感、不愿使用协议破解方案的用户
• 具备基础技术能力、能维护多组件依赖的开发者
• macOS 用户（当前工具链最成熟的平台）

常规风险

• 外部依赖安全：Agent-Eye 为个人开发者项目（T3 级别），需自行审查代码
• 本地服务暴露：localhost:8080 需确保仅绑定 127.0.0.1，避免公网暴露
• 权限管理：peekaboo 操作窗口需适当系统权限，应遵循最小权限原则
• 误操作风险：自动化点击可能触发意外交互，建议关键操作前截图确认