构建社区节点#
社区节点是托管在 npm 注册表中的 npm 包。
在构建要提交到社区节点仓库的节点时,请使用以下资源确保您的节点设置正确:
- n8n 建议使用
n8n-nodeCLI 工具 来构建和测试您的节点。特别是如果您计划提交节点供 n8n 验证,这一点尤其重要。这确保您的节点具有正确的结构并遵循社区节点要求。它还简化了代码检查和测试。 - 查看 n8n 自己的节点 以获取可在您的节点中使用的模式示例。
- 参考关于构建您自己的节点的文档。
- 确保您的节点遵循社区节点的标准。
Standards 标准#
使用 n8n-node 工具 进行开发确保您的节点遵循以下标准,这些标准是使您的节点在 n8n 社区节点仓库中可用所必需的:
- 确保包名以
n8n-nodes-或@<scope>/n8n-nodes-开头。例如,n8n-nodes-weather或@weatherPlugins/n8n-nodes-weather。 - 在您的包关键字中包含
n8n-community-node-package。 - 确保将您的节点和凭据添加到
package.json文件中的n8n属性内。 - 使用代码检查器(
npm run lint)检查您的节点并在本地测试(npm run dev)以确保其正常工作。 - 将包提交到 npm 注册表。有关更多信息,请参考 npm 关于向注册表贡献包的文档。
Submit your node for verification by n8n 提交你的节点供 n8n 验证#
n8n 审核已验证的社区节点。用户可以从 n8n 的节点面板中发现和安装已验证的社区节点。这些节点需要遵守某些技术和 UX 标准和约束。
在提交你的节点供 n8n 审核之前,你必须:
- 从
n8n-node工具生成的脚手架开始。虽然这不是严格要求的,但 n8n 强烈建议对你计划提交验证的任何社区节点使用n8n-nodeCLI 工具。使用该工具可确保你的节点遵循预期的约定并符合社区节点要求。 - 确保你的节点遵循已验证社区节点的技术指南,并且所有自动检查都通过。具体来说,已验证的社区节点不允许使用任何运行时依赖项。
- 确保你的节点遵循 UX 指南。
- 确保节点具有适当的文档,以 npm 包中的 README 或相关公共仓库的形式。
- 将你的节点提交到 npm,因为 n8n 将从那里获取它进行最终审核。
Ready to submit? 准备提交?#
如果你的节点满足上述所有要求,请注册或登录 n8n Creator Portal 并提交你的节点进行验证。请注意,n8n 保留拒绝与 n8n 任何付费功能(尤其是企业功能)竞争的节点的权利。