UUID搜索引用定位查询工具上线

Creator 2.x 扩展插件
#1

商店地址
https://store.cocos.com/app/detail/8177

一句话简介

您是否曾因无法确定某个资源（脚本、图片、预制体、动画、材质等）在项目的何处被引用而烦恼？您是否在重构或删除资源时，总是担心遗漏而导致线上BUG？引用查找器 一键解决您的烦恼，精准、快速地定位所有资源引用，让您的项目维护和重构工作事半功倍！

支持版本
平台: Mac 、Win

版本: Cocos Creator 2.4.5 - 2.4.15

安装注意项
请确保您的 Cocos Creator 版本在 2.4.5 - 2.4.15 之间。
可以安装在项目的packages目录下，也可以安装在全局目录下。
推荐安装在全局目录，方便其他项目使用。
使用流程
1.安装完成后重新打开Creator编辑器

2.在Creator编辑器顶部菜单栏依次点击 -> 拓展 -> uuid_lookup -> open

或者直接点击资源管理器里面的任意资源 -> 右键 -> 引用查询 会自动打开插件并查询该资源的引用。

3.将弹出的编辑器面板嵌入Creator右侧，方便使用。

:sparkles: 亮点聚焦 :sparkles:

:rocket: 闪电般的快速定位：忘掉繁琐的搜索操作吧！您可以在插件中通过 文件名、路径、长/短 UUID 等任意信息进行搜索，瞬间锁定目标资源。
:computer_mouse: 右键一键查询：无需打开插件面板，直接在 资源管理器 中对任意资源 右键 -> 查找引用，结果立刻呈现！这是专为您打造的最高效工作流。
:link: 引用链式查询：在查找结果中，对引用的资源（如 Prefab）再次点击查询，即可 深挖其在项目中的引用，轻松追溯完整的引用链条，项目脉络一览无余！
核心功能

本插件提供了强大而细致的资源引用查找功能，深入您的项目，为您提供最精准的引用报告。

强大而灵活的查找能力
多种查找方式：
一键右键查询：在 资源管理器 中选中资源，右键一键查找。
模糊名称搜索：在插件面板中输入 文件名 或 路径 即可快速定位资源。
UUID 精准查询：支持输入 长/短 UUID 进行查询。
全面的资源支持：轻松查找 场景 (.fire)、预制体 (.prefab)、动画剪辑 (.anim)、材质 (.mtl) 以及 字体 (.fnt) 文件中对指定资源的引用。
精准到“点”的定位
普通的查找工具可能只会告诉您哪个文件引用了资源，但它能做得更多！
查找结果会精确到 场景/预制体 中的具体 节点 (Node)、组件 (Component) 以及 属性 (Property)。让您一目了然，无需再次手动寻找。
高效、便捷的结果处理
交互式结果列表：查找结果清晰地分组成“节点引用”和“资源引用”。更可通过 链式查询，对结果进行再查询，深挖引用关系。
一键直达：
定位资源：快速在 资源管理器 中高亮定位到引用文件。
打开资源：直接打开引用的场景、预制体等。
定位节点：如果引用在场景中，可以直接定位到该节点。
显示文件：在操作系统的文件夹中显示该文件。
复制信息：轻松复制资源的路径、UUID等信息。
人性化的自定义设置
结果显示定制：您可以选择“折叠”或“展开”查找结果，在结果繁多时保持控制台的清爽。同时，也可以选择是否在列表中显示类型和匹配文本等详细信息。
智能选项亮点：
:white_check_mark: 自动高亮首个资源：结果自动聚焦首项，提高效率。
:white_check_mark: 显示类型、UUID 和匹配文本：信息更直观，定位更精准。
:white_check_mark: 引用范围过滤：支持只查找“预制体和场景”，加快查询速度，减少无关结果干扰。
:white_check_mark: 开启右键查询：资源管理器中即可右键查找，快速无缝衔接。
为什么您需要这个插件？

节省海量时间：无论是通过右键菜单还是模糊搜索，查找引用都只在弹指之间。
避免线上错误：在删除或替换资源前，进行一次完整的引用检查，确保万无一失，有效避免因资源丢失导致的线上黑屏、报错等严重问题。
优化项目结构：定期清理无用资源，是保持项目健康、减小包体的关键。本插件是您进行此项工作的最佳助手。
提升开发体验：告别繁琐、重复的体力劳动，聚焦于核心玩法和逻辑开发，享受流畅、高效的工作流。

国庆放价
#2

什么时候打折了 准备入手试试

#3

打折了，从现在到国庆期间限时8折哈

#4

国庆放价，冲冲冲 :grinning:

#5

国庆放价！ Cocos开发者必备的UUID搜索插件限时折扣，查引用、理依赖，项目维护更省心！

#6

打折了哈，从现在到国庆期间限时8折哈 :grinning:

#7

需要一个3.8的版本.

#8

很强，在内存分析中起大用，不用自己去搜索目录了，强！！！！！！

#9

3.8后面可能会支持哈

#10

太便宜了，建议涨价，不要太卷了，给其他插件开发者留点路子。

#11

有道理，国庆节后涨涨价。

#12

image
image757×764 116 KB

#13

你去商店搜seek pro啊

#14

我最常用的插件更新了。

## 版本更新说明

本次更新重点优化了查询速度、脚本工作流和 Cocos Creator 3.x 兼容性。

### 更新亮点

- **查询速度大幅优化**  
  新增资源类型索引、缓存和批量处理机制，大型项目下查询更流畅，减少等待和编辑器卡顿。

