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

2026-02-11 00:36:56 +08:00
parent e0037c125a
commit 7d5e943ab1
6 changed files with 193 additions and 98 deletions
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -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 | ✅ 已实现 | |
--- a/README.md
+++ b/README.md
@@ -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

--- a/main.js
+++ b/main.js
@@ -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}`);
 		}
 	},

--- a/panel/index.js
+++ b/panel/index.js
@@ -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";
 	},
 });
--- a/scene-script.js
+++ b/scene-script.js
@@ -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) {
--- a/注意事项.md
+++ b/注意事项.md
@@ -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"` 检查目录名冲突。