n8n Master

核心功能

n8n Master 是一款面向 n8n 工作流自动化的专业级技能，覆盖从概念解释到生产部署的全链路支持。其核心能力包括：

1. 概念与调试支持：通过结构化知识库索引（Concepts/Nodes/APIs/Recipes/QAs/Sources）快速定位问题，提供基于官方文档的准确解答，明确区分确认事实与合理推断。

2. 节点配置生成：

• HTTP Request 节点：输出完整配置模板，包含方法、URL、认证、请求头、查询参数、请求体、响应路径解析及常见故障排查
• Code 节点：生成符合 n8n 规范的 JavaScript 代码，正确处理 items 数组结构，支持 "Run Once for All Items" 和 "Run Once for Each Item" 模式

3. 工作流 JSON 输出：按标准模板生成可直接导入 n8n 的完整工作流文件，自动设置 active: false，使用凭证占位符并提示绑定要求。

4. API 集成与测试：集成 toolbox 脚本实现轻量级 API 测试（api_tester.py）、飞书多维表格操作，支持从真实请求反推 n8n HTTP 节点配置。

5. 生产加固：针对可靠性需求提供 dedup 键、幂等写入、运行 ID 追踪、指数退避重试、失败通知、人工审核队列等 hardened 模式。

6. 文档编译：通过 AI 文档编译器将原始文档转化为结构化知识卡片，维护索引与编译日志。

显著优势

• 来源可信：严格依赖本地引用和官方源文件，拒绝编造参数；冲突时明确标注而非掩饰
• 安全优先：内置多层安全规则——禁止输出真实令牌、强制 dry-run 模式、环境变量隔离敏感信息
• 实用导向：所有输出保持 copy-paste 可用性，避免冗长教程
• 生产就绪：区分原型开发与生产 hardened 两种模式，主动提示风险点

局限性与注意事项

• 不替代 n8n 官方文档，复杂场景需查阅最新版本说明
• Toolbox 脚本需显式调用，非自动执行
• 凭证管理需用户手动完成，无法自动绑定
• 飞书/Firecrawl 等第三方集成依赖环境变量预配置

适用人群

• n8n 初学者：快速理解节点行为与表达式机制
• 自动化工程师：构建复杂 API 集成与数据处理管道
• DevOps/SRE：实施生产级工作流的可靠性加固与可观测性
• 技术负责人：评估自动化方案的可行性与风险

风险提示

• 涉及写操作、批量更新、客户/财务数据时，工具默认 dry-run，需显式确认后方可执行
• 网络请求可能受代理环境、API 限流、认证过期等因素影响
• 代码节点中的自定义 JavaScript 需自行测试边界条件

核心用法

n8n-master 是一款专为 n8n 自动化平台打造的智能技能助手。它通过结构化的本地知识库（wiki cards + source docs）提供精准的 n8n 技术支持，主要功能覆盖六大场景：概念解答与调试指导、HTTP Request 节点配置（含认证、参数、响应路径）、Code 节点 JavaScript 编写（遵循 n8n items 返回规范）、完整工作流 JSON 生成（可直接导入 n8n）、生产环境加固建议（重试、幂等、人工审核队列），以及外部 API 集成测试（Feishu、Firecrawl 等）。

用户提问时，技能会按优先级检索本地索引：概念查 ALL-Concepts.md、节点查 ALL-Nodes.md、外部 API 查 ALL-APIs.md、模式查 ALL-Recipes.md，必要时使用 rg 搜索原始文档，确保答案有据可查，不臆造参数。

显著优点

知识体系完备：内置 105 个 Markdown 文档的 n8n 官方知识库，涵盖节点、概念、API、配方等，避免 LLM 幻觉。
输出即生产就绪：HTTP 请求、Code 节点、工作流 JSON 均按 n8n 规范生成，带凭证占位符和导入说明，复制即用。
安全意识突出：所有模板强制脱敏，禁止硬编码密钥；支持 dry-run 模式；生产加固配方内置幂等、去重、失败通知机制。
零第三方依赖：Python 工具箱仅用标准库，消除供应链攻击面。
透明可追溯：每个回答标注源文件路径，区分确认事实与推理，便于审计。

潜在缺点与局限性

来源可信度受限：维护者为个人开发者（T3），无公开 GitHub 仓库，用户难以验证项目历史与作者信誉。
外部 API 依赖：Feishu、Firecrawl 等工具需网络连通，且受目标平台稳定性与限流策略影响。
知识更新滞后：本地 wiki 为静态快照，若 n8n 版本迭代快，可能存在文档过时风险，需手动触发文档编译流程更新。
功能边界明确：拒绝回答超出 n8n 范畴的通用编程问题，对非技术用户有一定上手门槛。

适合的目标群体

• n8n 初学者：需要结构化学习节点用法、表达式语法、调试技巧。
• 自动化工程师：快速生成可导入的复杂工作流，关注生产可靠性。
• 系统集成开发者：需要对接 Feishu、Firecrawl 等外部 API，获取认证与请求模板。
• 运维/ DevOps：寻求重试策略、幂等设计、失败通知等生产加固方案。

常规使用风险

网络与性能：外部 API 调用存在超时（默认 30-60 秒）与临时故障风险，建议用户自行实现重试退避。
凭证管理：依赖用户正确设置环境变量，共享环境或日志配置不当可能导致凭证泄露。
SSRF 与输入风险：虽工具箱有基础验证，但用户仍应避免传入不可信 URL 或路径。
写操作不可逆：Feishu 字段创建等写操作默认 dry-run，用户需显式确认 --execute，误操作可能导致数据变更。