Replace In List 列表元素按值或索引替换节点
Replace In List 节点允许创作者对现有列表中的特定元素执行就地替换操作。它支持两种灵活的定位机制：通过匹配具体的元素值（Item Matching）进行替换，或者直接指定数字索引下标（Index Position）进行替换。
输入引脚规范 (Inputs)
- Items（
list）：待修改的目标母列表。 - Item To Replace（
any）：母列表中待被替换的目标元素值（仅当Replace By设置为"item"时可见）。 - Index To Replace（
int）：待被替换元素的所在索引下标（仅当Replace By设置为"index"时可见）。 - New Item（
any）：用于填补替换进列表的全新元素项。
面板属性 (Properties)
- Replace By（
str）：指定定位待替换元素的策略："item"：按元素值精准匹配替换；"index"：按索引下标位置替换。
输出引脚规范 (Outputs)
- Output（
list）：完成了目标元素替换后的全新修改后列表工件。
使用示例 (Example)
# 原始输入列表 Items: [1, 2, 3, 4]
# 方式一：按元素值匹配替换 (Replace by item)
# Item To Replace: 3
# New Item: "three"
# Output 输出: [1, 2, "three", 4]
# 方式二：按索引下标替换 (Replace by index)
# Index To Replace: 1
# New Item: "two"
# Output 输出: [1, "two", 3, 4]
关键技术特性 (Notes)
- 首处匹配原则：当选用
"item"按值替换模式时，如果列表中存在多个相同元素，节点默认仅替换首次出现的那一项； - 边界安全校验：当选用
"index"按索引替换模式时，指定的下标数值必须处于列表有效下标边界之内； - 元素未找到保底：当按值替换但在列表中未检索到目标项时，节点不会报错，而是安全地原样返回原始列表；
- 不可变防御机制 (Immutability)：操作绝不会直接篡改或污染上游原始列表的内存状态，而是分配并返回一个全新的列表副本。