    "StartGame_ClickStart": {
        "pre_wait_freezes": 500,
        "recognition": {
            "type": "OCR",
            "param": {
                "expected": [
                    "点击任意处开始"
                ],
                "roi": [
                    450,
                    555,
                    390,
                    40
                ]
            }
        },
        "action": {
            "type": "Click"
        },
        "next": [
            "[JumpBack]StartGame_ClickStart_again",
            "StartGame_Login",
            "[JumpBack]StartGame_Login_wait",
            "StartGame_Scene_Check_Homepage"
        ]
    }

该节点先进行一次 "roi": [450,555,390,40] 的 OCR ，之后 Click 刚才 OCR 的结果。

提示

Click 在没有显式指定 target 时，默认为 true（目标为本节点中刚刚识别到的位置（即自身）。详见 MaaFramework 任务流水线协议

流程必须能退出

任何循环、重试和可选步骤都应该能解释：什么时候继续、什么时候退出、失败后去哪里。

节点必须便于审核

节点命名、desc、图片路径和跳转关系应能让维护者快速判断节点用途。不要把多个阶段塞进一个巨大节点里。

节点设计

节点职责

业务流程推荐优先拆成几个阶段：

Enter：进入某个页面或入口。
Verify：确认当前页面、状态或前置条件。
Click：点击已经识别到的目标。
Do：执行一个业务动作或一组强相关动作。
OCR：只负责 OCR 判断或文本提取。

节点命名

任务专属节点必须以任务名开头，例如：

StartGame_...
Award_...
Award_Task_...
Award_MaintenanceArea_...

通用节点使用固定前缀：

UI_：纯视觉识别节点，例如 UI_Task_ClaimAll。
Status_：状态判断节点，例如 Status_In_MainMenu。
SceneDo_：可复用动作节点，例如 SceneDo_GetItem。
AnySceneEnter_：万能跳转入口，例如 AnySceneEnter_MainMenu。

推荐在任务节点中使用动作语义：

Task_Enter:Target：进入某个页面或入口。
Task_Verify:State：确认页面或状态。
Task_Click:Target：点击某个已识别目标。
Task_Do:Action：执行某个业务动作。
Task_OCR:Meaning：只负责 OCR 判断。

冒号后面写目标或状态，便于调试日志中快速看出节点用途。

desc 编写

业务节点应写 desc。描述要说明节点目的，而不是重复字段名。

识别与点击

可以接受的点击形式

节点自身识别到目标后，使用 action: "Click" 点击当前识别结果。
使用 box_index 指定 And 节点输出自身的某个子识别命中范围并点击自身，或使用 param.target 点击另一个已经参与识别的 UI 节点。
在 custom 中点击前，先通过 pipeline 或截图分析确认当前界面和目标位置。

不允许的点击形式

没有 recognition 就直接点击坐标。
只靠 post_delay 猜测页面已经到位后点击。
custom 中直接 post_click(x, y)，但没有任何视觉识别或状态判断保护。

如果确实必须使用坐标，需要在 PR 中说明原因，并在坐标点击前增加足够的视觉识别条件。

OCR 与状态识别

OCR 和状态识别节点应只负责判断或提取信息，不要同时承担复杂流程控制。OCR 的 expect 应来自实际游戏画面，不应凭空编写。

模板匹配应使用稳定、特征明确的区域。避免把大面积背景、动态数字、红点、倒计时等容易变化的内容放进模板图，除非节点目的就是识别这些状态。

流程控制

有一些奇妙的方法可以让 Pipeline做到许多事情。下面是一些例子：

可选子任务

通过利用 [JumpBack] 配合多个 max_hit: 1 的节点实现可选子任务

示例：assets\resource\pipeline\Award.json

{
    "AwardMain": {
        "desc": "奖励领取入口",                    // 描述
        "next": [
            "[JumpBack]AwardSub_MaintenanceArea", // 通过 [JumpBack] 使节点执行完毕后返回并再次执行该节点
            "[JumpBack]AwardSub_Task",            // 通过 [JumpBack] 使节点执行完毕后返回并再次执行该节点
            "AwardEnd"                            // 结束节点
        ]
    },
    "AwardSub_MaintenanceArea": {                 // 节点默认为 DirectHit ，直接命中
        "max_hit": 1,                             // 通过 "max_hit": 1 实现在本次执行任务时只会进入一次本节点
        "next": [
            "Award_MaintenanceArea"               // next 内填写子任务入口节点
        ]
    },
    "AwardSub_Task": {
        "max_hit": 1,
        "next": [
            "Award_Task"
        ]
    },
    "AwardEnd": {}
}