模型消费
数据集、标注、训练、验证和导出属于独立产品 Darra AI Studio。PLC 视觉运行时只消费已交付的 inference-only 工件,并在运行版本激活前完成会话准备。
本页不讲解训练、蒸馏、标注或模型加密。那些工作在 AI Studio 完成。
产品分工
| 环节 | 产品 | 当前状态 |
|---|---|---|
| 数据集、标注、训练、评估、导出 | Darra AI Studio | 不在本产品 |
| 在视觉节点中引用已交付工件 | Darra RT IDE 视觉编程 | 可用 |
| 运行版本激活前准备 inference-only 会话 | 现场 Windows 服务 | 可用 |
| 扫描周期外推理,扫描边界提交标量摘要 | 现场 Windows 服务 | 可用 |
| 现场训练、微调或改权重 | — | 不可用 |
| 推理时临时创建会话或懒加载模型 | — | 不可用 |
| 隐式下载、切换未准备版本 | — | 不可用 |
当前生产推理路径为 Windows 服务内的 ONNX Runtime CPU。枚举中的 GPU / NPU / DirectML / CUDA / TensorRT / OpenVINO 不能当作已交付现场能力。
引用已交付工件
在拖拽图或视觉 SCL 中放置分类、检测或语义分割节点时,只填写 AI Studio 已交付工件的标识、版本和输入合同。不要把数据集路径、训练超参或标注目录写进节点。
- 在 Darra AI Studio 完成训练或导入,并导出现场推理工件。
- 把该工件交付到目标现场,使其进入项目部署校验能看到的模型集合。
- 在视觉节点中选择标识与版本,核对本节点预处理与工件输入合同一致。
- 保存
.dplc并执行部署校验。校验通过不表示现场会话已经准备完成。 - 现场运行版本激活前,Runtime 必须把该版本用到的会话全部 Prepared。任一会话未准备,推理作业失败。
导入成功、本地预览成功或部署校验通过,都不能代替现场准备。
推理执行条件
模型推理同时满足以下条件才会执行:
- 视觉功能已启用并获得授权。
- 项目部署已通过校验。
- 模型工件已由 AI Studio 交付。
- 输入布局、颜色顺序、尺寸和预处理与工件合同匹配。
- 资源已按项目唯一策略
RuntimeResourcePolicy预留。 - 推理会话已在运行版本激活前准备完成。
任一条件不满足都应明确失败。运行时不会自动下载模型、切换到未准备版本、启动训练,也不会为了继续运行而返回全零“成功”结果。
会话与版本
现场只消费已 Prepared 的 inference-only 会话。
- 每个运行版本绑定一组明确的模型标识与版本,不能只改显示名称。
- 替换模型必须交付新工件、重新校验,并在新运行版本激活前重新准备会话。
- 回滚必须选择已经交付且曾经准备成功的完整候选,不能只改版本号。
- 运行版本切换会取消旧版本未完成调用,防止旧结果写入新项目。
- 推理期不得创建新会话、不得改权重、不得把训练记录当作可执行模型。
项目中即使保存了历史训练或验证记录,也不表示本产品提供训练执行能力。
PLC 看到什么
推理在扫描周期外执行。PLC scan 不会等待模型。
- PLC 只接收项目中声明的有界标量摘要,例如合格标志、数量、坐标。
- 检测框集合、掩码、张量和完整类别表属于富结果,由诊断或上位界面读取。
- 系统不会按
VIS_JOB_*/VIS_RESULT_*命名约定自动创建变量。 OnInferenceCompleted只整理已返回的标量;图像处理和推理仍在流程节点中执行。
当前不要做的事
| 不要在 PLC IDE / Runtime 中寻找 | 应去哪里 |
|---|---|
| 数据集导入、COCO / YOLO 交换、人工标注 | Darra AI Studio |
| 训练、蒸馏、评估、导出 | Darra AI Studio |
| 内置自动推理标注 | 不在本产品;标注在 AI Studio 完成 |
| 现场下载或热切换未准备模型 | 不可用 |
| 实例分割、异常检测运行时算子 | 当前不可用,不能作为交付方案 |
| 把开发电脑单图结果写成现场精度 | 必须在目标设备重新准备并做 HIL |
常见诊断
| 现象 | 处理 |
|---|---|
| 推理节点无法选择模型 | 确认 AI Studio 工件已交付到当前项目,并填写标识与版本 |
| 作业失败且诊断为模型未准备 | 检查运行版本激活前的会话准备;不要指望推理时懒加载 |
| 输出无法解释 | 核对本节点预处理与工件输入合同,而不是改 PLC 变量名 |
| 本地预览有结果、现场没有 | 本地预览不准备现场会话;重新执行部署校验和现场准备 |
| 想在 IDE 里训练 | 打开 Darra AI Studio,不要在视觉编程中寻找训练入口 |
| GPU / TensorRT 按钮不可用 | 当前现场推理路径为 CPU;不能按未交付后端选型 |
| 队列满或资源不足 | 按 RuntimeResourcePolicy 降低并发或输入尺寸,不要绕过准入 |