目    录

第1章  工作流体系基础与n8n自动化引擎原理 1

1.1  工作流的基本计算模型 1

1.1.1  什么是工作流 1

1.1.2  数据管道模型（Item流）及执行状态管理 4

1.1.3  n8n基本构建方式与触发机制实现 5

1.1.4  节点执行序列与依赖解析流程 11

1.1.5  工作流可以做什么 12

1.1.6  一个基本的工作流组成 14

1.2  n8n技术栈与架构组成 17

1.2.1  Node.js执行环境与TypeScript内核组件 17

1.2.2  Credential系统与安全隔离机制 20

1.2.3  Expression解析器与数据路径绑定原理 21

1.2.4  Workflow Engine执行器的任务调度链路 23

1.3  n8n特性介绍 24

1.3.1  节点类型分类及适用场景 24

1.3.2  并行流程、循环处理与动态分支 25

1.3.3  网络请求、文件流处理与API调用栈 26

1.3.4  系统扩展方式与常见插件生态 28

1.4  n8n基础操作与入门实践 29

1.4.1  n8n工作流介绍 30

1.4.2  n8n.io注册与登录 32

1.4.3  n8n基本操作方式 34

1.4.4  第一个工作流：邮件触发器与邮件分类器 37

1.4.5  事件触发、Excel数据读取与回档 39

1.4.6  HTTP请求与数据合并 41

1.4.7  表达式构建 45

1.4.8  模板导入、工作流版本管理与部署方式简介 45

1.4.9  n8n内建工作流 46

1.5  本章小结 50

第2章  工作流基础能力与常用业务场景构建 51

2.1  系统触发与任务调度工作流 51

2.1.1  Cron触发器构建定时同步任务 51

2.1.2  Webhook触发器集成外部系统 53

2.1.3  轮询模式的API数据获取与状态对比 56

2.2  数据清洗与结构化处理工作流 57

2.2.1  Function节点中的批处理与Map操作 57

2.2.2  JSON数据校验与字段映射策略 59

2.2.3  合并、分拆与动态生成数据结构 60

2.3  API集成与系统互通工作流 61

2.3.1  REST API高级调用（认证、分页、签名） 61

2.3.2  GraphQL查询与动态变量绑定 62

2.3.3  多API汇聚与数据集成模式 64

2.4  文件、媒体与消息工作流 66

2.4.1  多格式文件解析与处理（CSV、PDF、图像） 67

2.4.2  QQ邮件自动化填充、分组与解析 67

2.4.3  文件上传Webhook与HR文档解析 72

2.5  本章小结 74

第3章  常用业务自动化与行业级工作流设计 75

3.1  AI增强型内容生成工作流 75

3.1.1  多模型串联的文本生成链路 75

3.1.2  文档抽取、结构化与自动总结流程 76

3.1.3  参数化Prompt注入与模板化生成 77

3.1.4  多轮生成与自动质量评估链 77

3.2  企业数据同步与系统集成场景 78

3.2.1  CRM→ERP订单流转自动化 78

3.2.2  业务系统库存同步与异常对齐机制 82

3.2.3  数据库增量同步与冲突校准流程 83

3.2.4  报表计算与自动分发链路 84

3.3  运营自动化与事件驱动推送 84

3.3.1  营销事件触发与自动通知 84

3.3.2  内容审核、过滤与分类节点流程 85

3.3.3  用户行为采集与自动标签计算 89

3.4  客服自动化场景 90

3.4.1  点击触发事件配置 90

3.4.2  客服消息接收与智能体接入 93

3.4.3  接入聊天模型、第三方数据库与工具链 97

3.4.4  接入用户查询页 100

3.4.5  接入消息发送器与AWS Lambda模块 102

3.5  本章小结 103

第4章  复杂工作流结构设计与高阶构建方式 104

4.1  条件分支、循环与动态路由 104

4.1.1  If、Switch条件逻辑工程化使用 104

4.1.2  Split In Batches的事务型循环处理 107

4.1.3  动态路由节点构建策略 109

4.2  多数据源联动与上下游依赖控制 110

4.2.1  多源数据合并与优先级策略 110

4.2.2  执行链依赖管理与错误回滚 110

4.3  工作流性能优化与资源管理 111

4.3.1  大数据批次处理与分片策略 111

4.3.2  API速率控制与缓存节点 113

4.4  工作流模块化与复用的工程方法 115

