Skip to content

FlowEngineLib ​

Engine/FlowEngineLib/ 是节点图执行内核,不是完整的宿主工作流系统。模板持久化、版本和搜索位于 ColorVision.Engine/Templates/Flow/;编辑器、交互式/无界面执行、前后处理和诊断位于 ColorVision.Engine/FlowProcessing/,项目结果处理仍在 Projects/*。

先查什么 ​

现象第一检查点
Base64 流程加载后没有节点Base64 是否为空、NodeEditor.LoadCanvas(rawData)、节点类型是否可用
重复打开同一流程没有变化loadedCanvas 的 MD5 缓存是否直接命中
开始按钮点了但没跑GetStartNodeName()、startNodeNames、IsExecutionReady、CanAcceptStart
服务节点没有设备FlowNodeManager.UpdateDevice、MQTTServiceInfo、节点 NodeType
节点执行但流程不结束是否连接 CVEndNode,是否走到 CVStartCFC.FireFinished()
最后一个节点结束后固定多等一段时间“设置 → 其他 → 流程后处理时间(毫秒)”及最后节点到完成事件的间隔
Finished 重复触发clear() 是否解绑旧 BaseStartNode.Finished
项目包收不到结果FlowEngineControl.Finished 到宿主 FlowCompleted 的桥接
UI 选择和节点参数不一致属性元数据、FlowPropertyEditorRegistry 与选择器绑定;专用补充面板再查 NodeConfiguration/

控制面 ​

对象负责
FlowEngineControl通过图宿主加载画布,管理开始节点和服务节点,抛出引擎级 Finished
CVFlowContainer多开始节点、按 key 追加/加载/启动流程
FlowNodeManager / FlowServiceManager设备视图、服务节点同步和 MQTT service 绑定
FlowEngineAPI启动、停止、开始节点查询的外部接口
FlowRuntimeHost / FlowEngineRunner为无界面执行持有隔离节点图、服务快照和明确的加载/运行/停止生命周期

FlowEngineControl.NodeAdded 会把节点分成两类:BaseStartNode 进入 startNodeNames 并订阅完成事件;CVBaseServerNode 进入服务节点集合并同步到设备视图。

FlowEngineAPI 定义 LoadFromFile / LoadFromBase64、StartNode 和 StopNode,具体的 FlowEngineControl 另提供 TryStartNode。TryStartNode(name, serialNumber) 检查当前未运行、开始节点存在、IsExecutionReady 和 CanAcceptStart。拒绝时返回 false,接受时返回 true。开始端口分发抛错时,结束已登记的动作并清理资源,保留原始异常供调用方处理。StartNode 返回 void。

流程执行编号会被旧服务用于结果文件名,开始入口通过 Tool.SanitizeFileName 将 Windows 非法文件名字符(含 ?、路径分隔符和控制字符)替换为 _,去除尾部点/空格,空名与保留设备名使用安全占位/前缀。合法编号保持不变;等待完成、回调、运行状态、查找开始动作和停止均使用相同规范化编号,FlowHeadlessExecutionRequest.SerialNumber 也保存实际执行编号。拥有业务批次的调用方须在创建批次和诊断记录前生成此编号,不能只在某个算法请求发送时替换,否则会割裂批次、消息和完成事件的关联。客户产品 SN 是独立业务字段,保留原值用于显示、追溯和协议回传;用它生成文件名时单独格式化,不改写文件内容或历史批次。

BaseStartNode.RequiresConnectionReady 默认是 false,因此不能统一要求所有本地开始节点的 Ready 为真;要求连接的开始节点才通过 Ready 门禁。CanAcceptStart 还要求开始输出已连线。服务节点的 getActionEvent / getBaseEvent 构造请求,再由 DoTransferToServer 转交发送链。扩展方式见节点扩展契约。

BaseStartNode 实现 IDisposable;脱离 FlowEngineControl 构造开始节点的读取器也必须在读取后释放节点。

核心节点 ​

节点/基类重点
CVCommonNode节点名、类型、设备码、端口事件、颜色注册
BaseStartNode创建开始输出,维护 Ready/Running,分发 CVStartCFC
CVBaseServerNode模板、图片、Token、超时、请求参数和服务端响应
CVEndNodeTryDoFinishing() 接受首次终止后调用 FireFinished(),重复到达不会再次结束
AlgorithmNode / AlgorithmARVRNode把模板、图像、颜色、POI、SMU 数据打包成算法请求

FlowEndDelayMilliseconds 是运行级配置。执行已满 500 ms、仍在运行且未收到停止请求时,CVEndNode 在发布完成事件前另等配置的 1–1000 ms。配置为 0 时直接进入完成检查。分析流程节拍时可分别比较最后节点结束到完成事件、完成事件到下一轮启动的间隔。修改现场配置后,用实际流程核对结果完整性和外部联动时序。

大部分节点构建并转发执行参数,由服务完成算法。LightingSensorNode 复用现有 LightingControl 服务,支持 A/B 通道开关和查询,不另建连接或本地后端。

AlgorithmEQENode 请求中的 SMUData 携带电气分支的结果 ID 和类型,同时保留旧 SMU_MasterId 字段兼容既有算法服务。SpectrumEQENode 的服务路径按紧邻前步结果构造关联;本地路径保留实际 SMU 量测关联、V/mA 单位和缺失输入校验,不能套用服务的零值占位。源码见 Engine/FlowEngineLib/CalcEQEParam.cs、AlgorithmEQENode.cs 和 Node/Spectrum/SpectrumEQENode.cs。

节点类型加载 ​

画布保存类型 GUID 和 程序集文件名|类型名称。加载先匹配 GUID 和原模型标识,再尝试同程序集的短类型名;仍找不到时,先按已加载类型的完整名称、再按短名称跨程序集查找。名称必须唯一,重名时拒绝猜测。编辑器、运行容器和中立流程编译器共用 STNodeTypeRegistry 的名称回退,不需要逐节点映射表,也不改写输入文件。正常保存使用当前类型 GUID,以及 STNodeSerializationModelAttribute 声明的兼容模型标识;未声明时使用当前程序集和完整类型名。节点实例 ID、属性和连线沿用原内容。

确实找不到类型时,编辑器和运行容器创建 STMissingNode,显示“缺失”标题及原始参数的只读内容。它不注册为可新建的业务结点,不执行原结点的构造、属性处理或算法,不接收或转发运行数据。只对类型缺失降级;已知类型的构造或参数恢复异常、损坏文件仍报错,并保留当前画布。交互式运行、引擎启动入口和开始结点本身均拒绝启动含占位的流程,提示恢复组件或删除、替换;中立执行编译继续以 UnknownNodeType 拒绝缺失类型。版本和搜索投影允许读取占位,保持原类型标识而不将其改写为占位类。

STND v1 的结点属性新增 __STNode.PortLayout,保存标题、输入/输出的顺序、名称、类型名及单连接/空端口标记;旧读取器忽略该扩展,不改变文件版本。占位再次保存使用原模型标识、类型 GUID、实例 ID 和原始属性字节,移动及复制只更新相应布局或实例 ID;组件恢复后重新打开即可按原类型加载。中立编译前需对已恢复类型的旧占位重新保存,使端口索引按实际结点重建。保存和复制入口共用此记录,未知的二进制业务参数不会被当作文本重新编码。

早期 STND v1 没有每结点的端口定义,全局端口编号无法唯一反推出缺失类型的端口数量。遇到这种缺失结点时整组旧连线暂不绘制,原始编号与原结点顺序封存在 __STNode.LegacyConnections,不会猜接其他结点。恢复全部所需组件并重新打开后可恢复旧连线;手动删除或替换占位后需自行确认并重新连线。占位存在期间仍可保存原始结点数据与封存连线。这是旧数据的信息缺口,不表示算法能被自动替代。

持久化实现位于 Engine/ST.Library.UI/NodeEditor/STNodeSavedState.cs、STMissingNode.cs 和 STNodeCanvasReader.cs。第三方插件或设备按实际交付组合验收。

普通 BV/LV 节点在 ColorVision.Engine 中实现,保留 FlowEngineLib.LVCameraNode 完整类型名,并声明稳定保存标识 FlowEngineLib.dll|FlowEngineLib.LVCameraNode。新宿主直接调用 Engine 的本地取图实现,未选中本地路径时沿用原服务请求。旧端继续加载自己的旧版 FlowEngineLib:GUID 不同时仍可按这个完整模型标识找到旧类,按原参数构造服务请求。只保留 namespace 而保存 Engine DLL 名不足以兼容这种旧加载器,也不应固定某一版本自动生成的 GUID。

曾保存为 Engine 模型标识的画布可在新宿主中按名称回退加载,再保存或通过数据库工具“更新流程节点”写回旧端可识别的模型;旧端自身不具备跨 DLL 名称回退。这里兼容的是流程数据,并不提供 CLR 类型转发:旧端保持整套旧 DLL 不变;跟随新宿主升级且直接引用迁出节点的项目包需引用 Engine 并重新编译。需要 Engine 属性编辑器的相机、校准、POI、SMU、传感器和算法节点位于 FlowProcessing/Nodes/Compatibility/,保留原 namespace;普通参数节点和公共执行基类仍在 FlowEngineLib。属性编辑器元数据直接引用 Engine 实现,不属于旧流程保存契约。

跨版本验收应将新节点实际保存的画布交给目标旧 DLL 的 FlowEngineControl.LoadFromBase64,核对旧类身份、参数、连线和请求字段。此步骤只加载和构造数据,真实流程或采集另行验收。

上游 DLL 更新核对 ​

上游通常只交付 FlowEngineLib.dll 等编译产物,不同步提供源码或完整变更说明。因此升级前需要反编译新旧 DLL,才能确认对方实际修改了什么。Engine 中 FlowProcessing/Nodes/Compatibility/ 下的节点是本地维护的实现,替换上游 DLL 不会自动同步这些代码;不能仅凭同名类型、版本号或参数数量判断兼容。

  1. 分别保留上次接收与本次接收的原 DLL,在隔离目录中记录文件版本、程序集身份和 SHA-256;关联的 ST.Library.UI.dll 或协议依赖有变化时一并核对。不要直接覆盖正在使用的 DLL。
  2. 用 ILSpy 等工具反编译,比较对应节点、基类、请求数据类型及加载/保存入口。重点检查完整类型名、保存标识和 GUID 匹配规则、持久化属性名/类型/默认值、端口及连接顺序,以及服务主题、操作码、请求字段和响应处理。
  3. 将确认需要的上游改动同步到 Engine 中的对应节点,保留本地取图路由、结果交接与稳定保存标识;区分上游服务行为变更和本地扩展,不把反编译文件整体覆盖进现有实现。记录已核对的 DLL 版本/哈希及同步范围,未能确认的差异列为验证缺口。
  4. 用合成流程检查新旧两端加载、保存往返、参数、连线及构造的服务请求,再运行相关迁移、相机路由和属性编辑器测试。反编译和离线验证不启动流程、不连接设备或数据库;真实服务/相机验收另按任务授权进行。

弃用节点兼容 ​

标记 Obsolete 的节点类型会从 STNodeTreeView 的新建/右键目录和 Copilot 节点目录中排除,但仍由节点类型注册表保留,因此旧画布可以继续反序列化。例如旧 MQTT、V5 开始/结束、合规验证、ROI、第三方算法、校正和图像拼接节点都走这条兼容路径;完成存量流程迁移前不要删除这些类型。

旧合规流程依赖以下类型和请求标识;排查画布加载或服务请求时按表定位:

节点类型请求 operatorCode保留的参数契约
AlgComplianceMathNodeCompliance_MathTempName、ComplianceMath、IsBreak;新实例默认 CIE、IsBreak = false,请求使用 ComplianceMathParam.ComplianceType 和模板/前步参数
AlgComplianceContrastNodeCompliance_ContrastOperation、TempName;ComplianceContrastParam 带运算整数值及两路输入的 PreFlowRecorderId
AlgComplianceJudgmentNodeCompliance.JudgmentIsBreak 默认 true,与前步参数一起构造 ComplianceJudgmentParam

ComplianceMathType 的序列化值为 CIE = 1、JND = 2、CIE_BUZ = 3。这些名字、类型和数值属于存量画布/请求兼容边界,迁移前须核对实际保存的节点、模板和算法服务。保留类型支持旧图加载,不表示当前客户端提供对应模板编辑器,也不保证所连接服务仍实现旧算法。

完成链路 ​

“节点完成”不等于“流程图完成”。正常结束路径由 End 节点闭合上述 Finished 链;取消、超时和启动拒绝需读取所属运行器的终止状态。宿主可将此事件桥接为 FlowControl.FlowCompleted / EngineExecutionCompleted,但不会因此自动完成客户业务。

Finished 携带 FlowEngineEventArgs,字段包括 StartNodeName、SerialNumber、Status、TotalTime、Message 与错误节点信息;调用方按 Status 判断执行结果,按 StartNodeName 识别开始节点。

节点完成通知尚未发布时,流程完成通知可延后。CVStartCFC 副本共享延后计数,通知采用实际结束流程的副本。开始节点向各订阅者分别传递同一终态,记录单个订阅者的异常后继续通知引擎和其余订阅者。

流程结束时,BaseStartNode.DoFinishing 沿开始端口传递终态,供沿途节点释放运行记录;宿主后处理属于后续阶段。单次停止取消 StopToken 并释放运行资源,已停止的分支无法再次完成流程。资源释放失败时继续尝试其余资源,将异常写入日志,并发布已确定的终态。CVBaseServerNode 收到 Completed 时只清理并转发状态。IgnoreErrors 用于上游出错后的收尾,保留本节点自身的失败状态。

“逻辑与”“组合”及多输入服务和本地节点只汇合同一次运行的分支。重复框内还要求轮次一致。同 SN 重新测量时,旧分支的结果和停止信号不会参与或清空新运行的待汇合输入。

共享会话的 RunFinalized、后处理失败策略及项目兼容链见执行会话;隔离运行的状态映射见无界面执行。它们不是 FlowEngineLib 内核自动附带的业务阶段。

宿主边界 ​

FlowEngineLib 只知道节点图和引擎执行状态,不拥有模板数据库、WPF 文档选择或业务批次。服务快照与节点必须在所属图代际内使用,不能让隔离 RuntimeHost 复用编辑器的可变节点。

模板下拉和属性配置归工作区,流程保存和 .cvflow 归模板持久化,完整跨模块所有权见Flow 架构。不要在内核补项目判定、导出或宿主 UI 行为。

检查 ​

验收项通过标准
构建和依赖FlowEngineLib.csproj、ST.Library.UI、MQTT/JSON 依赖能加载
画布加载桌面画布复用相同内容。无界面宿主重载时按当前服务快照重新建立节点连接
节点发现开始节点进入 startNodeNames,服务节点进入服务集合
服务绑定外部 MQTTServiceInfo 能绑定到服务节点
启动链输入 SN 后能从正确开始节点启动,运行状态正确
参数链模板、图像、颜色、POI、SMU 能进入请求数据
完成链结束时能抛出 SN、状态、耗时、消息和错误节点
清理停止或重新加载后不叠加旧事件
宿主桥接ViewFlow/FlowExecutionSession 能接到模板、服务、运行按钮和最终化结果

不要这样理解 ​

  • FlowEngineLib 不是完整 DSL 平台;它是节点执行内核。
  • 不要把项目判定写进节点内核。
  • 不要把服务绑定问题误判成节点执行问题,先看服务快照与 PropertyGrid 契约;也不要忽略会影响重复加载的 loadedCanvas 缓存。

验证入口与缺口 ​

交付兼容需使用对应存量流程和目标服务验证。项目判定及业务终态应沿宿主后处理和 RunFinalized 链核对。

基于 MIT License 发布。