n8n 中文文档

工作流审查

提示

Feature availability 功能可用性

工作流审查可用于:

  • n8n Cloud: Enterprise
  • Self-hosted: Enterprise

工作流审查自 n8n 2.37.0 起可用。实例管理员必须在 Settings 设置 > Policies 策略 中启用此功能。

提示

Preview status 预览状态

工作流审查处于 Preview 阶段,在正式发布前可能发生变化。请避免在生产工作流中依赖此功能。

工作流审查允许团队在发布特定工作流版本前进行审批。在 Publish 发布 菜单中选择 Submit for review 提交审查,而不是直接发布,并分配审查者。批准后,n8n 会自动发布该版本。

启用此功能后,审查仍是可选的。除非该工作流已有未关闭的审查,否则你仍然可以直接发布。

n8n 不会在分配审查者或审查者请求修改时发送电子邮件或其他外部通知。请在左侧菜单中查看 Reviews 审查,了解需要你处理的请求。

审查的工作方式

审查与工作流的一个已保存版本(即固定版本)绑定。审查未关闭时,你可以继续编辑。新保存会创建更新的版本,但不会更改固定版本,除非有人将这些变更提交到审查中。

审查涵盖的内容

审查涵盖一个工作流的内容:固定保存版本中记录的节点和连接。可视化差异和审批仅适用于这些内容。

审查不涵盖工作流依赖的资源。这些资源不属于差异的一部分,不受审批限制;即使审查仍处于打开状态,只要你更改它们,变更就会立即应用到已发布的工作流:

  • Workflow settings 工作流设置,例如时区、错误工作流和执行顺序。
  • 工作流使用的 Credentials 凭据。
  • Variables 变量。
  • Data tables 数据表。
  • 工作流调用的子工作流。每个子工作流都是独立的工作流,如有需要,也有自己的审查。

审查状态

  • Waiting for review 等待审查:固定版本正在等待决定。n8n 会阻止发布。
  • Changes requested 请求修改:审查者请求更新。n8n 会继续阻止发布,直到有人提交更新版本(审查回到 Waiting for review 等待审查)并有人批准该版本。
  • Approved 已批准:审查者或管理员已批准。审查关闭,发布解除阻止。n8n 会以 requester 请求者(提交工作流进行审查的用户)的身份发布固定版本,因此发布历史和审计记录会将发布归属于请求者,而不是批准审查者。在少数情况下,n8n 无法自动发布该版本:审查会保持已批准且关闭。此时请在编辑器中使用 Publish 发布 按钮自行发布版本。
  • Closed 已关闭(未批准):当没有内容需要继续审查时,n8n 也可以在未批准的情况下关闭审查,例如工作流被删除、归档或移出项目。这些审查会显示在 Reviews 审查 > Closed 已关闭 下,而 Activity 活动 会说明审查关闭的原因。

审查打开时发布

审查打开时(Waiting for review 或 Changes requested),n8n 会阻止通过编辑器、公共 API 和 n8n MCP 服务器发布该工作流。你仍然可以取消发布工作流,但这不会关闭审查,也不会解除新版本发布的阻止。

一个工作流同时只能有一个打开的审查。审查打开期间,再次选择 Publish 发布 或 Submit for review 提交审查 不会启动新审查。请将较新的保存版本提交到现有审查中(参阅将后续变更提交到打开的审查)。

启用工作流审查

实例管理员在 Settings 设置 > Policies 策略 的 Workflow reviews 工作流审查 下,为整个实例启用工作流审查。

有关实例安全策略的更多信息,请参阅管理安全策略。

提交或更新审查

版本是待审查和发布的工作流快照。审查是围绕该版本发起的请求和讨论。两者分别命名,因此提交流程会要求填写两者的名称。

  1. 打开工作流并选择 Publish 发布(或按 Shift+P)。
  2. 选择 Submit for review 提交审查,而不是直接发布。
  3. 在第一步中,为快照输入 Version name 版本名称(必填)。你也可以选择描述版本变更。
  4. 在下一步中,输入 Review title 审查标题 并分配 Reviewer 审查者(均为必填)。你也可以选择添加 Review description 审查描述。
  5. 选择 Submit 提交。

审查者需要对该工作流拥有 workflow:read 权限,但不需要 workflow:publish 权限。

n8n 会为当前保存版本创建审查。你可以从左侧菜单的 Reviews 审查 中打开它。

将后续变更提交到打开的审查

  1. 打开工作流。
  2. 在编辑器页眉的审查状态中选择 Submit changes 提交变更。
  3. 为较新的版本输入 Version name 版本名称(必填)。你也可以选择描述版本变更。
  4. 你可以选择更新 Review description 审查描述,然后选择 Submit 提交。

n8n 会将打开的审查更新为该较新版本。如果审查处于 Changes requested 请求修改 状态,它会回到 Waiting for review 等待审查。

Review required 偏好设置

在 Publish 发布 菜单中,你可以为当前工作流打开 Review required 必须审查。打开后,选择 Publish 发布 会为你打开提交审查对话框,而不是直接发布。

浏览器会为该工作流存储此偏好。它不会保存到工作流本身,因此不会影响其他用户。打开的审查仍会阻止所有人发布,直到审查关闭。

审查提交内容

审查详情包含两个选项卡:

  • Activity 活动:描述、活动源和评论。审查关闭后评论仍会显示。在此版本中,评论不会锚定到特定节点。
  • Changes 变更:当前 Published 已发布 版本与 In review 审查中 版本之间的可视化工作流差异。差异的工作方式类似于源代码控制的工作流差异。

能够打开审查的人员可以在 Activity 活动 中发表评论,但不能作出决定。要作出决定,分配的审查者、项目管理员或实例管理员可以选择:

  • Approve 批准:关闭审查,并以请求者身份发布固定版本。
  • Request changes 请求修改:保持审查打开,以便编辑者更新工作流并重新提交。

权限

操作 可执行的人员
为实例启用或禁用工作流审查 有权访问 Settings 设置 > Policies 策略 的实例管理员
提交工作流进行审查 对该工作流拥有 workflow:publish 权限的用户
使用较新版本更新打开的审查 对该工作流拥有 workflow:publish 权限的用户
查看审查正在进行 可以打开工作流的用户,包括查看者和编辑者。除非列在下方,否则他们无法打开审查详情。
打开审查详情并显示在 Reviews 审查 中 请求者、审查作者、分配的审查者,以及项目或实例管理员。管理员可以查看所有审查。
作为审查者出现 对该工作流至少拥有 workflow:read 权限的用户
批准或请求修改 分配的审查者、项目管理员或实例管理员。除非作者同时拥有其中一个角色,否则作者不能作出决定。

requester 请求者是提交工作流进行审查的用户。Authors 作者包括请求者,以及之后向同一打开审查提交较新版本的任何人。

提示

Cancelling reviews 取消审查

目前无法取消或撤回打开的审查。n8n 计划在未来版本中添加此功能。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。