n8n-as-code

面向 n8n 的智能体工具包。

VS Code / Cursor 智能体 · n8n 环境管理 · n8n-manager · GitOps · AI 技能 · TypeScript 工作流

通过具备实时 n8n 上下文的智能体，在编辑器中构建、编辑、部署和调试 n8n 工作流。

文档 · 入门指南 · VS Code 使用指南 · CLI 使用指南

---

正在使用 V1 版本？ V2+ 版本引入了工作区环境（workspace environments）。请先阅读 迁移指南，并在仓库根目录下执行 n8nac workspace migrate --json，确认无误后再执行 n8nac workspace migrate --write 进行应用。V1 用户可以继续使用 legacy 分支和包：V1 分支 · CLI: npx --yes n8nac@v1 · Claude Code: /plugin marketplace add https://github.com/EtienneLescot/n8n-as-code#v1。

n8n 版本兼容性 — n8n-as-code 捆绑的节点 Schema 是基于 n8n 最新稳定版构建的。请保持您的 n8n 实例更新，以获得最佳的生成和验证效果。

独立项目 — n8n-as-code 是一个独立的社区项目，与 n8n 公司无关联，也未得到其背书或资助。

---

n8n-as-code 能为您做什么

n8n-as-code 可将代码仓库转变为一个完整的 n8n 开发工作区：

功能	说明
编辑器原生工作流开发	在 VS Code、Cursor 或终端中浏览、打开、编辑、验证及同步 n8n 工作流。
智能体就绪的上下文	生成扎实的指令、Schema、示例和节点知识，使 AI 智能体能够安全地处理真实 n8n 工作流。
GitOps 风格同步	显式拉取和推送工作流、审查 Diff、解决冲突，并将工作流源代码纳入版本控制。
TypeScript 工作流编写	将工作流转换为可读的 .workflow.ts 文件，更便于人类和智能体进行编辑。
实时 n8n 操作	验证工作流、检查凭据、运行测试、激活工作流，并基于选定的 n8n 环境检查执行结果。

该仓库用于存储工作流文件、生成的智能体上下文以及工作区安全配置。机密信息和本地运行状态将保留在本地。

快速入门

VS Code / Cursor

1. 从 VS Code Marketplace 或 Open VSX 安装扩展。
2. 打开一个文件夹或 .code-workspace。
3. 点击扩展图标，然后点击齿轮图标来配置您的工作区。
4. 创建或选择一个 n8n 环境。
5. 使用集成的 Agent Workbench 或您选择的智能体来拉取或创建工作流。

配置 UI 使用与 CLI 相同的模型：工作区环境属于仓库上下文，本地管理实例属于机器资源。

VS Code / Cursor 指南

Claude Code

/plugin marketplace add https://github.com/EtienneLescot/n8n-as-code
/plugin install n8n-as-code@n8nac-marketplace

然后询问 Claude 您需要的工作流。n8n-architect 技能会根据需要处理工作区设置、n8n 上下文、验证和同步步骤。

Claude 设置文档

通用智能体技能

从仓库的 skills 目录安装技能：

https://github.com/EtienneLescot/n8n-as-code/tree/main/skills

然后询问您的智能体您需要的工作流。该技能会提供所需的 n8n Schema、示例、验证规则和工作区命令，让智能体处理剩余工作。