开发基础设定

端口类型（Port Types）

类型

说明

示例

TEXT

单行文本

"hello"

LONGTEXT

多行文本

JSON / SQL 片段

INT

整数

42

FLOAT

浮点数

3.14

BOOL

布尔开关

True/False

CSV

逗号分隔列表

"a,b,c"

JSON

JSON 对象

{"key": "value"}

EXCEL

Excel 工作表数据

工作表名 + 单元格范围

FILE

本地文件路径

"data/input.csv"

UPLOAD

用户上传的文件

临时路径

SKLEARNMODEL

Scikit-learn 模型

RandomForestClassifier

TORCHMODEL

PyTorch 模型

nn.Module

IMAGE

图像张量/数组

np.ndarray（HWC 格式）

属性类型（Property Types）

类型

说明

示例

TEXT

文本输入框

"name"

LONGTEXT

多行文本输入框

"multiline\ncontent"

INT

整数输入

10

FLOAT

浮点数输入

0.5

BOOL

布尔开关控件

True

CHOICE

下拉选择列表

["A", "B", "C"]

DYNAMICFORM

动态表单（可增删项）

键值对列表

RANGE

数值范围（最小/最大值）

[0, 100]

画布使用指南

基础操作

  • ✅ 创建节点：从左侧组件树拖拽至画布

  • ✅ 连接节点：从输出端口拖拽至目标输入端口

  • ✅ 运行节点：右键点击 → 选择“运行此节点”

  • ✅ 查看日志：右键点击 → 选择“查看节点日志”

  • ✅ 分组节点：选中多个节点 → 右键 → “创建背景框”

高级功能

  • 🔁 循环执行：结合“循环控制器”与“背景框”实现迭代逻辑

  • 📁 文件操作：在属性面板中使用文件选择器上传或加载本地文件

  • 💾 工作流管理：通过左上角按钮保存或加载整个工作流

  • 🧩 节点分组：使用“背景框”组织逻辑模块，提升画布可读性

  • 📦 依赖自动安装：运行失败时，自动根据节点声明的 requirements 安装缺失依赖

快捷键

快捷键

功能

Ctrl+R

运行整个工作流

Ctrl+S

保存工作流

Ctrl+O

加载工作流

Ctrl+A

全选所有节点

Del

删除选中的节点

Shift+左键

选中多个节点

Ctrl+左键

取消选中多个节点

Alt+Shift+左键拖拽

删除连线内的节点连线

节点状态颜色标识

状态

边框颜色

空闲

灰色

运行中

蓝色

成功

绿色

失败

红色

连接线状态颜色标识

状态

线条颜色

空闲

黄色

输入端运行中

蓝色

输出端运行中

绿色

日志系统

  • 基于 Loguru_ 实现结构化、彩色日志输出

  • 每个节点拥有独立的日志缓冲区

  • 节点内使用 self.logger.info("...") 可捕获自定义日志信息

  • 所有 print() 输出将被自动捕获并显示在日志面板中

  • 日志按节点持久化存储，可在 UI 中随时查看

数据流规则

  • 输入端口自动从上游节点的输出端口填充数据

  • 输出数据按端口名称存储（字典键值形式）

  • 支持多输入、多输出端口，多输入需要在组件开发中进行配置，默认单输入，多输入自动按照端口连接顺序进行列表聚合

  • 不允许形成循环依赖（系统自动检测并阻止）