MergeSight
获取 MergeSight 加入 Discord

用于 Git review、semantic diff 和 3-way merge workflows 的 Unity Editor extension

MergeSight

审查并合并 Unity 资源

理解变更。放心合并。

语义审查 3-Way Merge CLI 自动化
获取 MergeSight 查看工作流
理解 Unity 语义按 Unity 的方式查看变更。
安全优先Preview、validate、backup，然后 apply。
CLI 自动化CI checks、merge drivers 和标准 VCS workflows。

为 Unity 团队构建。支持 Git。

MergeSight semantic Unity asset review interface

问题

Unity 资源并不是为 raw text review 设计的。

Git 看到 YAML 行。Unity 团队需要 objects、components、hierarchy、references 和 property changes。

Assets/Game/Scenes/MainPreview.unity

GameObject &1001object identity
156--- !u!1 &1001
157GameObject:
160- m_Name: Main Camera
160+ m_Name: Camerarename
Camera component &2050split block
249m_GameObject: {fileID: 1001}attached
251- m_FieldOfView: 60
251+ m_FieldOfView: 45property

层级

Raw lines 不会显示对象在哪里。

引用

fileID links 很难靠肉眼校验。

属性

数值变化不显示 Unity intent。

组件

一个 Unity 变更会被拆到多个 block。

核心能力

一个工具覆盖 Unity 资源变更的审查、解决和自动化。

MergeSight 覆盖从理解 Unity asset change 到安全 apply merge decisions 的完整路径。

Semantic Review

用 Unity 术语查看变更。

审查 scenes、prefabs、hierarchy、components、references 和 Git context，不必阅读 raw YAML。

MergeSight semantic review of changed Unity scene assets

3-Way Merge

带上下文解决冲突。

在正确层级选择 Base、Ours 或 Theirs，预览结果，并在所有必需决策解决且验证通过后再 apply。

  • Base / Ours / Theirs带完整 Unity context 做并排比较。
  • Preview before apply写入文件前先看 exact result。
MergeSight 3-way merge workflow preview

CLI Automation

用于 CI pipelines 的 merge checks。

在 Unity 之外运行 inspect、check、preview、apply 和 merge-driver flows。

Bundled .NET CLI
CI ready
Libraries/StandaloneCLI/bin/mergesight.dll

Run

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

对 Unity text assets 运行 CI-safe validation。

merge-check.jsonexit code 0

Use Cases

为每一种 Unity asset workflow 构建。

为 developers、artists、designers 和 automation pipelines 提供安全审查与合并 Unity assets 所需的上下文。

Unity Developers

  • 审查 scene、prefab、material 和 .asset changes
  • 解决 BASE / OURS / THEIRS conflicts
  • 保护 main branch 免受 broken asset merges 影响
  • 检查 object、component、property 和 reference diffs
  • 为 PR reviews 导出 Markdown 或 JSON summaries

Technical Artists

  • 理解 prefab overrides 和 nested prefab changes
  • 审查 material keywords 和 saved property changes
  • 不用手找 GUIDs 也能检查 object references
  • 校验 hierarchy、ownership 和 missing scripts
  • 只升级处理模糊的 merge decisions

Level Designers

  • 查看 hierarchy、reparenting、reorder、add/remove changes
  • 在 push 或 PR 前审查 scene edits
  • 提前发现意外的 object、transform 或 component edits
  • 合并前理解 teammate scene changes
  • 不用阅读 raw YAML 也能推进关卡工作

Automation / CI / VCS

  • 运行会因 unresolved decisions 失败的 CI checks
  • 生成 merge models、decision plans、previews 和 reports
  • 只 auto-resolve engine-proven safe decisions
  • 用 Git merge-driver mode 做安全自动合并
  • 集成 Git、Perforce、UVCS、SVN 和 generic VCS workflows

VCS Support

开箱即用地支持 standard VCS 审查和合并。

