发布 Duaer 社区节点

包的要求

• 包名以 n8n-nodes- 或 @<scope>/n8n-nodes- 开头。Duaer 拒绝安装其他名字的社区包。
• package.json 的 n8n 字段列出所有节点和凭证。
• npm run lint 通过，并在 Duaer 里试过。
• npm 包或公开仓库里有 README，说明凭证和每个操作。

带 provenance 发布到 npm

从 2026 年 5 月 1 日起，Duaer 要求社区包带 npm provenance。Duaer 的社区包扫描会判定没有 provenance 的版本不通过。provenance 由 GitHub Actions 签名，证明这个版本是哪个仓库、哪次提交构建的。从本机直接发布不带 provenance。

1. 第一次发布前，在 npmjs.com 的包设置里打开 Trusted Publishers，添加 GitHub Actions：填仓库所有者、仓库名和工作流文件名 publish.yml。不用长期令牌。
2. 运行下面第一条命令，生成发布工作流。用 npm create 生成的新项目已经带有它。
3. 运行 npm run release：升级版本号、提交、打标签并推送。标签触发 GitHub Actions 发布到 npm。

npx n8n-node release --init-workflow   # once: adds .github/workflows/publish.yml
npm run release                          # bump, tag, push; GitHub Actions publishes

不能用 Trusted Publishers 时，在仓库的 Actions 密钥里保存 NPM_TOKEN，工作流会改用它。

在 Duaer 里安装

1. 以 Duaer 实例所有者或管理员身份打开设置 › Community nodes。
2. 输入包名并确认风险提示。
3. 安装完成后，在节点面板里搜索新节点。

安装前请读 社区节点的风险。