ef-compiler 新增结点说明

一、action 下添加结点

在 nodejs/ef-compiler/actions/ 下新建 hello-parser.js：

const types = ['hello']

function parse(action, parseContext) {
  const parsed = { type: 'hello', value: action.value || '' }
  return Object.assign({}, action, parsed)
}

async function execute(action, ctx) {
  const msg = action.value ? String(action.value) : 'hello'
  if (ctx.logMessage) await ctx.logMessage('[hello] ' + msg, ctx.folderPath)
  return { success: true }
}

module.exports = { types, parse, execute }

在 workflow-json-parser.js 里：actionModules 加 require('./actions/hello-parser.js')；要中文名则在 getActionName 的 typeNames 加 'hello': '打招呼'。

工作流 JSON：{ "type": "hello", "value": "世界" }

二、fun 下添加结点

1. 新建脚本

在 actions/fun/ 下新建 xxx.js：

async function executeTestFun({ num, str, folderPath }) {  // 函数名与注册表 execute 一致；入参 key 与注册表 in 对应，folderPath 由框架注入
  const n = Number(num ?? 0)   // 第 1 个入参，转成 number
  const s = String(str ?? '')  // 第 2 个入参，转成 string
  return { success: true, value: String(n) + s }  // 成功：返回 value，框架会写入出参变量并打日志；失败可返回 { success: false, error: '...' }
}
module.exports = { executeTestFun }  // 导出与注册表 execute 同名的函数

2. 注册表一条

在 nodejs/ef-compiler/actions/fun-node-registry.js 里添加：

{
  type: 'test-fun',        // 工作流里的 type
  category: 'io',          // 与 get() 分类一致：io / img / chat
  in: ['num', 'str'],      // 入参名，与上面 executeTestFun 的 input 的 key 一致；对应 inVars[0]、inVars[1] 或 action.num、action.str
  out: 'variable',         // 出参变量名来自 action.variable 或 action.outVars[0]
  execute: 'executeTestFun',
  script: 'test-fun.js',
  displayName: 'test-fun', // 可选
}

工作流示例：{ "type": "test-fun", "inVars": ["myNum", "myStr"], "variable": "result" }

可选：字段别名

在注册表加 inAlt：

inAlt: { savePath: 'save-path' }

可选：完全自定义

注册表配 customParse、customRun；脚本导出 parseNode、runNode。

ef-compiler新增结点说明.md 2.3 KB Historique Raw