EtienneLescot/n8n-as-code

解决的问题

它将 n8n 工作流开发从纯可视化界面转变为以代码为中心、支持 AI 代理的工作空间。这使开发人员能够使用版本控制 (GitOps)，在专业 IDE 中编辑工作流，并让 AI 代理能够利用 n8n 环境的实时上下文来构建和调试工作流。

运作方式

该项目提供了一套工具，弥合了 n8n 基于 JSON 的工作流与开发者编辑器之间的差距：

• CLI 与扩展：VS Code/Cursor 扩展与 CLI (n8nac) 用于管理环境、同步编辑器与 n8n 实例之间的工作流，并处理验证。
• TypeScript 转换：将 n8n 的 JSON 工作流转换为可读的 .workflow.ts 文件，使人类与 AI 代理更容易进行修改。
• 代理技能 (Agent Skills)：提供一个包含节点架构、文档与验证规则的“技能”层，可插入 AI 代理（如 Claude Code 或 Cursor），使其能够生成有效的 n8n 工作流。
• 环境管理：管理多个 n8n 环境（例如 Dev、Prod），并支持通过 n8n-manager 进行本地托管实例管理。

适用对象

• n8n 用户：希望超越可视化编辑器来处理复杂工作流的人员。
• 开发人员：希望为自动化管线实施 GitOps 的人员。
• AI 工程师：正在构建能够自主创建或维护 n8n 工作流的代理的人员。

特色亮点

• 代理就绪上下文：为 AI 代理提供扎实的指令与架构，以确保安全运行。
• GitOps 风格同步：明确的拉取/推送工作流，支持差异审查与冲突解决。
• TypeScript 编写：能够将工作流转换为 TypeScript，以获得更好的可读性与可维护性。
• 环境升级：将工作流从一个环境移动到另一个环境的工具，同时重新映射凭证与参考。
• IDE 集成：原生支持 VS Code 与 Cursor，并集成了 Agent Workbench。