离线开发任务版本管理

更新时间：2026-09-16 14:18:49

概述

离线开发任务支持草稿版本和发布版本。编辑任务时，可以将未完成的配置保存为草稿，也可以发布为用于正式调度的版本。系统会保留历史版本，便于查看变更、恢复稳定配置和排查运行问题。

两种版本的主要区别如下：

版本类型	版本说明	使用限制
草稿版本	保存当前编辑进度，可以继续修改和手动运行	不能用于调度、URL 触发或跨环境迁移
发布版本	保存经过确认的正式配置	可用于调度、URL 触发和跨环境迁移

业务价值

版本管理会保留离线开发任务的草稿版本、发布版本和历史版本，避免后续修改直接覆盖已有配置。用户可以追踪任务变更，并在新版本出现异常时恢复至稳定版本，降低问题排查和任务恢复成本。

适用场景

版本管理适用于以下场景：

• 任务配置尚未完成，需要暂存后继续编辑或验证。
• 任务经过确认，需要发布并用于正式调度。
• 多人协作修改任务，需要追踪历史变更。
• 新版本运行异常，需要恢复至稳定版本。
• 需要将任务的发布版本迁移至其他环境。

前提条件

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

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

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

保存和发布任务

进入编辑页

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

操作说明

离线开发任务编辑页提供以下版本相关操作：

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

操作可用规则

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

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

保存为草稿

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

1. 在任务编辑页点击「保存为草稿」。

2. 系统保存当前任务定义，并继续停留在当前页面。

3. 历史版本中覆盖最新草稿版本，同时更新草稿版本保存时间。

4. 当任务仅存在草稿版本、尚无发布版本时，任务列表显示「仅存在草稿」标识。

   

5. 当任务仅存在草稿版本时，不支持配置调度，「调度开关」和「URL 触发开关」失效，并提示「仅支持调度发布态任务」。

发布

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

1. 在任务编辑页确认所有节点均已配置完成。
2. 点击「发布」。
3. 系统新增一条发布版本记录，并通过保存时间区分不同发布版本。
4. 页面继续停留在当前编辑页，并显示新生成的版本编号。

发布并退出

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

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

发布运行并退出

需要在发布后立即运行任务时，通过「发布」右侧的下拉菜单选择「发布运行并退出」。系统生成发布版本、运行任务，然后返回任务列表。

运行任务

可在任务编辑页点击「运行」，也可在任务列表中运行目标任务。不同入口对应的版本规则如下。

在编辑页运行任务

1. 在任务编辑页点击「运行」。

2. 若任务配置未发生更改，系统运行当前版本，并提示最新版本为草稿版本或发布版本。

   
   

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

   

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

操作项	说明
取消	关闭弹窗，不执行运行。
保存为草稿并运行	保存并运行当前草稿版本。
发布并运行	生成发布版本并运行。

1. 当任务存在未配置项时，「发布并运行」不可用。需完成配置后再发布并运行。

在列表页运行任务

1. 在任务列表中找到目标任务，点击「运行」。
2. 系统运行该任务的最新版本。
3. 运行时，系统提示当前运行版本为草稿版本还是发布版本。

说明

调度任务和 URL 触发任务始终运行最新发布版本；从任务列表手动运行时，系统运行任务的最新版本。

查看与恢复历史版本

查看历史版本

1. 在任务编辑页点击「查看历史版本」。
2. 系统默认展示最新版本的任务画布。
3. 选择需要查看的历史版本。历史版本页面仅展示节点分布，不支持直接编辑节点配置。

切换到历史版本

1. 在「历史版本」列表中，选择目标版本。
2. 切换后返回任务画布。画布中的节点配置将更新为所选版本的配置。
3. 确认配置后，可以继续修改或重新发布。

恢复稳定版本

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

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

其他功能的版本规则

列表页操作规则

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

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

仅有草稿版本时的限制

新建任务且仅存在草稿版本时，不显示以下功能：

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

跨环境迁移规则

迁移规则

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

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

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

管理与监控

管理中心配置

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

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

任务监控

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

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

使用限制与常见问题

注意事项

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

常见问题

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