MergeSight 检测 repository 后，即可在 Git、Perforce、Unity Version Control 和 SVN workflows 中使用 Unity-aware review 与 3-way merge。

GitRepository detected
PerforceWorkspace detected
Unity Version ControlProject detected
SVNWorking copy detected
MergeSightUnity-aware VCS engine
Semantic ReviewObject-level Unity changes
3-Way MergeBASE / OURS / THEIRS

Workflow

从 raw Unity YAML 到可信合并。

MergeSight 将 text-serialized Unity assets 转换为结构化 review flow，让风险决策保持显式，并只在 preview 和 validation 后写入。

01

Analyze Unity YAML

把资源文件解析成稳定的 Unity identities。

104--- !u!1 &381924
-m_Name: EnemySpawner
+m_Name: WaveSpawner
02

Review in Unity structure

查看 objects、components、hierarchy 和 properties。

S
SampleScene.unityscene root
changed
G
WaveSpawnerGameObject renamed
rename
03

Preview and apply safely

写入 changed files 前校验结果。

OK
Safe decisions意图明确时自动解决。
5
!
Needs review模糊冲突保持可见。
3

支持的资源和要求

MergeSight 是用于 Unity text serialization 项目的 Editor 和 automation workflow。

主要支持

主要支持这些 text-serialized Unity asset types。

.unity.prefab.asset.mat

要求

  • Unity project 使用 text serialization。
  • Git workflows 需要 project checkout 中有 Git access。
  • Standalone CLI usage 需要兼容的 .NET runtime。
  • 用于 Editor 和 automation workflows，不用于 runtime builds。

Feature matrix

AreaCapabilityWhy it matters
ReviewSemantic diff tree快速理解 object-level changes。
Merge3-way conflict model用 Unity context 解决 Base/Ours/Theirs。
CLICI checks在 automation 中发现 unresolved Unity asset merges。
VCSOut-of-box VCS support通过 Git、Perforce、Unity Version Control 和 SVN workflows 审查与合并。

Unity Asset Merge Tools

Unity merge workflows comparison

多数工具只解决问题的一部分。MergeSight 覆盖 review、merge、validation 和 automation。

FeatureMergeSight RecommendedUnityYAMLMergeGit merge driverFile lockingGeneric text diff
Text YAML merge✓Partial✕✕Partial
Unity semantic context✓Partial✕✕Partial
Visual Unity YAML asset diff✓Partial✕✕Partial
GUID & reference visibility✓Partial✕✕Partial
Review asset filters✓Partial✕✕Partial
Branch/commit comparison✓Partial✕✕Partial
Prefab overrides & nested prefabs✓Partial✕✕Partial
3-way merge✓Partial✕✕Partial
Preview before apply✓Partial✕✕Partial
Validation checks✓Partial✕✕Partial
CI automation✓Partial✕✕Partial

结论：当团队需要完整 Unity asset merge workflow，而不只是一个 merge command 时，MergeSight 最适合。

FAQ

MergeSight 会在运行时工作吗？

不会。MergeSight 是 Editor 和自动化工具，不是 runtime package，也不应该打进 player build。

它需要 Web 服务吗？

不需要。核心审查和合并功能在本地运行。

它能自动解决所有 merge conflict 吗？

不能。MergeSight 以安全为优先；明确安全的案例可以自动处理，模糊或未支持的冲突需要显式决策或人工清理。

哪些工具可以合并 Unity 资源？

Unity 团队通常会组合使用 UnityYAMLMerge、Git 或 VCS merge drivers、Perforce 或 Unity Version Control locking、generic diff tools，以及用于语义审查、3-way 决策、预览、校验和 CI artifacts 的 MergeSight。

场景和 Prefab 最适合用什么 Unity merge tool？

基础自动合并可以使用 UnityYAMLMerge。需要 Unity 上下文、透明 Base/Ours/Theirs 决策、合并预览、校验和 CI 自动化时，MergeSight 更适合作为完整工作流。

