EtienneLescot/n8n-as-code

解决的问题

n8n-as-code 为管理 n8n 自动化提供了一种以开发者为中心的工作流。它将 n8n 的开发从纯视觉界面转变为基于代码的环境，支持版本控制（GitOps）、环境迁移（开发 → 生产），并允许使用 AI 代理在有依据的上下文中安全地构建和编辑工作流。

如何工作

该项目将 n8n 的基于 JSON 的工作流转换为可读性强的 TypeScript 文件（.workflow.ts），便于人类和 AI 代理进行修改。它提供 CLI（n8nac）和 VS Code/Cursor 扩展，用于将这些文件与 n8n 环境同步、验证，并通过 n8n-manager 管理本地 n8n 实例。为支持 AI 代理，项目还提供“技能”层，包含节点模式、文档和验证规则，使代理能够生成准确的工作流。

适用人群

使用 n8n 并希望在首选代码编辑器中应用 GitOps、环境管理、AI 辅助开发等软件工程最佳实践的开发者和自动化工程师。

主要亮点

• GitOps 同步：显式地从版本控制中拉取和推送工作流，审查差异，解决冲突。
• TypeScript 编写：将工作流转换为 TypeScript，提升可读性和可编辑性。
• 代理就绪的上下文：提供基于事实的知识（模式、示例），使 AI 代理能够安全地生成和编辑工作流。
• 环境迁移：将工作流从一个环境（例如开发）迁移到生产环境，自动重映射凭据和引用。
• 集成工具链：包含 VS Code 扩展、CLI 工具，以及适用于 Claude Code 等代理的专用技能。