为你的工程添加Serein.Library项目引用（也可在Negut上下载），使用 DynamicFlow 特性标记你的类，可以参照 Net461DllTest 的实现（该示例工程的设计并不完善，并未做依赖分离，仅做参考）。编译为 Dll文件后，拖入到软件中即可。如果你不想下载整个工程文件，“FLowEdit”目录下放有“FlowEdit可视化流程编辑器.zip”压缩包，可以直接解压使用（但可能需要你安装 .Net8 运行环境）。

如何让我的方法成为节点？

使用 NodeAction 特性标记你的方法。

动作节点 - Action
触发器节点 - Flipflop

关于 DynamicNodeType 枚举的补充说明。

1. 不生成节点控件的枚举值：

Init - 初始化方法
- 入参：IDynamicContext（有且只有一个参数）。
- 返回值：自定义，但不会处理返回值，支持异步等待。
- 描述：在运行时首先被调用。语义类似于构造方法。建议在Init方法内初始化类、注册类等一切需要在构造函数中执行的方法。
Loading - 加载方法
- 入参：IDynamicContext（有且只有一个参数）。
- 返回值：自定义，但不会处理返回值，支持异步等待。
- 描述：当所有Dll的Init方法调用完成后，首先调用、也才会调用DLL的Loading方法。建议在Loading方法内进行业务上的初始化（例如启动Web，启动第三方服务）。
Exit - 结束方法
- 入参：IDynamicContext（有且只有一个参数）。
- 返回值：自定义，但不会处理返回值，支持异步等待。
- 描述：当结束/手动结束运行时，会调用所有Dll的Exit方法。使用场景类似于：终止内部的其它线程，通知其它进程关闭，例如停止第三方服务。
关于IDynamicContext说明
- 基本说明：IDynamicContext是动态上下文接口，内部提供全局单例的IFlowEnvironment环境接口，用以注册、获取实例（单例模式），一般情况下，你无须关注IFlowEnvironment对外暴露的属性方法。

2. 基础节点

Script - 脚本节点

入参：可选可变
描述：有时我们需要定义一个临时的类对象，但又不想在代码中写死属性，又或者某些流程操作中，因为业务场景需要布置大量的逻辑判断，导致流程图变得极为臃肿不堪入目，于是引入了脚本节点。脚本节点动态能力强，不同于表达式使用递归下降，而是基于AST抽象语法树调用相应的C#代码，性能至少差强人意。
使用方式：

// 定义一个类
 class Info{
   string PlcName;
   string Content;
   string LogType;
   DateTime LogTime;
 }

 // 获取必要的参数
 let flow = GetFlowApi(); // 脚本默认挂载的方法，获取当前流程的API
 let plc = flow.GetGlobalData("JC-PLC"); // 流程API对应的方法，获取全局数据
 let arg = flow.GetArgData(0); // 获取第一个入参
 let varInfo = arg.Var; // 获取入参对象的Var属性
 let data = arg.Data; // 获取入参对象的Data属性

 let log = new Info(); // 创建一个类
 log.Content =  plc + " " + varInfo + " - 状态 Value  : " + data;
 log.PlcName = plc.Name;
 log.LogType = "info";
 log.LogTime = GetNow(); // 脚本默认挂载的方法，获取当前时间
 return log; // 返回对象

GlobalData - 全局数据节点
- 入参：KeyName ，在整个流程环境中标识某个数据的key值。
- 描述：有时需要获取其它节点的数据，但如果强行在两个节点之间进行连线，会让项目流程图变得无比丑陋，如果在类库代码中自己对全局数据进行维护，可能也不太优雅，所以引入了全局数据节点（全局变量）
- 使用方式：全局数据节点实质上只是一个节点容器，这意味着你能将任意节点拖拽到该容器节点上，当流程执行到这个容器节点（全局数据节点）时，会自动调用容器内部的节点对应的方法，并将返回的数据保存在运行环境维护的Map中。
- 其它获取到全局数据的方式：
  1. 表达式：
```
@Get #KeyName# // 使用##符号表达全局数据KeyName的标识符
```
  2. Script代码：
```
let flow = GetFlowApi(); // 获取流程API
let data = flow.GetGlobalData("KeyName"); // 获取全局数据
```
  3. C# 代码中（不建议）：
