---
pkg: '@nocobase/plugin-version-control'
title: "版本控制"
description: "版本控制插件操作手册：配合 AI 搭建自动保存版本，手动创建版本、恢复版本、设置保留数量、配置快捷键和纳入版本的用户数据表。"
keywords: "版本控制,Version control,运维管理,AI 搭建,nocobase-revision,nb revision create,创建版本,恢复版本,NocoBase"
---

# 版本控制

在 NocoBase 中，**版本控制（Version control）** 用来给当前应用保存一份可回退的版本。你可以手动创建版本，在需要时恢复到某个已保存的状态；也可以让 AI 搭建在完成阶段性成果后自动保存版本。

版本控制依赖 [备份管理](../backup-manager/index.mdx) 提供保存和恢复能力。使用版本控制前，需要先启用备份管理。

:::warning 注意

社区版和标准版不包含版本控制插件。如果需要保存可回退的应用状态，可以使用 [备份管理](../backup-manager/index.mdx)：在关键变更前手动创建备份，需要回退时再还原对应备份。

:::

## AI 自动保存版本

启用版本控制插件后，AI 搭建会多一层回退保障。AI Agent 开始处理需求时，会检查当前应用可用的 NocoBase Skills；如果识别到 `nocobase-revision` skill，后续就可以把关键搭建节点保存为可恢复版本。

![AI 开始搭建时识别 nocobase-revision skill](https://static-docs.nocobase.com/20260611115845.png)

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

![AI 搭建后创建版本](https://static-docs.nocobase.com/20260611115804.png)

这些版本会出现在版本列表中。后续如果配置不符合预期，可以恢复到上一个清晰的搭建节点，再继续让 AI 调整。

## 进入插件

启用插件后，顶部导航栏会出现「版本控制」菜单。你可以在这里直接创建版本，也可以进入版本列表。

另外，你也可以从「系统设置 / 版本控制」进入插件页面。创建版本的默认快捷键是 `Ctrl + K`，可以在设置页里修改。

![20260611112317](https://static-docs.nocobase.com/20260611112317.png)

## 创建版本

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

![20260611112739](https://static-docs.nocobase.com/20260611112739.png)

点击保存后，列表里会先出现一条「保存中」的记录。保存完成后，版本会显示在列表里。

几个要点：

- 版本名由系统自动生成，不需要手动填写
- 从顶部导航按钮、快捷键和列表页按钮创建，效果完全一样
- 列表会显示版本名、描述、文件大小、创建时间、创建人，以及后续操作

## 管理与恢复版本

版本列表页主要有这几类操作：

- 「刷新」：重新加载当前版本列表
- 「删除」：删除单个版本，或勾选多条后批量删除
- 「恢复」：把当前应用恢复到该版本保存时的状态

:::warning 注意

恢复版本会覆盖当前应用当前的配置状态，以及该版本中包含的数据内容。恢复前，建议先创建一个当前版本，方便你随时回退。

:::

点击「恢复」后，应用会短暂进入维护状态并执行恢复。恢复完成前，不要重复提交恢复操作。如果恢复失败，界面会显示错误通知。

## 设置版本策略

切换到「设置」标签页后，你可以控制版本保留和版本内容范围。

![](https://static-docs.nocobase.com/20260526220720.png)

设置项包括：

- `Versions to keep`：保留的版本数量上限。超过上限后，较早的版本会自动删除
- `Shortcut: create version`：创建版本的快捷键。按 `Ctrl + 字母键` 设置，按 `Backspace` 清除
- `User collections`：选择哪些用户创建的数据表需要跟着版本一起保存

:::tip

默认情况下，版本不会包含你自己创建的数据表内容。只有当你希望把部分业务数据也一起纳入版本时，才需要在这里选择对应的数据表。

:::

如果你选择了某个用户数据表，系统会把和它存在关系的数据表一并纳入版本，这样恢复时通常更完整。

## 相关链接

- [备份管理](../backup-manager/index.mdx) — 版本控制依赖的基础能力
- [迁移管理](../migration-manager/index.md) — 在多环境之间迁移应用配置
- [发布管理](../release-management/index.md) — 结合备份、迁移和变量配置规划发布流程
- [AI 搭建快速开始](../../ai-builder/index.md) — 用自然语言完成数据建模、页面配置和工作流编排
