历史版本
大约 4 分钟scenefeature
概念说明
场景联动的历史版本管理功能，记录了场景每次发布上线的完整配置信息。每次点击【发布上线】都会生成一个新版本，包含版本号、版本描述、发布时间等信息。历史版本支持查看、回退等操作，确保场景配置的可追溯性和可恢复性。
版本管理的主要用处在于：
- 可追溯性：通过版本历史记录，可以清晰地追溯场景配置的变更过程，有助于问题排查和决策支持。
- 可重复性：在需要时，可以根据历史版本将场景恢复到某一特定版本，确保在不同情况下能够复现相同的结果。
- 风险控制：通过保留历史版本，可以降低因配置变更失败导致的风险，随时回退到上一个稳定版本。
- 配置对比：可以对比不同版本之间的配置差异，了解每次变更的具体内容。
一、查看历史版本
1.1 访问历史版本列表
- 在场景草稿编辑页面，点击右上角的【历史版本】按钮（时钟图标）。
- 在下拉菜单中，会显示该场景的所有历史版本记录。
- 每个版本记录包含以下信息：
- 版本描述：发布时填写的备注信息（如果未填写则显示"未命名版本"）
- 版本状态：
- 当前：正在预览的版本（仅快照模式下显示）
- 启用：当前线上运行的版本（最新发布的版本）
- 历史：之前发布的历史版本
- 版本号：自动生成的版本号（如 v1、v2、v3...）
- 发布时间：版本发布的日期和时间
1.2 版本排序
历史版本列表按照发布时间倒序排列，最新发布的版本排在最前面。
二、预览历史版本
2.1 切换到历史版本
- 在历史版本下拉菜单中，点击某个历史版本记录。
- 系统会自动切换到【快照模式】，加载该版本的配置数据。
- 页面顶部会显示提示信息，例如：
您正在预览历史版本 v1 (2024-01-01 10:00:00)，所有内容为只读状态。可选择 返回草稿 或 回退版本
2.2 快照模式特点
进入快照模式后：
- 页面右上角的【发布上线】按钮会变成【回退版本】按钮（红色）
- 所有配置项均为只读状态，无法编辑
- 可以查看该版本的完整配置（触发器、执行器等）
- 可以切换不同的执行器标签页查看各个执行器的配置
三、版本回退
3.1 回退到历史版本
- 在快照模式下，点击右上角的【回退版本】按钮。
- 系统会弹出确认对话框：
即将覆盖现有草稿数据，是否回退到此版本?
- 点击【确定】按钮，系统会执行以下操作：
- 将选中的历史版本配置恢复到草稿区域
- 覆盖当前的草稿数据
- 自动退出快照模式，返回草稿编辑模式
- 回退成功后，需要点击【发布上线】才能将回退后的配置应用到线上。
注意
- 版本回退会覆盖当前的草稿数据，无法撤销
- 回退后需要重新发布上线，配置才会生效
- 建议在回退前先将当前草稿导出备份
3.2 返回草稿编辑
在快照模式下，可以通过以下方式返回草稿编辑模式：
- 点击【回退版本】按钮旁的下拉菜单，选择【返回草稿】。
- 或者点击提示信息中的【返回草稿】链接。
- 系统会退出快照模式，返回到当前草稿编辑状态。
四、版本历史记录
4.1 版本历史信息
每个历史版本记录包含以下详细信息：
- 版本ID：版本的唯一标识符（系统自动生成）
- 版本号：版本的序号（v1、v2、v3...）
- 版本描述：发布时填写的备注信息
- 发布时间：版本发布的完整日期和时间
- 发布人：发布该版本的用户（如果有记录）
- 数据状态：publish（已发布）或 draft（草稿）
4.2 版本数据存储
- 每个版本的配置数据都会完整保存，包括触发器配置和执行器配置
- 版本数据以快照形式存储，不会因为后续修改而改变
- 版本数据支持导出为JSON文件，便于备份和迁移
版本数据结构
版本快照包含两个主要部分：
- profile：版本元数据（版本号、版本描述、发布时间等）
- scene：场景配置数据（触发器配置、执行器配置等）