feat: 完善循环节点配置与作用域输出

- 支持次数与数组独立或组合配置并补齐检查规则

- 统一循环体临时变量与下游正式输出候选

- 稳定知识库对象数组字段并补充前后端测试

easyflow-ui-admin/packages/tinyflow-ui/src/components/utils/useRefOptions.svelte.ts

@@ -3,6 +3,11 @@ import type { Parameter } from '#types';
 import { getCurrentNodeId, getOptions } from '#components/utils/NodeUtils';
 import { getStartNodeParameterLabel } from '#components/utils/startNodeParameterLabel';
 import { nodeIcons } from '../../consts';
+import {
+  buildLoopReferenceParameters,
+  buildLoopScopeParameters,
+  isArrayDataType,
+} from '../../utils/loopScope';
 
 const fillRefNodeIds = (
   refNodeIds: string[],
@@ -27,7 +32,10 @@ const getChildren = (
 ) => {
   if (!params || params.length === 0) return [];
   return params.map((param: any) => {
-    const isCollection = param.dataType === 'Array' && param.children && param.children.length > 0;
+    const isCollection =
+      isArrayDataType(param.dataType) &&
+      param.children &&
+      param.children.length > 0;
     const childBaseLabel = param.formLabel || param.displayName || param.name;
     const normalizedChildLabel = String(childBaseLabel || '').trim();
     const pathLabel = !parentPathLabel
@@ -64,6 +72,7 @@ const nodeToOptions = (
   node: Node,
   nodeIsChildren: boolean,
   currentNode: Node,
+  nodes: Node[],
 ) => {
   const options = getOptions();
   const nodeType = node.type || '';
@@ -105,29 +114,27 @@ const nodeToOptions = (
       nodeType: nodeType,
       children,
     };
-  } else if (nodeType === 'loopNode' && currentNode.parentId) {
+  } else if (nodeType === 'loopNode') {
+    const referenceParameters = buildLoopReferenceParameters(
+      node,
+      currentNode,
+      nodes,
+    );
+    if (!referenceParameters.length) {
+      return undefined;
+    }
     return {
       label: title,
       icon: icon,
       value: node.id,
       selectable: false,
       nodeType: nodeType,
-      children: [
-        {
-          label: 'loopItem',
-          dataType: 'Any',
-          value: node.id + '.loopItem',
-          selectable: true,
-          nodeType: nodeType,
-        },
-        {
-          label: 'index',
-          dataType: 'Number',
-          value: node.id + '.index',
-          selectable: true,
-          nodeType: nodeType,
-        },
-      ],
+      children: getChildren(
+        referenceParameters,
+        node.id,
+        false,
+        nodeType,
+      ),
     };
   } else {
     const outputDefs = node.data.outputDefs;
@@ -168,7 +175,12 @@ export const useRefOptions: any = (
       for (const node of nodes) {
         const nodeIsChildren = node.parentId === currentNode.current.id;
         if (nodeIsChildren) {
-          const nodeOptions = nodeToOptions(node, nodeIsChildren, cNode);
+          const nodeOptions = nodeToOptions(
+            node,
+            nodeIsChildren,
+            cNode,
+            nodes,
+          );
           nodeOptions && resultOptions.push(nodeOptions);
         }
       }
@@ -177,9 +189,17 @@ export const useRefOptions: any = (
       fillRefNodeIds(refNodeIds, currentNodeId, edges);
 
       for (const node of nodes) {
-        if (refNodeIds.includes(node.id)) {
+        const isScopedLoop =
+          node.type === 'loopNode' &&
+          buildLoopScopeParameters(node, cNode, nodes).length > 0;
+        if (refNodeIds.includes(node.id) || isScopedLoop) {
           const nodeIsChildren = node.parentId === currentNode.current.id;
-          const nodeOptions = nodeToOptions(node, nodeIsChildren, cNode);
+          const nodeOptions = nodeToOptions(
+            node,
+            nodeIsChildren,
+            cNode,
+            nodes,
+          );
           nodeOptions && resultOptions.push(nodeOptions);
         }
       }