MacroAI 使用者手册

一、简介

MacroAI 是一款 Windows 宏自动化工具。您可以使用他人制作好的自动化脚本，让软件自动完成鼠标点击、键盘输入、图像识别等一系列操作。

适用场景： 游戏辅助 · 办公自动化 · 软件测试 · 运维管理 · RPA

二、快速上手

1. 导入项目

从设计者那里获得项目文件（.macroai 格式）后：

1. 点击菜单 项目 → 导入（或按 Ctrl+I）
2. 选择 .macroai 项目包（旧版 .zip 包仍可导入）
3. 如果设计者标记了分发包，系统会自动进入运行模式

什么是分发包？设计者导出的特殊项目包，导入后自动进入运行模式且无法切换至设计模式，您只需关注运行所需的配置即可。

2. 认识运行模式界面

导入分发包后，您将看到简洁的运行模式界面，主要分为三个区域：

┌── ① 项目信息（可折叠） ───────────────────────┐
│  📁 项目名称                                   │
│  设计分辨率：1920×1080   坐标策略：等比缩放     │
│  ────────────────────────────────────────────  │
│  项目描述：自动识别游戏界面，匹配相同图案       │
│  并自动点击消除。可自定义头像和昵称显示。       │
└──────────────────────────────────────────────────┘

┌── ② 区域校准（始终可见） ───────────────────┐
│  🖥 运行区域：── 未校准 ──  [ 校准运行区域 ]  │
│  🖥 设计区域：1920×1080（参考）               │
│  坐标策略：等比缩放（自动适配）               │
└──────────────────────────────────────────────────┘

┌── ③ 个性化配置（可折叠） ───────────────────┐
│  ⚠️ 昵称：使用默认值                          │
│  ✅ 头像：已设置                              │
│  ❌ 签名档：未设置                            │
└──────────────────────────────────────────────────┘

工具栏提供运行/停止、后台/前台切换、日志级别控制等基本功能。

3. 第一步：校准运行区域

校准是使用脚本的第一步，确保脚本的操作位置与您的屏幕匹配：

1. 点击区域校准卡片上的 [ 校准运行区域 ] 按钮
2. 按照屏幕指示框选脚本运行的窗口或区域
3. 校准完成后，卡片上会显示运行区域的具体尺寸和位置

如果设计区域是全屏，系统会自动适配当前屏幕，无需手动框选。

4. 第二步：填写个性化配置

如果设计者设置了用户配置变量（如昵称、头像等），在个性化配置区填写：

• 文本类型：在输入框中输入您的值
• 图像类型：点击 [截图] 或 [选择文件] 上传您的图片

每项配置左侧的状态图标表示：

所有修改会自动保存。

5. 运行脚本

所有配置完成后，点击 ▶ 运行（或按 F5）执行脚本。点击 ■ 停止（或按 Shift+F5）随时终止。

运行过程中，底部的日志面板会自动展开，显示执行进度和结果。

三、配置完整度指示器

工具栏右侧的指示器帮助您了解当前配置状态：

点击指示器可展开详细配置清单，查看具体哪些项需要关注，点击 [跳转] 快速定位。

四、日志面板

运行日志显示在界面底部的可折叠面板中：

• 空闲时：面板收起，底部只显示运行按钮
• 运行中：面板自动展开，实时显示日志
• 运行结束：保留最后状态，可手动收起

工具栏的 🐞 调试 下拉菜单控制日志详细程度：

五、浮动控制面板

运行脚本时自动弹出浮动控制面板（始终置顶，可拖拽）：

• 暂停/继续：临时停止或恢复执行
• 自定义动作按钮：设计者定义的快捷操作（如"暂停后手动调整窗口"）。设计者也可将动作设为独立悬浮按钮——以独立小窗显示在屏幕任意位置，拖拽后的位置会自动记忆；设为"不显示"的动作则不出现在运行界面
• 任务区（Pro 功能）：显示周期任务的状态墙和待办数量，见下文
• 背景音乐控制：如果脚本包含音乐，显示暂停/继续/静音按钮
• 关闭面板：停止脚本执行

任务区：状态墙与待办按钮

设计者配置了周期任务（如"每日签到""每 2 小时提醒喝水"）时，面板中会出现任务区：

• 状态墙：每个任务一个小方块。实心 = 本轮已有结果，空心 = 还没做；绿色 = 已完成，蓝色 = 等待执行，黄色 = 正在执行，灰色 = 空闲或已停用。鼠标悬停可查看任务名和进度
• 待办按钮：显示"待办 N"或"✓ 全部完成"

点击任意方块或待办按钮，打开弹出任务面板：

• 点整行执行：绑定了动作的任务，点击行即可执行（运行中再点 = 停止）
• 确认完成：纯提醒类任务，点击行即确认完成一次
• 右键任务行：手动补做一次等操作
• ⚙ 设置：快捷开关——显示状态墙、提醒方式（托盘气泡 / 应用内弹窗 / 提示音）、全部完成时通知、自动执行总开关

任务提醒

任务到期或进入新周期时，按 ⚙ 设置中开启的渠道提醒您：

若设计者将任务设置为"到期自动执行"，到点且 自动执行总开关 开启时，会自动依次运行绑定的动作，无需您在场；每次到期、排队与执行结果都可在日志中追溯。

六、常见问题

校准区域时框选错了怎么办？

重新点击 [ 校准运行区域 ] 按钮再次框选即可。

个性化配置填错了怎么恢复？

文本类型点击 [恢复默认] 即可还原为设计者的示例值；图像类型点击 [清除] 后重新选择。

状态指示器一直显示🔴？

说明运行区域尚未校准。请完成校准操作后再运行。

运行过程中脚本点击位置不对？

可能是运行区域校准不准确，请重新校准。如果问题持续，联系脚本的设计者。

如何切换后台/前台模式？

• 后台模式（默认）：在后台模拟操作，不影响您正常使用电脑
• 前台模式：直接控制鼠标键盘，会抢占控制权

后台模式无效时可切换为前台模式。

状态墙里的方块是什么意思？

实心 = 本轮已有结果，空心 = 还没做。绿色 = 已完成，蓝色 = 等待执行，黄色 = 正在执行，灰色 = 空闲或停用。红色实心 = 本期已结束但没有完成；红色空心 = 任务绑定的动作已缺失（提醒与计数会暂停，请联系设计者修复）。

任务提醒收不到？

打开弹出任务面板的 ⚙ 设置，检查对应渠道是否开启（应用内弹窗和托盘气泡默认开启，提示音默认关闭）。注意：任务显示红色空心方块（动作缺失）时提醒会暂停。

任务到点没有自动执行？

需要同时满足两个条件：设计者在任务中选择了"自动执行"，且弹出任务面板 ⚙ 设置 中的自动执行总开关已开启。另外，自动执行需要软件处于开启状态——错过到点不会补做，当时发生了什么可在任务执行日志中追溯。

七、快捷键速查

更详细的信息请参考 帮助 → 设计者指南（面向脚本制作者）。

问题反馈： 使用中如遇到程序报错或有任何建议，请发送邮件至 macroai@sowe.com。我们期待您的反馈！