离线开发任务版本管理

更新时间：2026-06-03 18:11:03

概述

离线开发任务版本管理为任务编辑过程新增草稿态与发布态的版本记录能力。用户在保存任务时，可以选择「保存为草稿」或「发布」，系统会保留对应的历史版本，并支持查看历史版本、切换到指定版本继续编辑，以及在运行、迁移、监控等场景中按版本状态执行相应逻辑。

业务价值

该功能用于解决修改同一任务时，后一次提交直接覆盖前一次修改，无法追溯历史版本的问题。通过保留草稿版本和发布版本，团队可以更清晰地追踪变更、快速定位问题版本，并在新版本出现异常时及时恢复到稳定版本，降低故障恢复时间和数据污染风险。

适用场景

该功能适用于离线开发任务的日常迭代、多人协同开发、问题排查、历史变更追溯、任务迁移以及上线后版本回退等场景，尤其适合需要频繁调整处理逻辑和稳定发布的任务。

前提条件

使用本功能前，请确认以下条件已满足：

1. 当前账号具备离线开发任务的查看和编辑权限。
2. 需要发布任务时，任务中不存在配置异常节点。
3. 需要引用子任务时，仅可选择存在发布态版本的子任务。

配置异常节点是指缺少必填项，或当前所有者对相关资源无权限的节点。存在配置异常节点时，任务可以运行、取消或保存为草稿，但不能发布。

页面功能变化

本章节说明离线开发任务编辑页新增的操作项，以及各操作项在不同状态下的可用规则。

入口说明

在「离线开发任务」页面，点击「创建离线开发任务」新建任务，或在任务列表中点击目标任务进入编辑页。

编辑页按钮说明

进入离线开发任务编辑页后，原有的「保存」「取消」功能调整为以下操作：

按钮	说明
运行	运行当前任务的草稿态或者发布态版本。
取消	退出当前编辑页，返回任务列表。
保存为草稿	保存当前任务定义为草稿态版本。
发布	保存当前任务定义为发布态版本，并保留在当前页面。
发布并退出	保存当前任务定义为发布态版本，并返回任务列表。
查看历史版本	查看任务的历史版本，并切换到指定版本。
当前版本	展示当前页面对应的版本状态和版本信息。

按钮生效规则

不同编辑状态下，按钮的可用范围不同。

1. 当画布中没有任何节点时，仅「取消」按钮生效，其余按钮置灰并提示「至少需要一个节点」。
2. 当画布中已添加节点，但存在配置异常节点时，「运行」「取消」「保存为草稿」按钮生效；「发布」「发布并退出」按钮置灰并提示「存在配置异常节点」。
3. 当所有节点均配置完成时，「运行」「取消」「保存为草稿」「发布」「发布并退出」按钮均可使用。
4. 当任务包含「子任务」节点时，仅可选择存在发布态版本的子任务；父任务被触发调度时，使用子任务的发布态版本。

保存草稿与发布

本章节介绍如何保存草稿版本和发布版本，以及保存后系统的状态变化。

入口说明

在「离线开发任务编辑」页面完成任务编排后，可通过页面顶部操作按钮保存当前版本。

保存为草稿

保存为草稿用于记录当前编辑进度，不影响已有发布版本的使用状态。

1. 在「离线开发任务编辑」页面，点击「保存为草稿」按钮。
2. 系统保存当前任务定义，并继续停留在当前页面。
3. 历史版本中覆盖最新草稿态版本，同时更新草稿态保存时间。
4. 当任务仅存在草稿版本、尚无发布版本时，任务列表显示「仅存在草稿」标识。
5. 当任务仅存在草稿版本时，不支持配置调度，「调度开关」和「URL 触发开关」失效，并提示「仅支持调度发布态任务」。

仅存在草稿版本的任务仍可继续编辑和手动运行，但不能作为调度任务正式执行。

发布

发布用于生成可被调度、迁移和稳定复用的正式版本。

