节点参考¶

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

当前覆盖范围¶

当前开发候选完整目录由真实客户端源码生成，包含每项用途与默认端口；机器可读 JSON另含默认配置和搜索预设。此源码投影不是全部节点的运行验收证明，动态端口以实际配置为准。

自定义 Python 与 gcbppy另有开发候选详细章节，包含脚本端口、类型桥和 worker 生命周期。是否可创建及运行，以当前客户端节点目录、组件和账号权益为准；下面的首版数量不是新版本机器可读能力清单。

本目录首版记录了 137 个可从 Shift+A 菜单添加的节点，其中 38 个节点具备完整参考页，另有 99 个当时位于“施工中”分类。这些数字描述文档首版覆盖范围，不代表当前客户端节点总数或当前稳定性分类。

完整首版文档已经为 137 个可添加节点分别提供可检索的固定页面：

• 非“施工中”节点提供完整参考，包括端口、属性、执行语义、常见错误和示例。
• “施工中”的 99 个节点采用简略说明，记录预期功能、主要输入输出和已知限制，并统一标注“开发中，不保证可用性”。
• 不在添加菜单中出现的内部节点不进入公开节点总索引；只有用户在正常界面中需要理解时，才会在对应功能章节解释。

施工中节点

“施工中”表示节点仍可能缺少执行能力、错误处理、资源适配或稳定性验证。它们可用于了解计划中的功能，但不应承担重要自动化。文档中的简略说明不构成兼容性或可用性承诺。

添加菜单分类¶

新增开发候选的完整契约见多状态 UI 识别、截图、安卓实例与窗口控制、受保护执行域和单选项映射。搜索结果显示“分类 → 原节点名 · 主字段 → 值”；多个主字段独立展开，其他字段保留默认值，不枚举所有组合。

节点原始所属模块可能更细，但参考文档以用户在 Shift+A 菜单中看到的分类为准，避免同一个节点在文档和软件中位置不一致。

上述数量保留首版口径；当前候选的“切换整型”已归入执行类，其类型 ID 和整数分支语义不变。实际分类以当前节点目录为准。

如何阅读节点页面¶

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

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

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

端口和默认值¶

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

执行节点的共同规则¶

• 开始节点是蓝图唯一入口，不能复制出第二个入口。
• 结束节点可以存在多个，执行到任意一个都会终止本次蓝图。
• 结束优先于仍在等待的循环或其他路线。
• 合并类门禁只允许一条符合条件的路线继续，后续到达的路线在本次执行中被阻止。
• 顺序节点按固定顺序触发多个执行输出。
• 整数切换根据输入整数选择对应路线；没有匹配项时走默认路线。

找不到某个节点时¶

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