用途:面向 n8n-as-code 的全部工作,包括工作区就绪检查、环境管理、本地托管实例与隧道、工作流编写、校验、同步、推送和拉取。
主要能力:以 npx --yes n8nac 为主接口,npx --yes @n8n-as-code/n8n-manager 仅用于本地托管运行时生命周期、隧道和工作流展示命令。支持环境状态查询、环境添加与 API 密钥绑定、工作流列表、拉取、推送、校验、测试,以及基于 schema 的节点信息查询与示例搜索。
使用方式:在上下文根目录(含 n8nac-config.json、AGENTS.md、.agents/skills 及配置的 workflowsPath)先运行 npx --yes n8nac update-ai,再读 AGENTS.md,然后运行 npx --yes n8nac env status --json 解析有效环境。常用命令包括 npx --yes n8nac env add <name> --base-url <url> --workflows-path workflows/<name>、npx --yes n8nac env auth set <name> --api-key-stdin、npx --yes n8nac env use <name>、npx --yes n8nac list、npx --yes n8nac pull <workflowId>、npx --yes n8nac push <path-to-workflow.workflow.ts> --verify。修改前先拉取,修改后推送;冲突时用 npx --yes n8nac resolve <workflowId> --mode keep-current 或 keep-incoming 显式解决。
适用场景:代码优先的工作流编写与同步、离线节点知识查询、本地托管 n8n 实例管理、需要时配置原生 n8n MCP 辅助进行只读实时发现与运行时执行。
限制:不得猜测节点参数,须以 schema 输出为准;不得手写 n8nac-config.json 或密钥文件;不得在命令行内联传递密钥;推送已发布工作流在 n8n 2.x 上等同部署,需用 --draft 谨慎处理;原生 MCP 仅作补充,不作为主要编写与同步路径;Docker 不可用或命令连续失败两次应停止并报告诊断。