```
SereinEnv.GetFlowGlobalData("KeyName"); // 获取全局数据
SereinEnv.AddOrUpdateFlowGlobalData("KeyName", obj); // 设置/更新全局数据，不建议
```
ExpOp- 表达式节点
- 入参: 自定义的表达式。
- 取值表达式：@Get
  - 描述：有时节点返回了object，但下一个节点只需要对象中某个属性，而非整个对象。如果修改节点的定义，有可能破坏了代码的封装，为了解决这个痛点，于是增加了表达式功能。
  - 使用方法：
    1. 获取对象的属性成员：
      @Get .[property]/[field]
    2. 获取对象的数组成员中下标为22的项：
      @Get .array[22]
    3. 获取对象的字典成员中键为“33”的值：
      @Get .dict[33]
    4. 获取对象“ID”属性并转为int：
      @Get .ID<int>
    5. 获取KeyName为【 MyDevice 】全局数据：
      @Get #MyDevice#
    6. 从全局数据【 MyDevice 】中获取“IP”属性：
      @Get #MyDevice#.IP
- 数据类型转换表达式：@Dtc
  - 描述：有时需要显式的设置节点参数值，但参数接收了其它的类型，需要经过一次转换，将显式的文本值转为入参数据类型。
  - 使用方法：
```
@Dtc <long>1233
@Dtc <bool>True
@Dtc <DateTime>2024-12-24 11:13:42 （注：如果右值为“now”，则自动获取当前时间）
```
ExpCondition - 条件表达式节点
- 入参: 自定义。
- 描述：与表达式节点不同，条件表达式节点是判断条件是否成立，如果成立，返回true，否则返回false，如果表达式执行失败，而进入 error 分支。
- 增加描述：如果入参数据为某个对象，需要得到其属性/字段，可以在表达式输入框使用“ .[property]/[field]< type> [op] value ”的方式判断条件，注意，必须使用“.”符号，这有助于显然的表达需要从入参对象中取内部某个值，另外，也可以在入参数据编辑框，使用“@Get .[property]/[field]”的方式重新定义入参数据。
- 表达式符号说明：
- [property] /[field] : 属性/字段
- [op] : 操作符
  1. bool表达式：==
  2. 数值表达式：==、>=、 <=、in a-b （表示判断是否在a至b的数值范围内）, !in a-b（取反）；
  3. 文本表达式：==/equals（等于）、!=/notequals（不等于）、c/contains（出现过）、nc/doesnotcontain（没有出现过）、sw/startswith（开头等于）、ew/endswith（结尾等于）
- [value] ：条件值

3. 从DLL生成控件的枚举值：

Action - 动作
- 入参：自定义。如果入参类型为IDynamicContext，会传入当前的上下文；如果入参类型为NodeBase，会传入节点对应的Model。如果不显式指定参数来源，参数会尝试获取运行时上一节点返回值，并根据当前入参类型尝试进行类型转换。
- 返回值：自定义，支持异步等待。
- 描述：同步执行对应的方法。
Flipflop - 触发器
- 全局触发器
  - 入参：依照Action节点。
  - 返回值：Task<IFlipflopContext<TResult>>
  - 描述：运行开始时，所有无上级节点的触发器节点（在当前分支中作为起始节点），分别建立新的线程运行，然后异步等待触发（如果有）。这种触发器拥有独自的DynamicContext上下文（共用同一个Ioc），执行完成之后，会重新从分支起点的触发器开始等待。
- 分支中的触发器
  - 入参：依照Action节点。
  - 返回值：Task<IFlipflopContext<TResult>>
  - 描述：接收上一节点传递的上下文，同样进入异步等待，但执行完成后不会再次等待自身（只会触发一次）。
- IFlipflopContext<TResult>
  - 基本说明：IFlipflopContext是一个接口，你无须关心内部实现。
  - 参数描述：State，状态枚举描述（Succeed、Cancel、Error、Cancel），如果返回Cancel，则不会执行后继分支，如果返回其它状态，则会获取对应的后继分支，开始执行。
  - 参数描述：Type，触发状态描述（External外部触发，Overtime超时触发），当你在代码中的其他地方主动触发了触发器，则该次触发类型为External，当你在创建触发器后超过了指定时间（创建触发器时会要求声明超时时间），则会自动触发，但触发类型为Overtime，触发参数未你在创建触发器时指定的值）
  - 参数描述：Value，触发时传递的参数。
- 使用场景：配合 FlowTrigger<TEnum> 使用，例如定时从PLC中获取状态，当某个变量发生改变时，会通知相应的触发器，如果需要，可以传递对应的数据。演示：

README.md Unescape Escape

自述

计划任务 2024年10月28日更新

如何加载我的DLL？

如何让我的方法成为节点？

关于 DynamicNodeType 枚举的补充说明。

1. 不生成节点控件的枚举值：

2. 基础节点

3. 从DLL生成控件的枚举值：

README.md