- **支持 Cocos Creator 3.8.x**  
  同时适配 Cocos Creator 2.4.5 - 2.4.15 与 3.8.x，核心查询和引用定位流程保持一致。

- **拖动脚本后自动修正 import**  
  在资源管理器中移动 `.js`、`.ts` 文件或脚本文件夹后，自动更新项目内相对 `import`、`require` 路径，减少重构后的路径报错。

- **新增脚本依赖查询**  
  可选扫描脚本中的 `import` 引用，帮助分析公共工具、组件脚本和模块之间的依赖关系。

- **Button 点击脚本快速打开**  
  可从 `cc.Button` 的 Click Events 菜单直接打开绑定脚本，并支持复制绑定方法名。

- **引用结果更精准**  
  支持定位到场景或预制体中的具体节点、组件和属性，并可继续进行链式引用查询。

- **完善大项目使用体验**  
  支持引用结果折叠、场景/预制体范围过滤、资源类型索引和最近打开记录。

- **增加外部联动能力**  
  提供本地 `/open` 接口，可从日志工具或其他辅助工具中直接跳转到 Creator 资源。

### 使用建议

1. 更新后重启 Cocos Creator。
2. 在设置中确认已开启「资源类型索引（更快）」。
3. 如需移动脚本时自动修改路径，请开启「拖动后自动改 import」。
4. 大型项目日常查询可开启「引用仅查场景/预制体」，需要深度排查时再关闭。

### 安装注意

- Cocos Creator 2.4.x 请使用 2.4.5 - 2.4.15。
- Cocos Creator 3.x 建议使用 3.8.x。
- 插件可安装在项目 `packages` 目录，也可安装到全局插件目录。
- 安装或升级后请重启 Creator，确保菜单和 Inspector 功能正常加载。
#15

当前插件与/Users/feng/git/ylss/extensions/seek-pro相比有什么异同点？各自的优势是什么？如何选择

已处理 1m 53s

我按当前代码和 README 看，结论是：两者不是完全替代关系， uuid_lookup 是“资源查询 + 引用定位 + 工作流入口”的综合工具， seek-pro 是“Prefab/Scene UUID 问题扫描”的专用工具。

相同点

  • 都能查某个 UUID 在 .prefab / .scene 里的使用位置。
  • 都会解析到节点路径、组件、属性级别，而不是只告诉你“哪个文件包含 UUID”。
  • 都有资源管理器右键入口。
  • 都主要服务 Cocos Creator 3.x 项目里的资源引用排查。

主要差异

对比 当前插件 uuid_lookup seek-pro
定位 综合资源定位工具 UUID 专项排查工具
支持版本 Creator 2.4.x + 3.x manifest 写的是 >=3.3.0
查询输入 名称、路径、长 UUID、短 UUID、当前选中资源 主要从右键资源 UUID 或查缺失入口开始
引用范围 Scene/Prefab，也可扩展扫 anim/json/meta/material/spine/dragonbones/fbx/tiled-map 等 只扫 assets 下 .prefab / .scene
缺失 UUID 不是主功能 核心功能：查丢失引用
节点定位 支持打开资源、定位节点、高亮、Inspector 联动 主要是列出文件/节点/组件/属性
入口 面板、F5、右键、Inspector、Button、HTTP /open 菜单、快捷键、右键
工作流 删除前查引用、定位 UI 节点、查脚本引用、打开 Button 点击脚本 批量找坏引用、查某 UUID 具体使用点
复杂度 功能多，维护面大 小而专，逻辑直接

uuid_lookup 的优势

  • 更适合日常开发：只知道资源名、路径、UUID 都能查。
  • 查询后能继续操作：高亮、打开、打开文件夹、删除、查询引用链。
  • 引用结果可继续“定位节点”，对 UI / prefab 排查更顺手。
  • 支持 Inspector 快捷入口： open Component 、脚本引用查询、Button 点击脚本打开。
  • 支持外部 HTTP /open ，适合接入其他工具或自动化脚本。
  • 扫描范围更广，适合查图片、SpriteFrame、脚本、材质、动画、json、spine/龙骨等间接引用。

seek-pro 的优势

  • “查缺失 UUID”是它的核心能力，这点 uuid_lookup 目前不是主打。
  • 实现简单，目标明确：遍历 .prefab / .scene ，找丢失引用或指定 UUID 使用点。
  • 对批量体检很直接：想知道项目里哪些 prefab/scene 已经引用了不存在的资源，用它更快进入主题。
  • TypeScript 项目结构更清晰，专项维护成本低。

如何选择

  • 日常找资源、查谁引用、删除前确认、定位到节点/属性：选 uuid_lookup 。
  • 要做项目体检，批量找“已经丢失的 UUID 引用”：选 seek-pro 。
  • 只在 Creator 3.3+ 项目里做 prefab/scene UUID 排查： seek-pro 足够轻。
  • 要兼容 Creator 2.4 和 3.x，或需要 Inspector/Button/外部接口联动：选 uuid_lookup 。
  • 最实际的组合是： seek-pro 用于“坏引用巡检”， uuid_lookup 用于“定位、修复、日常资源引用工作流”。

我会保留两者，但定位不要重叠：把 seek-pro 当作诊断工具，把 uuid_lookup 当作生产力工具。如果要合并能力，最值得从 seek-pro 吸收进 uuid_lookup 的是“全项目缺失 UUID 扫描”这一项。