入门与基础概念

MacroAI 是一款跨平台宏自动化工具，支持 Windows 和 Android。它让你无需编程基础，就能制作出"自动点击、自动识别图片、自动识别文字"的自动化脚本。

典型用途：

• 游戏辅助 — 自动打怪、自动吃药、自动日常任务
• 办公自动化 — 批量填表、自动操作 ERP/CRM 系统
• 软件测试 — 模拟用户操作、回归测试
• 运维管理 — 定时巡检、监控告警后自动处理

核心能力：图像识别定位、OCR 文字识别、颜色检测、屏幕变化监控、鼠标键盘模拟、Lua 脚本扩展。

MacroAI 以项目为单位管理所有内容。使用任何功能前，必须先创建一个项目：

1. 点击菜单 项目 → 新建项目（或按 Ctrl+N）
2. 首次使用会引导你选择工作目录（项目文件存放位置），选一个你记得住的文件夹即可
3. 输入项目名称（如"对对碰辅助"）
4. 设定设计区域（见下一个问题）
5. 点击确定，项目创建完成

创建后你就可以在节点编辑器中添加节点、录制宏、管理图片了。

设计区域定义了你的脚本"在哪个范围内工作"。它告诉 MacroAI：你制作脚本时看到的目标窗口/画面是哪个区域。

为什么需要它？因为同一个脚本可能在不同分辨率的电脑上运行。有了设计区域作为参考基准，MacroAI 才能自动换算坐标，让脚本在别人电脑上也能正确运行。

两种选择：

• 全屏 — 如果你操作的是全屏游戏或整个桌面，选这个最简单
• 自定义框选 — 如果你只操作某个窗口（如浏览器、游戏窗口），用鼠标拖拽框选那个窗口

新手建议：不确定就选"全屏"，后续可以在项目设置中修改。

MacroAI 有两种工作模式，面向不同角色：

• 🔧 设计模式 — 给"制作脚本的人"用。包含节点编辑器、变量管理、图片管理等全部 9 个标签页，用来创作和编辑脚本。
• 🏃 运行模式 — 给"使用脚本的人"用。只显示项目信息、区域校准、个性化配置和运行按钮，界面简洁，专注运行。

怎么选？

• 你自己制作脚本 → 设计模式
• 别人发给你一个脚本文件，你只想运行 → 运行模式（导入分发包时会自动切换）

通过工具栏左侧的下拉菜单随时切换，快捷键无冲突。

节点是脚本中的一个操作步骤。比如"鼠标点击(500,300)"是一个节点，"等待2秒"是一个节点，"查找图像"也是一个节点。

节点编辑器让你像搭积木一样，把这些步骤从上到下排列，MacroAI 会按顺序执行它们。

基本操作：

• 添加节点：在左侧面板点击节点类型（如"查找图像""鼠标点击""等待"）
• 配置节点：双击节点打开配置对话框，设置具体参数
• 调整顺序：直接拖拽节点上下移动
• 组合逻辑：把节点拖入"循环"或"条件判断"容器内，实现重复执行或条件分支

节点编辑器会自动生成对应的脚本代码，你不需要手写任何代码。

两者是互补关系：

• 录制宏 — 你操作一遍，MacroAI 录下所有鼠标键盘动作，回放时原样重现。适合"固定步骤、不需要判断"的简单操作。
• 节点编辑器 — 手动搭建流程，可以加入图像识别、条件判断、循环等智能逻辑。适合"需要根据屏幕内容做决定"的复杂场景。

推荐工作流：

1. 先用录制快速录下一段操作
2. 在节点编辑器中添加"调用录制宏"节点
3. 在它前后加上图像查找、条件判断等节点，让流程更智能

简单说：录制解决"做什么"，节点编辑器解决"什么时候做、做几次、满足什么条件才做"。

用一句话概括：项目是容器，里面装着节点（主流程）、函数（可复用子流程）和宏（录制的操作序列）。

• 项目 — 一个完整的自动化任务。包含所有节点、图片、变量、函数、宏等。对应左侧项目列表中的一个条目。
• 节点 — 主流程中的一个步骤。在"节点编辑"标签页管理。
• 函数 — 把一组节点打包成可复用的模块，可以在主流程中多次调用。在"函数"标签页管理。
• 宏 — 录制下来的一段鼠标键盘操作。可以通过"调用录制宏"节点嵌入主流程。在"宏管理"标签页管理。

执行顺序：运行项目时，按节点编辑器中的顺序从上到下执行。遇到"调用函数"节点就跳去执行函数内容，遇到"调用录制宏"节点就回放录制的操作。