列表追加

📖 节点概述

将一个新元素添加到列表的末尾。输入列表可以是列表对象、JSON 数组字符串或多行文本（每行一个元素）。新元素可以是任意类型（字符串、数字、布尔、列表等）。原列表保持不变，返回追加元素后的新列表。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 动态构建列表：在循环中逐步向列表末尾添加元素。
• 记录收集：将处理结果逐个追加到结果列表中。
• 队列实现：向队列尾部添加新任务。
• 数据聚合：将多个来源的数据依次追加到总列表。
• 日志累积：将新日志条目追加到日志列表末尾。

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

节点有两个输入端口：原列表 和 新元素，输出端口 新列表。

场景案例：向水果列表末尾追加“橙子”

1. 准备原列表：在“原列表”多行文本框输入：

   apple
   banana
   cherry
   

   或从上游传入列表 ["apple", "banana", "cherry"]。

2. 设置新元素：在“新元素”输入框中填写 "orange"（或连线传入）。

3. 获取结果：新列表 输出 ["apple", "banana", "cherry", "orange"]。

4. 后续使用：将新列表用于展示、存储或继续处理。

追加非字符串元素示例：

• 原列表：[1, 2, 3]
• 新元素：4（整数） → 结果 [1, 2, 3, 4]
• 新元素：[5, 6]（列表） → 结果 [1, 2, 3, [5, 6]]（列表作为整体追加，不展开）

JSON 数组输入示例：

• 原列表文本框：["a", "b"]
• 新元素："c"
• 结果：["a", "b", "c"]

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 行为说明

• 节点首先将原列表解析为 Python 列表（支持列表对象、JSON 数组、多行文本）。
• 然后将新元素追加到列表末尾（使用 append）。
• 返回新列表，原列表保持不变（无副作用）。

⚠️ 注意事项

• 原列表不变：节点返回的是新列表，原输入列表不会被修改。如需覆盖原变量，请配合【变量设置】节点使用。
• 追加列表元素：如果新元素本身是列表，该列表会作为一个整体被追加到原列表末尾，而不是将列表内的元素逐个追加。如需合并列表（展开），请使用【列表合并】节点。
• 多行文本输入：原列表若使用多行文本，每行会被视为字符串元素。新元素可以是字符串，追加后成为新的字符串元素。
• 元素类型保留：新元素的原始类型会被保留（如整数、浮点数、布尔等）。
• 空列表：原列表为空时，追加后得到只包含新元素的列表。
• 性能：追加操作的时间复杂度为 O(1)（摊销），效率高。

💎 小贴士：

• 若需要在循环中动态构建列表，可将本节点放在循环体内，每次将新的处理结果追加到列表末尾。
• 若需要将多个列表合并为一个（展开内层列表），请使用【列表合并】节点。
• 若需要在列表开头插入元素，请使用【列表插入】节点（插入位置 0）。
• 该节点是纯数据节点，无需执行信号，可直接在数据流中使用。
• 结合【变量设置】节点，可以实现类似 list.append() 的原地修改效果。