节点参考
本节记录你能放到画布上的每一种节点。每个节点都有自己的页面：它做什么、何时不该用、每项设置的范围与默认值、它的端口，以及它在运行时的行为。
工具箱如何组织
节点工具箱有六个分组。本参考沿用相同顺序，让你在应用里看到的和在这里读到的一一 对应。
| 分组 | 节点数 | 做什么 |
|---|---|---|
| 操作 Actions | 6 | 向设备发送输入 |
| 检测 Detection | 3 | 读取屏幕上的内容 |
| 逻辑 Logic | 6 | 分支、循环、计算 |
| 记忆 Memory | 2 | 跨运行记住东西 |
| 验证码 Captcha | 1 | 通过一个挑战 |
| 控制 Control | 5 | 启动、停止、调用、监控 |
全部节点
操作 Actions
| 节点 | 摘要 |
|---|---|
| Click（点击） | 点击——或按住——屏幕上的一个点 |
| Swipe（滑动） | 在屏幕上滑动或拖动，用于滚动、快滑或移动 |
| Zoom（缩放） | 双指捏合放大或缩小屏幕 |
| Input Text（输入文本） | 向当前获得焦点的输入框打字 |
| Wait（等待） | 让流程暂停一段时间 |
| Key Press（按键） | 发送硬件/导航键，如 Back、Home、Enter |
检测 Detection
| 节点 | 摘要 |
|---|---|
| Find Image（查找图像） | 等待模板图像出现，然后按找到/未找到分支 |
| Check Region（检查区域） | 按规则检查矩形的颜色、亮度或变化 |
| Read Text (OCR)（读取文本） | 把一个或多个矩形里的文字读入变量 |
逻辑 Logic
| 节点 | 摘要 |
|---|---|
| If（如果） | 按条件分支——五种模式 |
| Branch（分支） | 随机选择一个输出 |
| Loop（循环） | 重复 Loop 与 Loop End 之间的节点 |
| Break（跳出） | 提前离开所在循环 |
| Continue（继续） | 跳到所在循环的下一次迭代 |
| Variable（变量） | 设置、清除、删除或记录流程变量 |
记忆 Memory
| 节点 | 摘要 |
|---|---|
| Memory Match（记忆匹配） | 询问候选者是否匹配已记住的任何东西 |
| Runtime Memory（运行时记忆） | 记住、忘记、清空或计数条目 |
验证码 Captcha
| 节点 | 摘要 |
|---|---|
| Captcha | 读取挑战、执行它，并验证是否被接受 |
控制 Control
| 节点 | 摘要 |
|---|---|
| Start（开始） | 每次运行开始的地方 |
| Stop（停止） | 以声明的状态和消息结束运行 |
| Return（返回） | 从任何地方结束整个流程，包括循环内 |
| Monitor Scope（监控范围） | 在区域内节点运行时守望某个条件 |
| Sub Flow（子流程） | 像函数一样调用另一个已保存流程 |
旧流程还可能包含工具箱里不再提供的节点类型，见旧节点。
如何阅读节点页
每一页都用同一结构，方便你直达所需：
- 用途 / 何时用 / 何时不用——这是对的节点吗？
- 如何运行——运行时到底做了什么，逐步说明。
- 设置——每个字段，含类型、范围、默认值和作用。
- 端口——每个出口以及什么路由到那里。
- 示例——一个基础的和一个实际的。
- 最佳实践、性能、内存——在规模下如何用好。
- 常见错误 / 故障排查 / FAQ——出什么问题、为什么。
每个节点共有的端口
多数节点暴露这些端口的一个子集。含义处处一致：
| 端口 | 走它的时机 | 备注 |
|---|---|---|
Success | 节点完成了它的活 | 多数节点必接 |
Failure | 可恢复的问题，或检测"未找到" | 请接上 |
Timeout | 操作未按时完成 | 仅操作节点 |
Cancelled | 运行在节点中途被停 | 永不被走——运行终止 |
Fatal | 设备断连，或配置无效 | 永不被走——运行终止 |
Cancelled 与 Fatal 不创造恢复路径
运行时在节点报告 cancelled 或 fatal 的那一刻就终止运行。这些端口在画布上存在，但从它们出发的连线在正常运行中不被走。想恢复的一切都必须到达 Failure。
Status 不是 route
对检测节点，节点的 status 与它离开的端口刻意不同。未找到模板的 Find Image 报告 status success——搜索正常运行——同时路由到 Failure。
实际效果是：一次"未找到"永不触发重试、永不计入连续失败护栏。完整解释见执行模型。
端口取决于设置的节点
四种节点从自身配置计算端口集，而非固定集合：
| 节点 | 端口 |
|---|---|
| If — Multiple Branches 模式 | case1…caseN，外加 default |
| If — Text-match 模式 | match、noMatch |
| Find Image — Branch by template | 每个模板一个端口，外加 notFound |
| Branch | branch1…branchN |
调低数量会移除尾部端口，编辑器则剪掉孤儿连线。