连接流版本管理把「正在编辑的草稿」与「线上运行的已发布版本」分开：保存只更新草稿，发布才生成一个不可变版本并切换到线上运行。通过本功能可以明确线上当前执行的是哪一版、查看版本演进记录，并在出问题时一键回滚到任一历史版本。核心能力：草稿与线上严格隔离、发布生成不可变版本、三个运行入口统一读生效版、版本历史可追溯、支持回滚与载入历史版本继续编辑。
准备工作#
保存草稿不再影响线上运行。请以画布顶部的版本标识判断线上实际执行的版本，不要以「已保存」判断「已上线」。
草稿与线上版本的关系#
打开连接流后，画布顶部会同时显示当前编辑状态与线上生效版本。以下为已上线流程的实际界面：| 画布顶部标识 | 含义 | 线上运行状态 |
|---|
| 正在编辑草稿 ＋ 已上线 VN | 草稿可继续编辑，线上已上线 | 按 VN 运行 |
| 正在编辑草稿 ＋ 未发布 | 该连接流从未发布过版本 | 没有生效版本 |
| 已下线 | 当前没有生效版本 | 停止运行 |
AI 连接流列表中，线上版本 列直接展示每条流程当前生效的版本号，未发布的流程显示为「未发布」：手动运行、事件触发与定时调度三个入口统一执行当前生效版本，不再读取正在编辑的草稿。保存草稿#
1
确认当前版本标识
在 集成平台 > 连接中心 > AI 连接流 打开目标连接流画布，查看画布顶部的编辑状态与线上版本，确认线上生效版本号。
2
修改并保存草稿
在画布中完成节点配置修改，点击顶部导航栏的
保存草稿。
说明：保存成功后线上运行仍执行原生效版本，画布顶部保持显示「正在编辑草稿」。
如果保存失败，请先处理报错再发布。以未保存的内容发起发布，上线内容可能与画布中看到的内容不一致。
发布连接流#
发布动作把当前草稿冻结为 一个不可变版本，并把该版本设为生效版本；已发布的版本内容不会被后续编辑改写。1
发起发布
在画布顶部导航栏点击
发布并启用。如该连接流已下线，点击
上线，进入同一套发布流程。
说明：从连接流列表发起时，点击列表行的 发布（从未发布）或 上线（已下线）。列表页发布的对象固定为该连接流最后一次已保存的草稿。
2
步骤 4：填写版本名称与版本备注
在
发布新版本 弹窗中填写
版本名称（最多 100 字）与
版本备注（最多 500 字），然后点击
确认发布。两个字段均可留空。
![发布新版本弹窗包含版本名称与版本备注两个输入项，以及取消和确认发布按钮]说明：版本号由系统按 V1、V2 的规则自增，本期不支持自定义版本号，弹窗中不提供版本号输入项。建议填写版本备注，便于回滚时判断目标版本。
3
确认发布结果
查看画布顶部版本标识，确认线上版本号已更新为本次发布的版本；打开 更多 > 历史版本，确认最新一条记录带「生效中」标识。
强制发布#
当连接流存在未调试通过的节点时，系统会先提示强制发布风险：选择继续后仍进入同一发布弹窗并生成新版本。强制发布只跳过「节点必须调试通过」这一项校验。发布失败的处理#
| 失败场景 | 处理方式 |
|---|
| 在线连接流数量超出配额 | 先下线不再使用的连接流或调整配额，再重新发布 |
| 版本生成、生效版本切换或上线状态变更任一步骤失败 | 本次发布整体不生效，线上仍保持原有版本 |
| 调试门禁未通过 | 按提示完成节点调试，或确认风险后使用强制发布 |
查看版本历史#
版本历史用于回答「谁在什么时间发布了哪一版、当前生效的是哪一版」。入口位于画布顶部的 更多 > 历史版本。1
打开版本历史
在连接流画布点击
更多，选择
历史版本，查看列表中的
版本、
命名、
备注、
发布人、
发布时间 与操作列。
| 能力 | 说明 |
|---|
| 只读查看 | 历史列表与版本内容均为只读 |
| 编辑该版本 | 任意版本（含生效版）均提供该入口，作用是把该版本内容载入草稿 |
| 回滚 | 仅非生效版本提供，生效版本不展示回滚 |
| 版本留存 | 每条连接流最多保留 20 个版本，超出后从版本号最小的历史版本开始清理 |
生效版本不参与清理。已产生的运行日志仍保留执行当时记录的版本号，不因版本被清理而改写。回滚到历史版本#
回滚把生效版本切换到选定的历史版本，运行入口立即按其执行。回滚不复制、不修改任何版本内容，也不改变当前草稿。1
回滚版本
打开 更多 > 历史版本，在目标历史版本的操作列点击 回滚。
2
确认回滚
在二次确认中核对目标版本号与提示文案，然后点击
确定。
回滚不再对目标版本做调试门禁校验。如果目标版本存在已失效的凭证或连接器引用，回滚后运行可能失败，失败原因会体现在运行日志中。
以历史版本为基础继续编辑#
历史版本不可编辑。如需在某个版本的编排内容上继续迭代，使用版本操作中的 编辑该版本，把该版本内容载入草稿，再从草稿发布为新版本。1
载入历史版本到草稿
在 更多 > 历史版本 中，对目标版本点击 编辑该版本。
2
确认覆盖草稿
如当前草稿存在未发布改动，在二次确认中核对覆盖提示后确认。
查看运行日志中的流程版本#
运行日志为每条执行记录标注本次执行使用的流程版本号，可用于复盘对齐「那次跑的是哪一版」。该字段固定为执行当时所用版本，事后发布新版本或回滚都不会改写既有日志。如果连接流从未发布却被触发，该次执行判定为失败，并在日志中明确提示，不会静默按草稿内容运行。验证结果#
1.
保存草稿后，线上运行仍执行原生效版本，连接流列表的线上版本列不变。
2.
发布后，版本历史新增一条记录，生效标识在新版本上，原生效版本仍可在历史中找到。
3.
运行日志中每条执行记录都显示本次执行使用的流程版本号；发布新版本或回滚后，既有日志内容不变。
4.
回滚后三个运行入口都按目标版本执行，且历史版本内容未被改写。
5.
使用「编辑该版本」载入某个版本到草稿后，画布草稿内容与该版本一致，线上生效版本没有变化。
常见问题#
这是版本管理的预期行为。保存只更新草稿，只有发布才会切换线上生效版本。
先确认画布顶部显示的线上版本号是否已更新为本次发布的版本，并核对连接流列表的线上版本列。如果仍指向旧版本，请重新打开历史版本核对生效标识，并重新发起发布。
版本号由系统按 V1、V2 自增，弹窗只提供版本名称与版本备注。本期不支持自定义版本号。
检查目标版本相关节点的凭证与连接器引用是否仍然有效。回滚不做调试门禁校验，因此不会阻止切换到已失效的版本；需要修复时，先发布一个可正常运行的新版本，再重新上线。
每条连接流最多保留 20 个版本，超出后从版本号最小的历史版本开始清理，生效版本不会被清理。运行日志中的流程版本字段不受清理影响。
不会。下线只停止运行并取消当前生效状态，草稿与全部历史版本保留。重新上线时按完整发布流程生成一个新版本。
停用与恢复#
如需停止某个连接流继续运行，在画布顶部点击 下线流程。下线后该连接流不再产生新的执行，草稿与历史版本保留。如需恢复运行，重新点击 上线 并按本文发布流程生成新版本。如需把线上内容退回到某个可用状态，优先使用回滚，而不是手工逐节点还原。 