1. 在「离线开发任务编辑」页面，确认所有节点已配置完成。
2. 点击「发布」按钮。
3. 系统新增一条发布态版本记录，并通过保存时间区分不同发布版本。
4. 页面继续停留在当前编辑页，版本状态更新为「当前版本 XXX」。

发布并退出

发布并退出适用于完成配置后直接返回任务列表的场景。

1. 在「离线开发任务编辑」页面，点击「发布并退出」按钮。
2. 系统新增一条发布态版本记录，并通过保存时间区分不同发布版本。
3. 系统返回「离线开发任务列表」页面。

运行任务

本章节介绍手动运行离线开发任务时，系统如何识别草稿版本、发布版本，以及在任务有变更时如何提示保存。

入口说明

可在「离线开发任务编辑」页面点击「运行」按钮，也可在「离线开发任务列表」页面直接运行任务。

在编辑页运行任务

1. 在「离线开发任务编辑」页面，点击「运行」按钮。
2. 若任务定义未发生更改，系统按当前手动运行逻辑执行，并提示「最新版本为草稿态」或「最新版本为发布态」。

1. 若任务定义已发生更改，系统弹出提示「运行前需保存任务，是否保存？」。

1. 在提示弹窗中，根据需要选择以下操作：

操作项	说明
取消	关闭弹窗，不执行运行。
保存为草稿并运行	保存当前草稿版本后运行，版本状态更新为「更新为最新版本 XXX」。
发布并运行	发布当前版本后运行，版本状态更新为「当前版本 XXX」。

1. 当任务存在未配置项时，「发布并运行」按钮置灰，不允许选择。

在列表页运行任务

1. 在「离线开发任务列表」页面，找到目标任务并执行运行操作。
2. 系统运行该任务的最新版本。
3. 运行时，系统提示当前运行版本为草稿态还是发布态。

调度任务和 URL 触发任务始终以发布态版本执行。列表页手动运行则以任务最新版本为准。

查看历史版本与切换版本

本章节介绍如何查看离线开发任务的历史版本，以及如何切换到某个历史版本继续编辑。

入口说明

在「离线开发任务编辑」页面，点击「查看历史版本」按钮。

查看历史版本

1. 在「离线开发任务编辑」页面，点击「查看历史版本」按钮。
2. 系统默认展示最新版本的任务画布。
3. 当前仅展示各节点的分布情况，不支持直接编辑。

切换到历史版本

1. 在「历史版本」列表中，选择目标版本。
2. 切换后返回任务画布页面。
3. 画布中的节点配置更新为所选历史版本的配置。
4. 页面中的版本状态更新为「当前版本 XXX」。

切换历史版本后，系统会将该版本内容加载到当前编辑上下文中，便于继续修改或重新发布。

回滚与恢复使用建议

本章节用于说明版本回滚的典型使用方式，帮助用户在任务异常时更快恢复稳定版本。

回滚建议

当最新修改导致任务运行失败、结果异常或需要快速恢复稳定逻辑时，可通过切换历史版本并重新发布的方式完成版本回滚。

1. 在「离线开发任务编辑」页面，点击「查看历史版本」。
2. 选择最近一次稳定可用的历史版本。
3. 返回画布后，确认节点结构与预期一致。
4. 点击「发布」或「发布并退出」，将该稳定版本重新设为最新发布版本。

列表页与周边功能影响

本章节汇总离线开发任务列表页及相关功能在引入版本管理后的变化，便于快速理解各操作默认基于哪个版本生效。

列表页操作规则

以下能力在任务列表页中与版本状态的关系如下：

功能	版本规则
编辑	进入编辑页后，遵循版本管理相关规则。
运行	运行最新版本，并提示当前版本为草稿态还是发布态。
重命名	不变更任何版本。
查看资源血缘	按发布态版本查看。
查看实例	不受版本管理影响。
所有者转移	不受版本管理影响。
另存为	以发布态版本为准，另存为后的副本为草稿态。
移动至	不受版本管理影响。
删除	不受版本管理影响。
跨环境迁移	以发布态版本为准；仅存在草稿态的任务不支持迁移。
管理后台转移权限	不受版本管理影响。
访问者查看任务	以最新版本为准，可查看历史版本，但不支持切换到某个历史版本。

