Unity Editor extension для Git-ревью, семантического diff и 3-way merge

MergeSight

Проверяйте и объединяйте Unity-ассеты


Понимайте изменения. Мержите без страха.

Семантическое ревью 3-way merge CLI-автоматизация
Понимание структуры Unity Смотрите изменения так, как их видит Unity.
Безопасность по дизайну Предпросмотр, валидация, backup. Только потом применение.
Автоматизация через CLI CI-проверки, merge drivers и VCS-интеграции.

Создано для Unity-команд. Работает с Git.

Интерфейс MergeSight для семантического ревью Unity-ассетов

Проблема

Unity-ассеты не создавались для ревью как обычный текст.

Git видит YAML-строки. Unity-командам нужны объекты, компоненты, иерархия, ссылки и изменения свойств.

Шумный YAML

Большие текстовые diff скрывают смысл изменений.

Рискованные конфликты

Ручные правки могут сломать ассеты.

Не хватает контекста

Структуру Unity сложно увидеть.

CI нужны проверки

Автоматизации нужен детерминированный результат.

Assets/Game/Scenes/MainPreview.unity

GameObject &1001идентичность
156--- !u!1 &1001
157GameObject:
158 m_ObjectHideFlags: 0
159 m_CorrespondingSourceObject: {fileID: 0}ссылка
160- m_Name: Main Camera
160+ m_Name: Cameraимя
161 m_TagString: MainCamera
164- m_StaticEditorFlags: 0
164+ m_StaticEditorFlags: 1флаги
165... unrelated serialized fields ...
Camera component &2050отдельный блок
243--- !u!20 &2050
244Camera:
246 m_CorrespondingSourceObject: {fileID: 1001}источник
249 m_GameObject: {fileID: 1001}связь
251- m_FieldOfView: 60
251+ m_FieldOfView: 45свойство
252 m_NearClipPlane: 0.3
253 m_FarClipPlane: 1000

Реальный рефакторинг сцены с перестройкой иерархии: в raw YAML перемещенные узлы, переупорядоченные дочерние объекты и правки свойств смешиваются в шумные текстовые блоки.

Иерархия

По YAML-строкам не видно, где находится объект.

WorldEnvironmentCamera

Ссылки

fileID-связи трудно проверить глазами.

Свойства

Значения меняются без понятного Unity-контекста.

FOV 60FOV 45

Компоненты

Одно Unity-изменение разбито на несколько блоков.

GameObjectCamera

Спроектирован для сложных merge Unity-ассетов

Один инструмент для ревью, разрешения конфликтов и автоматизации изменений Unity-ассетов.

MergeSight покрывает полный путь от понимания изменения Unity-ассета до безопасного применения merge-решений.

Семантическое ревью

Смотрите изменения Unity-ассетов в терминах Unity.

Проверяйте сцены, префабы, иерархию, компоненты, ссылки и Git-контекст без чтения raw YAML.

  • Браузер измененных ассетовСразу переходите к измененным сценам, префабам и asset-файлам.
  • Семантическое дерево diffПроверяйте GameObject, компоненты, свойства, ссылки и иерархию.
  • Режимы Git-сравненияСравнивайте ветки, коммиты и изменения working tree в одном представлении.
  • Фильтры и поискФокусируйтесь по типу ассета, пути, Git-статусу и плотности изменений.
  • Экспорт ревьюДелитесь Markdown или JSON-сводками с командой.
Семантическое ревью измененных Unity-сцен в MergeSight
Только измененные Unity-ассетыНачинайте со сцен и префабов, которые реально изменились.
Фильтр по области ревьюИспользуйте тип, статус, путь и сортировку по количеству изменений.
Контекст ветки и коммитаДержите исходные ревизии видимыми во время ревью.

3-way merge

Решайте конфликты с контекстом.

Выбирайте Base, Ours или Theirs на правильном уровне, смотрите результат заранее и применяйте изменения только после разрешения и валидации всех обязательных решений.

  • Base / Ours / TheirsСравнивайте изменения рядом друг с другом с полным Unity-контекстом.
  • Классификация конфликтовАвтоматически классифицируйте конфликты и подсвечивайте риск.
  • Безопасное авторазрешениеПрименяйте безопасные решения автоматически, затем проверяйте остальное.
  • Предпросмотр перед применениемВидите точный результат до записи изменений.
  • Backup и валидацияДелайте backup оригиналов и валидируйте результат после merge.
MergeSight 3-way merge workflow preview
Отслеживается узлов: 8 Конфликтов: 3 Авторазрешено: 5 Не решено: 3

CLI-автоматизация

