第37章：自定义 Workflow 节点开发实战

1. 项目背景Dify 内置了 20+ 种 Workflow 节点。但当金融客户要求"所有 AI 回复必须经过数据脱敏——手机号中间 4 位打星、身份证中间 10 位打星、邮箱前 2 位保留"时，内置节点不够用了。Code 节点可以写正则，但每个 Workflow 都要复制粘贴一遍——团队维护成本高。你需要开发一个可拖拽的、可配置的、可复用的"数据脱敏节点"。本章带你完整走通自定义节点的全流程——后端 Python 类（定义输入输出 + 核心算法）、注册到 NodeFactory、前端 React 组件（画布上的节点卡片）、单元测试。读完本章，你将具备开发任意自定义节点的能力。2. 项目设计小胖：“大师，公司合规要求所有 AI 回复里的手机号和身份证号自动打星。我用 Code 节点写了个正则——问题是每个 Workflow 都要复制粘贴一遍，而且团队其他人不知道怎么用。能不能封装成一个可拖拽的节点？”大师：“当然可以。自定义节点只需要三步：① 后端——写一个继承BaseNode的类，实现get_default_config()（定义节点在画布上的名称、输入输出 Schema）和_run()（核心执逻辑——收到输入文本，返回脱敏后的文本）。