不再透出的能力

新建任务且仅存在草稿态时，以下能力不透出：

1. 「另存为」。
2. 「资源血缘」。
3. 「访问者权限管理」。
4. 「协作者权限管理」。

跨环境迁移规则

本章节介绍离线开发任务在跨环境迁移时，系统如何根据任务版本状态决定是否支持迁移，以及迁移后的落地结果。

迁移规则

1. 仅存在草稿态的离线开发任务不支持迁移。
2. 存在发布态的离线开发任务支持迁移，迁移内容为最新发布态版本。
3. 当目标环境不存在相同 ID 的离线开发任务时，系统新建离线开发任务，并以草稿态保存迁移内容。
4. 当目标环境已存在相同 ID 的离线开发任务时：

场景	处理结果
目标任务已有草稿态	覆盖目标任务的草稿态版本。
目标任务无草稿态	新增一条草稿态版本。

跨环境迁移的落地结果始终为目标环境中的草稿态版本，便于迁移后再次确认和调整。

管理与监控

本章节介绍管理中心和任务监控中与版本管理相关的新增能力，帮助管理员和运维人员追踪版本使用情况。

管理中心配置

管理中心新增历史版本数量限制配置，用于控制单个离线开发任务可保留的历史版本数。

1. 在管理中心进入离线开发任务相关配置页面。
2. 找到「离线开发历史版本个数限制」配置项。
3. 按需设置保留数量，取值范围为 1 到 100。

任务监控

任务监控中的实例详情新增版本信息展示，用于识别当前实例对应的任务版本。

1. 在「任务监控」页面，进入目标实例详情。
2. 查看新增的版本信息字段，确认本次运行对应的版本状态和版本内容。

注意事项/常见问题

本章节汇总使用版本管理时需要重点关注的限制和排查建议。

注意事项

• 仅当任务至少包含一个节点时，才可执行运行、保存或发布操作。
• 存在配置异常节点时，任务不能发布，也不能执行「发布并退出」或「发布并运行」。
• 子任务节点仅可选择存在发布态版本的子任务。
• 调度任务和 URL 触发任务始终运行发布态版本。
• 仅存在草稿态的任务会显示「仅存在草稿」标识，且不能开启调度或 URL 触发。
• 历史版本页面当前仅支持查看节点分布，不支持查看节点详细配置，也不支持直接进入数据流。
• 访问者可以查看历史版本，但不能切换为某个历史版本。

常见问题

• 问题：为什么任务已经添加节点，但仍不能发布？
  解决方案：请检查是否存在配置异常节点，例如缺少必填项，或当前所有者对相关资源无权限。异常未处理前，任务只能保存为草稿。
• 问题：为什么「发布并运行」按钮不可用？
  解决方案：当前任务存在未配置项。请先补齐节点配置，再重新执行发布并运行。
• 问题：为什么任务可以手动运行，但不能开启调度？
  解决方案：该任务当前仅存在草稿态版本。请先发布任务，再开启调度或 URL 触发。
• 问题：为什么跨环境迁移时看不到某些任务？
  解决方案：仅存在草稿态的离线开发任务不支持迁移。请先为任务生成发布态版本。
• 问题：为什么查看历史版本后不能直接修改节点配置？
  解决方案：历史版本页面当前仅用于查看节点分布和切换版本，暂不支持在历史版本视图中直接编辑节点配置。

术语解释

在使用本功能前，建议了解以下术语。

术语	解释
草稿态版本	用户通过「保存为草稿」生成的版本，用于记录当前编辑进度，不直接用于调度。
发布态版本	用户通过「发布」或「发布并退出」生成的正式版本，可用于调度、迁移和稳定运行。
历史版本	系统保留的任务版本记录，可用于查看、切换和恢复。
配置异常节点	存在缺少必填项，或所有者无权限等问题的节点。