尊敬的 {{$json.recipient_name}},
+以下是您请求的{{$json.report_type}}报告:
+ +| 指标 | +数值 | +变化 | +
|---|---|---|
| {{this.name}} | +{{this.value}} | +{{this.change}} | +
commit 3898c312d5935a06297f7a504a2dee2580af9014 Author: 嘉宇 刘 <487954186@qq.com> Date: Tue Sep 9 09:29:17 2025 +0800 first commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..67b3537 --- /dev/null +++ b/README.md @@ -0,0 +1,222 @@ +# n8n工作流自动化指南 + +> 🚀 从零基础到专家级应用,全面掌握n8n工作流自动化技能 + +[](LICENSE) +[](https://n8n.io) +[](https://mkdocs.org) + +## 📖 项目简介 + +本项目是一份全面的n8n工作流自动化学习指南,旨在帮助用户从基础概念到高级应用,系统性地掌握n8n平台的使用技能。无论您是技术零基础的业务人员,还是需要深入了解部署运维的技术人员,都能在这里找到适合的学习路径。 + +### 🎯 目标读者 + +- **业务人员**: 希望通过低代码工具提升工作效率 +- **技术支持**: 负责n8n部署、配置和维护的技术人员 +- **开发者**: 需要构建复杂自动化流程的工程师 +- **AI爱好者**: 想要结合AI能力构建智能工作流 + +## ✨ 主要特色 + +### 🔧 全流程覆盖 +- **入门指导**: 从零开始的完整学习路径 +- **实战案例**: 丰富的真实业务场景示例 +- **进阶技巧**: AI集成、MCP协议、自然语言编程 +- **最佳实践**: 避坑指南和性能优化建议 + +### 🎨 现代化体验 +- **美观界面**: 精心设计的现代化文档界面 +- **直观图表**: 用图形化方式展示复杂概念,替代技术性强的代码图表 +- **响应式设计**: 支持PC、平板、手机等各种设备 +- **深色模式**: 支持明暗主题切换 + +### 📚 丰富资源 +- **模板库**: 2000+工作流模板资源 +- **视频教程**: 精选中英文视频教程合集 +- **工具推荐**: 社区节点和扩展工具 +- **参考文档**: 整理的官方和社区资源 + +## 📁 项目结构 + +``` +n8n指南/ +├── docs/ # 文档源文件 +│ ├── index.md # 首页 +│ ├── introduction/ # 引言和背景 +│ ├── installation/ # 安装配置指南 +│ ├── learning/ # 学习使用教程 +│ ├── reference/ # 参考资料 +│ ├── ai-center/ # AI卓越中心 +│ ├── assets/ # 静态资源 +│ │ ├── images/ # 图片资源 +│ │ └── pdfs/ # PDF文档 +│ └── stylesheets/ +│ └── extra.css # 自定义样式 +├── mkdocs.yml # MkDocs配置文件 +├── README.md # 项目说明文档 +└── n8n指南.md # 原始指南文档 +``` + +## 🚀 快速开始 + +### 📖 在线阅读 + +访问我们的在线文档网站,开始您的n8n学习之旅: + +``` +https://your-domain.github.io/n8n-guide +``` + +### 💻 本地部署 + +如果您希望在本地运行或贡献内容,请按以下步骤操作: + +#### 环境要求 + +- Python 3.7+ +- pip 包管理器 + +#### 安装步骤 + +1. **克隆项目** + ```bash + git clone https://github.com/your-username/n8n-guide.git + cd n8n-guide + ``` + +2. **安装依赖** + ```bash + pip install mkdocs + pip install mkdocs-material + pip install pymdown-extensions + ``` + +3. **启动开发服务器** + ```bash + mkdocs serve + ``` + +4. **访问文档** + 打开浏览器访问 `http://127.0.0.1:8000` + +#### 构建静态站点 + +```bash +mkdocs build +``` + +生成的静态文件将保存在 `site/` 目录中。 + +## 📋 学习路径 + +### 🌟 初学者路径 (1-2周) + +1. [背景介绍](docs/introduction/background.md) - 了解AI时代的机遇与挑战 +2. [快速开始](docs/installation/quick-start.md) - 云端注册体验 +3. [界面介绍](docs/installation/interface.md) - 熟悉操作界面 +4. [基本工作流](docs/learning/basic-workflows.md) - 创建第一个工作流 + +### 🛠️ 进阶用户路径 (1-2个月) + +1. [本地部署](docs/installation/local-deployment.md) - 搭建私有环境 +2. [常用节点](docs/learning/common-nodes.md) - 掌握核心功能 +3. [凭证管理](docs/installation/credentials.md) - 安全连接外部服务 +4. [模板应用](docs/learning/templates.md) - 快速复用方案 + +### 🚀 专家级路径 (3-6个月) + +1. [避坑指南](docs/learning/pitfalls.md) - 避免常见错误 +2. [MCP集成](docs/learning/mcp.md) - AI智能工作流 +3. [社区节点](docs/learning/community-nodes.md) - 扩展平台能力 +4. [自然语言编程](docs/learning/natural-language.md) - AI辅助开发 + +## 🔧 功能特性 + +### 📊 技术栈 + +- **文档框架**: MkDocs + Material主题 +- **样式增强**: 自定义CSS,现代化UI设计 +- **图表展示**: 替换技术性图表为直观可视化元素 +- **资源管理**: 支持本地图片、PDF等静态资源 + +### 🎨 界面特色 + +- **现代配色**: 青色系主色调,美观协调 +- **卡片布局**: 信息分块展示,层次清晰 +- **动画效果**: 适度的过渡动画,提升体验 +- **响应式**: 完美适配各种屏幕尺寸 + +### 📱 用户体验 + +- **快速导航**: 清晰的导航结构,快速定位内容 +- **搜索功能**: 全文搜索,快速找到需要的信息 +- **参考置顶**: 重要参考链接置于页面顶部 +- **进度跟踪**: 明确的学习路径和进度指示 + +## 🤝 贡献指南 + +我们欢迎社区贡献!您可以通过以下方式参与: + +### 📝 内容贡献 + +- **完善文档**: 改进现有内容,修正错误 +- **添加案例**: 分享实用的工作流案例 +- **翻译工作**: 帮助翻译英文资源 +- **视频制作**: 制作配套的视频教程 + +### 🐛 问题反馈 + +- **Bug报告**: 发现文档错误或链接失效 +- **功能建议**: 提出改进建议和新功能需求 +- **用户反馈**: 分享使用体验和学习心得 + +### 🛠️ 技术贡献 + +- **界面优化**: 改进文档界面和用户体验 +- **功能开发**: 增加新的文档功能 +- **性能优化**: 提升文档加载和访问性能 + +## 📞 联系我们 + +### 💬 社群交流 + +- **微信群**: 扫描二维码加入学习群 +- **QQ群**: n8n中文学习交流群 +- **邮件**: [your-email@domain.com](mailto:your-email@domain.com) + +### 🔗 相关链接 + +- **n8n官网**: [https://n8n.io](https://n8n.io) +- **官方文档**: [https://docs.n8n.io](https://docs.n8n.io) +- **中文社区**: [https://docs.n8ncn.io](https://docs.n8ncn.io) +- **GitHub项目**: [https://github.com/n8n-io/n8n](https://github.com/n8n-io/n8n) + +## 📄 版权信息 + +本项目采用 [MIT 许可证](LICENSE)。 + +### 🙏 致谢 + +感谢以下资源和社区的支持: + +- **n8n团队**: 提供优秀的自动化平台 +- **MkDocs社区**: 优秀的文档生成工具 +- **Material主题**: 美观的文档主题 +- **社区贡献者**: 分享模板和经验的社区成员 + +## 📈 项目统计 + +- **文档页面**: 20+ 详细页面 +- **学习模块**: 6大核心模块 +- **参考资源**: 100+ 精选资源链接 +- **模板库**: 2000+ 工作流模板 +- **更新频率**: 持续更新维护 + +--- + +⭐ 如果这个项目对您有帮助,请给我们一个Star! + +🔄 项目持续更新中,欢迎关注最新动态。 + +📖 开始您的n8n自动化之旅:[阅读文档](docs/index.md) diff --git a/docs/ai-center/functions.md b/docs/ai-center/functions.md new file mode 100644 index 0000000..1d5a059 --- /dev/null +++ b/docs/ai-center/functions.md @@ -0,0 +1,263 @@ +# AI卓越中心:职能与支持 + +## 📚 学习资源 + +- **官方文档**:[n8n官方文档](https://docs.n8n.io) +- **中文文档**:[n8n中文文档](https://docs.n8ncn.io) +- **快速开始**:[n8n.io](https://n8n.io) + +我们的AI卓越中心致力于为用户提供全方位的n8n技术支持和服务,助力个人和企业在自动化领域取得卓越成就。 + +## 🎯 核心职能 + +### 技术支持服务 + +
提供n8n部署、配置、优化等全方位技术支持,解决您在使用过程中遇到的各种技术问题
+为您提供项目规划、设计和实施的专业咨询,确保自动化项目的顺利进行和成功落地
+定期举办线上线下培训课程,帮助用户掌握n8n使用技巧和行业最佳实践
+维护和管理技术社区资源,促进用户交流合作,共同推动n8n生态发展
+获得专业技术支持和项目咨询,与行业专家直接对话,快速提升技能水平
+参与真实项目开发,积累宝贵实战经验,建立个人技术品牌
+分享您的经验和见解,帮助他人成长,同时建立个人影响力
+探索AI+自动化的最新技术趋势,把握行业发展机遇
+
+ 扫描二维码加入微信群
+降低团队成员的学习门槛,提高工作效率
+避免因语言理解偏差导致的配置错误
+减少语言障碍,专注于业务逻辑设计
+新用户能更快熟悉界面和功能
+可视化界面降低门槛,代码节点提供无限可能
+模板快速起步,自定义代码满足特殊需求
+标准节点覆盖常见场景,开放API支持任意集成
+${weatherData.description}
+体感温度:${weatherData.feels_like}°C
+ +
+ 更新时间:${weatherData.current_time}
+ 由 n8n 自动发送 ❤️
+
生成时间: {{$json.generated_at}}
+尊敬的 {{$json.recipient_name}},
+以下是您请求的{{$json.report_type}}报告:
+ +| 指标 | +数值 | +变化 | +
|---|---|---|
| {{this.name}} | +{{this.value}} | +{{this.change}} | +
用自然语言描述需求,AI自动生成工作流
+通过对话实时调整和优化工作流逻辑
+自动生成n8n工作流JSON和节点配置
+生成的工作流可直接导入到n8n中使用
+用自然语言描述你想要的工作流功能
+AI分析需求并理解业务逻辑
+AI自动生成相应的n8n工作流
+review生成的工作流是否符合需求
+根据反馈进行细节调整
+导出到n8n平台正式使用
+
+
+
+
+### 2.2 本地/私有化部署
+
+#### 部署方式对比
+
+1. **n8n 云服务 (Cloud Hosting) - 最快速、无需部署**
+ * **描述**:最简单快捷的入门方式,无需任何本地安装和配置。访问 https://n8n.io 注册即可开始,官方提供免费试用。
+ * **适用人群**:初学者、业务用户、希望快速验证自动化想法的用户。
+
+2. **使用 npm 安装 - 适合开发者快速本地启动**
+ * **描述**:对于熟悉 Node.js 环境的开发者,通过简单的 `npm` 命令行指令即可在本地快速启动 n8n,适合在本地进行开发、测试和调试。
+
+3. **使用 Docker 安装 - 推荐的本地或服务器部署方式**
+ * **描述**:Docker 提供容器化部署,确保环境一致性,避免复杂的依赖问题。它封装了 n8n 及其所有依赖,是本地开发和中小型项目生产部署的理想选择。
+
+4. **服务器自托管 (Self-hosting) - 灵活且注重隐私**
+ * **描述**:n8n 是一款**公平代码许可 (fair-code licensed)** 的软件,支持自托管,提供极高的**灵活性、隐私和安全性控制**。您可以在 Digital Ocean, AWS, Azure, Google Cloud 等任意云服务器上部署,并进行深度定制化配置。
+ * **适用人群**:对数据隐私、系统性能或集成有特定需求的企业和高级用户。
+ **相关教程**:
+ * 图文教程
+ https://blog.csdn.net/2501_90561511/article/details/147479401?spm=1001.2014.3001.5502
+ * 视频教程:
+ https://www.bilibili.com/video/BV1kZNrzpEy6
+
+#### Docker 部署注意事项
+
+如果选择 Docker 部署,请特别注意 `volumes` 映射配置:
+* **第一个 Volume**:用于持久化存储 n8n 的工作流、凭证等核心数据。
+ * `Host Path`:您服务器上的一个路径,例如 `/data/n8n/config`。
+ * `Container Path`:固定为 `/home/node/.n8n`。
+* **第二个 Volume**:用于 n8n 工作流读写本地文件。
+ * `Host Path`:您服务器上用于存放处理文件的路径,例如 `/data/n8n/files`。
+ * `Container Path`:在 n8n 节点中访问该文件夹的路径,例如 `/files`(请记住这个路径)。
+
+
+
+### 2.3 界面介绍
+
+n8n 的界面直观易用,主要由工作流画布、节点面板、参数配置区和执行日志等部分组成。详细介绍请参考:
+https://n8n.akashio.com/article/n8n-ui
+
+### 2.4 凭证管理 (Credentials)
+
+**凭证是 n8n 连接外部世界的“钥匙”**。它用于安全地存储和管理连接外部服务(如数据库、API、邮箱)所需的授权信息(如 API 密钥、OAuth 令牌、用户名密码等)。
+
+* **安全存储**:n8n 对凭证进行加密存储,保护您的账户安全。
+* **集中管理**:在一个地方统一创建、查看和管理所有凭证。
+* **一次配置,多次使用**:创建一次凭证后,可在多个工作流和节点中重复使用。
+* **避免硬编码**:将敏感信息与工作流逻辑分离,是更安全、更易于维护的最佳实践。
+常用凭证:
+- 大模型凭证
+- 邮箱凭证
+- 数据库凭证
+图文示例请参考:
+https://jishuzhan.net/article/1951148541186977794
+
+### 2.5 n8n 汉化
+
+在使用 Docker 部署时,可以通过添加环境变量和挂载中文语言包的方式实现界面汉化。
+
+参考:
+https://zhuanlan.zhihu.com/p/1937586953865372387
+
+
+## 3. 学习与使用
+### 3.1常用节点
+
+
+
+1. 触发 (Triggers)
+
+触发器是工作流的起点,用于在特定事件发生时启动自动化流程。
+
+• **手动触发 (Manual Trigger)**:
+
+- **功能和用法**:手动触发节点用于**用户启动的工作流**。它允许您在需要时手动运行工作流,而不是等待特定事件发生。
+
+- **配置**:作为核心节点,通常不需要复杂配置,只需在需要时点击执行即可。
+
+• **定时触发 (Schedule Trigger)**:
+
+- **功能和用法**:定时触发节点用于**基于时间的自动化任务**。您可以设置工作流在特定时间或按固定时间间隔自动运行。
+
+- **配置**:您需要配置触发的时间、频率等参数。文档中也提到了该节点可能遇到的“常见问题”。
+
+• **Webhook (Webhook)**:
+
+- **功能和用法**:Webhook 节点用于**API 触发的自动化**。它允许外部服务通过发送HTTP请求来启动n8n工作流,实现实时集成和响应。
+
+- **配置**:需要设置一个生产URL,并在您的MCP客户端中使用这个URL。文档中提到了“工作流开发”和“常见问题”。在导入工作流时,需要更新Webhook URL。
+
+• **自动化 (Automation)**:
+
+- **功能和用法**:自动化是n8n的核心能力和目标。它涵盖了**连接任何带有API的应用程序并对其数据进行操作**,以及**构建复杂的、端到端的工作流**。n8n特别适用于**批量数据处理、搬运和引入AI到现有工作流**。
+
+- **配置**:自动化是n8n平台提供的整体能力,而非单一节点。各种触发器、处理节点和逻辑节点共同实现自动化。
+
+• **邮件触发 (Email Trigger)**:
+
+- **功能和用法**:邮件触发(IMAP)节点可以根据新邮件或其他邮件事件来启动工作流。例如,可以构建工作流来**自动标记收到的Gmail邮件** 或**根据新邮件内容草拟回复**。
+
+- **配置**:需要配置IMAP相关参数,如服务器、端口、凭据等。
+
+• **对话触发 (Chat Trigger)**:
+
+- **功能和用法**:对话触发节点用于响应聊天消息来启动工作流。例如,“AI代理聊天”和“Telegram AI聊天机器人”是趋势模板,它们可能通过对话触发来接收用户输入。
+- 配置:配置聊天平台和监听的事件。
+
+2. 输入 (Input)
+
+输入节点用于从各种数据源获取信息,供工作流后续处理使用。
+
+• **读本地文件 (Read Local File)**:
+
+- **功能和用法**:允许工作流读取本地文件系统中的文件。
+
+- **配置**:使用“Read/Write Files from Disk”核心节点来指定文件路径和读取方式。
+
+• **HTTP 请求 (HTTP Request)**:
+
+- **功能和用法**:HTTP请求节点是**“半开放式节点”**,它允许n8n接入**几乎任何开放API的第三方服务**。可以用于从互联网获取数据。
+
+- **配置**:需要配置请求URL、方法(GET、POST等)、头部信息和请求体等。可以与ChatGPT结合使用来编写代码片段,帮助连接不在官方节点库中的功能。
+
+• **MySQL 获取数据 (MySQL Get Data)**:
+
+- **功能和用法**:n8n支持与MySQL数据库集成。可以用于从MySQL数据库中**查询和检索数据**。
+
+- **配置**:需要配置MySQL凭据和要执行的查询语句。例如,可以使用AI代理与PostgreSQL或MongoDB数据库进行交互,并支持自定义SQL查询和模式内省,MySQL也应有类似功能。
+
+• **RSS 网络搜索 (RSS Web Search)**:
+
+- **功能和用法**:RSS Read和RSS Feed Trigger节点用于**读取RSS订阅源**,从而获取最新的网络信息或文章更新。可以构建“基于RSS的阅读分流器” 或**监控RSS源并总结文章**。
+
+- **配置**:输入RSS订阅源URL。
+
+• **Google 表格、云盘 (Google Sheets, Google Drive)**:
+
+- **功能和用法**:n8n与Google Sheets和Google Drive有深度集成。您可以**读取、写入Google Sheets中的数据**;**访问和利用Google Drive中的文件**,例如构建AI助手来回答基于文档内容的问题。还可以监控Google Drive中的新文档,并使用AI进行总结。
+
+- **配置**:需要配置Google凭据,并指定要操作的表格或文件路径。
+
+3. 处理 (Process)
+
+处理节点用于对输入数据进行转换、分析或执行特定操作。
+
+• **AI 代理 (AI Agent)**:
+
+- **功能和用法**:AI代理节点是n8n中构建高级AI功能的核心。它将**LangChain框架可视化**,允许AI代理**发现、管理和运行工作流**。AI代理能够根据任务自动选择和执行工具(如搜索、存储)。
+
+- **配置**:AI代理节点具有子节点,允许灵活配置**模型(Model)、记忆(Memory)、工具(Tool)和输出解析器(Output Parser)**。在使用社区节点作为AI代理工具时,必须设置环境变量 `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true`。
+
+• **代码 (Code)**:
+
+- **功能和用法**:代码节点是**“半开放式节点”**,支持在服务器端运行**JavaScript和Python代码**。这使得您可以**编写自定义逻辑**或处理n8n内置节点无法直接支持的复杂任务。
+
+- **配置**:在节点内部编写JavaScript或Python代码,可以访问和处理工作流中的数据。
+
+• **编辑字段 (Edit Fields)**:
+
+- **功能和用法**:Edit Fields (Set) 节点用于**设置或修改工作流中数据项的字段值**。这类似于电子表格中查找和修改单元格的操作,AI可以通过此类节点修改数据。
+- **配置**:指定要编辑的字段名和新的值。
+
+4. 逻辑 (Logic)
+
+逻辑节点用于控制工作流的执行路径和数据流。
+
+• **If (If)**:
+
+- **功能和用法**:If 节点用于**条件判断**,根据设定的条件将工作流分支到不同的路径。
+
+- **配置**:设置条件表达式,当条件为真时执行一个分支,为假时执行另一个分支。
+
+• **循环项 (Loop Over Items)**:
+
+- **功能和用法**:Loop Over Items (Split in Batches) 节点用于**遍历数据集合**,对每个数据项执行重复操作。
+
+- **配置**:配置循环的批处理大小或遍历方式。
+
+• **切换 (Switch)**:
+
+- **功能和用法**:Switch 节点类似于多条件判断,根据输入数据的不同值将工作流路由到多个不同的分支。
+
+- **配置**:为不同的输入值设置对应的输出分支。
+
+• **合并 (Merge)**:
+
+- **功能和用法**:Merge 节点用于**合并来自不同分支的数据流**,使它们能够在一个统一的流中继续处理。
+
+- **配置**:选择合并数据的策略。
+
+5. 输出 (Output)
+
+输出节点用于将工作流处理后的结果发送到外部服务或存储。
+
+• **发送邮件 (Send Email)**:
+
+- **功能和用法**:Send Email 节点用于**发送电子邮件**。您可以配置邮件内容、收件人、主题等。
+
+- **配置**:需要配置邮件服务提供商的凭据(如Gmail、Outlook.com、Yahoo)。
+
+• **响应 Webhook (Respond to Webhook)**:
+
+- **功能和用法**:Respond to Webhook 节点用于**向发起Webhook请求的服务发送响应**。这使得n8n可以作为API的后端,对外部请求进行处理并返回数据。
+
+- **配置**:配置响应的状态码和响应体内容。
+
+• **生成文件到本地 (Generate File to Local)**:
+
+- **功能和用法**:虽然没有直接名为“生成文件到本地”的节点,但“Read/Write Files from Disk”核心节点支持**写入文件到本地磁盘**。这意味着工作流可以将处理后的数据保存为本地文件。例如,AI可以“SaveFile”将修改后的文件保存回硬盘。
+
+- **配置**:使用“Read/Write Files from Disk”节点,选择写入操作,并指定文件内容和保存路径。
+
+### 3.2基本工作流创建
+图文教程:
+https://mp.weixin.qq.com/s/oIcmTW0Gg2r63C0Tn91r2Q
+视频教程:
+https://www.bilibili.com/video/BV1nejbz6Eip/?spm_id_from=333.337.search-card.all.click&vd_source=d9f631f2aa422b95711dea08e6660a60
+
+### 3.3避坑指南
+n8n容易踩坑的环节,同事也是开发稳定性高的n8n工作流的要求。
+https://x.com/binggandata/status/1951798212995829996
+
+1️⃣97% 的 n8n 工作流缺乏异常处理, 在出错时默默失败。 建议:为每个工作流添加一个错误触发器, 并强制对关键节点(HTTP/API/DB)进行异常处理+邮件/Slack 通知。
+
+2️⃣320 个 webhooks 未进行身份验证, 152 个进程仍在使用明文 HTTP。 有些直接在节点中硬编码键。 建议:对所有 webhooks 强制执行身份验证, 全程使用 HTTPS,不要硬编码 API 密钥,定期轮换它们,并加密存储。
+
+3️⃣很多流程有无用节点、API 在循环里频繁请求、无效数据转换反复出现。 建议:能批量就批量,流程结构清晰,节点合并, 并行能并行,复杂逻辑直接用代码节点搞定。
+
+4️⃣35% 的工作流接入了 AI,但大部分没做向量数据库和缓存,token 消耗高。 建议:Prompt 要分块,简单用 GPT-3.5,复杂用 GPT-4, 批量处理+结果校验,AI 节点也要异常处理和日志监控。
+
+5️⃣74.7% 工作流分类都是 General, 文档说明严重不足,协作查错全靠猜。 建议:流程统一命名+标签, 关键节点加 Sticky Note,协作排查省大把时间。
+
+6️⃣高频套路: 数据转换(Set→HTTP)、API 链式(HTTP→HTTP)、条件分流(If/Switch→Set)、数据聚合(Set→Merge) 建议:直接套用成熟流程模板,少造轮子。
+
+7️⃣上线前安全清单: 所有 webhook 有认证、外部请求全 HTTPS、敏感数据加密、权限分层、异常信息不泄露隐私。 建议:每次上线前都照单自查一遍。
+
+8️⃣维护和优化: 慢流程拆分为子流程,API 并发要批量/加缓存,老旧节点及时清理。 建议:每月安全&性能巡检,流程有改动就同步文档。
+
+9️⃣很多流程没监控,出错没人知道,维护成本高。 建议:每个关键流程都加集中日志和监控, 记录流程名、节点、错误和时间戳,AI/长流程建议加进度日志。
+
+1️⃣0️⃣只要你把这些最佳实践都落地了: 绝大部分工作流有异常处理、webhook 全认证、HTTPS 全覆盖、无明文密钥、流程分类注释完整, 平均执行时间都能压到 10 秒以内!
+
+### 3.4进阶应用 - 模板套用
+n8n的模板套用方式非常直观
+首先在任意位置复制整段文本:
+
+
+
+在n8n任意位置粘贴:
+
+
+2000+模板
+https://github.com/enescingoz/awesome-n8n-templates ✅
+2000+模板
+https://github.com/Zie619/n8n-workflows ✅
+
+### 3.5进阶应用 - mcp
+
+模型上下文协议(MCP)定义了AI代理与外部工具的标准化通信框架,允许在不同LLM之间无缝切换工具集成逻辑。其架构包含三大组件:
+
+1. 主机(Host):承载MCP连接的LLM应用(如Claude Desktop、Cursor IDE)
+2. 客户端(Client):作为对接MCP服务器的通信端点
+3. 服务器(Server):为主机提供工具、数据或提示资源的独立服务
+
+这种架构使得n8n能以两种角色接入MCP生态:既可以将工作流作为MCP服务器对外暴露功能,也能作为客户端调用其他MCP服务器的能力。
+
+如何将整个mcp工作流部署为mcp服务
+图文教程
+https://zhuanlan.zhihu.com/p/1913630305291567877
+官网介绍:
+https://n8n.io/workflows/3770-build-your-own-n8n-workflows-mcp-server/
+
+### 3.6进阶应用 - 自然语言编程
+使用官方扩展:n8nchat
+https://n8nchat.com
+
+部署开源项目
+https://www.bilibili.com/video/BV1HuKEzDEaj/?spm_id_from=333.337.search-card.all.click&vd_source=c1396b80a656000a13265d2670a6de6e
+
+### 3.7进阶应用 - 社区节点
+ 社区节点排行榜 TOP 100
+https://github.com/restyler/awesome-n8n?tab=readme-ov-file
+点击设置
+
+
+
+点击社区节点和下载
+
+
+输入想要安装的社区节点
+
+
+## 4. 参考资料与术语表
+### 4.1 参考资料
+n8n文档
+https://docs.n8n.io
+中文文档:
+https://docs.n8ncn.io
+官方社区(模板、社区成员)
+https://community.n8n.io/
+快速开始:
+https://n8n.io/
+界面介绍
+https://n8n.akashio.com/article/n8n-ui
+教学合集:
+https://www.darrelltw.com/n8n-tutorial-resources/#templates
+零基础教程
+https://www.bilibili.com/video/BV1nejbz6Eip/?spm_id_from=333.337.search-card.all.click&vd_source=d9f631f2aa422b95711dea08e6660a60
+2000+模板
+https://github.com/enescingoz/awesome-n8n-templates
+2000+模板
+https://github.com/Zie619/n8n-workflows
+n8n踩坑环节。
+https://x.com/binggandata/status/1951798212995829996
+使用n8n自动抓取天气预报,并发送到微信
+https://zhuanlan.zhihu.com/p/629643758
+n8n+mcp+deepseek
+https://blog.csdn.net/m0_59235245/article/details/147950398)
+视频教程
+https://www.bilibili.com/video/BV11QX8YNEjU/?spm_id_from=333.337.search-card.all.click&vd_source=d9f631f2aa422b95711dea08e6660a60
+mcp节点
+https://github.com/nerding-io/n8n-nodes-mcp
+如何将整个mcp工作流部署为mcp服务
+图文教程
+https://zhuanlan.zhihu.com/p/1913630305291567877
+官网介绍:
+https://n8n.io/workflows/3770-build-your-own-n8n-workflows-mcp-server/
+n8nchat(自然语言编程)
+https://n8nchat.com
+飞书表格
+https://mp.weixin.qq.com/s/MIoNKpCSBYhhBjxCAaGSYg
+多智能体工作流
+https://mp.weixin.qq.com/s/efsB3GwZzTVH4rjW5i0iGQ
+论文自动解读知识库
+[https://mp.weixin.qq.com/s/YBoM7YkpHjsFl-hyaSsnOw
+### 4.2 术语表
+
+- **n8n**: 一个开源且公平代码许可的工作流自动化工具,允许用户通过可视化界面连接应用程序和 API,以实现数据操作和业务流程自动化。
+- **MCP (Model Context Protocol)**: 模型上下文协议,一种标准化协议,用于使 AI 模型能够与外部工具和数据源进行交互,从而扩展其能力。
+- **n8n MCP 服务器工作流模板**: 一个预构建的 n8n 工作流,用于将现有的 n8n 工作流转换为一个 MCP 服务器,使得 AI 客户端可以发现、管理和执行这些工作流。
+- **AI 代理 (AI Agent)**: 能够理解指令、规划行动、使用工具并与环境交互以实现目标的智能系统,通常由大型语言模型驱动。
+- **工作流 (Workflow)**: 在 n8n 中,由一系列相互连接的节点组成的自动化流程,用于执行特定任务或自动化业务逻辑。
+- **节点 (Node)**: n8n 工作流的基本组成单元,代表一个特定的操作或与一个应用程序的集成。
+- **MCP 触发器 (MCP Trigger)**: n8n MCP 服务器工作流模板中的一个核心节点,用于接收 MCP 客户端的请求并触发相关操作(如发现、管理或执行工作流)。
+- **“可用”工作流 (Available Workflows)**: 在 n8n MCP 服务器中,被明确允许 AI 代理访问和使用的 n8n 工作流集合,通常通过标签或其他过滤方式进行管理。
+- **Redis**: 一个开源的、内存中的数据结构存储,可用作数据库、缓存和消息代理。在 n8n MCP 服务器模板中,它被用作内存来跟踪“可用”工作流。
+- **Subworkflow 触发器 (Subworkflow Trigger)**: n8n 中的一种触发器节点,允许一个工作流作为另一个工作流的子流程被调用和执行,常用于模块化和参数传递。
+- **输入模式 (Input Schema)**: 定义工作流或节点预期接收的数据结构和数据类型,确保数据以正确的格式传入。
+- **直通方法 (Passthrough Method)**: 在 n8n 中,一种参数传递方式,表示当节点未明确设置参数时,将使用传入的数据作为默认值。
+- **API 密钥 (API Key)**: 应用程序编程接口密钥,一种用于验证用户、应用程序或服务的身份并授予其访问 API 权限的凭证。
+- **Claude Desktop**: 一种 MCP 客户端或 AI 代理,能够通过 MCP 协议与外部工具和数据源(如 n8n MCP 服务器)进行交互。
+- **LangChain**: 一个流行的开源框架,旨在帮助开发者构建由大型语言模型 (LLM) 驱动的应用程序和代理,它将 LLM 相关代码封装为可复用的组件。
+- **RAG (Retrieval-Augmented Generation)**: 检索增强生成,一种 AI 技术,通过从外部知识库中检索相关信息来增强大型语言模型的生成能力,使其能够提供更准确和实时的回答。
+- **HTTP Request**: 一种 n8n 节点,用于向任意 HTTP/HTTPS 端点发送请求,常用于与未直接集成的第三方服务进行交互。
+- **Code 节点 (Code Node)**: n8n 中的一种节点,允许用户在工作流中编写和执行自定义的 JavaScript 或 Python 代码,实现更复杂的逻辑或与特定库交互。
+- **私有部署 (Self-hosting)**: 用户在自己的服务器或基础设施上安装和运行软件,而不是使用云服务提供商提供的托管版本,通常出于隐私、安全或定制需求。
+- **低代码 (Low-code)**: 一种软件开发方法,通过最少量的手动编码实现应用程序的快速开发,通常依赖于图形用户界面和可视化工具。
+- **无代码 (No-code)**: 一种软件开发方法,允许非技术用户通过拖拽界面和预构建组件来创建应用程序和自动化流程,无需编写任何代码。
+- **Docker**: 一个用于开发、交付和运行应用程序的开源平台,通过容器化技术使应用程序及其依赖项能够打包在一起,并在任何环境中以相同方式运行。
+- **GitHub**: 一个基于 Web 的版本控制和协作平台,用于软件开发,允许开发者存储、管理和共享代码仓库。n8n 的许多工作流模板和社区节点都托管在 GitHub 上。
+
+
+## 5. n8n迷你Hackathon小组
+### 5.1 职能与支持
+- 技术支持:提供专业的技术支持,解决用户在使用n8n过程中遇到的问题。
+- 项目咨询:为用户提供项目规划、设计和实施的咨询服务,确保项目的顺利进行。
+- 培训服务:定期举办线上或线下的培训课程,帮助用户掌握n8n的使用技巧和最佳实践。
+- 社区建设:维护和管理社区资源,促进用户之间的交流与合作,共同推动n8n的发展。
+### 5.2 加入我们的方式
+扫码加入群聊:
+
diff --git a/n8n指南.pdf b/n8n指南.pdf
new file mode 100644
index 0000000..bc9b899
Binary files /dev/null and b/n8n指南.pdf differ