版本管理
版本管理专业版+在 NocoBase 中,版本管理(Version control) 用来给当前应用保存一份可回退的版本。你可以手动创建版本,在需要时恢复到某个已保存的状态;也可以让 AI 搭建在完成阶段性成果后自动保存版本。
版本管理依赖 备份管理 提供保存和恢复能力。使用版本管理前,需要先启用备份管理。
社区版和标准版不包含版本管理插件。如果需要保存可回退的应用状态,可以使用 备份管理:在关键变更前手动创建备份,需要回退时再还原对应备份。
AI 自动保存版本
启用版本管理插件后,AI 搭建会多一层回退保障。AI Agent 开始处理需求时,会检查当前应用可用的 NocoBase Skills; 如果识别到 nocobase-revision skill,后续就可以把关键搭建节点保存为可恢复版本。

当 AI 完成一段可以独立确认的成果后,比如搭好一个页面、创建一组数据表,或者配置完一条工作流,它会通过 NocoBase CLI 执行 nb revision create。你不需要频繁手动点击「创建版本」,也不用担心每个细小调整都生成一条版本记录。

这些版本会出现在版本列表中。后续如果配置不符合预期,可以恢复到上一个清晰的搭建节点,再继续让 AI 调整。
进入插件
启用插件后,顶部导航栏会出现「版本管理」菜单。你可以在这里直接创建版本,也可以进入版本列表。
另外,你也可以从「系统设置 / 版本管理」进入插件页面。创建版本的默认快捷键是 Ctrl + K,可以在设置页里修改。

创建版本
点击「创建版本」,输入一段描述后保存即可。描述最多 2000 个字符,适合记录这次版本对应的变更背景,比如“调整审批流程字段和权限”。

点击保存后,列表里会先出现一条「保存中」的记录。保存完成后,版本会显示在列表里。
几个要点:
- 版本名由系统自动生成,不需要手动填写
- 从顶部导航按钮、快捷键和列表页按钮创建,效果完全一样
- 列表会显示版本名、描述、文件大小、创建时间、创建人,以及后续操作
管理与恢复版本
版本列表页主要有这几类操作:
- 「刷新」:重新加载当前版本列表
- 「删除」:删除单个版本,或勾选多条后批量删除
- 「恢复」:把当前应用恢复到该版本保存时的状态
恢复版本会覆盖当前应用当前的配置状态,以及该版本中包含的数据内容。恢复前,建议先创建一个当前版本,方便你随时回退。
点击「恢复」后,应用会短暂进入维护状态并执行恢复。恢复完成前,不要重复提交恢复操作。如果恢复失败,界面会显示错误通知。
设置版本策略
切换到「设置」标签页后,你可以控制版本保留和版本内容范围。

设置项包括:
Versions to keep:保留的版本数量上限。超过上限后,较早的版本会自动删除Shortcut: create version:创建版本的快捷键。按Ctrl + 字母键设置,按Backspace清除User collections:选择哪些用户创建的数据表需要跟着版本一起保存
默认情况下,版本不会包含你自 己创建的数据表内容。只有当你希望把部分业务数据也一起纳入版本时,才需要在这里选择对应的数据表。
如果你选择了某个用户数据表,系统会把和它存在关系的数据表一并纳入版本,这样恢复时通常更完整。

