Unity Comparison Studio

面向 Unity UI Prefab 的效果验收与颜色校准工作台

通过本机 Unity MCP 获取 Prefab 层级、节点参数与实际画面，对效果图和实际截图进行颜色对比、节点定位与 RGBA 校准。

使用手册 · 更新记录 · 版本包 · GitHub Releases

---

核心能力

类别	功能
Prefab 浏览	锁定指定文件夹，浏览并快速搜索 Prefab
Unity MCP	读取 Prefab 节点层级、RectTransform、Graphic/Text RGBA 和运行时信息
画面对比	效果图、实际效果、叠加、差异及四图分屏查看
颜色校准	整图或定位区域分析，输出目标色、实际色、建议 RGBA、Delta E 与可信度
节点定位	从图片点击位置对应 Unity 节点，并区分重复路径实例
安全写入	仅修改已有 Graphic/Text 的 RGBA；不增删节点或组件，不自动保存 Prefab

目录结构

Unity-Comparison-Studio/
├─ ComparisonStudio/    # WPF 工具源码与构建脚本
├─ ReleasePackages/     # 版本化发布包及 SHA256
├─ README.md            # 项目入口
├─ UserManual.md        # 使用说明
├─ CHANGELOG.md         # 版本记录
└─ VERSION              # 当前版本号

该结构与 unity-UIProbe 的存放方式保持一致：源码、说明文档和版本发布包分层管理，构建产物不散落在源码目录中。

快速开始

1. 从 Releases 或 ReleasePackages 下载最新 ZIP。
2. 校验同名 .sha256 文件后解压。
3. 启动 ComparisonStudio.exe。
4. 确保 Unity 已打开目标工程，并启用 MCP for Unity；默认地址为 http://127.0.0.1:8080/mcp。
5. 在工具台选择效果图、实际效果截图和 Prefab 根目录，再读取节点并开始校色。

实际截图与节点快照应来自同一 UI 状态。时间或状态不一致时，节点对应和校色建议的可信度会下降。

从源码构建

环境要求：Windows、.NET Framework 4.8、Visual Studio Build Tools / MSBuild。

cd ComparisonStudio
build.bat

输出文件：ComparisonStudio\bin\Debug\ComparisonStudio.exe。

安全边界

• 不向 Unity 工程添加工具脚本。
• 不新增或删除 Unity 节点、组件。
• 不自动保存 Prefab。
• 当前只允许修改已有 Graphic/Text 颜色 RGBA。
• 无法验证运行时节点与 Prefab Stage 节点对应关系时禁止写入。
• Unity 当前 Prefab 有未保存改动时禁止自动切换其他 Prefab。

最新版本

当前版本：v0.1.0。详见 CHANGELOG.md。