Antigravity Clicker

这是一个基于图像识别的 Windows UI 自动化工具，专门设计用于在 VS Code 等复杂界面中执行自动点击任务。它具备智能避让功能，能有效避免与用户抢夺鼠标控制权。

核心特性

• 图像识别定位：使用 pyautogui 和 opencv 进行高精度图像匹配，不受 UI 树结构限制。
• 智能避让系统：实时监听全局鼠标和键盘事件。一旦检测到用户操作，脚本将自动暂停 1.5 秒，确保不干扰用户正常工作。
• 区域嵌套识别：支持先定位背景区域再寻找目标按钮，极大提高了在复杂背景下的识别准确率。
• 长按支持：支持对滚动按钮进行长按操作，模拟真实的人类交互。
• 全局退出热键：随时按下 Ctrl + Shift + Q 即可安全终止脚本，窗口将自动关闭。
• 管理员权限自动提升：脚本启动时会自动请求 UAC 权限，确保能操作高权限窗口。

项目结构

.
├── antigravity/          # 资源文件夹
│   ├── target.png        # 目标点击按钮图片
│   ├── scroll_bg.png     # 滚动条/区域背景图片
│   └── scroll_btn.png    # 滚动倒三角按钮图片
├── main.py               # 主程序脚本
├── requirements.txt      # 依赖清单
└── README.md             # 项目说明文档

快速开始

1. 安装依赖

确保你已安装 Python 3.x，然后在终端运行：

pip install -r requirements.txt

2. 准备图片

在 antigravity 文件夹中放入你的目标图片：

• target.png: 你想要自动点击的按钮。
• scroll_bg.png: 包含滚动按钮的背景区域。
• scroll_btn.png: 具体的滚动按钮（如倒三角）。

3. 运行脚本

python main.py

使用说明

• 避让机制：当你移动鼠标或敲击键盘时，控制台会显示避让倒计时。倒计时结束后，脚本会自动恢复扫描。
• 退出方式：按下 Ctrl + Shift + Q 组合键。
• 权限说明：脚本需要管理员权限才能在 VS Code 等以管理员身份运行的程序中模拟点击。

许可证

MIT License