集合操作 (Set)

📖 节点概述

对多个列表进行集合运算，支持交集、并集、差集和对称差。每个列表会被视为一个集合（自动去除重复元素），运算结果返回去重后的列表。支持动态增减输入端口（右键菜单），至少 2 个列表。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 数据去重聚合：对多个来源的列表取并集，得到全部不重复的元素。
• 共同筛选：取多个列表的交集，找出同时满足多个条件的元素（如拥有所有权限的用户）。
• 差异分析：取差集，找出在一个列表中但不在其他列表中的元素（如新增、删除的条目）。
• 唯一性校验：对称差可用于找出只在一个列表中出现（不同时在多个列表）的元素。
• 标签系统：多个标签集合的并、交、差运算，实现复杂的标签筛选逻辑。

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

节点通过动态端口接收至少 2 个列表，选择操作模式后输出结果列表。

场景案例：求两个列表的交集（公共元素）

1. 准备列表：
   • 列表 A：["apple", "banana", "cherry"]
   • 列表 B：["banana", "cherry", "date"]
2. 连接节点：确保有 2 个输入端口，分别连接列表 A 和列表 B。
3. 操作模式：选择 交集。
4. 获取结果：结果列表 输出 ["banana", "cherry"]（顺序可能与输入不同）。

并集示例：

• 列表 A：[1,2,3]，列表 B：[3,4,5]
• 模式：并集 → 结果：[1,2,3,4,5]

差集示例：

• 列表 A：[1,2,3,4]，列表 B：[3,4,5]
• 模式：差集 → 结果：[1,2]（从首个列表中移除后续所有列表元素的并集）

对称差示例：

• 列表 A：[1,2,3]，列表 B：[3,4,5]
• 模式：对称差 → 结果：[1,2,4,5]（只在一个集合中出现的元素）

多个列表：

• 列表 1：[1,2,3]，列表 2：[2,3,4]，列表 3：[3,4,5]
• 模式：交集 → 结果：[3]（所有列表共有）
• 模式：并集 → 结果：[1,2,3,4,5]
• 模式：差集 → 结果：[1]（列表1 减去 列表2∪列表3）
• 模式：对称差 → 依次对 列表1、列表2、列表3 进行对称差：((1,2,3) Δ (2,3,4)) = (1,4)，再 Δ (3,4,5) = (1,3,5)

⚙️ 引脚与参数说明

📥 输入引脚（动态）

⚙️ 控件参数

📤 输出引脚

🔧 集合运算逻辑说明

• 交集：所有集合的共同部分。运算顺序不影响结果。
• 并集：所有集合的合并，去掉重复。运算顺序不影响结果。
• 差集：首个集合减去后续所有集合的并集。即：首个集合 - (第二个集合 ∪ 第三个集合 ∪ ...)。
• 对称差：对多个集合依次求对称差。对称差定义为 (A ∪ B) - (A ∩ B)，具有结合性。例如三个集合：((A Δ B) Δ C)。

⚠️ 注意事项

• 元素去重：每个输入列表中的重复元素在集合运算中只被考虑一次，输出结果也自动去重。
• 元素类型要求：列表元素必须是可哈希的（如数字、字符串、元组），不能是嵌套的列表或字典。如果包含不可哈希类型，节点会处理异常并返回空列表。
• 动态端口管理：右键单击节点可增加输入端口，至少 2 个。未连线的端口会被自动忽略。
• 输出顺序不定：集合本身是无序的，因此输出结果的元素顺序不确定。如需固定顺序，可在节点后连接【列表排序】。
• 空列表处理：任何空列表视为空集合。交集运算中若有一个空集合，结果为空；并集忽略空集合；差集若首个列表为空，结果为空。
• 性能：集合运算时间复杂度 O(n) 到 O(n*m) 取决于元素数量和集合个数。

💎 小贴士：

• 交集常用于筛选同时满足多个条件的数据。
• 差集可以用来找出新增的数据（新列表减去旧列表）或已删除的数据（旧列表减去新列表）。
• 并集常用于汇总所有唯一项，配合【列表长度】可得到唯一项总数。
• 对称差可以找出在不同列表间出现奇数次的数据，用于检测变化。
• 由于是纯数据节点，无需执行信号，可在数据流中随时使用。