教程¶
教程以“完成一个可验证结果”为目标，说明前置条件、操作步骤、验收方法和失败处理。节点的完整端口和属性仍以节点参考为准；需要查单个按钮时，可回到用户手册。
第一次使用¶
如果还没有创建过蓝图，先完成创建第一个自动化。确认蓝图可以保存和 Debug 后，再进入下面的案例。
推荐学习路线¶
- 按当前时间与条件执行：认识执行线、数据线、比较、分支和单次汇流。
- 从录制素材生成图像识别动作：把时间线中的画面变成可执行的识别目标。
- 拆分并复用过长宏：跨蓝图迁移片段及其依赖，并整理开始、结束接口。
- 整理与迁移内嵌资源：理解资源状态、替换和导出边界，安全缩小蓝图或宏包。
四篇教程可以独立完成。若主要使用宏编辑器，可以先做第二篇，再根据需要阅读第三、第四篇。
教程索引¶
| 教程 | 完成后的结果 | 预计重点 |
|---|---|---|
| 按当前时间与条件执行 | 在指定星期执行共同动作，多个条件同时成立时也只触发一次。 | 当前时间、数值对比、分支、单次汇流 |
| 拆分并复用过长宏 | 把长宏的一段移动到另一蓝图，并保留所需资源、变量和组件关系。 | 宏片段剪贴板、蓝图接口、.gmacro |
| 从录制素材生成图像识别动作 | 从主预览轨的截图或视频帧生成识别模板并完成 Debug。 | 录制素材、逐个管理、自动生成模板 |
| 整理与迁移内嵌资源 | 区分已使用、未使用和受保护资源，完成导出、替换或迁移。 | Image、Video、ONNX、.gmacro、.gcbps |
跟随教程时¶
- 使用测试目标，不直接操作重要账号、窗口或文件。
- 每完成一段执行路线就保存并进行小范围 Debug，不要等全部连完才检查。
- 教程使用当前界面名称；如果项目仍在开发中并出现轻微文字差异，以相同功能和节点分类为准。
- 百分比坐标依赖画布尺寸。改变画布或目标分辨率后，应重新检查模板和触摸位置。
- “施工中”节点不会作为这些教程的关键步骤。
操作结果与预期不同时，先查看教程末尾的失败处理，再参考故障排查。