节点参考¶

节点参考用于回答具体问题：某个节点何时执行、每个端口传递什么、属性如何影响结果，以及失败时会发生什么。学习完整工作流时请阅读教程；理解画布和连线时请先阅读蓝图编辑器。

当前覆盖范围¶

当前节点完整目录按 1.0.4+7 所用源码导出 228 项，包含 199 项可创建定义和 29 项内部节点。机器可读 JSON提供默认端口、配置及搜索预设。内部节点、施工中定义和具备依赖要求的节点也会出现在源码目录中；目录不是全部功能的运行验收清单。

普通节点的详细说明包括多状态 UI 识别、截图、获取文件列表、窗口尺寸至、变量转字符串和目标描述数组筛选。

自动化流程可使用结束蓝图、结束自动化与跳转控制后续步骤；通用游戏组件、二维游戏寻路和小地图寻路分别说明实际目标与组件要求。模型/3D、PDF及自有安卓14等仍按客户端的施工中标记处理，不因目录有定义就视为已开放。

按分类查询¶

需要自定义脚本时，阅读自定义 Python 与 gpy。具体类型、动态端口和当前模式仍按客户端实际配置确定。

如何阅读节点页面¶

每个完整节点参考页采用同一顺序：

1. 用途：节点解决什么问题，以及何时不该使用。
2. 添加路径：在 Shift+A 菜单中的分类与名称。
3. 执行行为：节点何时读取输入、何时产生输出、失败后是否继续。
4. 输入端口：名称、类型、是否必填和默认值。
5. 输出端口：名称、类型以及值在何时有效。
6. 属性：属性面板中的选项、单位和有效范围。
7. 最小示例：能够独立说明节点行为的最短连接。
8. 常见错误：症状、原因和修正方法。
9. 相关节点：可以替代、组合或容易混淆的节点。

施工中节点页只保留用途、主要端口、开发状态和限制，减少对尚未稳定行为的无效描述。

端口和默认值¶

• 执行端口控制先后顺序，数据端口只传递值。
• 端口颜色帮助识别类型，但不能替代节点页面中的类型说明。
• 未连接端口可能使用节点属性中的默认值，也可能被视为空输入；具体以节点页面为准。
• 支持整数的浮点输入会把整数作为可表示的数值使用，不代表所有类型都会自动转换。
• 通用类型端口在连接后可能显示实际类型，断开后恢复通用状态。
• 动态端口节点会通过加号增加端口，或在已有端口被占用后自动补充新的输入行。

执行节点的共同规则¶

• 开始节点是蓝图唯一入口，不能复制出第二个入口。
• 执行线走到头没有再连接任何节点，这条线就自然完成，不需要专门接结束节点。
• “结束蓝图”可以有多个，先到达的节点结束当前蓝图并写入具名共享变量；“结束自动化”则停止后续蓝图。需要跳到指定蓝图时使用“结束并跳转”。
• 结束优先于仍在等待的循环或其他路线。
• 需要蓝图持续待命（监听、Helper 等）时，把执行线接到保持运行；显式终止才用结束节点。
• 合并类门禁只允许一条符合条件的路线继续，后续到达的路线在本次执行中被阻止。
• 顺序节点按固定顺序触发多个执行输出。
• 整数切换根据输入整数选择对应路线；没有匹配项时走默认路线。

找不到某个节点时¶

1. 确认搜索词是软件中显示的节点名称，而不是某个属性名。
2. 清空搜索，按分类浏览。
3. 检查节点是否属于“施工中”。
4. 确认你位于节点画布，而不是宏时间线或文本输入状态。
5. 如果蓝图包含一个不能从菜单创建的节点，它可能由宏、节点组或导入数据维护，不应手动重建。