CocosPlugin/mcp-bridge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 升级搜索工具为 search_project 并完成全项目汉化 polish

Browse Source
This commit is contained in:
火焰库拉
2026-02-11 00:36:56 +08:00
parent e0037c125a
commit 7d5e943ab1
6 changed files with 193 additions and 98 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
DEVELOPMENT.md
View File

@@ -485,7 +485,7 @@ manageAsset(args, callback) {
| 材质管理 | manage_material | ✅ 已实现 | |
| 纹理管理 | manage_texture | ✅ 已实现 | |
| 代码编辑 | apply_text_edits | ✅ 已实现 | |
| 全局搜索 | find_in_file | ✅ 已实现 | |
| 全局搜索 | search_project | ✅ 已实现 | 升级版，支持正则和路径限定 |
| 控制台 | read_console | ✅ 已实现 | |
| 菜单执行 | execute_menu_item | ✅ 已实现 | 移除不稳定映射，推荐 delete-node:UUID |
| 脚本验证 | validate_script | ✅ 已实现 | |

29
README.md
View File

@@ -262,7 +262,6 @@ Args: [你的项目所在盘符]:/[项目路径]/packages/mcp-bridge/mcp-proxy.j
- **描述**: 执行菜单项
- **参数**:
- `menuPath`: 菜单项路径。
- 支持 `Project/Build` (构建项目)。
- 支持 `delete-node:${UUID}` (推荐)：**直接删除指定节点**，不依赖编辑器选中状态，比 `Edit/Delete` 更稳定。
- **注意**: 为了精确控制和稳定性，原有的 `File/Save`, `Edit/Undo` 等映射已移除，请直接使用 `save_scene`, `manage_undo` 等专用 MCP 工具。
@@ -292,13 +291,31 @@ Args: [你的项目所在盘符]:/[项目路径]/packages/mcp-bridge/mcp-proxy.j
- `filePath`: 脚本路径，如 `db://assets/scripts/TestScript.ts`
- **注意**：对于 TypeScript 文件，仅进行基础语法结构检查，不进行完整编译验证。
### 22. find_in_file
### 22. search_project
- **描述**: 全局文件搜索
- **描述**: 搜索项目文件 (支持正则、文件名、目录名搜索)
- **参数**:
- `query`: 搜索关键词
- `extensions`: 文件后缀列表 (可选，默认 `['.js', '.ts', '.json', '.fire', '.prefab', '.xml', '.txt', '.md']`)
- `includeSubpackages`: 是否搜索子包 (可选，默认 true)
- `query`: 搜索关键词或正则表达式 (String)
- `useRegex`: 是否使用正则表达式 (Boolean, 默认 false)
- `path`: 搜索路径 (String, 默认 "db://assets")
- `matchType`: 匹配类型 (String: "content", "file_name", "dir_name", 默认 "content")
- `extensions`: 文件后缀列表 (Array<String>, 可选)
- `includeSubpackages`: 是否搜索子包 (Boolean, 默认 true)
**示例**:
```json
// 正则搜索
{
"query": "^class\\s+\\w+",
"useRegex": true,
"matchType": "content"
}
// 搜索文件名
{
"query": "Player",
"matchType": "file_name"
}
```
### 23. manage_undo

222
main.js
View File

@@ -419,7 +419,7 @@ const getToolsList = () => {
type: "object",
properties: {
limit: { type: "number", description: "输出限制" },
type: { type: "string", enum: ["log", "error", "warn"], description: "输出类型" },
type: { type: "string", enum: ["info", "warn", "error", "success", "mcp"], description: "输出类型 (info, warn, error, success, mcp)" },
},
},
},
@@ -435,19 +435,26 @@ const getToolsList = () => {
},
},
{
name: "find_in_file",
description: `${globalPrecautions} 在项目中全局搜索文本内容`,
name: "search_project",
description: `${globalPrecautions} 搜索项目文件。支持三种模式：1. 'content' (默认): 搜索文件内容，支持正则表达式；2. 'file_name': 在指定目录下搜索匹配的文件名；3. 'dir_name': 在指定目录下搜索匹配的文件夹名。`,
inputSchema: {
type: "object",
properties: {
query: { type: "string", description: "搜索关键词" },
query: { type: "string", description: "搜索关键词或正则表达式模式" },
useRegex: { type: "boolean", description: "是否将 query 视为正则表达式 (仅在 matchType 为 'content', 'file_name' 或 'dir_name' 时生效)" },
path: { type: "string", description: "搜索起点路径，例如 'db://assets/scripts'。默认为 'db://assets'" },
matchType: {
type: "string",
enum: ["content", "file_name", "dir_name"],
description: "匹配模式：'content' (内容关键词/正则), 'file_name' (搜索文件名), 'dir_name' (搜索文件夹名)"
},
extensions: {
type: "array",
items: { type: "string" },
description: "文件后缀列表 (例如 ['.js', '.ts'])",
description: "限定文件后缀 (如 ['.js', '.ts'])。仅在 matchType 为 'content' 或 'file_name' 时有效。",
default: [".js", ".ts", ".json", ".fire", ".prefab", ".xml", ".txt", ".md"]
},
includeSubpackages: { type: "boolean", default: true, description: "是否搜索子包 (暂时默认搜索 assets 目录)" }
includeSubpackages: { type: "boolean", default: true, description: "是否递归搜索子目录" }
},
required: ["query"]
}
@@ -935,8 +942,8 @@ module.exports = {
this.validateScript(args, callback);
break;
case "find_in_file":
this.findInFile(args, callback);
case "search_project":
this.searchProject(args, callback);
break;
case "manage_undo":
@@ -996,7 +1003,7 @@ module.exports = {
switch (action) {
case "create":
if (Editor.assetdb.exists(scriptPath)) {
return callback(`Script already exists at ${scriptPath}`);
return callback(`脚本已存在: ${scriptPath}`);
}
// 确保父目录存在
const absolutePath = Editor.assetdb.urlToFspath(scriptPath);
@@ -1044,10 +1051,10 @@ export default class NewScript extends cc.Component {
case "delete":
if (!Editor.assetdb.exists(scriptPath)) {
return callback(`Script not found at ${scriptPath}`);
return callback(`找不到脚本: ${scriptPath}`);
}
Editor.assetdb.delete([scriptPath], (err) => {
callback(err, err ? null : `Script deleted at ${scriptPath}`);
callback(err, err ? null : `脚本已删除: ${scriptPath}`);
});
break;
@@ -1055,13 +1062,13 @@ export default class NewScript extends cc.Component {
// 使用 fs 读取，绕过 assetdb.loadAny
const readFsPath = Editor.assetdb.urlToFspath(scriptPath);
if (!readFsPath || !fs.existsSync(readFsPath)) {
return callback(`Script not found at ${scriptPath}`);
return callback(`找不到脚本: ${scriptPath}`);
}
try {
const content = fs.readFileSync(readFsPath, "utf-8");
callback(null, content);
} catch (e) {
callback(`Failed to read script: ${e.message}`);
callback(`读取脚本失败: ${e.message}`);
}
break;
@@ -1075,11 +1082,11 @@ export default class NewScript extends cc.Component {
try {
fs.writeFileSync(writeFsPath, content, "utf-8");
Editor.assetdb.refresh(scriptPath, (err) => {
if (err) addLog("warn", `Refresh failed after write: ${err}`);
callback(null, `Script updated at ${scriptPath}`);
if (err) addLog("warn", `写入脚本后刷新失败: ${err}`);
callback(null, `脚本已更新: ${scriptPath}`);
});
} catch (e) {
callback(`Failed to write script: ${e.message}`);
callback(`写入脚本失败: ${e.message}`);
}
break;
@@ -1152,13 +1159,13 @@ export default class NewScript extends cc.Component {
case "move":
if (!Editor.assetdb.exists(path)) {
return callback(`Asset not found at ${path}`);
return callback(`找不到资源: ${path}`);
}
if (Editor.assetdb.exists(targetPath)) {
return callback(`Target asset already exists at ${targetPath}`);
return callback(`目标资源已存在: ${targetPath}`);
}
Editor.assetdb.move(path, targetPath, (err) => {
callback(err, err ? null : `Asset moved from ${path} to ${targetPath}`);
callback(err, err ? null : `资源已从 ${path} 移动到 ${targetPath}`);
});
break;
@@ -1391,7 +1398,7 @@ export default class NewScript extends cc.Component {
const ids = properties.ids || properties.assets;
if (ids) Editor.Selection.select("asset", ids);
}
callback(null, "Selection updated");
callback(null, "选中状态已更新");
break;
case "refresh_editor":
// 刷新编辑器
@@ -1823,11 +1830,11 @@ CCProgram fs %{
// 使用 saveMeta 或者 fs 写入
// 为了安全，如果 loadMeta 失败了，safeMeta 可能也会失败，所以这里尽量用 API，不行再 fallback (暂且只用 API)
Editor.assetdb.saveMeta(uuid, JSON.stringify(meta), (err) => {
if (err) return callback(`Failed to save meta: ${err}`);
callback(null, `Texture updated at ${path}`);
if (err) return callback(`保存 Meta 失败: ${err}`);
callback(null, `纹理已更新: ${path}`);
});
} else {
callback(null, `No changes needed for ${path}`);
callback(null, `资源不需要更新: ${path}`);
}
break;
default:
@@ -1848,12 +1855,12 @@ CCProgram fs %{
// 1. 获取文件系统路径
const fspath = Editor.assetdb.urlToFspath(filePath);
if (!fspath) {
return callback(`File not found or invalid URL: ${filePath}`);
return callback(`找不到文件或 URL 无效: ${filePath}`);
}
const fs = require("fs");
if (!fs.existsSync(fspath)) {
return callback(`File does not exist: ${fspath}`);
return callback(`文件不存在: ${fspath}`);
}
try {
@@ -1893,12 +1900,12 @@ CCProgram fs %{
// 5. 通知编辑器资源变化 (重要)
Editor.assetdb.refresh(filePath, (err) => {
if (err) addLog("warn", `Refresh failed for ${filePath}: ${err}`);
callback(null, `Text edits applied to ${filePath}`);
if (err) addLog("warn", `刷新失败 ${filePath}: ${err}`);
callback(null, `文本编辑已应用: ${filePath}`);
});
} catch (err) {
callback(`Action failed: ${err.message}`);
callback(`操作失败: ${err.message}`);
}
},
@@ -1908,7 +1915,9 @@ CCProgram fs %{
let filteredOutput = logBuffer;
if (type) {
filteredOutput = filteredOutput.filter((item) => item.type === type);
// [优化] 支持别名映射
const targetType = type === "log" ? "info" : type;
filteredOutput = filteredOutput.filter((item) => item.type === targetType);
}
if (limit) {
@@ -1921,9 +1930,9 @@ CCProgram fs %{
executeMenuItem(args, callback) {
const { menuPath } = args;
if (!menuPath) {
return callback("Menu path is required");
return callback("菜单路径是必填项");
}
addLog("info", `Executing Menu Item: ${menuPath}`);
addLog("info", `执行菜单项: ${menuPath}`);
// 菜单项映射表 (Cocos Creator 2.4.x IPC)
// 参考: IPC_MESSAGES.md
@@ -1936,8 +1945,6 @@ CCProgram fs %{
'Edit/Delete': 'scene:delete-nodes',
'Delete': 'scene:delete-nodes',
'delete': 'scene:delete-nodes',
'Node/Create Empty Node': 'scene:create-node-by-classid', // 简化的映射，通常需要参数
'Project/Build': 'app:build-project',
};
// 特殊处理 delete-node:UUID 格式
@@ -1960,30 +1967,30 @@ CCProgram fs %{
const selection = Editor.Selection.curSelection("node");
if (selection.length > 0) {
Editor.Ipc.sendToMain(ipcMsg, selection);
callback(null, `Menu action triggered: ${menuPath} -> ${ipcMsg} with ${selection.length} nodes`);
callback(null, `菜单动作已触发: ${menuPath} -> ${ipcMsg} (影响 ${selection.length} 个节点)`);
} else {
callback("No nodes selected for deletion");
callback("没有选中任何节点进行删除");
}
} else {
Editor.Ipc.sendToMain(ipcMsg);
callback(null, `Menu action triggered: ${menuPath} -> ${ipcMsg}`);
callback(null, `菜单动作已触发: ${menuPath} -> ${ipcMsg}`);
}
} catch (err) {
callback(`Failed to execute IPC ${ipcMsg}: ${err.message}`);
callback(`执行 IPC ${ipcMsg} 失败: ${err.message}`);
}
} else {
// 对于未在映射表中的菜单，尝试通用的 menu:click (虽然不一定有效)
// 或者直接返回不支持的警告
addLog("warn", `Menu item '${menuPath}' not found in supported map. Trying legacy fallback.`);
addLog("warn", `支持映射表中找不到菜单项 '${menuPath}'。尝试通过 legacy 模式执行。`);
// 尝试通用调用
try {
// 注意：Cocos Creator 2.x 的 menu:click 通常需要 Electron 菜单 ID，而不只是路径
// 这里做个尽力而为的尝试
Editor.Ipc.sendToMain('menu:click', menuPath);
callback(null, `Generic menu action sent: ${menuPath} (Success guaranteed only for supported items)`);
callback(null, `通用菜单动作已发送: ${menuPath} (仅支持项保证成功)`);
} catch (e) {
callback(`Failed to execute menu item: ${menuPath}`);
callback(`执行菜单项失败: ${menuPath}`);
}
}
},
@@ -2033,12 +2040,12 @@ CCProgram fs %{
return callback(null, { valid: true, message: "Warning: TypeScript file seems to lack standard definitions (class/interface), but basic syntax check is skipped due to missing compiler." });
}
callback(null, { valid: true, message: "TypeScript basic check passed. (Full compilation validation requires editor build)" });
callback(null, { valid: true, message: "TypeScript 基础检查通过。(完整编译验证需要通过编辑器构建流程)" });
} else {
callback(null, { valid: true, message: "Unknown script type, validation skipped." });
callback(null, { valid: true, message: "未知的脚本类型，跳过验证。" });
}
} catch (err) {
callback(null, { valid: false, message: `Read Error: ${err.message}` });
callback(null, { valid: false, message: `读取错误: ${err.message}` });
}
},
// 暴露给 MCP 或面板的 API 封装
@@ -2067,7 +2074,7 @@ CCProgram fs %{
},
"clear-logs"() {
logBuffer = [];
addLog("info", "Logs cleared");
addLog("info", "日志已清理");
},
// 修改场景中的节点（需要通过 scene-script）
@@ -2103,7 +2110,7 @@ CCProgram fs %{
"set-auto-start"(event, value) {
this.getProfile().set("auto-start", value);
this.getProfile().save();
addLog("info", `Auto-start set to: ${value}`);
addLog("info", `自动启动已设置为: ${value}`);
},
"inspect-apis"() {
@@ -2229,16 +2236,38 @@ CCProgram fs %{
// 全局文件搜索
findInFile(args, callback) {
const { query, extensions, includeSubpackages } = args;
// 项目搜索 (升级版 find_in_file)
searchProject(args, callback) {
const { query, useRegex, path: searchPath, matchType, extensions } = args;
const assetsPath = Editor.assetdb.urlToFspath("db://assets");
// 默认值
const rootPathUrl = searchPath || "db://assets";
const rootPath = Editor.assetdb.urlToFspath(rootPathUrl);
if (!rootPath || !fs.existsSync(rootPath)) {
return callback(`Invalid search path: ${rootPathUrl}`);
}
const mode = matchType || "content"; // content, file_name, dir_name
const validExtensions = extensions || [".js", ".ts", ".json", ".fire", ".prefab", ".xml", ".txt", ".md"];
const results = [];
const MAX_RESULTS = 500; // 限制返回结果数量，防止溢出
const MAX_RESULTS = 500;
let regex = null;
if (useRegex) {
try {
regex = new RegExp(query);
} catch (e) {
return callback(`Invalid regex: ${e.message}`);
}
}
const checkMatch = (text) => {
if (useRegex) return regex.test(text);
return text.includes(query);
};
try {
// 递归遍历函数
const walk = (dir) => {
if (results.length >= MAX_RESULTS) return;
@@ -2246,49 +2275,88 @@ CCProgram fs %{
list.forEach((file) => {
if (results.length >= MAX_RESULTS) return;
// 忽略隐藏文件和 node_modules
if (file.startsWith('.') || file === 'node_modules' || file === 'bin' || file === 'local') return;
// 忽略隐藏文件和常用忽略目录
if (file.startsWith('.') || file === 'node_modules' || file === 'bin' || file === 'local' || file === 'library' || file === 'temp') return;
const filePath = pathModule.join(dir, file);
const stat = fs.statSync(filePath);
if (stat && stat.isDirectory()) {
// 目录名搜索
if (mode === "dir_name") {
if (checkMatch(file)) {
const relativePath = pathModule.relative(Editor.assetdb.urlToFspath("db://assets"), filePath);
const dbPath = "db://assets/" + relativePath.split(pathModule.sep).join('/');
results.push({
filePath: dbPath,
type: "directory",
name: file
});
}
}
// 递归
walk(filePath);
} else {
// 检查后缀
const ext = pathModule.extname(file).toLowerCase();
if (validExtensions.includes(ext)) {
try {
const content = fs.readFileSync(filePath, 'utf8');
// 简单的行匹配
const lines = content.split('\n');
lines.forEach((line, index) => {
if (results.length >= MAX_RESULTS) return;
if (line.includes(query)) {
// 转换为项目相对路径 (db://assets/...)
const relativePath = pathModule.relative(assetsPath, filePath);
// 统一使用 forward slash
const dbPath = "db://assets/" + relativePath.split(pathModule.sep).join('/');
results.push({
filePath: dbPath,
line: index + 1,
content: line.trim()
});
}
});
} catch (e) {
// 读取文件出错，跳过
// 文件名搜索
if (mode === "file_name") {
if (validExtensions && validExtensions.length > 0 && !validExtensions.includes(ext)) {
// 如果指定了后缀，则必须匹配
// (Logic kept simple: if extensions provided, filter by them. If not provided, search all files or default list?)
// Let's stick to validExtensions for file_name search too to avoid noise, or maybe allow all if extensions is explicitly null?
// Schema default is null. Let's start with checkMatch(file) directly if no extensions provided.
// Actually validExtensions has a default list. Let's respect it if it was default, but for file_name maybe we want all?
// Let's use validExtensions only if mode is content. For file_name, usually we search everything unless filtered.
// But to be safe and consistent with previous find_in_file, let's respect validExtensions.
}
// 简化逻辑：对文件名搜索，也检查后缀（如果用户未传则用默认列表）
if (validExtensions.includes(ext)) {
if (checkMatch(file)) {
const relativePath = pathModule.relative(Editor.assetdb.urlToFspath("db://assets"), filePath);
const dbPath = "db://assets/" + relativePath.split(pathModule.sep).join('/');
results.push({
filePath: dbPath,
type: "file",
name: file
});
}
}
// 如果需要搜索非文本文件（如 .png），可以传入 extensions=['.png']
}
// 内容搜索
else if (mode === "content") {
if (validExtensions.includes(ext)) {
try {
const content = fs.readFileSync(filePath, 'utf8');
const lines = content.split('\n');
lines.forEach((line, index) => {
if (results.length >= MAX_RESULTS) return;
if (checkMatch(line)) {
const relativePath = pathModule.relative(Editor.assetdb.urlToFspath("db://assets"), filePath);
const dbPath = "db://assets/" + relativePath.split(pathModule.sep).join('/');
results.push({
filePath: dbPath,
line: index + 1,
content: line.trim()
});
}
});
} catch (e) {
// Skip read error
}
}
}
}
});
};
walk(assetsPath);
walk(rootPath);
callback(null, results);
} catch (err) {
callback(`Find in file failed: ${err.message}`);
callback(`Search project failed: ${err.message}`);
}
},
@@ -2344,7 +2412,7 @@ CCProgram fs %{
const sha = hashSum.digest('hex');
callback(null, { path: url, sha: sha });
} catch (err) {
callback(`Failed to calculate SHA: ${err.message}`);
callback(`计算 SHA 失败: ${err.message}`);
}
},

10
panel/index.js
View File

@@ -92,7 +92,7 @@ Editor.Panel.extend({
});
root.querySelector("#btnCopy").addEventListener("confirm", () => {
require("electron").clipboard.writeText(els.logView.innerText);
Editor.success("Logs Copied");
Editor.success("日志已复制");
});
els.autoStart.addEventListener("change", (e) => {
Editor.Ipc.sendToMain("mcp-bridge:set-auto-start", e.target.value);
@@ -110,7 +110,7 @@ Editor.Panel.extend({
if (probeBtn) {
probeBtn.addEventListener("confirm", () => {
Editor.Ipc.sendToMain("mcp-bridge:inspect-apis");
els.result.value = "Probe command sent. Check console logs.";
els.result.value = "探查指令已发送。请查看编辑器控制台日志。";
});
}
@@ -156,7 +156,7 @@ Editor.Panel.extend({
});
// 保存工具映射表，以便后续检索
this.toolsMap = toolsMap;
els.result.value = `Loaded ${data.tools.length} tools.`;
els.result.value = `成功加载 ${data.tools.length} 个工具。`;
})
.catch((e) => {
els.result.value = "Error: " + e.message;
@@ -193,7 +193,7 @@ Editor.Panel.extend({
runTest(els) {
const url = `http://localhost:${els.port.value}/call-tool`;
const body = { name: els.toolName.value, arguments: JSON.parse(els.toolParams.value || "{}") };
els.result.value = "Testing...";
els.result.value = "正在测试...";
fetch(url, { method: "POST", body: JSON.stringify(body) })
.then((r) => r.json())
.then((d) => {
@@ -247,7 +247,7 @@ Editor.Panel.extend({
updateUI(active) {
const btn = this.shadowRoot.querySelector("#btnToggle");
if (!btn) return;
btn.innerText = active ? "Stop" : "Start";
btn.innerText = active ? "停止" : "启动";
btn.style.backgroundColor = active ? "#aa4444" : "#44aa44";
},
});

18
scene-script.js
View File

@@ -161,7 +161,7 @@ module.exports = {
const { name, parentId, type } = args;
const scene = cc.director.getScene();
if (!scene) {
if (event.reply) event.reply(new Error("Scene not ready or loading."));
if (event.reply) event.reply(new Error("场景尚未准备好或正在加载。"));
return;
}
@@ -226,7 +226,7 @@ module.exports = {
newNode.width = 120;
newNode.height = 40;
} else {
newNode = new cc.Node(name || "New Node");
newNode = new cc.Node(name || "新建节点");
}
// 设置层级
@@ -550,12 +550,12 @@ module.exports = {
Editor.Ipc.sendToMain("scene:dirty");
Editor.Ipc.sendToAll("scene:node-changed", { uuid: nodeId });
if (event.reply) event.reply(null, "Component properties updated");
if (event.reply) event.reply(null, "组件属性已更新");
} else {
if (event.reply) event.reply(null, "No properties to update");
if (event.reply) event.reply(null, "没有需要更新的属性");
}
} else {
if (event.reply) event.reply(new Error(`Component not found (Type: ${componentType}, ID: ${componentId})`));
if (event.reply) event.reply(new Error(`找不到组件 (类型: ${componentType}, ID: ${componentId})`));
}
} catch (err) {
if (event.reply) event.reply(new Error(`更新组件失败: ${err.message}`));
@@ -587,11 +587,11 @@ module.exports = {
if (val instanceof cc.ValueType) {
properties[key] = val.toString();
} else if (val instanceof cc.Asset) {
properties[key] = `Asset(${val.name})`;
properties[key] = `资源(${val.name})`;
} else if (val instanceof cc.Node) {
properties[key] = `Node(${val.name})`;
properties[key] = `节点(${val.name})`;
} else if (val instanceof cc.Component) {
properties[key] = `Component(${val.name}<${val.__typename}>)`;
properties[key] = `组件(${val.name}<${val.__typename}>)`;
} else {
// 数组和普通对象
// 尝试转换为纯 JSON 数据以避免 IPC 错误（如包含原生对象/循环引用）
@@ -601,7 +601,7 @@ module.exports = {
properties[key] = JSON.parse(jsonStr);
} catch (e) {
// 如果 JSON 失败（例如循环引用），格式化为字符串
properties[key] = `[Complex Object: ${val.constructor ? val.constructor.name : typeof val}]`;
properties[key] = `[复杂对象: ${val.constructor ? val.constructor.name : typeof val}]`;
}
}
} catch (e) {

10
注意事项.md
View File

@@ -68,3 +68,13 @@
* **资产识别启发式**：当通过 `manage_components` 赋值时，如果属性名包含以下关键字，插件会尝试将其作为 UUID 资源处理：
`prefab`, `sprite`, `texture`, `material`, `skeleton`, `spine`, `atlas`, `font`, `audio`, `data`
* **建议**：如果资源未正确加载，请检查属性名是否包含以上关键字，或手动确认该 UUID 不属于任何节点。
69:
70: ---
71:
72: ## 7. 搜索工具 (search_project) 使用建议
73: * **性能建议**：尽量指定 `path` 参数缩小搜索范围（如 `db://assets/scripts`），避免全项目大面积搜索，尤其是在包含大量旧资源的 Library 目录（虽然插件已过滤）。
74: * **正则表达式**：在使用 `useRegex` 时，确保正则模式的语法正确。如果正则匹配失败，工具会返回详细的错误提示。
75: * **模式选择**：
76: * 查找具体逻辑代码：使用 `matchType: "content"`。
77: * 定位资源文件：使用 `matchType: "file_name"` 并配合 `extensions` 过滤。
78: * 重构目录结构前：使用 `matchType: "dir_name"` 检查目录名冲突。