用途:为在 n8n 仓库中开发提供快速参考,提醒关键编码约定,完整文档见 /AGENTS.md 及 /packages/frontend/AGENTS.md。
主要约定:TypeScript 禁用 any 改用 unknown,优先 satisfies 而非 as(测试除外),共享类型放 @n8n/api-types;错误处理使用 n8n-workflow 的 UnexpectedError,不使用已弃用的 ApplicationError;前端采用 Vue 3 Composition API,CSS 变量代替硬编码 px,文本走 i18n $t('key'),E2E 使用单一无空格的 data-testid;后端遵循 Controller → Service → Repository,依赖注入用 @n8n/di,配置用 @n8n/config,校验用 Zod;测试用 Vitest(单元)与 Playwright(E2E)。
用法:常用命令包括 pnpm build > build.log 2>&1、pnpm typecheck、pnpm lint;测试在包目录执行,如 pushd packages/cli && pnpm test。关键包有 packages/cli、packages/frontend/editor-ui、packages/@n8n/api-types、packages/@n8n/db、packages/workflow。
限制:应用数据库仅支持 SQLite/PostgreSQL,数据库节点可例外使用特定功能;更多细节需查阅上述 AGENTS.md 文档。资料未提供版本、安装命令与收费信息。