功能全面的 Unity UI 开发辅助工具集
一站式覆盖 资源索引 · 质量检测 · 运行时调试 · 批量操作，显著提升 UI 开发效率与质量。
| 类别 | 功能 |
|---|---|
| 🔍 索引与搜索 | 预制体索引与搜索 · 资源引用追踪（图片/字体/材质/嵌套预制体）· 嵌套关系双向总览 |
| ✅ 质量检测 | 综合检测（重名节点 / 多余 Raycast Target / 资源丢失）· 协作式重命名 · 动画路径自动修复 |
| 🎯 运行时调试 | Play 模式点击拾取 UI 元素 · Device Simulator 支持 · 完整层级与组件信息面板 |
| 🛠️ 实用工具 | 图片规范化 · 大红大金资源导入 · 高清/透明截图 · TMP 富文本可视化生成器 |
| ⚡ 预制体助手 | 快速创建 UI 节点 · 九宫格锚点 · 智能布局（全屏/居中/侧边栏）· Prefab 显隐恢复 · 按钮射线缩放 |
| 🔄 一键更新 | 关于页检测新版本，编辑器内直接下载并导入，零 git/CLI 依赖 |
- 从 Release 页面 下载最新
.unitypackage（或下载.zip解压）。 - 在 Unity 中通过
Assets > Import Package > Custom Package导入；或将UIProbe文件夹放入项目Assets任意位置（建议置于Editor目录）。 - 菜单栏点击
Tools > UIProbe打开工具窗口。 - 首次使用：在「设置」页配置检测规则 → 在「预制体索引」页点击 🔄 刷新索引。
📖 完整功能说明请见 使用手册 (User Manual)。
v3.12.0 新增
- 记录并恢复 Prefab 节点的
activeSelf显隐状态；仅恢复仍能稳定匹配的节点，避免误改已变更的结构。 - 批量检测并调整按钮的 Raycast Target 与缩放设置，支持预览修改范围后再写入。
v3.11.0 新增
- 关于页「检查更新」检测到新版本后，可直接在编辑器内下载最新
.unitypackage并触发导入，带可取消进度条。 - 三选一交互：立即更新(自动导入) / 稍后再说 / 前往下载页；自动导入失败时自动回退到浏览器下载页。
- 全程不依赖 git/CLI，也不要求工程绑定 GitHub 仓库。
点击展开查看 v3.10.0 → v1.4 的全部更新记录
v3.11.0 新增
- 关于页「检查更新」可直接下载最新
.unitypackage并触发导入，带可取消进度条。 - 支持立即更新、稍后再说与前往下载页三种操作；失败时自动回退至浏览器下载。
v3.10.0 重构
- God Object 拆分：
UIProbeWindow重构为模块注册表 + 三大共享服务（Config / PrefabIndex / Navigation），新增模块只需登记一个类，不再需要改 7 处。 - 按职责重组目录：
Modules/Services/Core/Data/IO/，对终端用户功能完全透明、无回退。 - 设置页「运行时拾取方式」、关于页「最新更新」改为默认收起的折叠区，减少初次打开的视觉噪音。
v3.9.3 修复
- 刷新预制体索引后，资源引用搜索结果会自动基于最新索引重算，避免继续显示旧节点记录。
- 引用图片的节点路径改为完整层级，包含预制体根节点，长命名自动换行完整显示。
- 资源引用结果中，图层节点名以蓝色链接显示，点击可打开对应预制体并定位到层级内节点。
- Image/RawImage 引用说明改为黄色显示，图片类引用在列表中更容易区分。
- 材质贴图引用按实际使用节点记录，同一材质被多个节点复用时不再只显示第一个节点。
v3.9.2 新增
- 检测已删除节点: 预制体中节点被移除后，无法自动修复的绑定路径标记为
unresolved，显示详细原因（"节点已删除" / "多个同名节点"） - 导出映射文件包含
resolvedCount/unresolvedCount统计，便于 Vx 了解需人工处理数量 - 导入时自动跳过 unresolved 条目并记录日志
- UI 日志区 ⚠ 标记无法自动修复的条目，与正常修复区分显示
v3.9.1 修复
- 协同导出模式即使未启用自动修复，也会维护预制体层级快照，移动层级或
OldName→NewName后可正常导出 oldPath → newPath 映射 - 修复从历史配置恢复自动修复开关时监听未完整恢复的问题
自动修复模式 (有权限)
- 全新的「动画修复」模块，开启后在预制体编辑模式中调整层级结构或修改节点命名时，自动检测并修复 Animator/Animation 的绑定路径
- 改名修复通过变更前后的层级快照识别同一个 Transform，
OldName→NewName可像移动层级一样实时回写动画绑定路径 - 防抖机制 + 路径智能匹配，无感修复，Unity Console 输出详细日志
协同导出/导入 (无权限)
- 导出修复映射: 扫描当前预制体失效路径，生成 JSON 文件（包含 clip GUID、oldPath → newPath、binding 详情）
- 协同导出同样使用层级快照：进入预制体并保持 UIProbe 面板打开后，移动层级或改名都可导出 oldPath → newPath 映射
- 导入并应用修复: Vx 侧选择 JSON 一键导入，自动按 GUID 定位剪辑并替换路径
- 独立存储目录
AnimationRepair/，与 CSV 导出分离
侧边栏角标提醒
- 含 Animator/Animation 组件的预制体，侧边栏「动画修复」按钮自动显示 ⚠ 角标
- Empty / Image / TMP Text 快速创建时 Layer 固定为
UI，不再依赖父节点
- 新增「动画修复」模块，支持预制体内层级变化后的动画绑定路径自动修复
- 支持协同导出/导入 JSON 映射，由有权限成员导入并应用到动画剪辑
- 含 Animator/Animation 组件的预制体，侧边栏「动画修复」按钮自动显示 ⚠ 角标
预览缩略图 + 行级勾选
- 预览列表每行左侧 32x32 缩略图，项目内外文件均支持
- 每行勾选框，取消勾选的文件不参与执行
撤销系统
- 执行前自动备份被覆盖的文件，通过
RedGoldUndoManager推入撤销栈 - 执行后可一键撤销恢复，与大红大金模块共享同一撤销系统
布局自适应
- 预览列表从固定 220px 改为
ExpandHeight(true)，窗口拉高时填满 - 所有路径输入框、文件名列表改为
ExpandWidth(true)+MinWidth
- 功能模块显示设置新增
Filter节点排查开关，可控制临时排查工具入口显示。 - 功能模块显示设置新增
大红大金资源修改导入开关，可单独隐藏图片工具里的大红大金子标签。 - 关闭大红大金子标签后，如果当前停留在该页，会自动回到图片规范化页。
- 移除旧版
Assets/UIProbeRecords目录扫描逻辑，避免打开工具或刷新历史记录时在项目内自动生成空目录。 - 记录保存/导入仍会按需创建 AppData 记录目录，不影响实际保存流程。
全 Tab 溢出修复
- 根级
BeginScrollView包裹整个内容区，更新横幅 + 所有 Tab 统一滚动 - 侧栏加
BeginScrollView可滚动，改为MinWidth(80)~MaxWidth(180)自适应 - 窗口最小尺寸设为 400x250，无法缩到比内容更窄
- 资源引用节点路径
300px、嵌套总览统计280px、重名检测输入200px等全部改为ExpandWidth自适应
交互缺陷修复
- Recorder "清空" 加确认弹窗，防止误删
- Picker 快捷键提示不再写死 "F1" 改为 "见设置"
- About 页版本号从
UIProbeUpdateChecker.VERSION动态读取 - ResourceDetector 移除空 TODO 注释
品质可配置化 + 栈式多级撤销持久化 + 预览缩略图
- 品质列表改为可配置：增删改条目，每个品质独立配置关键字、输出路径、命名模板
- 撤销栈持久化到磁盘，重启 Unity 后仍可撤销，按钮显示
↩ 撤销 (N) - 预览列表每行左侧 32x32 缩略图，点击可 ping 文件
命名模板扩展 + 预设系统 + 增量生成
- 模板变量
{Name}{Pinyin}{Seq:3}{Quality}，品质列表 UI 实时预览样例 - 预设保存/加载/删除，涵盖品质列表、格数规则、尺寸参数
- "☑ 仅变更行"自动选中变更行，"✕ 清除未变更"一键清除，生成按钮显示变更计数
行内编辑 + 冲突预警 + 批量操作栏
- 双击编辑名称、下拉切换品质、自动更新输出路径
- 同源冲突/目标冲突自动检测，折叠标题含冲突计数 ⚠
- 批量前缀/后缀/查找替换/统一格数/统一品质/批量设置输出路径
多源文件夹 + Excel 解析 + 资源引用联动
- 多个图片源文件夹按优先级匹配，零外部依赖解析 .xlsx
- 生成完成后异步扫描受影响预制体，弹窗展示，Console 输出完整 JSON
后台分帧生成 + 差异报告
- 每帧处理 3 行，编辑器保持响应，进度条实时更新
- 支持取消按钮，取消后等当前批处理完成即停
- 生成 Markdown 差异报告（汇总表 + 新增/修改/失败清单）
- 表格驱动导入: 图片工具新增“大红大金资源修改导入”子标签，支持读取 CSV/TSV 表格，根据名称与图标路径匹配待处理图片。
- 按品质分流输出: 可分别配置红/紫/金品质输出目录，按表格品质字段自动生成并写入对应资源路径。
- 智能预览与变更识别: 预览列表按“可替换 / 未找到 / 未匹配”分组展示，并标记新增、修改、无变化资源；同名源图会自动选取最后修改时间最新的文件。
- 输出可控与安全回滚: 支持在预览中切换使用已有输出、直接编辑输出文件名；生成覆盖前自动备份旧文件，面板内可一键撤销并恢复表格数据。
- 格数尺寸规则: 支持按“格数：长 / 格数：宽 / 格数”计算输出画布，正方形 1-6 格可统一输出 512x512，其它比例按单格像素生成。
- 预览与回写: 导入前可预览每行匹配结果、尺寸、输出路径和问题项，生成后可覆盖原表或另存回写后的表格，并对异常路径和多行字段做容错清洗。
- 资源引用 CSV 导出: “资源引用 (Asset References)”页签的搜索结果现在支持一键导出 CSV，便于排查资源影响范围、提交审阅和长期归档。
- 完整引用明细: 导出内容包含搜索资源类型、搜索关键字、引用类型、预制体名称、预制体路径、节点路径、资源名称、资源路径和额外信息。
- 所见即所得: 导出当前界面显示的搜索结果，不重新扫描，确保表格内容与搜索结果一致。
- Raycast Target 检测 CSV 导出: 综合检测中的“不必要的 Raycast Target”分组现在支持一键导出 CSV，便于团队审阅、批量归档和性能优化追踪。
- 完整结果字段: 导出内容包含预制体路径、预制体名称、节点名称、节点路径、组件类型、Raycast Target 状态和问题描述。
- 工作流补齐: 可先扫描当前预制体，导出射线检测清单，再按清单逐项关闭或批量关闭无交互组件上的 Raycast Target。
- 拾取方式设置生效修复: 修复 Device Simulator 或触摸模拟输入会绕过已配置拾取方式的问题。现在右键、中键、Ctrl+左键、Alt+左键都会严格按照设置触发。
- 配置容错增强: 当历史配置中出现非法拾取方式值时，会安全回退到默认右键拾取，避免设置页或拾取逻辑异常。
- 自动保存补强: 关闭 UIProbe 面板时会同步收集 Picker 配置，确保自动拾取模式等设置稳定持久化。
- 仅截UI层与双背景差值合成: 通过自动控制 UI 相机连续进行两帧渲染（纯黑底 + 纯白底），并在内存中基于数学等式精确推算所有半透明特效区域的真实 Alpha 通道。彻底消除了此前包含特效（如 VFX / UIParticle）的 UI 在截图时产生的黑色块，输出完美带通道的 PNG 图片。
- UI相机智能拾取: 自动识别场景中 Tag="UICamera" 或 Culling Mask 仅渲染 UI 的专属相机进行截图剥离。
- 界面体验修复: 修复了截屏界面的左右排版问题，完美自适应当前窗口宽度。
- 突破序列化深度限制: 重构了预制体索引 (
PrefabIndexCache) 与界面记录 (UIRecordData) 的底层序列化结构。通过将树状嵌套转换为扁平列表 (Flattened List) 并采取按引用动态重建的技术，彻底打破了 Unity 原生JsonUtility所存在的Serialization depth limit 10报错限制。 - 大项目支持: 现已支持对项目中层级无限制深度的超复杂嵌套 UI 预制体进行完美索引与还原。
- 锚点图标优化: 为九宫格锚点提供直观的方位图标（◤ ▲ ◥, ◀ ● ▶, ◣ ▼ ◢），操作更明确。
- 互斥拉伸逻辑: 水平、垂直、全屏拉伸逻辑重构为独立互斥状态。点击一种模式会自动优化另一轴向布局，避免混乱。
- 状态视觉反馈: 当前生效的拉伸模式将以亮蓝色高亮显示，布局状态一目了然。
- 自由定制面板: 在【设置】选项卡中新增“功能模块显示设置”，允许用户自由勾选需要在左侧边栏显示的功能模块。
- 清爽的体验: 彻底告别臃肿，只留下您最常用的核心功能，保持工具面板的极简与高效。
- 安全防抖: “设置”与“关于”页签固定可见，当您隐藏当前正处的页签时，系统会自动平滑切换至设置页。
- 一键截图: 在 Prefab Mode 下直接截图，无需运行游戏
- 自动对焦 (Auto Frame):
- 智能识别 Canvas (Environment) (屏幕区域) 并优先对焦
- 回退支持：自动计算 Root RectTransform 包围盒
- 确保截图完美匹配设计分辨率 (如 1920x1080)
- 透明背景: 支持 Prefab 元素的透明背景截图 (需设置相机清除模式)
- 所见即所得: 调整截屏分辨率时，Game View 自动同步尺寸，预览最终效果
- 比例修复: 彻底解决非 16:9 (如 iPhone X) 下的画面拉伸/黑边问题
- 2x/4x 超采样: 生成印刷级高清截图
- 问题：统计逻辑错误地包含递归嵌套的所有引用，导致实例数量不准确
- 解决：添加父路径检查算法，只统计直接嵌套的预制体实例
- 影响：正向视图和反向视图的实例数量现在准确反映直接嵌套关系
- 单实例（×1）：
- 直接显示 📍 定位 按钮
- 点击打开父预制体并在Hierarchy中选中实例
- 多实例（×N）：
- 显示 ▶ 位置 (N) 展开按钮
- 展开后列出所有实例的层级路径
- 每个路径都有独立的 定位 按钮
- 两种定位方式：
- 📍 定位：打开父预制体，在Hierarchy中选中嵌套实例
- 📁 Project：在Project窗口中定位预制体资源文件
- 智能舞台切换：
- 自动检测当前打开的预制体
- 避免重复打开和保存提示弹窗
- 流畅的定位体验
使用场景：
- 🔍 快速定位：查看嵌套预制体在父预制体中的位置和配置
- 📊 多实例管理：一个预制体在父预制体中出现多次时，精确定位每个实例
- 🐛 问题排查：准确的实例统计帮助分析依赖关系
功能全面的 UI 节点快速创建与布局工具，显著提升 UI 搭建效率。
- 快速创建 (Quick Create):
- Empty: 创建空子节点
- Image: 创建 Image 节点，可选 No Raycast 优化性能
- TMP Text: 创建 TextMeshPro 节点，支持从配置选择默认字体
- 快速锚点 (Quick Anchors):
- 九宫格按钮: 快速对齐到父节点的九个方位
- 一键拉伸: 水平/垂直/全屏拉伸，自动重置 Offset
- 位置归零: 一键重置位置
- 智能布局 (Smart Layout):
- 全屏面板 (Full Panel): 一键铺满父节点，可设置边距
- 居中窗口 (Center Window): 居中并设置固定宽高
- 侧边栏 (Side Widget): 快速吸附到边缘
- 拉伸模式: 开启时使用边距拉伸，关闭时使用固定尺寸
- 功能联动:
- 参数实时显示: 显示 Anchor/Offset/Size 等参数
- 智能状态同步: 自动检测当前锚点配置并提示布局类型
- 一键应用: 自动同步布局类型和参数到表单
- 撤销支持: 所有操作均支持
Ctrl+Z撤销
使用场景:
- 🎨 UI 搭建: 快速创建 UI 节点，无需手动配置组件和属性
- 📐 布局调整: 一键应用常用布局模式，无需手动计算锚点和偏移
- 🚀 提升效率: 九宫格对齐、拉伸模式等功能大幅减少重复操作
全新功能：批量排查预制体之间的嵌套引用关系，支持双向视图和智能筛选。
- 双向视图:
- 正向视图: 显示每个预制体嵌套了哪些子预制体
- 反向视图: 显示每个预制体被哪些父预制体引用
- 智能筛选:
- 📁 文件夹筛选：只查看特定目录
- 🔢 嵌套数量筛选：全部 | 有嵌套 | ≥N 种嵌套
- 多层嵌套检测: 自动检测并显示深层嵌套关系（A→B→C）
- CSV 导出: 表头：序号 | 预制体文件夹 | 预制体名称 | 嵌套预制体名称 | 实例数量
使用场景:
- 🔍 影响评估: 修改公用预制体前，查看有哪些界面在用它
- 📊 复用率统计: 找出项目中最常被嵌套的预制体
- 🐛 依赖排查: 追踪预制体之间的依赖链
- 🏗️ 架构分析: 理解UI预制体的层级结构
- 延迟应用机制：提前规划GameObject重命名，保存为JSON文件，稍后导入应用
- 团队协作友好：
- JSON文件提交到Git，团队成员同步导入
- 避免"代码已改、节点未改"导致的引用失效
- 提前规划好重命名映射，代码和预制体分开提交
- 完整工作流：
- 导出：输入新名称 → 导出JSON（不应用）
- 开发：根据新名称修改代码引用
- 导入：选择JSON → 自动填充输入框（蓝色背景标记）
- 应用：批量应用或单个应用，保留动画修复提示
- 安全可控：
- 导入后可预览、手动调整、撤销单个映射
- 批量应用前显示确认对话框
- 保留现有的动画路径修复机制
- JSON格式：包含节点路径、新旧名称、预制体信息、导出时间，便于版本追溯
使用场景：
- 🔄 大规模重命名：规划好所有改名，一次性应用
- 👥 团队协作：一人规划，其他人导入应用
- 📝 配合代码修改：先导出JSON → 改代码 → 再应用重命名
- 多维度 UI 检查：在一个面板集成多种检测规则，全方位扫描 UI 问题
- 不必要的 Raycast Target：检测并关闭无交互组件的 Raycast Target，提升性能
- 资源缺失检测：扫描丢失的 Sprite 图片、字体引用
- 组件完整性：检测 Missing Script 和空引用组件
- 综合检测面板：
- 动态筛选：根据检测结果自动生成筛选标签，快速聚焦特定问题
- 批量修复：支持多选和批量关闭 Raycast Target，一键优化性能
- 可视化定位：点击结果直接 Ping 到目标节点
- 工作流整合：
- 原 "重名检测" 升级为 "预制体综合检测"
- 包含 "综合检测" (新)、"重命名修改"、"历史记录" 三大子功能
- 支持对当前打开的预制体进行一键扫描
- 可视化编辑：无需记忆富文本标签，通过可视化界面生成 TextMeshPro 富文本代码
- 基础格式支持：颜色、字号、粗体、斜体、下划线、删除线、透明度
- 预设快捷设置：10 种常用颜色 + 5 个预设字号，一键应用
- 自定义调节：自定义颜色选择器 + 字号滑块（10-60）+ 透明度滑块（0-100%）
- 累积模式：对同一文本多次应用不同格式，完美处理复杂多彩文本
- 格式历史记录：显示已应用的所有格式，支持撤销和删除单个格式
- 一键复制：生成的富文本代码一键复制到剪贴板，直接粘贴使用
使用场景：
- 🎮 游戏策划：快速生成任务描述、对话文本等多彩显示效果
- 🎨 UI 美术：配置物品描述、等级显示等分级高亮文本
- 📝 配置表编辑：直接生成标准格式的富文本配置字段
累积模式示例：
原始文本: "成功从[普通]-旧日镇撤离1次。"
步骤1: 选中"普通"(4-6) → 白色 → 累积应用
步骤2: 选中"旧日镇"(8-11) → 蓝色 → 累积应用
步骤3: 选中"1"(13-14) → 金色 → 累积应用
→ 一次性复制最终结果！
- 多种拾取方式：支持右键、Ctrl+左键、中键、Alt+左键四种拾取方式
- 解决按钮触发问题：右键拾取不会触发按钮的 onClick 事件，避免意外弹窗
- 灵活配置：在设置页面选择最适合的拾取方式，配置持久化
- UI 显示：拾取页签实时显示当前使用的拾取方式
- 向后兼容：默认使用右键拾取，旧配置自动兼容
推荐设置： 使用右键拾取（默认），既不会触发 UI 交互，操作也最方便。
使用方法：
- 打开 UIProbe → 设置 → "运行时拾取方式"
- 选择拾取方式（右键/Ctrl+左键/中键/Alt+左键）
- Play 模式下使用选定的方式拾取 UI 元素
- Play 模式截屏：在运行时对游戏画面进行高质量截屏
- 灵活分辨率设置：支持游戏分辨率或自定义分辨率（含 1080p、720p、2K、4K 快捷预设）
- 超采样支持：1x-4x 超采样倍数，显著提升截图质量和清晰度
- 透明背景截屏：实验性透明背景功能，适合 UI 元素截图
- 快捷键操作：F12 快速截屏，无需中断游戏
- 自动存储管理：自动保存到
UIProbe/Screenshots/文件夹，时间戳命名防止覆盖 - 便捷查看：一键打开截图文件夹或直接查看最新截图
使用场景：
- 🎮 游戏开发：记录 UI 界面、对比美术效果、保存 BUG 复现画面
- 🎨 UI 设计：导出透明背景 UI 元素、生成高分辨率原型图
- 📝 文档制作：编写操作手册、制作教程素材、展示功能特性
- 预制体嵌套引用追踪：自动扫描预制体内嵌套的预制体实例，记录层级关系
- 通用资源引用架构：统一的
AssetReference系统，支持图片、预制体、材质、字体等多种资源类型 - 索引页增强显示：预制体列表显示多种资源引用统计（🖼 图片、📦 预制体等）
- 详情分组展示：按资源类型分组显示引用详情，图标直观，可点击定位
- 资源查找页升级：新增资源类型选择器，支持按类型搜索（图片/预制体/材质/字体）
- CSV 导出：资源引用搜索结果可导出为 CSV 表格，包含预制体、节点路径、资源路径和额外信息
- 预制体反查功能：搜索某个预制体，快速找到所有嵌套使用它的父预制体
- 便捷交互：点击预制体引用可直接定位并选中资源
使用场景：
- 📊 影响范围评估：修改通用预制体前，查看所有引用它的父预制体
- 🔍 资源依赖分析：查看预制体使用了哪些外部预制体和图片资源
- 🎯 快速定位：通过资源名称反向查找使用它的所有预制体
- 文件化配置：所有设置保存到
UIProbe/Settings/config.json，脱离Unity EditorPrefs - 跨项目共享：配置文件独立于Unity项目，可在不同项目间共享
- 便于备份：配置文件可直接拷贝、备份或纳入版本控制
- 自动迁移：首次运行自动从EditorPrefs迁移，无需手动操作
- JSON格式：配置文件可读可编辑，方便手动调整
Windows: C:\Users\<用户名>\AppData\Roaming\UIProbe\Settings\config.json
macOS: ~/Library/Application Support/UIProbe/Settings/config.json
- 统一尺寸：将不同尺寸的图片批量规范化到统一尺寸
- 保持内容：保持非透明内容不变形，仅扩展透明区域
- 灵活对齐：支持居中对齐或保持原位两种模式
- 任意路径：支持处理项目外文件夹的图片
- 批量处理：一键处理整个文件夹（含子文件夹）
- 安全选项：可选覆盖原文件或生成新文件（自定义后缀）
- 双向查询：既能查看预制体使用了哪些图片，也能查看图片被哪些预制体引用
- 索引详情：在预制体索引中点击展开按钮，可查看该预制体使用的所有图片资源
- 反向搜索：新增"资源引用"标签页，搜索图片资源即可查看所有使用它的预制体
- 详细信息：显示图片名称、组件类型（Image/RawImage）、节点层级路径
- 快速定位：点击图片名即可在 Project 窗口定位该资源
- 自动记录：在重名检测中修改节点名称时，自动记录修改详情
- 日志生成：点击"完成修改并生成日志"按钮，自动生成标准CSV报告
- 详细信息：CSV包含预制体名称、修改前/后名称、完整节点路径、修改时间
- 便于存档：日志文件按日期归档在
Modification_Logs文件夹中 - 快捷访问：设置页面新增快速打开修改日志文件夹的按钮
- 精确层级匹配：修复逻辑升级为基于层级路径的精确匹配，彻底解决同名节点误伤问题
- 智能引用检测：重命名节点时，自动检测预制体中关联的动画剪辑
- 一键批量修复：发现断连的动画引用时，可一键批量更新所有从属的 AnimationClip
- 防误操作：提供操作确认对话框，告知将影响的动画和属性列表
- 如果从旧版本升级，建议直接使用 v1.7.7，包含更安全的修复逻辑
- 团队协作支持：导入批量检测结果后可按文件夹过滤
- 可视化选择：展开过滤面板，勾选/取消勾选要显示的文件夹
- 问题数统计：每个文件夹显示包含的问题预制体数量
- 持久化设置：排除的文件夹自动保存，下次导入自动应用
- 快捷操作：支持"全选"和"全不选"快速切换
使用场景：团队分工时，每个成员只需关注自己负责的模块文件夹
- 双模式导出：批量检测结果支持两种导出模式
- 简化模式：预制体+重复节点汇总（名称+数量）
- 详细模式：每个重复节点完整路径单独一行
- 智能过滤：自动过滤无重复命名的预制体，只导出有问题的项
- 路径优化：详细模式显示"所属文件夹"而非完整预制体路径，避免冗余
- 触摸输入支持：运行时拾取(Picker)现在支持触摸输入
- Simulator兼容：可在Unity Device Simulator中正常使用拾取功能
- 完整字段导出：批量检测CSV新增"是否已处理"、"处理时间"、"是否已弃用"、"弃用时间"列
- 布局修复：重命名检测组收起时不再占用过多空间
- 按钮对齐：弃用/打开按钮统一宽度，确保对齐
- 输入框焦点优化：重命名应用后自动清空输入框并释放焦点
- 弃用标记功能：批量检测支持标记已弃用预制体
- 自动过滤：导入批量结果时自动排除已弃用项
- 视觉反馈：已弃用项显示灰色背景和⛔图标
弃用功能使用：
- 点击卡片上的"弃用"按钮标记废弃预制体
- 已弃用项在下次导入时自动过滤
- 可随时点击"恢复"取消弃用状态
- 智能分组：同一预制体在同一天的记录合并到一个JSON文件
- 三层折叠：日期 → 预制体 → 具体记录
- 紧凑显示：预制体内记录采用紧凑格式，节省空间
- 批量管理：可删除整个预制体的所有记录
- 避免重复：不再为每次重命名创建新文件
UI结构示例：
📅 2026-01-19 (2个预制体, 共5条)
📦 MainPanel (3条记录)
1. 20:30:45 - Button → CloseButton
2. 20:41:23 - Image → BackgroundImage
📦 DialogPanel (2条记录)
1. 20:55:57 - Panel → ContentPanel
- 文件组织：按日期文件夹自动组织（Rename_History/2026-01-19/）
- 独立存储：每条记录独立JSON文件（预制体名_时间戳.json）
- 折叠展示：按日期分组，点击展开/收起
- 灵活删除：支持删除单条记录或整个日期文件夹
- 性能优化：延迟加载，避免单文件过大
- 焦点保持：重命名后自动展开对应组，无需滚动查找
- 智能提示：组消失时（已无重名）控制台显示提示
- 流畅体验：连续处理同一组节点更便捷
- 自动保存：所有检测规则修改立即保存
- 跨会话保持：关闭重开窗口设置不会重置
- 完整支持：检测范围、过滤模式、前缀、白名单、黑名单全部自动保存
- 进度跟踪：支持处理状态标记，已处理卡片显示绿色背景✅
- 智能完成：打开预制体自动检测，无重名自动标记完成
- 返回功能：单个检测显示"返回批量结果"按钮
- 进度显示：工具栏显示处理进度（已处理 X/Y）
- 状态持久化：处理状态保存到JSON，跨会话保持
- 子标签系统：重名检测页面分为「检测功能」和「历史记录」
- 自动刷新：重命名后自动重新检测，实时更新
- 搜索历史管理：历史记录新增✕删除按钮
- CSV自动保存：批量检测CSV自动保存到配置目录
- 自动保存索引：刷新索引后自动保存到磁盘，无需每次重新扫描。
- 自动加载索引：打开窗口时自动加载上次的索引，启动更快速。
- 智能检测：自动检测索引根路径变化，提示刷新。
- 显示更新时间：界面显示索引的上次更新时间。
- 存储位置：
<主文件夹>/IndexCache.json（默认在AppData）
- 搜索清除按钮：搜索框输入后显示 ✕ 按钮，一键清空并恢复索引状态。
- CSV格式改进：批量检测导出增加"是否存在重复命名"列（是/否），便于快速筛选。
- 灵活的检测范围：支持全局检测和同级（兄弟节点）检测。
- 智能过滤规则：
- 白名单：允许特定的节点名重复（如
Viewport,Content）。 - 黑名单：强制禁止特定的节点名重复。
- 前缀过滤：只检测特定前缀的节点（如
c_,m_）。 - UGUI 组件检测：检测同类型的组件节点是否重名。
- 白名单：允许特定的节点名重复（如
- 可视化设置：在 Settings 标签页中集中管理所有规则。
- 预制体索引集成：在 "预制体索引" 标签页中直接进行批量操作。
- 统一检测规则：批量检测自动使用 Settings 中配置的公用检测规则，确保检测标准一致。
- 批量检测：一键检测选中的多个预制体，支持进度显示和取消操作。
- CSV 导出：自动生成检测报告，包含：
- 所属文件夹
- 预制体名称
- 是否存在重复命名（是/否）
- 重名节点详情（节点名及重复次数）
- 历史记录：自动记录每一次重命名操作。
- 一键回滚：支持撤销重命名操作，恢复到之前的状态。
- 可视化界面：在重名检测面板底部查看操作历史。
- 统一存储：支持自定义数据存储路径。
- CSV 归档：检测报告自动保存到
CSV_Exports目录。 - 历史归档：重命名历史自动保存到
Rename_History目录。 - 索引缓存：预制体索引自动保存，启动即用。
在「设置」页面可以配置：
- 检测模式：Smart（智能过滤） / Strict（严格模式）
- 检测范围：Global（全局） / SameLevel（同级）/ Children（子节点）
- 白名单/黑名单：自定义允许或禁止重复的节点名称
配置文件独立于 Unity EditorPrefs，便于团队共享：
- Windows:
%AppData%/UIProbe/Settings/config.json - macOS:
~/Library/Application Support/UIProbe/Settings/config.json
柯家荣 · 沈浩天 — © 2024-2026 UIProbe Team.