Modly如何处理多节点扩展复合节点ID设计全解析【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modlyModly 是一款可在本地 GPU 上运行的 3D 模型生成桌面应用支持从图片或文字提示词生成 3D 模型。它的可视化工作流系统允许用户安装各种扩展Extension而一个扩展往往包含多个节点。为了让这些节点在画布上互不冲突地被识别、执行和展示Modly 采用了一套简洁的复合节点 IDextension_id/node_id设计。本文带你轻松看懂这套机制的来龙去脉。先搞懂一个扩展可以包含多个节点Modly 的每个扩展都带有一份manifest.json清单文件其中的nodes数组声明了该扩展向工作流提供的所有节点。以内置的网格平滑扩展为例它声明了一个smooth节点扩展 IDmesh-smoother节点 IDsmooth输入 / 输出mesh → mesh参数迭代次数、平滑强度、模式Taubin / Laplacian清单定义见 src/areas/workflows/nodes/mesh-smoother/manifest.json。也就是说扩展是安装包节点才是工作流画布上真正被拖拽和连线的基本单位。一个扩展装进去后可能同时带来好几个节点。核心设计扩展ID/节点ID复合标识如果只用节点 ID比如smooth不同扩展里同名的节点就会打架。Modly 的解法是在构建扩展列表时把两者拼成一个斜杠分隔的复合 IDmesh-smoother / smooth ├─ 扩展 IDextensionId └─ 节点 IDnodeId这一拼接逻辑位于 src/areas/workflows/mockExtensions.ts 的buildAllWorkflowExtensions函数中它遍历所有流程类和模型类扩展的nodes为每个节点生成一条WorkflowExtension记录。每条记录同时保留三层信息字段含义示例id复合 ID画布节点用它做唯一键mesh-smoother/smoothextensionId父扩展 ID用于 IPC 调用mesh-smoothernodeId节点在扩展内的 IDsmooth接口定义见 src/areas/workflows/mockExtensions.ts。这样设计的好处很直接复合 ID 保证全局唯一拆开后又能分别拿到该调哪个扩展和该调哪个节点一份数据满足所有场景。运行时如何拆解复合 ID 并执行当工作流运行到某个扩展节点时执行器会把复合 ID 按斜杠拆开前半部分定位扩展进程后半部分告诉扩展执行哪个节点parts[0]→extId扩展 IDparts[1]→nid节点 ID作为nodeId传给扩展这个拆解与调用的关键逻辑在 src/areas/workflows/workflowRunStore.ts 中最终通过window.electron.extensions.runProcess把扩展 ID、节点 ID、输入文件和参数一起交给扩展执行。整个过程中节点的实际标识React Flow 画布上的node.id与扩展的复合 ID 是相互独立的——画布 ID 只负责布局与连线复合 ID 才负责我是谁、我该跑什么。画布上如何呈现按扩展分组展示在节点面板里内置节点平铺展示而第三方扩展则按父扩展 ID 分组折叠同属一个扩展的多个节点被收纳在同一组下方便查找与拖拽。分组逻辑见 src/areas/workflows/WorkflowsPage.tsx。节点被拖入画布后会以extensionId字段保存它引用的复合 ID再由 src/areas/workflows/nodes/ExtensionNode.tsx 反查对应的扩展定义渲染出输入/输出端口、参数表单和执行状态。多输入扩展还支持按端口索引input-0、input-1区分不同类型的数据线。小结三层 ID 各司其职Modly 的多节点扩展体系可以用一句话概括扩展 ID 负责定位安装包节点 ID 负责定位具体功能复合 ID 负责全局唯一寻址。声明层manifest.json的nodes数组定义扩展包含哪些节点构建层buildAllWorkflowExtensions拼出扩展ID/节点ID复合标识执行层workflowRunStore拆解复合 ID把扩展 ID 和节点 ID 分别传给扩展进程展示层节点面板按扩展分组ExtensionNode按复合 ID 反查定义并渲染这套设计简单却非常实用也是 Modly 工作流系统能够稳定运行多扩展、多节点协作的关键。想深入了解可从 src/areas/workflows/ 目录下的源码入手。【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考