#Управление версиями

#Введение

Skill управления версиями (nocobase-revision) создаёт восстанавливаемую версию приложения после того, как AI Builder завершил значимый этап. Например, после создания страницы, набора collections или настройки workflow ИИ может выполнить nb revision create, чтобы сохранить текущее состояние.

Он не создаёт версию после каждого изменения поля. По умолчанию сохранение выполняется только после завершения и проверки понятного этапа, чтобы список версий оставался читаемым, а точку восстановления было проще выбрать.

О списке версий, ручном создании, восстановлении и настройках хранения см. руководство по плагину Version Control.

#Возможности

Может:

• Создавать версию после завершённого и проверенного этапа построения
• Записывать краткое описание того, что было сохранено
• Создавать версии в текущем CLI-окружении

Не может:

• Заменять базовые возможности сохранения и восстановления плагина Backup Management
• Создавать версии, если плагин Version Control не включён
• Автоматически восстанавливать приложение до версии. Для восстановления используйте плагин Version Control

#Примеры промптов

#Сценарий A: сохранить готовую настройку страницы

Сохрани текущий результат как версию: завершена настройка страницы управления клиентами, области фильтров и формы редактирования

Skill преобразует описание в краткую заметку версии и создаст версию.

Режим команды:

nb revision create "Завершена настройка страницы управления клиентами, области фильтров и формы редактирования"

#Сценарий B: сохранить модель данных и workflow

Collections поставщиков и workflow согласования закупок уже проверены. Создай версию.

Подходит для работы, которая объединяет несколько возможностей. Например, создать collections через Моделирование данных, настроить процесс согласования через Управление рабочими процессами, проверить результат и затем сохранить версию.

#Сценарий C: создать версию в указанном окружении

В окружении dev сохрани версию: завершена настройка страницы управления заявками и полей SLA

Если указанное окружение отличается от текущего CLI-окружения, Skill сначала подтверждает цель, чтобы не сохранить версию в неправильном приложении.

Режим команды:

nb revision create --env dev --yes "Завершена настройка страницы управления заявками и полей SLA"

#Как писать описания версий

Описание версии должно говорить, что было завершено, а не использовать расплывчатую метку.

Рекомендуется:

• Завершены клиентский реестр, страница деталей и процесс отправки на согласование
• Завершены collections поставщиков, форма заявки на закупку и workflow согласования
• Completed customer detail page, edit form, and submission workflow wiring

Не рекомендуется:

• snapshot
• backup
• test
• version 2
• Только дата или временная метка

Также не указывайте в описании токены, URL, пароли или другую чувствительную информацию. Описание отображается в списке версий и должно оставаться понятным, читаемым и пригодным для аудита.

#FAQ

Когда следует создавать версию?

После этапа, который можно проверить отдельно. Например, страница открывается и корректно редактируется, связи между collections проверены, или workflow сохранён и цепочка nodes проверена.

Почему не создавать версию после каждой правки ИИ?

Слишком много мелких версий быстро делают список трудным для чтения. Обычно версия должна обозначать точку, к которой можно вернуться и продолжить работу, а не одно переименование поля или перемещение кнопки.

Нужно ли проверять результат перед созданием версии?

Да. Skill управления версиями предназначен для сохранения завершённых и проверенных результатов. Если страница ещё выдаёт ошибку или workflow не подтверждён, сначала попросите ИИ исправить и проверить результат.

Где восстановить созданную версию?

В списке версий плагина Version Control. Восстановление перезаписывает текущую конфигурацию приложения и данные, включённые в эту версию. Перед операцией прочитайте руководство по плагину Version Control.

#Связанные ссылки

• Руководство по плагину Version Control — ручное создание, восстановление и настройка правил версий
• Backup Management — базовая возможность, от которой зависит Version Control
• Обзор AI Builder — обзор и установка всех Skills AI Builder
• Управление публикацией — публикация между окружениями, резервное копирование, восстановление и миграция