История версий

Просматривайте прошлые версии, изучайте изменения и восстанавливайте общий документ.

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

Как работает история версий

мутация - это одно повторно воспроизводимое изменение контента, такое как установка ячейки или вставка абзаца. менять является одним представлением о сотрудничестве, которое несет упорядоченную группу мутаций.

1. Запись изменений

Каждое редактирование от пользователя или агента производит мутации. Univer упаковывает эти мутации в набор изменений и отправляет его для совместной работы, чтобы подтвердить и сохранить.

100%

После подтверждения в подачу поступает пересмотр, который идентифицирует свою позицию в истории документа.История индексирует подтверждённые вносимые в него изменения, группирует их по времени и операции и строит временную шкалу версии.

2. Воссоздание прошлого содержимого

снимок - это полное состояние контента при одной ревизии. Когда выбирается историческая версия, Univer загружает базовый снимок и наборы изменений, которые следуют за ним до целевой ревизии, а затем переигрывает их мутации в порядке. Результатом является только просмотр содержимого, как оно стояло при этой ревизии.

100%

Пример: snapshot на revision 10 + changesets для ревизий 11–15 = содержимое на revision 15.

3. Восстановление текущего документа

Выбор Восстановите эту версию начинается следующим образом:

Выбрать версию → Отправить mutation восстановления → Подтверждение → Обновить текущий документ с новой revision

Операция восстановления создает новый исторический рекорд.Предыдущие версии остаются доступными.

Просмотр версий и изменений

  1. Откройте историю в редакторе и выберите версию.
  2. Расширить группу версий, чтобы проверить индивидуальные изменения. Выберите один пересмотр, чтобы прочитать его содержание и изменения в просмотрщике только для чтения.
  3. Выберите Восстановите эту версию, когда требуется откат. Восстановление обновляет общий документ посредством совместной работы, поэтому каждый другой участник получает изменение.

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

Цвета изменений

МеткаЗначение
🟦 Синий: обновленоСуществующий контент изменился.
🟩 Зелёный: добавлениеНовая строка, абзац, запись или объект доски.
🟥 Красный: удаленоСодержимое удалено в этой версии.

Цвета указывают на Тип изменения. Замена текста может производить как вставку, так и удаление. Каждый зритель продукта определяет, сколько контента выделено.

История в пяти продуктах

Приведенные ниже примеры взяты из одного проекта Northstar.Содержание на английском языке и сроки расширены, так что каждый документ показан вместе с действиями, стоящими за его изменениями.

Sheets

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

Sheets — Руководство по интеграции

Docs

Краткое описание запуска продукта охватывает дату запуска, форматирование абзаца и добавления, сделанные для готовности клиента. Удаленный текст остается видимым с красным прочерком, поэтому каждая редакция сохраняет свой контекст.

Docs — Руководство по интеграции

Slides

Следите за целевыми показателями и объектами страницы в Launch Review. Выберите запись истории, чтобы увидеть обновленные, вставленные и удаленные объекты, отмеченные непосредственно на слайде.

Slides — Руководство по интеграции

Relational Table

Launch Tracker показывает изменения в задачах, владельцах и статусах.Записи и изменения поля появляются в контексте таблицы, которая уточняет, когда и как изменились бизнес-данные.

Relational Table — Руководство по интеграции

Canvases

Release Workspace показывает карты планирования и свойства объектов.Вставленные, удаленные и обновленные объекты остаются помеченными на холсте, что облегчает отслеживание пересмотра планирования.

Canvases — Руководство по интеграции

PDF

Coming soon: История версий PDF пока недоступна.

Интеграция с приложением

История версий объединяет расширение History в Server SDK с плагинами истории продуктов в Web SDK.

  • На сервере добавьте History Service, Endpoint и постоянный адаптер базы данных для Core Collaboration. Сервис подписывается на создание Unit и совершенные изменения, строит индекс истории и обнажает запросы на версии и изменения.
  • В браузере регистрируют общую возможность истории и плагины пользовательского интерфейса History/ History продукта, затем подключают конечную точку истории. Зритель загружает выбранный пересмотр и отображает его изменения. Для пользовательского контента регистрируют соответствующие плагины просмотра.
  • Ваше приложение предоставляет идентификатор и авторизацию, а сервер проверяет прочитанные истории и восстанавливает разрешения. Историческая версия может содержать данные, которые текущий документ уже удалил.

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

Индексы истории - это восстановленные производные данные. Подтвержденные изменения остаются авторитетным источником контента. Ваше приложение контролирует постоянство и удержание. Панель истории не заменяет резервные копии.

Связь с другими функциями

СпособностьЦель
Ундо / RedoВосстановить или повторно применить операцию редактирования без службы истории.
История версийСледите за подтвержденными версиями во время сеансов, проверяйте изменения и восстанавливайте общий контент.
Сравнение контентаСравните два состояния контента для пользовательского интерфейса или агента. Сравнение только для чтения не восстанавливает контент.
WorktreeИзолируйте проекты изменений для обзора, прежде чем объединять их в общий контент.

Изменения агентов, внесенные через API Facade, входят в один и тот же конвейер истории, как только их подтверждает сотрудничество.Приложения могут комбинировать историю с сравнением контента для автоматического обзора и проверок.

Назад ко всем функциям

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.