读取组件数据 · Auto Connect
根据名称列表，在当前 Grasshopper 文档中读取指定组件的输出数据
📖 功能概述
这个组件通过组件名称而不是物理连线来定位数据来源。它会在当前 Grasshopper 文档中查找名称匹配的对象，并把这些对象的输出数据收集出来。
它特别适合自动排版、跨区域引用和减少长连线的场景。
💡 核心价值：即使组件位置发生变化，只要名称保持一致，数据仍然可以被稳定读取。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 名称列表 (N) | 必需 | 需要读取数据的目标组件名称列表。相同名称会合并读取，并整理到同一个输出分支中。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 数据 (D) | 按输入名称顺序输出的数据树。每个分支对应一个名称，并包含匹配组件的全部输出数据。 |
🛠️ 工作流程
1
输入名称列表
→
2
按名称检索组件
→
3
读取输出数据
→
4
按名称分支输出
- 组件会在当前文档中查找名称完全匹配的对象。
- 如果多个组件重名，它们的数据会被合并到同一分支。
- 读取的是组件当前求解后的运行时输出数据。
🧪 典型使用场景
| 场景 | 说明 |
|---|---|
| 自动排版后取数 | 当组件因排版移动后，不必重新拉线，只要名称不变即可继续读取数据。 |
| 跨区域数据访问 | 在画布不同区域通过相同名称引用同一个数据来源。 |
| 名称驱动流程 | 把数据流组织成“按名称引用”的结构，减少画布中的复杂线缆。 |
⚠️ 注意事项
- 名称匹配通常要求完全一致。
- 同名组件会被视为同一来源组并合并数据。
- 该组件负责读取数据，不会自动创建物理连线。
- 为了保持稳定，建议在工作流中统一命名规范。
📌 组件信息
| 名称 | 读取组件数据 |
| 英文名 | Auto Connect |
| 分类 | LK → GUI |
| 基类 | GH_Component |
| GUID | {6E4A3F6B-399A-4A2A-92B4-14DEC3A68908} |