first commit

2025-09-09 09:29:17 +08:00
commit 3898c312d5
26 changed files with 6649 additions and 0 deletions
--- a/docs/reference/glossary.md
+++ b/docs/reference/glossary.md
@@ -0,0 +1,225 @@
+# 术语表
+
+## 📚 学习资源
+
+- **官方文档**：[n8n官方文档](https://docs.n8n.io)
+- **中文文档**：[n8n中文文档](https://docs.n8ncn.io)
+- **快速开始**：[n8n.io](https://n8n.io)
+
+本术语表收录了n8n和工作流自动化领域的重要概念和专业术语，帮助您更好地理解和使用相关技术。
+
+## 🅰️ A-E
+
+### AI Agent (AI代理)
+能够理解指令、规划行动、使用工具并与环境交互以实现目标的智能系统，通常由大型语言模型驱动。
+
+### API (应用程序编程接口)
+Application Programming Interface的缩写，是不同软件应用程序之间进行通信的接口规范。
+
+### API Key (API密钥)
+用于验证用户、应用程序或服务身份并授予其访问API权限的凭证字符串。
+
+### Code Node (代码节点)
+n8n中的一种节点，允许用户在工作流中编写和执行自定义的JavaScript或Python代码，实现更复杂的逻辑或与特定库交互。
+
+### Credentials (凭证)
+在n8n中用于安全存储和管理连接外部服务所需的授权信息，如API密钥、OAuth令牌、用户名密码等。
+
+### Cron表达式
+用于定义定时任务执行时间的表达式格式，由秒、分、时、日、月、周等字段组成。
+
+### Docker
+一个用于开发、交付和运行应用程序的开源平台，通过容器化技术使应用程序及其依赖项能够打包在一起。
+
+## 🅰️ F-J
+
+### Fair-code License (公平代码许可)
+n8n采用的开源许可模式，允许个人和小型团队免费使用，大型企业需要购买商业许可。
+
+### HTTP Request (HTTP请求)
+一种n8n节点，用于向任意HTTP/HTTPS端点发送请求，常用于与未直接集成的第三方服务进行交互。
+
+### Input Schema (输入模式)
+定义工作流或节点预期接收的数据结构和数据类型，确保数据以正确的格式传入。
+
+### JSON (JavaScript对象表示法)
+一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成。
+
+## 🅰️ K-O
+
+### Low-code (低代码)
+一种软件开发方法，通过最少量的手动编码实现应用程序的快速开发，通常依赖于图形用户界面和可视化工具。
+
+### MCP (Model Context Protocol) 模型上下文协议
+一种标准化协议，用于使AI模型能够与外部工具和数据源进行交互，从而扩展其能力。
+
+### MCP Server (MCP服务器)
+提供工具、数据或提示资源给AI客户端的独立服务，在MCP架构中作为资源提供方。
+
+### MCP Trigger (MCP触发器)
+n8n MCP服务器工作流模板中的一个核心节点，用于接收MCP客户端的请求并触发相关操作。
+
+### No-code (无代码)
+一种软件开发方法，允许非技术用户通过拖拽界面和预构建组件来创建应用程序和自动化流程，无需编写任何代码。
+
+### Node (节点)
+n8n工作流的基本组成单元，代表一个特定的操作或与一个应用程序的集成。
+
+### n8n
+一个开源且公平代码许可的工作流自动化工具，允许用户通过可视化界面连接应用程序和API。
+
+## 🅰️ P-T
+
+### Passthrough Method (直通方法)
+在n8n中，一种参数传递方式，表示当节点未明确设置参数时，将使用传入的数据作为默认值。
+
+### RAG (Retrieval-Augmented Generation) 检索增强生成
+一种AI技术，通过从外部知识库中检索相关信息来增强大型语言模型的生成能力。
+
+### Redis
+一个开源的、内存中的数据结构存储，可用作数据库、缓存和消息代理。在n8n MCP服务器模板中用作内存存储。
+
+### Self-hosting (私有部署)
+用户在自己的服务器或基础设施上安装和运行软件，而不是使用云服务提供商提供的托管版本。
+
+### Subworkflow Trigger (子工作流触发器)
+n8n中的一种触发器节点，允许一个工作流作为另一个工作流的子流程被调用和执行，常用于模块化和参数传递。
+
+### Trigger (触发器)
+工作流的起点，定义了工作流在什么条件下开始执行，如手动触发、定时触发、Webhook触发等。
+
+## 🅰️ U-Z
+
+### Webhook
+一种HTTP回调机制，允许外部系统在特定事件发生时向n8n发送HTTP请求来触发工作流执行。
+
+### Workflow (工作流)
+在n8n中，由一系列相互连接的节点组成的自动化流程，用于执行特定任务或自动化业务逻辑。
+
+## 📊 常用节点类型
+
+### 触发器节点 (Trigger Nodes)
+
+| 节点名称 | 英文名称 | 功能描述 |
+|---------|---------|----------|
+| **手动触发** | Manual Trigger | 用户手动启动工作流 |
+| **定时触发** | Schedule Trigger | 基于时间自动触发 |
+| **Webhook触发** | Webhook | HTTP请求触发 |
+| **邮件触发** | Email Trigger (IMAP) | 邮件事件触发 |
+| **文件监控** | File System Trigger | 文件变化触发 |
+
+### 输入节点 (Input Nodes)
+
+| 节点名称 | 英文名称 | 功能描述 |
+|---------|---------|----------|
+| **HTTP请求** | HTTP Request | 发送HTTP请求获取数据 |
+| **文件读取** | Read Local File | 读取本地文件内容 |
+| **数据库查询** | MySQL/PostgreSQL | 查询数据库数据 |
+| **RSS读取** | RSS Read | 获取RSS订阅内容 |
+| **Google表格** | Google Sheets | 读取Google表格数据 |
+
+### 处理节点 (Process Nodes)
+
+| 节点名称 | 英文名称 | 功能描述 |
+|---------|---------|----------|
+| **数据设置** | Set | 设置或修改数据字段 |
+| **代码执行** | Code | 执行JavaScript/Python代码 |
+| **AI代理** | AI Agent | 集成AI模型处理 |
+| **数据转换** | Transform | 数据格式转换 |
+| **文本处理** | Text Processing | 文本分析和处理 |
+
+### 逻辑节点 (Logic Nodes)
+
+| 节点名称 | 英文名称 | 功能描述 |
+|---------|---------|----------|
+| **条件判断** | IF | 根据条件分支执行 |
+| **分支选择** | Switch | 多条件路由分发 |
+| **循环处理** | Loop Over Items | 批量数据处理 |
+| **数据合并** | Merge | 合并多个数据流 |
+| **错误捕获** | Error Trigger | 错误处理机制 |
+
+### 输出节点 (Output Nodes)
+
+| 节点名称 | 英文名称 | 功能描述 |
+|---------|---------|----------|
+| **邮件发送** | Email Send | 发送电子邮件 |
+| **文件写入** | Write Local File | 保存文件到本地 |
+| **HTTP响应** | Webhook Response | 返回HTTP响应 |
+| **数据库插入** | Database Insert | 写入数据库 |
+| **消息通知** | Slack/Teams | 发送即时消息 |
+
+## 🔧 技术概念
+
+### 数据格式
+
+| 概念 | 说明 | 示例 |
+|------|------|------|
+| **JSON** | JavaScript对象表示法 | `{"name": "张三", "age": 30}` |
+| **CSV** | 逗号分隔值文件 | `姓名,年龄\n张三,30` |
+| **XML** | 可扩展标记语言 | `<user><name>张三</name></user>` |
+| **YAML** | 人类友好的数据序列化标准 | `name: 张三\nage: 30` |
+
+### 认证方式
+
+| 类型 | 说明 | 应用场景 |
+|------|------|----------|
+| **API Key** | 简单的密钥认证 | 大多数REST API |
+| **OAuth 2.0** | 开放授权标准 | 社交媒体、云服务 |
+| **Basic Auth** | 基础用户名密码认证 | 简单的HTTP服务 |
+| **Bearer Token** | 承载令牌认证 | 现代Web API |
+| **JWT** | JSON Web令牌 | 无状态认证 |
+
+## 🌐 业务术语
+
+### 自动化类型
+
+| 类型 | 定义 | 特点 |
+|------|------|------|
+| **RPA** | 机器人流程自动化 | 模拟人工操作 |
+| **API集成** | 应用程序接口集成 | 系统间数据交换 |
+| **ETL** | 提取、转换、加载 | 数据处理流程 |
+| **事件驱动** | 基于事件的自动化 | 实时响应处理 |
+| **批处理** | 批量数据处理 | 定时大量处理 |
+
+### 监控指标
+
+| 指标 | 英文 | 说明 |
+|------|------|------|
+| **执行次数** | Execution Count | 工作流运行次数 |
+| **成功率** | Success Rate | 成功执行的百分比 |
+| **平均执行时间** | Average Execution Time | 工作流平均运行时间 |
+| **错误率** | Error Rate | 执行失败的百分比 |
+| **并发数** | Concurrency | 同时执行的工作流数量 |
+
+## 📚 学习资源术语
+
+### 文档类型
+
+| 类型 | 说明 | 特点 |
+|------|------|------|
+| **快速开始** | Quick Start | 新手入门指南 |
+| **API文档** | API Documentation | 接口使用说明 |
+| **最佳实践** | Best Practices | 经验总结和建议 |
+| **故障排查** | Troubleshooting | 问题解决指南 |
+| **发布日志** | Release Notes | 版本更新说明 |
+
+### 社区角色
+
+| 角色 | 职责 | 要求 |
+|------|------|------|
+| **用户** | 使用n8n创建工作流 | 基础使用技能 |
+| **贡献者** | 分享模板和经验 | 实践经验丰富 |
+| **专家** | 解答技术问题 | 深度技术能力 |
+| **维护者** | 维护项目和社区 | 全面技术和管理能力 |
+
+!!! tip "术语学习建议"
+    - 先掌握基础概念，再深入专业术语
+    - 结合实际操作理解抽象概念
+    - 关注术语的英文原文，便于查阅国际资源
+    - 定期回顾和更新术语理解
+
+---
+
+掌握这些术语将大大提高您在n8n社区的交流效率和学习效果！
+
+[上一章：参考资料](resources.md){ .md-button } [下一章：AI卓越中心](../ai-center/functions.md){ .md-button .md-button--primary }
--- a/docs/reference/resources.md
+++ b/docs/reference/resources.md
@@ -0,0 +1,302 @@
+# 参考资料
+
+这里汇集了学习和使用n8n所需的全部资源，包括官方文档、社区资源、教程视频和实用工具。
+
+## 📄 本地PDF文档
+
+- **n8n指南.pdf** - 本指南的PDF版本，可离线阅读
+
+## 🔗 指南中所有链接汇总
+
+### 官方资源
+- [n8n官方文档](https://docs.n8n.io) - 最权威、最完整的官方文档
+- [n8n中文文档](https://docs.n8ncn.io) - 中文社区维护的文档版本
+- [n8n官方社区](https://community.n8n.io/) - 官方论坛，模板分享和问题讨论
+- [n8n.io](https://n8n.io/) - 官方主页，在线试用和云服务
+
+### 视频教程
+- [B站 - n8n完整教程](https://www.bilibili.com/video/BV1nejbz6Eip) - 零基础入门，2小时
+- [B站 - n8n部署实战](https://www.bilibili.com/video/BV1kZNrzpEy6) - Docker部署，45分钟
+- [B站 - n8n+MCP实战](https://www.bilibili.com/video/BV11QX8YNEjU) - MCP集成，1.5小时
+- [B站 - n8nChat使用](https://www.bilibili.com/video/BV1HuKEzDEaj) - 自然语言编程，30分钟
+
+### 图文教程
+- [微信公众号 - n8n基础教程](https://mp.weixin.qq.com/s/oIcmTW0Gg2r63C0Tn91r2Q)
+- [CSDN - n8n本地部署详解](https://blog.csdn.net/2501_90561511/article/details/147479401)
+- [知乎 - n8n界面介绍](https://n8n.akashio.com/article/n8n-ui)
+- [知乎 - n8n汉化指南](https://zhuanlan.zhihu.com/p/1937586953865372387)
+- [知乎 - MCP工作流部署](https://zhuanlan.zhihu.com/p/1913630305291567877)
+- [技术站 - 凭证管理实战](https://jishuzhan.net/article/1951148541186977794)
+
+### 实战案例
+- [知乎 - 天气预报微信推送](https://zhuanlan.zhihu.com/p/629643758)
+- [CSDN - n8n+MCP+DeepSeek](https://blog.csdn.net/m0_59235245/article/details/147950398)
+- [微信 - 飞书表格集成](https://mp.weixin.qq.com/s/MIoNKpCSBYhhBjxCAaGSYg)
+- [微信 - 多智能体工作流](https://mp.weixin.qq.com/s/efsB3GwZzTVH4rjW5i0iGQ)
+- [微信 - 论文自动解读知识库](https://mp.weixin.qq.com/s/YBoM7YkpHjsFl-hyaSsnOw)
+
+### 模板资源
+- [Awesome n8n Templates](https://github.com/enescingoz/awesome-n8n-templates) - 2000+模板
+- [n8n Workflows Collection](https://github.com/Zie619/n8n-workflows) - 2000+模板
+- [n8n.io/workflows](https://n8n.io/workflows) - 500+官方精选
+
+### 社区节点
+- [Top 100社区节点](https://github.com/restyler/awesome-n8n)
+- [MCP节点](https://github.com/nerding-io/n8n-nodes-mcp)
+
+### 工具和平台
+- [n8nchat](https://n8nchat.com) - 官方自然语言编程工具
+- [Darrell的n8n教程合集](https://www.darrelltw.com/n8n-tutorial-resources/)
+- [冰糖数据的避坑指南](https://x.com/binggandata/status/1951798212995829996)
+
+### 官方模板和案例
+- [Build your own n8n workflows MCP server](https://n8n.io/workflows/3770-build-your-own-n8n-workflows-mcp-server/)
+
+## 📚 官方资源
+
+### 核心文档
+
+| 资源 | 链接 | 说明 |
+|------|------|------|
+| **英文官方文档** | [docs.n8n.io](https://docs.n8n.io) | 最权威、最完整的官方文档 |
+| **中文文档** | [docs.n8ncn.io](https://docs.n8ncn.io) | 中文社区维护的文档版本 |
+| **官方社区** | [community.n8n.io](https://community.n8n.io/) | 官方论坛，模板分享和问题讨论 |
+| **快速开始** | [n8n.io](https://n8n.io/) | 官方主页，在线试用和云服务 |
+
+### 官方学习资源
+
+- **n8n学院**: 官方在线课程和认证
+- **用例库**: 官方提供的工作流模板
+- **最佳实践**: 官方推荐的使用指南
+- **发布日志**: 新功能和更新说明
+
+## 🎥 视频教程
+
+### 中文教程
+
+| 教程类型 | 链接 | 时长 | 难度 |
+|----------|------|------|------|
+| **零基础入门** | [B站 - n8n完整教程](https://www.bilibili.com/video/BV1nejbz6Eip) | 2小时 | ⭐ |
+| **Docker部署** | [B站 - n8n部署实战](https://www.bilibili.com/video/BV1kZNrzpEy6) | 45分钟 | ⭐⭐ |
+| **MCP集成** | [B站 - n8n+MCP实战](https://www.bilibili.com/video/BV11QX8YNEjU) | 1.5小时 | ⭐⭐⭐ |
+| **自然语言编程** | [B站 - n8nChat使用](https://www.bilibili.com/video/BV1HuKEzDEaj) | 30分钟 | ⭐⭐ |
+
+### 英文教程
+
+- **YouTube官方频道**: n8n官方视频教程
+- **YouTube社区频道**: 第三方创作者分享
+- **Udemy课程**: 付费深度课程
+
+## 📖 博客文章和教程
+
+### 技术博客
+
+=== "入门教程"
+    - [微信公众号 - n8n基础教程](https://mp.weixin.qq.com/s/oIcmTW0Gg2r63C0Tn91r2Q)
+    - [CSDN - n8n本地部署详解](https://blog.csdn.net/2501_90561511/article/details/147479401)
+    - [知乎 - n8n界面介绍](https://n8n.akashio.com/article/n8n-ui)
+
+=== "高级应用"
+    - [知乎 - n8n汉化指南](https://zhuanlan.zhihu.com/p/1937586953865372387)
+    - [知乎 - MCP工作流部署](https://zhuanlan.zhihu.com/p/1913630305291567877)
+    - [技术站 - 凭证管理实战](https://jishuzhan.net/article/1951148541186977794)
+
+=== "实战案例"
+    - [知乎 - 天气预报微信推送](https://zhuanlan.zhihu.com/p/629643758)
+    - [CSDN - n8n+MCP+DeepSeek](https://blog.csdn.net/m0_59235245/article/details/147950398)
+    - [微信 - 飞书表格集成](https://mp.weixin.qq.com/s/MIoNKpCSBYhhBjxCAaGSYg)
+
+### 系列文章
+
+- **Darrell的n8n教程合集**: [完整学习资源](https://www.darrelltw.com/n8n-tutorial-resources/)
+- **冰糖数据的避坑指南**: [Twitter避坑系列](https://x.com/binggandata/status/1951798212995829996)
+
+## 🛠️ 工具和资源
+
+### 模板库
+
+| 模板库 | 数量 | 特色 | 链接 |
+|--------|------|------|------|
+| **Awesome n8n Templates** | 2000+ | GitHub最全模板集合 | [GitHub](https://github.com/enescingoz/awesome-n8n-templates) |
+| **n8n Workflows Collection** | 2000+ | 分类详细的工作流集合 | [GitHub](https://github.com/Zie619/n8n-workflows) |
+| **官方模板** | 500+ | 官方精选和验证 | [n8n.io/workflows](https://n8n.io/workflows) |
+
+### 社区节点
+
+- **社区节点排行榜**: [Top 100社区节点](https://github.com/restyler/awesome-n8n)
+- **MCP节点**: [MCP协议支持](https://github.com/nerding-io/n8n-nodes-mcp)
+- **自定义节点开发**: 官方开发指南
+
+### 开发工具
+
+=== "编辑器和IDE"
+    ```
+    推荐工具：
+    - VS Code: n8n工作流JSON编辑
+    - n8nChat: 自然语言编程工具
+    - Postman: API测试工具
+    ```
+
+=== "监控和调试"
+    ```
+    监控工具：
+    - Grafana: 性能监控仪表板
+    - ELK Stack: 日志分析
+    - Uptime Kuma: 服务可用性监控
+    ```
+
+=== "部署工具"
+    ```
+    部署方案：
+    - Docker Compose: 容器化部署
+    - Kubernetes: 集群部署
+    - Terraform: 基础设施即代码
+    ```
+
+## 🔗 相关项目和生态
+
+### AI和自动化工具
+
+| 工具类型 | 推荐工具 | 与n8n集成度 |
+|----------|----------|-------------|
+| **大语言模型** | OpenAI, Claude, Gemini | ⭐⭐⭐⭐⭐ |
+| **向量数据库** | Pinecone, Weaviate | ⭐⭐⭐⭐ |
+| **文档处理** | LangChain, LlamaIndex | ⭐⭐⭐⭐ |
+| **图像处理** | Stability AI, Midjourney | ⭐⭐⭐ |
+
+### 业务系统集成
+
+- **CRM系统**: Salesforce, HubSpot, 腾讯企点
+- **项目管理**: Jira, Trello, 飞书项目
+- **通讯工具**: Slack, 企业微信, 钉钉
+- **存储服务**: Google Drive, OneDrive, 阿里云OSS
+
+## 📊 学习路径和认证
+
+### 学习路径建议
+
+<div class="learning-path">
+  <div class="path-level">
+    <div class="level-header">📚 第一阶段：基础入门</div>
+    <div class="level-content">
+      <div class="learning-item">📖 官方文档学习</div>
+      <div class="learning-item">🎥 基础视频教程</div>
+      <div class="learning-item">⚡ 第一个工作流</div>
+    </div>
+  </div>
+  
+  <div class="path-arrow">⬇️</div>
+  
+  <div class="path-level">
+    <div class="level-header">🛠️ 第二阶段：实践应用</div>
+    <div class="level-content">
+      <div class="learning-item">📋 模板复用</div>
+      <div class="learning-item">💼 业务场景实践</div>
+      <div class="learning-item">🔧 问题解决</div>
+    </div>
+  </div>
+  
+  <div class="path-arrow">⬇️</div>
+  
+  <div class="path-level">
+    <div class="level-header">🚀 第三阶段：进阶技能</div>
+    <div class="level-content">
+      <div class="learning-item">🔨 自定义节点</div>
+      <div class="learning-item">🔗 高级集成</div>
+      <div class="learning-item">⚡ 性能优化</div>
+    </div>
+  </div>
+  
+  <div class="path-arrow">⬇️</div>
+  
+  <div class="path-level">
+    <div class="level-header">👨‍💼 第四阶段：专家级应用</div>
+    <div class="level-content">
+      <div class="learning-item">🏗️ 架构设计</div>
+      <div class="learning-item">👥 团队培训</div>
+      <div class="learning-item">🌟 社区贡献</div>
+    </div>
+  </div>
+</div>
+
+**学习路径说明：**
+每个阶段都建立在前一阶段的基础上，建议按顺序进行学习，确保扎实掌握每个阶段的核心技能后再进入下一阶段。
+
+### 技能认证
+
+| 认证级别 | 能力要求 | 推荐学习时间 |
+|----------|----------|-------------|
+| **入门级** | 基本操作、模板使用 | 1-2周 |
+| **应用级** | 独立设计工作流 | 1-2个月 |
+| **专家级** | 复杂系统集成 | 3-6个月 |
+| **架构师** | 企业级解决方案 | 6个月+ |
+
+## 🤝 社区和支持
+
+### 中文社区
+
+- **QQ群**: n8n中文学习交流群
+- **微信群**: 扫描二维码加入学习群
+- **知乎专栏**: n8n实战经验分享
+- **博客园**: 技术文章和案例分享
+
+### 国际社区
+
+- **Discord**: 官方即时聊天社区
+- **Reddit**: r/n8n 讨论版
+- **Stack Overflow**: 技术问题求助
+- **GitHub Discussions**: 功能讨论和建议
+
+### 商业支持
+
+- **官方支持**: 企业级技术支持
+- **合作伙伴**: 认证实施伙伴
+- **培训服务**: 官方和第三方培训
+- **咨询服务**: 解决方案咨询
+
+## 📅 学习计划模板
+
+### 30天入门计划
+
+=== "第1周：基础学习"
+    **目标**: 熟悉界面和基本概念
+    - [ ] 完成云端注册和体验
+    - [ ] 学习界面布局和基本操作
+    - [ ] 创建第一个简单工作流
+    - [ ] 了解常用节点类型
+
+=== "第2周：实践应用"
+    **目标**: 掌握核心功能
+    - [ ] 配置凭证管理
+    - [ ] 学习HTTP请求和数据处理
+    - [ ] 创建定时任务工作流
+    - [ ] 实现邮件自动化
+
+=== "第3周：进阶功能"
+    **目标**: 使用高级特性
+    - [ ] 学习条件判断和循环
+    - [ ] 集成AI功能
+    - [ ] 使用代码节点
+    - [ ] 错误处理和调试
+
+=== "第4周：项目实战"
+    **目标**: 完成实际项目
+    - [ ] 设计业务工作流
+    - [ ] 部署到生产环境
+    - [ ] 监控和优化
+    - [ ] 文档和分享
+
+### 持续学习建议
+
+!!! tip "保持学习的方法"
+    1. **订阅更新**: 关注官方博客和发布日志
+    2. **社区参与**: 积极参与社区讨论和问题解答
+    3. **实践项目**: 持续寻找新的自动化场景
+    4. **分享经验**: 写博客、做分享，教学相长
+    5. **关注趋势**: 了解AI和自动化领域的最新发展
+
+---
+
+有了这些丰富的学习资源，您的n8n学习之路将更加顺畅！
+
+[上一章：社区节点](../learning/community-nodes/){ .md-button } [下一章：术语表](glossary/){ .md-button .md-button--primary }