+
@@ -90,4 +94,19 @@
#resultContent { flex: 1; }
.button-group { display: flex; gap: 5px; padding: 5px 0; }
label { font-size: 11px; color: #888; margin: 4px 0; }
+ .tool-description {
+ margin-bottom: 10px;
+ }
+ .description-box {
+ background: #222;
+ color: #ccc;
+ border: 1px solid #444;
+ padding: 8px;
+ font-size: 11px;
+ line-height: 1.4;
+ min-height: 60px;
+ max-height: 120px;
+ overflow-y: auto;
+ border-radius: 2px;
+ }
\ No newline at end of file
diff --git a/panel/index.js b/panel/index.js
index 29ad429..9a1255f 100644
--- a/panel/index.js
+++ b/panel/index.js
@@ -2,151 +2,225 @@
const fs = require("fs");
Editor.Panel.extend({
- style: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
- template: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
+ style: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
+ template: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
- messages: {
- "mcp-bridge:on-log"(event, log) { this.renderLog(log); },
- "mcp-bridge:state-changed"(event, config) { this.updateUI(config.active); }
- },
+ messages: {
+ "mcp-bridge:on-log"(event, log) {
+ this.renderLog(log);
+ },
+ "mcp-bridge:state-changed"(event, config) {
+ this.updateUI(config.active);
+ },
+ },
- ready() {
- const root = this.shadowRoot;
- // 获取元素
- const els = {
- port: root.querySelector("#portInput"),
- btnToggle: root.querySelector("#btnToggle"),
- autoStart: root.querySelector("#autoStartCheck"),
- logView: root.querySelector("#logConsole"),
- tabMain: root.querySelector("#tabMain"),
- tabTest: root.querySelector("#tabTest"),
- panelMain: root.querySelector("#panelMain"),
- panelTest: root.querySelector("#panelTest"),
- toolName: root.querySelector("#toolName"),
- toolParams: root.querySelector("#toolParams"),
- toolsList: root.querySelector("#toolsList"),
- testBtn: root.querySelector("#testBtn"),
- listBtn: root.querySelector("#listToolsBtn"),
- clearBtn: root.querySelector("#clearTestBtn"),
- result: root.querySelector("#resultContent"),
- left: root.querySelector("#testLeftPanel"),
- resizer: root.querySelector("#testResizer")
- };
+ ready() {
+ const root = this.shadowRoot;
+ // 获取元素
+ const els = {
+ port: root.querySelector("#portInput"),
+ btnToggle: root.querySelector("#btnToggle"),
+ autoStart: root.querySelector("#autoStartCheck"),
+ logView: root.querySelector("#logConsole"),
+ tabMain: root.querySelector("#tabMain"),
+ tabTest: root.querySelector("#tabTest"),
+ panelMain: root.querySelector("#panelMain"),
+ panelTest: root.querySelector("#panelTest"),
+ toolName: root.querySelector("#toolName"),
+ toolParams: root.querySelector("#toolParams"),
+ toolDescription: root.querySelector("#toolDescription"),
+ toolsList: root.querySelector("#toolsList"),
+ testBtn: root.querySelector("#testBtn"),
+ listBtn: root.querySelector("#listToolsBtn"),
+ clearBtn: root.querySelector("#clearTestBtn"),
+ result: root.querySelector("#resultContent"),
+ left: root.querySelector("#testLeftPanel"),
+ resizer: root.querySelector("#testResizer"),
+ };
- // 1. 初始化状态
- Editor.Ipc.sendToMain("mcp-bridge:get-server-state", (err, data) => {
- if (data) {
- els.port.value = data.config.port;
- els.autoStart.value = data.autoStart;
- this.updateUI(data.config.active);
- els.logView.innerHTML = "";
- data.logs.forEach(l => this.renderLog(l));
- }
- });
+ // 1. 初始化状态
+ Editor.Ipc.sendToMain("mcp-bridge:get-server-state", (err, data) => {
+ if (data) {
+ els.port.value = data.config.port;
+ els.autoStart.value = data.autoStart;
+ this.updateUI(data.config.active);
+ els.logView.innerHTML = "";
+ data.logs.forEach((l) => this.renderLog(l));
+ }
+ });
- // 2. 标签切换
- els.tabMain.addEventListener("confirm", () => {
- els.tabMain.classList.add("active"); els.tabTest.classList.remove("active");
- els.panelMain.classList.add("active"); els.panelTest.classList.remove("active");
- });
- els.tabTest.addEventListener("confirm", () => {
- els.tabTest.classList.add("active"); els.tabMain.classList.remove("active");
- els.panelTest.classList.add("active"); els.panelMain.classList.remove("active");
- this.fetchTools(els);
- });
+ // 2. 标签切换
+ els.tabMain.addEventListener("confirm", () => {
+ els.tabMain.classList.add("active");
+ els.tabTest.classList.remove("active");
+ els.panelMain.classList.add("active");
+ els.panelTest.classList.remove("active");
+ });
+ els.tabTest.addEventListener("confirm", () => {
+ els.tabTest.classList.add("active");
+ els.tabMain.classList.remove("active");
+ els.panelTest.classList.add("active");
+ els.panelMain.classList.remove("active");
+ this.fetchTools(els);
+ });
- // 3. 基础功能
- els.btnToggle.addEventListener("confirm", () => {
- Editor.Ipc.sendToMain("mcp-bridge:toggle-server", parseInt(els.port.value));
- });
- root.querySelector("#btnClear").addEventListener("confirm", () => {
- els.logView.innerHTML = ""; Editor.Ipc.sendToMain("mcp-bridge:clear-logs");
- });
- root.querySelector("#btnCopy").addEventListener("confirm", () => {
- require("electron").clipboard.writeText(els.logView.innerText);
- Editor.success("Logs Copied");
- });
- els.autoStart.addEventListener("change", (e) => {
- Editor.Ipc.sendToMain("mcp-bridge:set-auto-start", e.target.value);
- });
+ // 3. 基础功能
+ els.btnToggle.addEventListener("confirm", () => {
+ Editor.Ipc.sendToMain("mcp-bridge:toggle-server", parseInt(els.port.value));
+ });
+ root.querySelector("#btnClear").addEventListener("confirm", () => {
+ els.logView.innerHTML = "";
+ Editor.Ipc.sendToMain("mcp-bridge:clear-logs");
+ });
+ root.querySelector("#btnCopy").addEventListener("confirm", () => {
+ require("electron").clipboard.writeText(els.logView.innerText);
+ Editor.success("Logs Copied");
+ });
+ els.autoStart.addEventListener("change", (e) => {
+ Editor.Ipc.sendToMain("mcp-bridge:set-auto-start", e.target.value);
+ });
- // 4. 测试页功能
- els.listBtn.addEventListener("confirm", () => this.fetchTools(els));
- els.clearBtn.addEventListener("confirm", () => { els.result.value = ""; });
- els.testBtn.addEventListener("confirm", () => this.runTest(els));
+ // 4. 测试页功能
+ els.listBtn.addEventListener("confirm", () => this.fetchTools(els));
+ els.clearBtn.addEventListener("confirm", () => {
+ els.result.value = "";
+ });
+ els.testBtn.addEventListener("confirm", () => this.runTest(els));
- // 5. 【修复】拖拽逻辑
- if (els.resizer && els.left) {
- els.resizer.addEventListener('mousedown', (e) => {
- e.preventDefault();
- const startX = e.clientX;
- const startW = els.left.offsetWidth;
- const onMove = (ev) => { els.left.style.width = (startW + (ev.clientX - startX)) + "px"; };
- const onUp = () => {
- document.removeEventListener('mousemove', onMove);
- document.removeEventListener('mouseup', onUp);
- document.body.style.cursor = 'default';
- };
- document.addEventListener('mousemove', onMove);
- document.addEventListener('mouseup', onUp);
- document.body.style.cursor = 'col-resize';
- });
- }
- },
+ // 5. 【修复】拖拽逻辑
+ if (els.resizer && els.left) {
+ els.resizer.addEventListener("mousedown", (e) => {
+ e.preventDefault();
+ const startX = e.clientX;
+ const startW = els.left.offsetWidth;
+ const onMove = (ev) => {
+ els.left.style.width = startW + (ev.clientX - startX) + "px";
+ };
+ const onUp = () => {
+ document.removeEventListener("mousemove", onMove);
+ document.removeEventListener("mouseup", onUp);
+ document.body.style.cursor = "default";
+ };
+ document.addEventListener("mousemove", onMove);
+ document.addEventListener("mouseup", onUp);
+ document.body.style.cursor = "col-resize";
+ });
+ }
+ },
- fetchTools(els) {
- const url = `http://localhost:${els.port.value}/list-tools`;
- fetch(url).then(r => r.json()).then(data => {
- els.toolsList.innerHTML = "";
- data.tools.forEach(t => {
- const item = document.createElement('div');
- item.className = 'tool-item';
- item.textContent = t.name;
- item.onclick = () => {
- els.toolName.value = t.name;
- els.toolParams.value = JSON.stringify(this.getExample(t.name), null, 2);
- };
- els.toolsList.appendChild(item);
- });
- els.result.value = `Loaded ${data.tools.length} tools.`;
- }).catch(e => { els.result.value = "Error: " + e.message; });
- },
+ fetchTools(els) {
+ const url = `http://localhost:${els.port.value}/list-tools`;
+ fetch(url)
+ .then((r) => r.json())
+ .then((data) => {
+ els.toolsList.innerHTML = "";
+ const toolsMap = {};
+ data.tools.forEach((t) => {
+ toolsMap[t.name] = t;
+ const item = document.createElement("div");
+ item.className = "tool-item";
+ item.textContent = t.name;
+ item.onclick = () => {
+ els.toolName.value = t.name;
+ els.toolParams.value = JSON.stringify(this.getExample(t.name), null, 2);
+ this.showToolDescription(els, t);
+ };
+ els.toolsList.appendChild(item);
+ });
+ // 保存工具信息到实例，以便后续使用
+ this.toolsMap = toolsMap;
+ els.result.value = `Loaded ${data.tools.length} tools.`;
+ })
+ .catch((e) => {
+ els.result.value = "Error: " + e.message;
+ });
+ },
- 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...";
- fetch(url, { method: 'POST', body: JSON.stringify(body) })
- .then(r => r.json())
- .then(d => { els.result.value = JSON.stringify(d, null, 2); })
- .catch(e => { els.result.value = "Error: " + e.message; });
- },
+ showToolDescription(els, tool) {
+ if (!tool) {
+ els.toolDescription.textContent = "选择工具查看说明";
+ return;
+ }
+
+ let description = tool.description || "无描述";
+ let inputSchema = tool.inputSchema;
+
+ let details = [];
+ if (inputSchema && inputSchema.properties) {
+ details.push("参数说明:");
+ for (const [key, prop] of Object.entries(inputSchema.properties)) {
+ let propDesc = `- ${key}`;
+ if (prop.description) {
+ propDesc += `: ${prop.description}`;
+ }
+ if (prop.required || (inputSchema.required && inputSchema.required.includes(key))) {
+ propDesc += " (必填)";
+ }
+ details.push(propDesc);
+ }
+ }
+
+ els.toolDescription.innerHTML = `${description}
${details.join('
')}`;
+ },
- getExample(name) {
- const examples = {
- "set_node_name": { "id": "UUID", "newName": "Hello" },
- "update_node_transform": { "id": "UUID", "x": 0, "y": 0, "color": "#FF0000" },
- "create_node": { "name": "Node", "type": "sprite", "parentId": "" },
- "open_scene": { "url": "db://assets/Scene.fire" }
- };
- return examples[name] || {};
- },
+ 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...";
+ fetch(url, { method: "POST", body: JSON.stringify(body) })
+ .then((r) => r.json())
+ .then((d) => {
+ els.result.value = JSON.stringify(d, null, 2);
+ })
+ .catch((e) => {
+ els.result.value = "Error: " + e.message;
+ });
+ },
- renderLog(log) {
- const view = this.shadowRoot.querySelector("#logConsole");
- if (!view) return;
- const atBottom = view.scrollHeight - view.scrollTop <= view.clientHeight + 50;
- const el = document.createElement("div");
- el.className = `log-item ${log.type}`;
- el.innerHTML = `${log.time}${log.content}`;
- view.appendChild(el);
- if (atBottom) view.scrollTop = view.scrollHeight;
- },
+ getExample(name) {
+ const examples = {
+ set_node_name: { id: "UUID", newName: "Hello" },
+ update_node_transform: { id: "UUID", x: 0, y: 0, color: "#FF0000" },
+ create_node: { name: "Node", type: "sprite", parentId: "" },
+ open_scene: { url: "db://assets/Scene.fire" },
+ manage_editor: { action: "get_selection" },
+ find_gameobjects: { conditions: { name: "Node", active: true }, recursive: true },
+ manage_material: {
+ action: "create",
+ path: "db://assets/materials/NewMaterial.mat",
+ properties: { uniforms: {} },
+ },
+ manage_texture: {
+ action: "create",
+ path: "db://assets/textures/NewTexture.png",
+ properties: { width: 128, height: 128 },
+ },
+ execute_menu_item: { menuPath: "Assets/Create/Folder" },
+ apply_text_edits: {
+ filePath: "db://assets/scripts/TestScript.ts",
+ edits: [{ type: "insert", position: 0, text: "// Test comment\n" }],
+ },
+ read_console: { limit: 10, type: "log" },
+ validate_script: { filePath: "db://assets/scripts/TestScript.ts" },
+ };
+ return examples[name] || {};
+ },
- updateUI(active) {
- const btn = this.shadowRoot.querySelector("#btnToggle");
- if (!btn) return;
- btn.innerText = active ? "Stop" : "Start";
- btn.style.backgroundColor = active ? "#aa4444" : "#44aa44";
- }
-});
\ No newline at end of file
+ renderLog(log) {
+ const view = this.shadowRoot.querySelector("#logConsole");
+ if (!view) return;
+ const atBottom = view.scrollHeight - view.scrollTop <= view.clientHeight + 50;
+ const el = document.createElement("div");
+ el.className = `log-item ${log.type}`;
+ el.innerHTML = `${log.time}${log.content}`;
+ view.appendChild(el);
+ if (atBottom) view.scrollTop = view.scrollHeight;
+ },
+
+ updateUI(active) {
+ const btn = this.shadowRoot.querySelector("#btnToggle");
+ if (!btn) return;
+ btn.innerText = active ? "Stop" : "Start";
+ btn.style.backgroundColor = active ? "#aa4444" : "#44aa44";
+ },
+});
diff --git a/scene-script.js b/scene-script.js
index 28a0f01..f3d5d46 100644
--- a/scene-script.js
+++ b/scene-script.js
@@ -91,7 +91,7 @@ module.exports = {
"create-node": function (event, args) {
const { name, parentId, type } = args;
const scene = cc.director.getScene();
- if (!scene || !cc.director.getRunningScene()) {
+ if (!scene) {
if (event.reply) event.reply(new Error("Scene not ready or loading."));
return;
}
@@ -202,7 +202,16 @@ module.exports = {
try {
// 查找并移除组件
- const component = node.getComponentById(componentId);
+ let component = null;
+ if (node._components) {
+ for (let i = 0; i < node._components.length; i++) {
+ if (node._components[i].uuid === componentId) {
+ component = node._components[i];
+ break;
+ }
+ }
+ }
+
if (component) {
node.removeComponent(component);
Editor.Ipc.sendToMain("scene:dirty");
@@ -222,20 +231,51 @@ module.exports = {
// 获取组件属性
const properties = {};
for (const key in c) {
- if (typeof c[key] !== "function" &&
- !key.startsWith("_") &&
- c[key] !== undefined) {
+ if (typeof c[key] !== "function" && !key.startsWith("_") && c[key] !== undefined) {
try {
- properties[key] = c[key];
+ // Safe serialization check
+ const val = c[key];
+ if (val === null || val === undefined) {
+ properties[key] = val;
+ continue;
+ }
+
+ // Primitives are safe
+ if (typeof val !== 'object') {
+ properties[key] = val;
+ continue;
+ }
+
+ // Special Cocos Types
+ if (val instanceof cc.ValueType) {
+ properties[key] = val.toString();
+ } else if (val instanceof cc.Asset) {
+ properties[key] = `Asset(${val.name})`;
+ } else if (val instanceof cc.Node) {
+ properties[key] = `Node(${val.name})`;
+ } else if (val instanceof cc.Component) {
+ properties[key] = `Component(${val.name}<${val.__typename}>)`;
+ } else {
+ // Arrays and Plain Objects
+ // Attempt to strip to pure JSON data to avoid IPC errors with Native/Circular objects
+ try {
+ const jsonStr = JSON.stringify(val);
+ // Ensure we don't pass the original object reference
+ properties[key] = JSON.parse(jsonStr);
+ } catch (e) {
+ // If JSON fails (e.g. circular), format as string
+ properties[key] = `[Complex Object: ${val.constructor ? val.constructor.name : typeof val}]`;
+ }
+ }
} catch (e) {
- // 忽略无法序列化的属性
+ properties[key] = "[Serialization Error]";
}
}
}
return {
- type: c.__typename,
+ type: cc.js.getClassName(c) || c.constructor.name || "Unknown",
uuid: c.uuid,
- properties: properties
+ properties: properties,
};
});
if (event.reply) event.reply(null, components);
@@ -255,9 +295,7 @@ module.exports = {
// 遍历组件属性
for (const key in component) {
- if (typeof component[key] !== "function" &&
- !key.startsWith("_") &&
- component[key] !== undefined) {
+ if (typeof component[key] !== "function" && !key.startsWith("_") && component[key] !== undefined) {
try {
properties[key] = component[key];
} catch (e) {
@@ -273,7 +311,7 @@ module.exports = {
const { prefabPath, parentId } = args;
const scene = cc.director.getScene();
- if (!scene || !cc.director.getRunningScene()) {
+ if (!scene) {
if (event.reply) event.reply(new Error("Scene not ready or loading."));
return;
}
@@ -314,4 +352,208 @@ module.exports = {
}
});
},
+
+ "find-gameobjects": function (event, args) {
+ const { conditions, recursive = true } = args;
+ const result = [];
+ const scene = cc.director.getScene();
+
+ function searchNode(node) {
+ // 跳过编辑器内部的私有节点
+ if (node.name.startsWith("Editor Scene") || node.name === "gizmoRoot") {
+ return;
+ }
+
+ // 检查节点是否满足条件
+ let match = true;
+
+ if (conditions.name && !node.name.includes(conditions.name)) {
+ match = false;
+ }
+
+ if (conditions.component) {
+ let hasComponent = false;
+ try {
+ if (conditions.component.startsWith("cc.")) {
+ const className = conditions.component.replace("cc.", "");
+ hasComponent = node.getComponent(cc[className]) !== null;
+ } else {
+ hasComponent = node.getComponent(conditions.component) !== null;
+ }
+ } catch (e) {
+ hasComponent = false;
+ }
+ if (!hasComponent) {
+ match = false;
+ }
+ }
+
+ if (conditions.active !== undefined && node.active !== conditions.active) {
+ match = false;
+ }
+
+ if (match) {
+ result.push({
+ uuid: node.uuid,
+ name: node.name,
+ active: node.active,
+ position: { x: node.x, y: node.y },
+ scale: { x: node.scaleX, y: node.scaleY },
+ size: { width: node.width, height: node.height },
+ components: node._components.map((c) => c.__typename),
+ });
+ }
+
+ // 递归搜索子节点
+ if (recursive) {
+ for (let i = 0; i < node.childrenCount; i++) {
+ searchNode(node.children[i]);
+ }
+ }
+ }
+
+ // 从场景根节点开始搜索
+ if (scene) {
+ searchNode(scene);
+ }
+
+ if (event.reply) {
+ event.reply(null, result);
+ }
+ },
+
+ "manage-vfx": function (event, args) {
+ const { action, nodeId, properties, name, parentId } = args;
+ const scene = cc.director.getScene();
+
+ const applyParticleProperties = (particleSystem, props) => {
+ if (!props) return;
+
+ if (props.duration !== undefined) particleSystem.duration = props.duration;
+ if (props.emissionRate !== undefined) particleSystem.emissionRate = props.emissionRate;
+ if (props.life !== undefined) particleSystem.life = props.life;
+ if (props.lifeVar !== undefined) particleSystem.lifeVar = props.lifeVar;
+
+ // 【关键修复】启用自定义属性，否则属性修改可能不生效
+ particleSystem.custom = true;
+
+ if (props.startColor) particleSystem.startColor = new cc.Color().fromHEX(props.startColor);
+ if (props.endColor) particleSystem.endColor = new cc.Color().fromHEX(props.endColor);
+
+ if (props.startSize !== undefined) particleSystem.startSize = props.startSize;
+ if (props.endSize !== undefined) particleSystem.endSize = props.endSize;
+
+ if (props.speed !== undefined) particleSystem.speed = props.speed;
+ if (props.angle !== undefined) particleSystem.angle = props.angle;
+
+ if (props.gravity) {
+ if (props.gravity.x !== undefined) particleSystem.gravity.x = props.gravity.x;
+ if (props.gravity.y !== undefined) particleSystem.gravity.y = props.gravity.y;
+ }
+
+ // 处理文件/纹理加载
+ if (props.file) {
+ // main.js 已经将 db:// 路径转换为 UUID
+ // 如果用户直接传递 URL (http/https) 或其他格式，cc.assetManager.loadAny 也能处理
+ const uuid = props.file;
+ cc.assetManager.loadAny(uuid, (err, asset) => {
+ if (!err) {
+ if (asset instanceof cc.ParticleAsset) {
+ particleSystem.file = asset;
+ } else if (asset instanceof cc.Texture2D || asset instanceof cc.SpriteFrame) {
+ particleSystem.texture = asset;
+ }
+ Editor.Ipc.sendToMain("scene:dirty");
+ }
+ });
+ } else if (!particleSystem.texture && !particleSystem.file && args.defaultSpriteUuid) {
+ // 【关键修复】如果没有纹理，加载默认纹理 (UUID 由 main.js 传入)
+ Editor.log(`[mcp-bridge] Loading default texture with UUID: ${args.defaultSpriteUuid}`);
+ cc.assetManager.loadAny(args.defaultSpriteUuid, (err, asset) => {
+ if (err) {
+ Editor.error(`[mcp-bridge] Failed to load default texture: ${err.message}`);
+ } else if (asset instanceof cc.Texture2D || asset instanceof cc.SpriteFrame) {
+ Editor.log(`[mcp-bridge] Default texture loaded successfully.`);
+ particleSystem.texture = asset;
+ Editor.Ipc.sendToMain("scene:dirty");
+ } else {
+ Editor.warn(`[mcp-bridge] Loaded asset is not a texture: ${asset}`);
+ }
+ });
+ }
+ };
+
+ if (action === "create") {
+ let newNode = new cc.Node(name || "New Particle");
+ let particleSystem = newNode.addComponent(cc.ParticleSystem);
+
+ // 设置默认值
+ particleSystem.resetSystem();
+ particleSystem.custom = true; // 确保新创建的也是 custom 模式
+
+ applyParticleProperties(particleSystem, properties);
+
+ let parent = parentId ? cc.engine.getInstanceById(parentId) : scene;
+ if (parent) {
+ newNode.parent = parent;
+ Editor.Ipc.sendToMain("scene:dirty");
+ setTimeout(() => {
+ Editor.Ipc.sendToAll("scene:node-created", {
+ uuid: newNode.uuid,
+ parentUuid: parent.uuid,
+ });
+ }, 10);
+ if (event.reply) event.reply(null, newNode.uuid);
+ } else {
+ if (event.reply) event.reply(new Error("Parent node not found"));
+ }
+
+ } else if (action === "update") {
+ let node = cc.engine.getInstanceById(nodeId);
+ if (node) {
+ let particleSystem = node.getComponent(cc.ParticleSystem);
+ if (!particleSystem) {
+ // 如果没有组件，自动添加
+ particleSystem = node.addComponent(cc.ParticleSystem);
+ }
+
+ applyParticleProperties(particleSystem, properties);
+
+ Editor.Ipc.sendToMain("scene:dirty");
+ Editor.Ipc.sendToAll("scene:node-changed", { uuid: nodeId });
+ if (event.reply) event.reply(null, "VFX updated");
+ } else {
+ if (event.reply) event.reply(new Error("Node not found"));
+ }
+
+ } else if (action === "get_info") {
+ let node = cc.engine.getInstanceById(nodeId);
+ if (node) {
+ let ps = node.getComponent(cc.ParticleSystem);
+ if (ps) {
+ const info = {
+ duration: ps.duration,
+ emissionRate: ps.emissionRate,
+ life: ps.life,
+ lifeVar: ps.lifeVar,
+ startColor: ps.startColor.toHEX("#RRGGBB"),
+ endColor: ps.endColor.toHEX("#RRGGBB"),
+ startSize: ps.startSize,
+ endSize: ps.endSize,
+ speed: ps.speed,
+ angle: ps.angle,
+ gravity: { x: ps.gravity.x, y: ps.gravity.y },
+ file: ps.file ? ps.file.name : null
+ };
+ if (event.reply) event.reply(null, info);
+ } else {
+ if (event.reply) event.reply(null, { hasParticleSystem: false });
+ }
+ } else {
+ if (event.reply) event.reply(new Error("Node not found"));
+ }
+ } else {
+ if (event.reply) event.reply(new Error(`Unknown VFX action: ${action}`));
+ }
+ },
};
diff --git a/test/run_tests.js b/test/run_tests.js
new file mode 100644
index 0000000..900f415
--- /dev/null
+++ b/test/run_tests.js
@@ -0,0 +1,309 @@
+const http = require('http');
+
+// 配置
+const CONFIG = {
+ host: '127.0.0.1',
+ port: 3456,
+ timeout: 5000
+};
+
+// 控制台输出颜色
+const colors = {
+ reset: "\x1b[0m",
+ red: "\x1b[31m",
+ green: "\x1b[32m",
+ yellow: "\x1b[33m",
+ cyan: "\x1b[36m",
+ gray: "\x1b[90m"
+};
+
+function log(type, msg) {
+ const timestamp = new Date().toLocaleTimeString();
+ switch (type) {
+ case 'info': console.log(`${colors.cyan}[INFO]${colors.reset} ${msg}`); break;
+ case 'success': console.log(`${colors.green}[PASS]${colors.reset} ${msg}`); break;
+ case 'error': console.log(`${colors.red}[FAIL]${colors.reset} ${msg}`); break;
+ case 'warn': console.log(`${colors.yellow}[WARN]${colors.reset} ${msg}`); break;
+ case 'group': console.log(`\n${colors.gray}=== ${msg} ===${colors.reset}`); break;
+ default: console.log(msg);
+ }
+}
+
+// HTTP 辅助函数
+function request(method, path, data) {
+ return new Promise((resolve, reject) => {
+ const options = {
+ hostname: CONFIG.host,
+ port: CONFIG.port,
+ path: path,
+ method: method,
+ headers: {
+ 'Content-Type': 'application/json',
+ },
+ timeout: CONFIG.timeout
+ };
+
+ const req = http.request(options, (res) => {
+ let body = '';
+ res.on('data', chunk => body += chunk);
+ res.on('end', () => {
+ if (res.statusCode >= 200 && res.statusCode < 300) {
+ try {
+ const parsed = JSON.parse(body);
+ // MCP 返回 { content: [{ type: 'text', text: "..." }] }
+ resolve(parsed);
+ } catch (e) {
+ // 某些接口可能返回纯文本或非标准 JSON
+ resolve(body);
+ }
+ } else {
+ reject(new Error(`HTTP ${res.statusCode}: ${body}`));
+ }
+ });
+ });
+
+ req.on('error', (e) => reject(new Error(`连接失败: ${e.message}`)));
+ req.on('timeout', () => {
+ req.destroy();
+ reject(new Error('请求超时'));
+ });
+
+ if (data) {
+ req.write(JSON.stringify(data));
+ }
+ req.end();
+ });
+}
+
+// MCP 工具调用封装
+async function callTool(name, args = {}) {
+ const payload = {
+ name: name,
+ arguments: args
+ };
+
+ try {
+ const response = await request('POST', '/call-tool', payload);
+
+ // 解析复杂的 MCP 响应结构
+ // 预期: { content: [ { type: 'text', text: "..." } ] }
+ if (response && response.content && Array.isArray(response.content)) {
+ const textContent = response.content.find(c => c.type === 'text');
+ if (textContent) {
+ // 工具结果本身可能是 JSON 字符串，尝试解析它
+ try {
+ return JSON.parse(textContent.text);
+ } catch {
+ return textContent.text;
+ }
+ }
+ }
+ return response;
+ } catch (e) {
+ throw new Error(`工具 [${name}] 调用失败: ${e.message}`);
+ }
+}
+
+// 断言辅助函数
+function assert(condition, message) {
+ if (!condition) {
+ throw new Error(message || "断言失败");
+ }
+}
+
+// --- 测试套件 ---
+const tests = {
+ async setup() {
+ log('group', '连接性检查');
+ try {
+ const tools = await request('POST', '/list-tools');
+ assert(tools && tools.tools && tools.tools.length > 0, "无法获取工具列表");
+ log('success', `已连接到 MCP 服务器。发现 ${tools.tools.length} 个工具。`);
+ return true;
+ } catch (e) {
+ log('error', `无法连接服务器。插件是否正在运行？ (${e.message})`);
+ return false;
+ }
+ },
+
+ async testNodeLifecycle() {
+ log('group', '节点生命周期测试');
+ const nodeName = `TestNode_${Date.now()}`;
+
+ try {
+ // 1. 创建节点
+ log('info', `尝试创建节点: ${nodeName}`);
+ const newNodeId = await callTool('create_node', { name: nodeName, type: 'empty' });
+ log('info', `create_node 响应: ${JSON.stringify(newNodeId)}`);
+ assert(typeof newNodeId === 'string' && newNodeId.length > 0, `create_node 没有返回 UUID。实际返回: ${JSON.stringify(newNodeId)}`);
+ log('success', `已创建节点: ${nodeName} (${newNodeId})`);
+
+ // 2. 查找节点
+ log('info', `尝试查找节点: ${nodeName}`);
+ const findResult = await callTool('find_gameobjects', { conditions: { name: nodeName } });
+ log('info', `find_gameobjects 响应: ${JSON.stringify(findResult)}`);
+ assert(Array.isArray(findResult), `find_gameobjects 没有返回数组。实际返回: ${JSON.stringify(findResult)}`);
+ assert(findResult.length >= 1, "find_gameobjects 未能找到已创建的节点");
+
+ // 查找特定节点（防止重名，虽然这里名字包含时间戳）
+ const targetNode = findResult.find(n => n.name === nodeName);
+ assert(targetNode, "找到节点但名称不匹配？");
+ assert(targetNode.uuid === newNodeId, `找到的节点 UUID 不匹配。预期 ${newNodeId}, 实际 ${targetNode.uuid}`);
+ log('success', `通过 find_gameobjects 找到节点: ${targetNode.name}`);
+
+ // 3. 更新变换 (Transform)
+ log('info', `尝试更新变换信息`);
+ await callTool('update_node_transform', { id: newNodeId, x: 100, y: 200 });
+ // 通过查找验证（因为查找会返回位置信息）
+ const updatedResult = await callTool('find_gameobjects', { conditions: { name: nodeName } });
+ const updatedNode = updatedResult.find(n => n.uuid === newNodeId);
+ log('info', `变换更新验证: x=${updatedNode.position.x}, y=${updatedNode.position.y}`);
+ assert(updatedNode.position.x === 100 && updatedNode.position.y === 200, `节点位置更新失败。实际: (${updatedNode.position.x}, ${updatedNode.position.y})`);
+ log('success', `节点变换已更新至 (100, 200)`);
+
+ return newNodeId; // 返回以供后续测试使用
+ } catch (e) {
+ log('error', `节点生命周期测试失败: ${e.message}`);
+ throw e;
+ }
+ },
+
+ async testComponents(nodeId) {
+ log('group', '组件管理测试');
+
+ // 1. 添加组件
+ // 使用 cc.Sprite 因为它最常用
+ log('info', `向 ${nodeId} 添加组件 cc.Sprite`);
+ const addResult = await callTool('manage_components', {
+ nodeId: nodeId,
+ action: 'add',
+ componentType: 'cc.Sprite'
+ });
+ log('success', `已添加 cc.Sprite 组件。响应: ${JSON.stringify(addResult)}`);
+
+ // 2. 获取组件
+ log('info', `列出 ${nodeId} 的组件`);
+ const components = await callTool('manage_components', { nodeId: nodeId, action: 'get' });
+ log('info', `manage_components (get) 响应: ${JSON.stringify(components)}`);
+
+ assert(Array.isArray(components), `无法获取组件列表。实际返回: ${JSON.stringify(components)}`);
+ // 宽松匹配：验证逻辑匹配（检查 type 或 properties.name 中是否包含 Sprite）
+ const spriteComp = components.find(c => (c.type && c.type.includes('Sprite')) || (c.properties && c.properties.name && c.properties.name.includes('Sprite')));
+ assert(spriteComp, "节点上未找到 cc.Sprite 组件");
+ log('success', `验证组件存在: ${spriteComp.uuid} (${spriteComp.type || 'Unknown'})`);
+
+ // 3. 移除组件
+ log('info', `移除组件 ${spriteComp.uuid}`);
+ const removeResult = await callTool('manage_components', {
+ nodeId: nodeId,
+ action: 'remove',
+ componentId: spriteComp.uuid
+ });
+ log('info', `移除结果: ${JSON.stringify(removeResult)}`);
+
+ // 等待引擎处理移除（异步过程）
+ await new Promise(r => setTimeout(r, 200));
+
+ // 验证移除
+ const componentsAfter = await callTool('manage_components', { nodeId: nodeId, action: 'get' });
+ log('info', `移除后的组件列表: ${JSON.stringify(componentsAfter)}`);
+
+ assert(!componentsAfter.find(c => (c.type && c.type.includes('Sprite')) || (c.uuid === spriteComp.uuid)), "组件未被移除");
+ log('success', `组件移除成功`);
+ },
+
+ async testEditorSelection(nodeId) {
+ log('group', '编辑器选中测试');
+
+ // 1. 设置选中
+ await callTool('manage_editor', {
+ action: 'set_selection',
+ target: 'node',
+ properties: { nodes: [nodeId] }
+ });
+
+ // 2. 获取选中
+ const selection = await callTool('manage_editor', { action: 'get_selection' });
+ // 预期: { nodes: [...], assets: [...] }
+ assert(selection.nodes && selection.nodes.includes(nodeId), "选中状态更新失败");
+ log('success', `编辑器选中状态已更新为节点 ${nodeId}`);
+ },
+
+ async testAssetManagement() {
+ log('group', '资源管理测试');
+ const scriptPath = 'db://assets/temp_auto_test.js';
+
+ // 1. 创建脚本
+ try {
+ await callTool('manage_script', {
+ action: 'create',
+ path: scriptPath,
+ content: 'cc.log("Test Script");'
+ });
+ log('success', `已创建临时资源: ${scriptPath}`);
+ } catch (e) {
+ if (e.message.includes('exists')) {
+ log('warn', `资源已存在，正在尝试先删除...`);
+ await callTool('manage_asset', { action: 'delete', path: scriptPath });
+ // 重试创建
+ await callTool('manage_script', { action: 'create', path: scriptPath, content: 'cc.log("Test Script");' });
+ } else {
+ throw e;
+ }
+ }
+
+ // 2. 获取信息
+ // 等待 AssetDB 刷新 (导入需要时间)
+ log('info', '等待 3 秒以进行资源导入...');
+ await new Promise(r => setTimeout(r, 3000));
+
+ log('info', `获取资源信息: ${scriptPath}`);
+ const info = await callTool('manage_asset', { action: 'get_info', path: scriptPath });
+ log('info', `资源信息: ${JSON.stringify(info)}`);
+
+ assert(info && info.url === scriptPath, "无法获取资源信息");
+ log('success', `已验证资源信息`);
+
+ // 3. 删除资源
+ await callTool('manage_asset', { action: 'delete', path: scriptPath });
+
+ // 验证删除 (get_info 应该失败或返回 null/报错，但我们检查工具响应)
+ try {
+ const infoDeleted = await callTool('manage_asset', { action: 'get_info', path: scriptPath });
+ // 如果返回了信息且 exists 为 true，说明没删掉
+ assert(!(infoDeleted && infoDeleted.exists), "资源本应被删除，但仍然存在");
+ } catch (e) {
+ // 如果报错（如 Asset not found），则符合预期
+ log('success', `已验证资源删除`);
+ }
+ }
+};
+
+async function run() {
+ console.log(`\n${colors.cyan}正在启动 MCP Bridge 自动化测试...${colors.reset}`);
+ console.log(`目标: http://${CONFIG.host}:${CONFIG.port}\n`);
+
+ const isConnected = await tests.setup();
+ if (!isConnected) process.exit(1);
+
+ try {
+ const nodeId = await tests.testNodeLifecycle();
+
+ await tests.testComponents(nodeId);
+
+ await tests.testEditorSelection(nodeId);
+
+ await tests.testAssetManagement();
+
+ // 清理：我们在测试中已经尽可能清理了，但保留节点可能有助于观察结果
+ // 这里只是打印完成消息
+
+ console.log(`\n${colors.green}所有测试已成功完成！${colors.reset}\n`);
+ } catch (e) {
+ console.error(`\n${colors.red}[FATAL ERROR]${colors.reset} 测试套件出错:`);
+ console.error(e);
+ process.exit(1);
+ }
+}
+
+run();
diff --git a/test/test_find_file.js b/test/test_find_file.js
new file mode 100644
index 0000000..7f4eeb8
--- /dev/null
+++ b/test/test_find_file.js
@@ -0,0 +1,107 @@
+const http = require('http');
+
+const CONFIG = {
+ host: '127.0.0.1',
+ port: 3456,
+ timeout: 5000
+};
+
+// HTTP Helper
+function request(method, path, data) {
+ return new Promise((resolve, reject) => {
+ const options = {
+ hostname: CONFIG.host,
+ port: CONFIG.port,
+ path: path,
+ method: method,
+ headers: { 'Content-Type': 'application/json' },
+ timeout: CONFIG.timeout
+ };
+
+ const req = http.request(options, (res) => {
+ let body = '';
+ res.on('data', chunk => body += chunk);
+ res.on('end', () => {
+ if (res.statusCode >= 200 && res.statusCode < 300) {
+ try { resolve(JSON.parse(body)); } catch (e) { resolve(body); }
+ } else {
+ reject(new Error(`HTTP ${res.statusCode}: ${body}`));
+ }
+ });
+ });
+
+ req.on('error', (e) => reject(new Error(`Connection failed: ${e.message}`)));
+ req.end(data ? JSON.stringify(data) : undefined);
+ });
+}
+
+async function callTool(name, args = {}) {
+ const payload = { name: name, arguments: args };
+ const response = await request('POST', '/call-tool', payload);
+ if (response && response.content && Array.isArray(response.content)) {
+ const textContent = response.content.find(c => c.type === 'text');
+ if (textContent) {
+ try { return JSON.parse(textContent.text); } catch { return textContent.text; }
+ }
+ }
+ return response;
+}
+
+async function run() {
+ console.log("Testing find_in_file...");
+
+ try {
+ // 1. Check tools
+ const tools = await request('POST', '/list-tools');
+ const findTool = tools.tools.find(t => t.name === 'find_in_file');
+ if (!findTool) {
+ console.error("FAILED: find_in_file tool not found in list.");
+ return;
+ }
+ console.log("PASS: find_in_file exists in tool list.");
+
+ // 2. Create a temp file to search for
+ const tempFilePath = "db://assets/test_find_me.txt";
+ const uniqueString = "UniqueStringToFind_" + Date.now();
+ console.log(`Creating temp file with content "${uniqueString}"...`);
+
+ await callTool('manage_asset', {
+ action: 'create',
+ path: tempFilePath,
+ content: `This is a test file.\nIt contains ${uniqueString} here.`
+ });
+
+ // Wait a bit for assetdb to refresh
+ await new Promise(r => setTimeout(r, 2000));
+
+ // 3. Call find_in_file
+ console.log(`Searching for "${uniqueString}"...`);
+
+ const results = await callTool('find_in_file', { query: uniqueString });
+
+ if (!Array.isArray(results)) {
+ console.error("FAILED: Result is not an array:", results);
+ // Cleanup
+ await callTool('manage_asset', { action: 'delete', path: tempFilePath });
+ return;
+ }
+
+ console.log(`Found ${results.length} matches.`);
+ const match = results.find(r => r.content.includes(uniqueString));
+
+ if (match) {
+ console.log("PASS: Found match in created file.");
+ console.log("Match Details:", match);
+ } else {
+ console.error("FAILED: Did not find match. Results:", results);
+ }
+
+ // 4. Cleanup
+ await callTool('manage_asset', { action: 'delete', path: tempFilePath });
+
+ } catch (e) {
+ console.error("Error:", e.message);
+ }
+}
+
+run();
diff --git a/test/test_undo.js b/test/test_undo.js
new file mode 100644
index 0000000..6418ed1
--- /dev/null
+++ b/test/test_undo.js
@@ -0,0 +1,146 @@
+const http = require('http');
+
+const CONFIG = {
+ host: '127.0.0.1',
+ port: 3456,
+ timeout: 5000
+};
+
+// HTTP Helper
+function request(method, path, data) {
+ return new Promise((resolve, reject) => {
+ const options = {
+ hostname: CONFIG.host,
+ port: CONFIG.port,
+ path: path,
+ method: method,
+ headers: { 'Content-Type': 'application/json' },
+ timeout: CONFIG.timeout
+ };
+
+ const req = http.request(options, (res) => {
+ let body = '';
+ res.on('data', chunk => body += chunk);
+ res.on('end', () => {
+ if (res.statusCode >= 200 && res.statusCode < 300) {
+ try { resolve(JSON.parse(body)); } catch (e) { resolve(body); }
+ } else {
+ reject(new Error(`HTTP ${res.statusCode}: ${body}`));
+ }
+ });
+ });
+
+ req.on('error', (e) => reject(new Error(`Connection failed: ${e.message}`)));
+ req.end(data ? JSON.stringify(data) : undefined);
+ });
+}
+
+async function callTool(name, args = {}) {
+ const payload = { name: name, arguments: args };
+ const response = await request('POST', '/call-tool', payload);
+ if (response && response.content && Array.isArray(response.content)) {
+ const textContent = response.content.find(c => c.type === 'text');
+ if (textContent) {
+ try { return JSON.parse(textContent.text); } catch { return textContent.text; }
+ }
+ }
+ return response;
+}
+
+// Helper to wait
+const wait = (ms) => new Promise(r => setTimeout(r, ms));
+
+async function run() {
+ console.log("Testing manage_undo...");
+
+ try {
+ // 1. Create a node
+ const nodeName = "UndoTestNode_" + Date.now();
+ console.log(`Creating node: ${nodeName}`);
+ const nodeId = await callTool('create_node', { name: nodeName, type: 'empty' });
+
+ if (!nodeId || typeof nodeId !== 'string') {
+ console.error("FAILED: Could not create node.", nodeId);
+ return;
+ }
+ console.log(`Node created: ${nodeId}`);
+
+ // Wait to ensure creation is fully processed
+ await wait(500);
+
+ // 2. Modify node (Change Name)
+ console.log("Modifying node name (Action to undo)...");
+ const newName = "RenamedNode_" + Date.now();
+ await callTool('set_node_name', { id: nodeId, newName: newName });
+
+ await wait(2000);
+
+ // Verify modification
+ let nodes = await callTool('find_gameobjects', { conditions: { name: newName } });
+ let node = nodes.find(n => n.uuid === nodeId);
+
+ if (!node) {
+ console.error(`FAILED: Node not found with new name ${newName}. Name update failed.`);
+ // Try to read console logs to see why
+ const logs = await callTool('read_console', { limit: 10, type: 'error' });
+ console.log("Recent Error Logs:", JSON.stringify(logs, null, 2));
+ return;
+ }
+ console.log(`Node renamed to ${node.name}.`);
+
+ // 3. Perform UNDO
+ console.log("Executing UNDO...");
+ await callTool('manage_undo', { action: 'undo' });
+
+ await wait(2000);
+
+ // Verify UNDO
+ nodes = await callTool('find_gameobjects', { conditions: { name: nodeName } });
+ // The original name was in variable nodeName
+ node = nodes.find(n => n.uuid === nodeId);
+
+ if (node && node.name === nodeName) {
+ console.log(`PASS: Undo successful. Node name returned to ${nodeName}.`);
+ } else {
+ console.error(`FAILED: Undo failed? Node name is ${node ? node.name : 'Unknown'}`);
+ }
+
+ // 4. Perform REDO
+ console.log("Executing REDO...");
+ await callTool('manage_undo', { action: 'redo' });
+
+ await wait(2000);
+
+ // Verify REDO
+ nodes = await callTool('find_gameobjects', { conditions: { name: newName } });
+ node = nodes.find(n => n.uuid === nodeId);
+
+ if (node && node.name === newName) {
+ console.log("PASS: Redo successful. Node name returned to " + newName + ".");
+ } else {
+ console.error(`FAILED: Redo failed? Node name is ${node ? node.name : 'Unknown'}`);
+ }
+
+ // Cleanup
+ // await callTool('manage_undo', { action: 'begin_group', description: 'Delete Node' }); // Optional
+ // Node deletion tool... wait, we don't have delete_node tool exposed yet?
+ // Ah, 'scene:delete-nodes' is internal.
+ // We can use 'batch_execute' if we had a delete tool.
+ // Checking available tools... we assume we can manually delete or leave it.
+ // Actually, let's construct a delete call if possible via existing tools?
+ // create_node, manage_components...
+ // Wait, DEVELOPMENT_PLAN says 'batch_execute' exists.
+ // But we don't have a direct 'delete_node' in getToolsList().
+ // Oh, we missed implementing 'delete_node' in the previous phases?
+ // Let's check main.js getToolsList again.
+ // ... It has 'create_node', 'manage_components', ... 'scene_management'...
+ // 'scene_management' has 'delete'? -> "场景管理" -> create, delete (scene file), duplicate.
+ // It seems we lack `delete_node`.
+ // Nevermind, letting the test node stay is fine for observation, or user can delete manually.
+
+ } catch (e) {
+ console.error("Error:", e.message);
+ }
+}
+
+run();
diff --git a/test/test_vfx.js b/test/test_vfx.js
new file mode 100644
index 0000000..5aa0672
--- /dev/null
+++ b/test/test_vfx.js
@@ -0,0 +1,175 @@
+const http = require('http');
+
+const CONFIG = {
+ host: '127.0.0.1',
+ port: 3456, // Ideally read from profile or keep dynamic, but fixed for test
+ timeout: 5000
+};
+
+// HTTP Helper
+function request(method, path, data) {
+ return new Promise((resolve, reject) => {
+ const options = {
+ hostname: CONFIG.host,
+ port: CONFIG.port,
+ path: path,
+ method: method,
+ headers: { 'Content-Type': 'application/json' },
+ timeout: CONFIG.timeout
+ };
+
+ const req = http.request(options, (res) => {
+ let body = '';
+ res.on('data', chunk => body += chunk);
+ res.on('end', () => {
+ if (res.statusCode >= 200 && res.statusCode < 300) {
+ try { resolve(JSON.parse(body)); } catch (e) { resolve(body); }
+ } else {
+ reject(new Error(`HTTP ${res.statusCode}: ${body}`));
+ }
+ });
+ });
+
+ req.on('error', (e) => reject(new Error(`Connection failed: ${e.message}`)));
+ req.end(data ? JSON.stringify(data) : undefined);
+ });
+}
+
+async function callTool(name, args = {}) {
+ const payload = { name: name, arguments: args };
+ const response = await request('POST', '/call-tool', payload);
+ if (response && response.content && Array.isArray(response.content)) {
+ const textContent = response.content.find(c => c.type === 'text');
+ if (textContent) {
+ try { return JSON.parse(textContent.text); } catch { return textContent.text; }
+ }
+ }
+ return response;
+}
+
+// Helper to wait
+const wait = (ms) => new Promise(r => setTimeout(r, ms));
+
+async function run() {
+ console.log("Testing manage_vfx...");
+
+ try {
+ // 1. Create a Particle Node
+ const nodeName = "VFX_Test_" + Date.now();
+ console.log(`Creating particle node: ${nodeName}`);
+
+ const createResult = await callTool('manage_vfx', {
+ action: 'create',
+ name: nodeName,
+ properties: {
+ duration: 5,
+ emissionRate: 50,
+ startColor: "#FF0000",
+ endColor: "#0000FF"
+ }
+ });
+
+ let nodeId = createResult;
+ // Check if result is UUID string or object
+ if (typeof createResult === 'object') {
+ // Sometimes mcp-bridge returns object? No, scene-script returns uuid or error.
+ // But checking just in case
+ nodeId = createResult.uuid || createResult;
+ }
+
+ if (!nodeId || typeof nodeId !== 'string') {
+ console.error("FAILED: Could not create VFX node.", createResult);
+ return;
+ }
+ console.log(`VFX Node created: ${nodeId}`);
+
+ await wait(1000);
+
+ // 2. Perform Undo (Verify creation undo)
+ // ... Optional, let's focus on Update first.
+
+ // 3. Update Particle Properties
+ console.log("Updating particle properties...");
+ const updateResult = await callTool('manage_vfx', {
+ action: 'update',
+ nodeId: nodeId,
+ properties: {
+ emissionRate: 100,
+ startSize: 50,
+ speed: 200
+ }
+ });
+ console.log("Update result:", updateResult);
+
+ await wait(1000);
+
+ // 4. Get Info to Verify
+ console.log("Verifying properties...");
+ const info = await callTool('manage_vfx', { action: 'get_info', nodeId: nodeId });
+
+ if (!info) {
+ console.error("FAILED: Could not get info.");
+ return;
+ }
+
+ console.log("Particle Info:", JSON.stringify(info, null, 2));
+
+ if (info.emissionRate === 100 && info.speed === 200) {
+ console.log("PASS: Properties updated and verified.");
+ } else {
+ console.error("FAILED: Properties mismatch.");
+ }
+
+ // 5. Verify 'custom' property using manage_components
+ // We need to ensure custom is true for properties to take effect visually
+ console.log("Verifying 'custom' property...");
+ const components = await callTool('manage_components', {
+ nodeId: nodeId,
+ action: 'get'
+ });
+
+ let particleComp = null;
+ if (components && Array.isArray(components)) {
+ particleComp = components.find(c => c.type === 'cc.ParticleSystem' || c.type === 'ParticleSystem');
+ }
+
+ if (particleComp && particleComp.properties) {
+ if (particleComp.properties.custom === true) {
+ console.log("PASS: ParticleSystem.custom is TRUE.");
+ } else {
+ console.error("FAILED: ParticleSystem.custom is FALSE or Undefined.", particleComp.properties.custom);
+ }
+
+ // Check texture/file if possible
+ if (particleComp.properties.file || particleComp.properties.texture) {
+ console.log("PASS: ParticleSystem has file/texture.");
+ } else {
+ console.warn("WARNING: ParticleSystem might not have a texture/file set.");
+ }
+ } else {
+ console.error("FAILED: Could not retrieve component details.");
+ }
+
+ await wait(1000);
+
+ // 6. Fetch Logs to debug texture loading
+ console.log("Fetching recent Editor Logs...");
+ const logs = await callTool('read_console', { limit: 20 });
+ if (logs && Array.isArray(logs)) {
+ logs.forEach(log => {
+ const msg = log.message || JSON.stringify(log);
+ const type = log.type || 'info';
+
+ // Filter for our debug logs or errors
+ if (typeof msg === 'string' && (msg.includes("[mcp-bridge]") || type === 'error' || type === 'warn')) {
+ console.log(`[Editor Log] [${type}] ${msg}`);
+ }
+ });
+ }
+
+ } catch (e) {
+ console.error("Error:", e.message);
+ }
+}
+
+run();