Merge-проверки для CI pipeline

Используйте packaged .NET CLI для быстрых CI-проверок, семантических merge-артефактов, Git merge-driver и wrapper-интеграций для внешних VCS.

  • CI-проверкиinspect, check, auto-plan, validate-plan
  • Git merge-driverбезопасные семантические решения из Git-процессов
  • VCS wrappersфайловые merge-процессы для внешних клиентов
Встроенный .NET CLI
Готово для CI
Libraries/StandaloneCLI/bin/mergesight.dll

Запуск

$ dotnet Libraries/StandaloneCLI/bin/mergesight.dll check

Запускает CI-safe валидацию Unity text assets и завершает проверку ошибкой, если найден неразрешенный или небезопасный merge-state.

merge-check.json код выхода 0

Процесс

От raw Unity YAML к merge, которому можно доверять.

MergeSight превращает text-serialized Unity-ассеты в структурированный процесс ревью, оставляет рискованные решения явными и пишет файлы только после предпросмотра и валидации.

01

Анализ Unity YAML

Парсит asset-файлы в стабильные Unity-идентификаторы.

104--- !u!1 &381924
105GameObject:
-m_Name: EnemySpawner
+m_Name: WaveSpawner
131m_Component:
+- component: {fileID: 99172}
148m_LocalPosition: {x: 4, y: 0, z: 2}
02

Ревью в структуре Unity

Видите объекты, компоненты, иерархию и свойства.

S
SampleScene.unityкорень сцены
изменено
G
WaveSpawnerGameObject переименован
rename
C
EnemyWaveControllerкомпонент добавлен
add
P
Transform.positionx изменился с 2 на 4
03

Предпросмотр и безопасное применение

Валидируйте результат до записи измененных файлов.

OK
Безопасные решенияАвторазрешение, когда намерение однозначно.
5
!
Требует ревьюНеоднозначные конфликты остаются видимыми.
3
->
Предпросмотр, backup, валидацияПрименение только после успешных проверок merge-результата.
готово

Поддерживаемые ассеты и требования

MergeSight это Editor- и automation-процесс для Unity-проектов с text serialization.

Основная поддержка

Основная поддержка покрывает эти типы text-serialized Unity-ассетов.

.unity .prefab .asset .mat

Дополнительные VCS wrapper templates могут включать паттерны для .physicMaterial, .anim, .controller и .overrideController.

Требования

  • Unity-проект использует text serialization для ассетов.
  • Git-процессы требуют доступ к Git из checkout проекта.
  • Для standalone CLI нужен совместимый .NET runtime.
  • Предназначен для Editor- и automation-процессов, не для runtime builds.

Матрица возможностей

Область Возможность Почему это важно
Ревью Семантическое дерево diff Быстро понимать изменения на уровне объектов.
Ревью Сравнение веток и коммитов Проверять изменения Unity-ассетов в реальных Git-процессах.
Ревью Экспорт сводок Делиться читаемыми отчетами об изменениях с командой.
Объединение 3-way модель конфликтов Разрешать Base/Ours/Theirs с Unity-контекстом.
Объединение Безопасное авторазрешение Доверять инструменту только доказанно безопасные решения.
Объединение Предпросмотр и валидация Писать файлы только когда результат готов.
CLI CI checks Находить неразрешенные merge Unity-ассетов в автоматизации.
CLI Режим Git merge-driver Использовать безопасный семантический auto-merge из Git.
VCS Wrapper templates Адаптировать file-based workflows под распространенные VCS clients.

FAQ

MergeSight работает в runtime?

Нет. MergeSight это инструмент для Editor и automation. Это не runtime package и он не предназначен для включения в player builds.

Нужен ли веб-сервис?

Нет. Основные функции ревью и merge работают локально.

Может ли он автоматически решить любой merge-конфликт?

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

Какие типы ассетов поддерживаются?

Основная поддержка покрывает text-serialized Unity-ассеты: .unity, .prefab, .asset и .mat.

Можно ли интегрировать с Perforce или Unity Version Control?

Настройка Git доступна через Editor wizard. Perforce, Unity Version Control / Plastic SCM, SVN и generic clients поддерживаются через wrapper templates и инструкции по настройке внешних клиентов.

Есть ли отдельный desktop merge tool?

Нет. MergeSight включает UI внутри Unity Editor и standalone .NET CLI library, но не отдельное desktop mergetool приложение.

Получите MergeSight, когда релиз в Asset Store будет готов.

Оставьте email, чтобы получить новости запуска, обновления документации и детали доступности MergeSight.

Короткая форма, без спама. Отправляем только важные новости о запуске.