变量获取 (Getter)

📖 节点概述

被动数据读取器，本身不能串联在执行流中，而是作为“数据源”被其他节点的输入引脚连线拉取。只要在下拉框中选择一个已存在的变量，该节点的 当前值 引脚就会实时输出该变量此刻的最新值。相当于编程中的 读取变量 操作。

💡 使用场景：

• 为其他节点提供动态数据：将变量值传入数学运算、条件判断、字符串拼接等任何需要数据引脚的节点。
• 流程状态监控：将当前循环次数、用户登录状态等变量值拉取到调试节点，实时显示在控制台。
• 多节点共享同一变量：避免重复连线，所有需要该变量值的节点都从同一个 Getter 引脚拉取。
• 变量值中转：作为桥梁，把变量值传给不接受直接变量引用的节点。

🎮 实战连线指南：如何正确使用它？

变量获取 节点没有 Exec 输入输出端口，不能出现在执行链路上。它就像一个“无线传感器”，放在画布上，其他节点需要该变量值时，直接将其输出 当前值 连线到目标节点的输入引脚即可。

场景案例：将用户登录状态传给条件分支，动态决定后续流程

1. 创建状态变量：先用【变量设置】节点创建一个布尔型变量，名称为 IsLoggedIn，初始值为 false。
2. 放置 Getter：在画布空白处拖入【变量获取】节点，在下拉框中选择 IsLoggedIn。
3. 连线数据：将【变量获取】节点的 当前值 引脚直接连接到【条件分支】节点的 条件 引脚。
4. 执行流无关：【条件分支】的执行入口仍由上一步动作（如“点击登录按钮”）的 Exec 输出提供，Getter 不参与执行流的串联。

实时刷新：只要变量值在流程中的任何地方被修改，Getter 输出的值会立刻同步更新，下游节点会在需要时拉取到最新数据。

⚙️ 引脚与参数说明

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 无 Exec 端口：该节点不能串联在执行流中，只能通过数据连线被其他节点引用。
• 变量不存在时：返回 None，不会报错，下游节点可通过【判断是否为None】等节点做防御。
• 与【变量设置】配对：通常一个 Setter 创建并赋值，一个或多个 Getter 读取，实现数据的生产与消费分离。
• 性能提示：Getter 本身几乎不消耗资源，可以放心在画布上放置多个，从不同位置读取同一个变量。