4.4.1  子工作流设计与参数传递 115

4.4.2  业务功能模块的拆解与封装 117

4.4.3  跨工作流的事件触发链 117

4.5  本章小结 118

第5章  n8n进阶：Function与代码型节点深度开发 119

5.1  Function节点的工程化应用模式 119

5.1.1  JS执行环境与内部API 119

5.1.2  数据变换与对象组合逻辑 121

5.1.3  自定义批处理流水线节点 121

5.1.4  代码节点中的安全与隔离 124

5.2  Function Item与高级数据操作 125

5.2.1  单Item处理逻辑 125

5.2.2  定制节点：动态字段解析与变量绑定 129

5.2.3  嵌套循环与复杂结构构建 132

5.3  代码节点的工程风格与可维护性 136

5.3.1  函数式结构与模块化拆分 136

5.3.2  错误处理与捕获模式 136

5.4  基于视频流的工作流实现 140

5.4.1  选取特征模板 140

5.4.2  注册应用凭证 141

5.4.3  添加全局变量 142

5.4.4  通过Function构建自定义节点 143

5.4.5  构建工作流 148

5.5  本章小结 149

第6章  自定义节点开发基础：从结构到实现 150

6.1  自定义节点的结构组成与元数据 150

6.1.1  NodeTypeDescription结构详解 150

6.1.2  inputs、outputs结构详解 152

6.1.3  在n8n节点中实现内部Context注入机制 153

6.2  execute函数与节点执行引擎交互 157

6.2.1  IExecuteFunctions接口逻辑 157

6.2.2  多Item输出的序列化规则 160

6.2.3  动态配置读取与执行路径生成 164

6.3  Credential开发与认证机制 169

6.3.1  API Key类型凭证 170

6.3.2  OAuth2身份授权流程 170

6.3.3  自定义签名算法与动态Token刷新 171

6.4  本章小结 175

第7章  TypeScript工程体系：n8n插件专业开发模式 176

7.1  TypeScript在n8n中的工程角色 176

7.1.1  类型系统与n8n核心接口映射 176

7.1.2  模块依赖、编译与产物 177

7.2  节点与凭证的工程化目录结构 177

7.2.1  多节点模块化组织方式 177

7.2.2  index文件与动态注册机制 181

7.2.3  资源文件与类型声明协调 185

7.3  常见TypeScript特性在n8n中的应用 186

7.3.1  泛型在节点输入输出中的设计 186

7.3.2  Utility Types构建结构模板 189

7.3.3  类型收窄处理复杂条件逻辑 192

7.3.4  运行时类型校验与Schema构建 196

7.4  本章小结 199

第8章  TypeScript构建高阶组件：复合节点与能力扩展 200

8.1  复合节点构建与业务逻辑封装 200

8.1.1  多步骤组合成单节点的工程模式 200

8.1.2  动态参数渲染与输入依赖 201

8.1.3  内部数据合并/拆分策略 204

8.1.4  模块化复用的节点库设计 208

8.2  AI相关复合节点开发 211

8.2.1  Prompt构建器节点 211

8.2.2  多模型选择器与负载调度策略 214

8.2.3  向量检索节点与RAG组合节点 215

8.2.4  文本后处理与内容生成过滤 218

8.3  本章小结 222

第9章  基于TypeScript驱动的复杂编排实现 223

9.1  多系统协作与复杂依赖管理 223

9.1.1  企业系统调用链的流程约束 223

9.1.2  多源数据冲突的调节策略 224

9.1.3  自定义事件路由层设计 227

9.2  多环境部署的集成工作流 229

9.2.1  开发/预发/生产环境隔离 230

9.2.2  API密钥与凭证多环境切换 231

9.3  高并发节点执行与性能优化 232

9.3.1  队列模式与多工作者协同 232

9.3.2  请求合并、缓存与节流策略 233

9.4  本章小结 237

第10章  复杂系统构建的关键：TypeScript定制中台系统及业务引擎 238

10.1  构建企业级AI自动化中台 238

10.1.1  AI流水线调度与模型切换策略 238

10.1.2  通过自定义节点实现企业知识库自动化同步 242

10.1.3  多模型协作链与复合推理结构 246

10.2  高度定制的企业业务引擎 250

10.2.1  采购、库存、计划链的集成 250

10.2.2  金融风控自动化节点组合 254

10.2.3  组合自定义节点为子工作流 257

10.3  本章小结 260