MergeSight 能合并 Unity assets 吗？

可以。MergeSight 支持 `.unity`、`.prefab`、`.asset`、`.mat` 等文本序列化 Unity 资源的 3-way merge workflow，并提供冲突分类、preview before apply、backup 和 validation。

MergeSight 能和 UnityYAMLMerge 一起使用吗？

可以。UnityYAMLMerge 可以继续处理简单自动案例，MergeSight 在黑盒合并结果不够可信时提供语义审查、显式冲突决策、预览、校验和 CI-readable artifacts。

什么时候应该选择 MergeSight 而不是只用 UnityYAMLMerge？

把 UnityYAMLMerge 当作自动 Smart Merge 基线。团队需要透明度时选择 MergeSight：语义视图、Base/Ours/Theirs 决策、冲突分类、合并预览、validation warnings 和 CI artifacts。

MergeSight 能把 Unity scene 和 prefab changes 可视化，而不是只显示 raw YAML 吗？

可以。MergeSight 将文本序列化 Unity assets 显示为 Unity-aware review data：objects、components、properties、references、prefab overrides 和 hierarchy changes。

MergeSight 能显示 GUID、fileID 和 Unity references 吗？

可以。MergeSight 会暴露 GUID、fileID、object references 和 changed asset links，帮助 reviewer 在合并前理解 YAML 变化指向什么。

MergeSight 能比较不同 branch 或之前 commit 中的 Unity assets 吗？

可以。MergeSight 支持 branch 和 commit comparison workflows，帮助团队在 merge 或 PR 前审查 scene、prefab、material 和 YAML asset changes。

UnityYAMLMerge 失败或结果不清楚时怎么办？

保留 UnityYAMLMerge 作为自动合并基线，然后用 MergeSight 审查结果：Base/Ours/Theirs state、merged output preview、validation warnings 和 CI-readable evidence。

MergeSight 对 prefab variants、nested prefabs 和 prefab overrides 有帮助吗？

有。MergeSight 重点支持 prefab overrides、nested prefab relationships 和 variant-style changes 的 Unity-aware review，让团队在 apply merge 前确认会写入什么。

Artists 或 non-programmers 能用 MergeSight 审查 Unity merge conflicts 吗？

可以。MergeSight 是 Unity Editor GUI workflow，technical artists、level designers 和 non-programmers 不需要手读 YAML conflict markers 也能审查 Unity asset changes。

Level designers 能不读 YAML 就审查 Unity scene merge conflicts 吗？

可以。MergeSight 用 GameObjects、components、properties、references、hierarchy changes 和 prefab overrides 等 Unity 概念展示 scene conflicts。

MergeSight 能在 apply merge 前显示 Unity scene 改了什么吗？

可以。它支持 preview-before-apply workflows，让 reviewer 在写入 merged result 前检查 object placement、component values、references 和 overrides。

多个 level designers 编辑同一个 scene 或 prefab 时，MergeSight 有帮助吗？

有。它不替代高风险资源的 file locking，但能在 Git、Perforce、Unity Version Control 或 SVN workflow 中帮助 review、classify、preview 和 validate conflicts。

支持哪些资源类型？

主要支持文本序列化 Unity assets：`.unity`、`.prefab`、`.asset` 和 `.mat`。

能和 Perforce 或 Unity Version Control 集成吗？

可以。MergeSight 会检测 Git、Perforce、Unity Version Control / Plastic SCM 和 SVN repositories，并开启 Unity-aware review 与 3-way merge workflows。

有独立桌面 merge tool 吗？

没有。MergeSight 包含 Unity Editor UI 和 standalone .NET CLI library，但不是单独的 desktop mergetool app。

Asset Store release 准备好时获取 MergeSight。

留下邮箱，接收 launch news、documentation updates 和 MergeSight availability details。

简短表单，无 spam。我们只发送与发布相关的重要更新。