测试结果
- */
- IpcManager.testIpcMessage = function (name_2) {
- return __awaiter(this, arguments, void 0, function (name, args) {
- if (args === void 0) { args = null; }
- return __generator(this, function (_a) {
- return [2 /*return*/, new Promise(function (resolve) {
- // 简单防呆：防止执行危险操作
- // 如果消息包含 "delete", "remove", "close", "stop" 且没有明确参数确认，则警告
- // 但用户要求"快速验证"，所以我们默认允许，但如果是无参调用可能有风险
- // 这里我们尝试使用 Editor.Ipc.sendToMain 或 requestToMain
- // @ts-ignore
- // 简单的测试：只是发送看看是否报错。
- // 对于 request 类型的消息，我们期望有回调
- // Cocos Creator 2.4 API: Editor.Ipc.sendToMain(message, ...args)
- try {
- // @ts-ignore
- if (Editor.Ipc.sendToMain) {
- // @ts-ignore
- Editor.Ipc.sendToMain(name, args);
- resolve({ success: true, message: "Message sent (sendToMain)" });
- }
- else {
- resolve({ success: false, message: "Editor.Ipc.sendToMain not available" });
- }
- }
- catch (e) {
- resolve({ success: false, message: "Error: ".concat(e.message) });
- }
- })];
- });
- });
- };
- return IpcManager;
-}());
-exports.IpcManager = IpcManager;
diff --git a/dist/IpcUi.js b/dist/IpcUi.js
deleted file mode 100644
index 322c0c3..0000000
--- a/dist/IpcUi.js
+++ /dev/null
@@ -1,353 +0,0 @@
-"use strict";
-var __awaiter =
- (this && this.__awaiter) ||
- function (thisArg, _arguments, P, generator) {
- function adopt(value) {
- return value instanceof P
- ? value
- : new P(function (resolve) {
- resolve(value);
- });
- }
- return new (P || (P = Promise))(function (resolve, reject) {
- function fulfilled(value) {
- try {
- step(generator.next(value));
- } catch (e) {
- reject(e);
- }
- }
- function rejected(value) {
- try {
- step(generator["throw"](value));
- } catch (e) {
- reject(e);
- }
- }
- function step(result) {
- result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
- }
- step((generator = generator.apply(thisArg, _arguments || [])).next());
- });
- };
-var __generator =
- (this && this.__generator) ||
- function (thisArg, body) {
- var _ = {
- label: 0,
- sent: function () {
- if (t[0] & 1) throw t[1];
- return t[1];
- },
- trys: [],
- ops: [],
- },
- f,
- y,
- t,
- g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
- return (
- (g.next = verb(0)),
- (g["throw"] = verb(1)),
- (g["return"] = verb(2)),
- typeof Symbol === "function" &&
- (g[Symbol.iterator] = function () {
- return this;
- }),
- g
- );
- function verb(n) {
- return function (v) {
- return step([n, v]);
- };
- }
- function step(op) {
- if (f) throw new TypeError("Generator is already executing.");
- while ((g && ((g = 0), op[0] && (_ = 0)), _))
- try {
- if (
- ((f = 1),
- y &&
- (t =
- op[0] & 2
- ? y["return"]
- : op[0]
- ? y["throw"] || ((t = y["return"]) && t.call(y), 0)
- : y.next) &&
- !(t = t.call(y, op[1])).done)
- )
- return t;
- if (((y = 0), t)) op = [op[0] & 2, t.value];
- switch (op[0]) {
- case 0:
- case 1:
- t = op;
- break;
- case 4:
- _.label++;
- return { value: op[1], done: false };
- case 5:
- _.label++;
- y = op[1];
- op = [0];
- continue;
- case 7:
- op = _.ops.pop();
- _.trys.pop();
- continue;
- default:
- if (
- !((t = _.trys), (t = t.length > 0 && t[t.length - 1])) &&
- (op[0] === 6 || op[0] === 2)
- ) {
- _ = 0;
- continue;
- }
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) {
- _.label = op[1];
- break;
- }
- if (op[0] === 6 && _.label < t[1]) {
- _.label = t[1];
- t = op;
- break;
- }
- if (t && _.label < t[2]) {
- _.label = t[2];
- _.ops.push(op);
- break;
- }
- if (t[2]) _.ops.pop();
- _.trys.pop();
- continue;
- }
- op = body.call(thisArg, _);
- } catch (e) {
- op = [6, e];
- y = 0;
- } finally {
- f = t = 0;
- }
- if (op[0] & 5) throw op[1];
- return { value: op[0] ? op[1] : void 0, done: true };
- }
- };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IpcUi = void 0;
-// @ts-ignore
-var Editor = window.Editor;
-var IpcUi = /** @class */ (function () {
- function IpcUi(root) {
- this.logArea = null;
- this.ipcList = null;
- this.allMessages = [];
- this.filterSelect = null;
- this.paramInput = null;
- this.root = root;
- this.bindEvents();
- }
- IpcUi.prototype.bindEvents = function () {
- var _this = this;
- var btnScan = this.root.querySelector("#btnScanIpc");
- var btnTest = this.root.querySelector("#btnTestIpc");
- var cbSelectAll = this.root.querySelector("#cbSelectAllIpc");
- this.logArea = this.root.querySelector("#ipcLog");
- this.ipcList = this.root.querySelector("#ipcList");
- this.filterSelect = this.root.querySelector("#ipcFilter");
- this.paramInput = this.root.querySelector("#ipcParams");
- if (btnScan) {
- btnScan.addEventListener("confirm", function () {
- return _this.scanMessages();
- });
- }
- if (btnTest) {
- btnTest.addEventListener("confirm", function () {
- return _this.testSelected();
- });
- }
- if (cbSelectAll) {
- cbSelectAll.addEventListener("change", function (e) {
- return _this.toggleAll(e.detail ? e.detail.value : e.target.value === "true" || e.target.checked);
- });
- }
- if (this.filterSelect) {
- this.filterSelect.addEventListener("change", function () {
- return _this.filterMessages();
- });
- }
- };
- IpcUi.prototype.scanMessages = function () {
- var _this = this;
- this.log("正在扫描 IPC 消息...");
- // @ts-ignore
- Editor.Ipc.sendToMain("mcp-bridge:scan-ipc-messages", function (err, msgs) {
- if (err) {
- _this.log("扫描错误: ".concat(err));
- return;
- }
- if (msgs) {
- _this.allMessages = msgs;
- _this.filterMessages();
- _this.log("找到 ".concat(msgs.length, " 条消息。"));
- } else {
- _this.log("未找到任何消息。");
- }
- });
- };
- IpcUi.prototype.filterMessages = function () {
- if (!this.allMessages) return;
- var filter = this.filterSelect ? this.filterSelect.value : "all";
- var filtered = this.allMessages;
- if (filter === "available") {
- filtered = this.allMessages.filter(function (m) {
- return m.status === "可用";
- });
- } else if (filter === "unavailable") {
- filtered = this.allMessages.filter(function (m) {
- return m.status && m.status.includes("不可用");
- });
- } else if (filter === "untested") {
- filtered = this.allMessages.filter(function (m) {
- return !m.status || m.status === "未测试";
- });
- }
- this.renderList(filtered);
- };
- IpcUi.prototype.renderList = function (msgs) {
- var _this = this;
- if (!this.ipcList) return;
- this.ipcList.innerHTML = "";
- msgs.forEach(function (msg) {
- var item = document.createElement("div");
- item.className = "ipc-item";
- item.style.padding = "4px";
- item.style.borderBottom = "1px solid #333";
- item.style.display = "flex";
- item.style.alignItems = "center";
- // Checkbox
- var checkbox = document.createElement("ui-checkbox");
- // @ts-ignore
- checkbox.value = false;
- checkbox.setAttribute("data-name", msg.name);
- checkbox.style.marginRight = "8px";
- // Content
- var content = document.createElement("div");
- content.style.flex = "1";
- content.style.fontSize = "11px";
- var statusColor = "#888"; // Untested
- if (msg.status === "可用")
- statusColor = "#4CAF50"; // Green
- else if (msg.status && msg.status.includes("不可用")) statusColor = "#F44336"; // Red
- content.innerHTML =
- '\n \n '
- .concat(msg.name, '\n ')
- .concat(
- msg.status || "未测试",
- '\n
\n ',
- )
- .concat(
- msg.description || "无描述",
- '
\n 参数: ',
- )
- .concat(msg.params || "无", "
\n ");
- // Action Button
- var btnRun = document.createElement("ui-button");
- btnRun.innerText = "执行";
- btnRun.className = "tiny";
- btnRun.style.height = "20px";
- btnRun.style.lineHeight = "20px";
- btnRun.addEventListener("confirm", function () {
- _this.runTest(msg.name);
- });
- item.appendChild(checkbox);
- item.appendChild(content);
- item.appendChild(btnRun);
- _this.ipcList.appendChild(item);
- });
- };
- IpcUi.prototype.testSelected = function () {
- return __awaiter(this, void 0, void 0, function () {
- var checkboxes, toTest, _i, toTest_1, name_1;
- return __generator(this, function (_a) {
- switch (_a.label) {
- case 0:
- checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
- toTest = [];
- checkboxes.forEach(function (cb) {
- // In Cocos 2.x, ui-checkbox value is boolean
- if (cb.checked || cb.value === true) {
- toTest.push(cb.getAttribute("data-name"));
- }
- });
- if (toTest.length === 0) {
- this.log("未选择任何消息。");
- return [2 /*return*/];
- }
- this.log("开始批量测试 ".concat(toTest.length, " 条消息..."));
- ((_i = 0), (toTest_1 = toTest));
- _a.label = 1;
- case 1:
- if (!(_i < toTest_1.length)) return [3 /*break*/, 4];
- name_1 = toTest_1[_i];
- return [4 /*yield*/, this.runTest(name_1)];
- case 2:
- _a.sent();
- _a.label = 3;
- case 3:
- _i++;
- return [3 /*break*/, 1];
- case 4:
- this.log("批量测试完成。");
- return [2 /*return*/];
- }
- });
- });
- };
- IpcUi.prototype.runTest = function (name) {
- var _this = this;
- return new Promise(function (resolve) {
- var params = null;
- if (_this.paramInput && _this.paramInput.value.trim()) {
- try {
- params = JSON.parse(_this.paramInput.value.trim());
- } catch (e) {
- _this.log("[错误] 无效的 JSON 参数: ".concat(e));
- resolve();
- return;
- }
- }
- _this.log("正在测试: ".concat(name, "，参数: ").concat(JSON.stringify(params), "..."));
- // @ts-ignore
- Editor.Ipc.sendToMain(
- "mcp-bridge:test-ipc-message",
- { name: name, params: params },
- function (err, result) {
- if (err) {
- _this.log("[".concat(name, "] 失败: ").concat(err));
- } else {
- _this.log("[".concat(name, "] 成功: ").concat(JSON.stringify(result)));
- }
- resolve();
- },
- );
- });
- };
- IpcUi.prototype.toggleAll = function (checked) {
- var checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
- checkboxes.forEach(function (cb) {
- cb.value = checked;
- });
- };
- IpcUi.prototype.log = function (msg) {
- if (this.logArea) {
- // @ts-ignore
- var time = new Date().toLocaleTimeString();
- this.logArea.value += "[".concat(time, "] ").concat(msg, "\n");
- this.logArea.scrollTop = this.logArea.scrollHeight;
- }
- };
- return IpcUi;
-})();
-exports.IpcUi = IpcUi;
diff --git a/IPC_MESSAGES.md b/docs/IPC_MESSAGES.md
similarity index 100%
rename from IPC_MESSAGES.md
rename to docs/IPC_MESSAGES.md
diff --git a/UPDATE_LOG.md b/docs/UPDATE_LOG.md
similarity index 76%
rename from UPDATE_LOG.md
rename to docs/UPDATE_LOG.md
index b5c5bd1..efcaa39 100644
--- a/UPDATE_LOG.md
+++ b/docs/UPDATE_LOG.md
@@ -192,7 +192,17 @@
- **修复**: 在 `scene-script.js` 层加固了前置拦截规则：
1. **直接拦截节点**: 当检测到传入 `cc.Node` 或 `Node` 作为组件类型时直接驳回，并返回富含指导意义的中文提示词（如“请使用 create-node 创建节点”）。
2. **继承链校验**: 提取引擎类定义后，强制要求通过 `cc.js.isChildClassOf` 判断该类必须继承自 `cc.Component`。若不合法则即时截断并提示。
-- **价值**: 通过将冰冷的底层异常翻译为“手把手教 AI 怎么重试”的指导性异常，彻底根治了 AI 在操作组件时乱认对象、反复撞墙的通病。
+- **价值**: 通过将冰冷的底层异常翻译为"手把手教 AI 怎么重试"的指导性异常，彻底根治了 AI 在操作组件时乱认对象、反复撞墙的通病。
+
+---
+
+## 面板加载修复 (2026-02-24)
+
+### 1. `panel/index.js` 语法错误修复
+
+- **问题**: 面板加载时出现 `SyntaxError: Invalid or unexpected token`，导致 MCP Bridge 插件面板完全无法渲染。
+- **原因**: `index.js` 中存在非法字符或格式错误，被 Cocos Creator 的面板加载器拒绝解析。
+- **修复**: 清理了文件中的语法问题，确保面板能够正常加载和初始化。
---
@@ -205,7 +215,7 @@
### 2. 资源管理层 `save` 动作幻觉别名兼容
-- **问题**: AI 偶尔会幻觉以为 `prefab_management`/`manage_script`/`manage_material`/`manage_texture`/`manage_shader` 的更新动作为 `save`，而不是标准定义的 `update` 或 `write`，导致抛出“未知的管理操作”报错。
+- **问题**: AI 偶尔会幻觉以为 `prefab_management`/`manage_script`/`manage_material`/`manage_texture`/`manage_shader` 的更新动作为 `save`，而不是标准定义的 `update` 或 `write`，导致抛出"未知的管理操作"报错。
- **修复**: 在 `main.js` 所有这些管理工具的核心路由表中，为 `update` 和 `write` 操作均显式添加了 `case "save":` 作为后备兼容，极大地增强了不同大模型在不同提示词上下文环境下的操作容错率。
---
@@ -221,3 +231,67 @@
- **问题**: 为了防止大体积结构传递给 AI 时引发 OOM 截断崩溃，`main.js` 后台强行限制了所有日志向 Webview 输出的边界值 (默认不超过 100~500 字符)，导致人类开发者从面板查看时无法追溯长内容如 Base64 和完整序列化返回值。
- **修复**: 拆分了拦截逻辑。剔除 `argsPreview` 与 `preview` 针对主面板渲染视图输出 `addLog` 时的预备阶段的 `substring` 剪裁。如今编辑器 UI 内将能看到完整、原生的调用参数和回调结果，而对于通过 HTTP 接口返还给 AI 的载荷依然安全拦截。
+
+## 日志系统持久化与健壮性优化 (2026-02-27)
+
+### 1. 日志文件持久化
+
+- **问题**: 插件的所有运行日志只保存在内存中（`logBuffer`），编辑器重启后日志全部丢失，无法进行会话级别的问题回溯。
+- **优化**: 在 `main.js` 的 `addLog` 函数中新增文件写入逻辑。所有日志实时追加写入项目目录下的 `settings/mcp-bridge.log` 文件（懒初始化路径）。
+- **实现细节**:
+ - 新增 `getLogFilePath()` 辅助函数，通过 `Editor.assetdb.urlToFspath` 推导项目根目录，将日志存放在 `settings/` 子目录中。
+ - 日志格式统一为 `[时间戳] [类型] 内容`，与面板日志保持一致。
+ - 文件写入使用 `fs.appendFileSync` 同步追加，失败时静默不影响主流程。
+
+### 2. 日志缓冲区内存保护
+
+- **问题**: 长时间运行的编辑器会话中，`logBuffer` 数组无限增长，最终导致内存压力。
+- **优化**: 在 `addLog` 中增加上限检查，当日志条数超过 2000 时自动截断旧日志，仅保留最近 1500 条。
+
+### 3. 请求关联计数器 (`_requestCounter`)
+
+- **优化**: 新增全局 `_requestCounter` 变量，为每个 HTTP 请求分配唯一的自增序号，便于在高并发场景下追踪同一请求的完整生命周期（从入队到执行到响应）。
+
+### 4. CommandQueue 兜底超时保护
+
+- **问题**: 原有的 `processNextCommand` 队列机制依赖每个指令主动调用 `done()` 回调来释放队列。如果某个工具函数内部逻辑异常导致 `done()` 未被调用，整个队列将永久停滞。
+- **优化**: 在 `enqueueCommand` 中为每个入队指令注册 60 秒兜底超时定时器 (`setTimeout`)。超时后强制释放队列位置并记录错误日志 `[CommandQueue] 指令执行超时(60s)，强制释放队列`，确保后续指令不被阻塞。
+- **正常路径**: 指令正常完成时通过 `clearTimeout` 取消定时器，无额外开销。
+
+### 5. 日志仅输出关键信息到编辑器控制台
+
+- **优化**: `addLog` 函数不再将所有类型的日志输出到编辑器控制台，仅 `error` 和 `warn` 级别日志通过 `Editor.error()` / `Editor.warn()` 输出，防止 `info` / `success` / `mcp` 类型日志刷屏干扰开发者。
+
+---
+
+## 性能与可靠性优化 (2026-02-28)
+
+### 1. CommandQueue 超时保护恢复
+
+- **问题**: 合并冲突解决时 `enqueueCommand` 中的 60 秒兜底超时保护代码丢失，导致如果工具函数内部异常未调用 `done()`，整个指令队列将永久停滞，后续所有操作将卡死不再响应。
+- **修复**: 在 `enqueueCommand` 中为每个入队指令注册 `setTimeout(60000)` 超时定时器，正常完成时通过 `clearTimeout` 取消。
+
+### 2. HTTP 请求体大小限制
+
+- **问题**: `_handleRequest` 中 `body += chunk` 无上限保护，超大请求体（恶意或异常客户端）可能耗尽编辑器进程内存。
+- **修复**: 新增 5MB (`5 * 1024 * 1024`) 请求体上限，超出时返回 HTTP 413 并销毁连接。
+
+### 3. 日志文件轮转机制
+
+- **问题**: `settings/mcp-bridge.log` 文件持续追加写入，长期使用会无限增长占用磁盘空间。
+- **修复**: 在 `getLogFilePath()` 初始化时检查文件大小，超过 2MB 自动将旧日志重命名为 `.old` 备份后创建新文件。
+
+### 4. 清理冗余调试日志
+
+- **问题**: `scene-script.js` 中 `update-node-transform` 和 `applyProperties` 共有 8 处 `Editor.log` 调试日志，每次操作都输出到编辑器控制台造成刷屏。
+- **修复**: 移除所有冗余 `Editor.log` 调试输出，保留必要的 `Editor.warn` 警告（如资源加载失败、属性解析失败等）。
+
+### 5. `applyProperties` 逻辑修复
+
+- **问题**: `applyProperties` 启发式资源解析分支中使用了 `return` 而非 `continue`，导致处理到该分支后会直接退出整个 `for...of` 循环，跳过后续属性的设置。
+- **修复**: 将 `return` 改为 `continue`，确保多属性同时更新时所有属性都能被正确处理。
+
+### 6. `instantiate-prefab` 统一使用 `findNode`
+
+- **问题**: `instantiate-prefab` 中查找父节点直接调用 `cc.engine.getInstanceById(parentId)`，绕过了 `findNode` 函数的压缩 UUID 解压与兼容逻辑。
+- **修复**: 统一改用 `findNode(parentId)`，确保所有场景操作对压缩和非压缩 UUID 格式的兼容性一致。
diff --git a/注意事项.md b/docs/注意事项.md
similarity index 100%
rename from 注意事项.md
rename to docs/注意事项.md
diff --git a/mcp-proxy.js b/mcp-proxy.js
deleted file mode 100644
index f956650..0000000
--- a/mcp-proxy.js
+++ /dev/null
@@ -1,149 +0,0 @@
-/**
- * MCP 桥接代理脚本
- * 负责在标准 MCP 客户端 (stdin/stdout) 与 Cocos Creator 插件 (HTTP) 之间转发请求。
- */
-
-const http = require("http");
-
-/**
- * 当前 Cocos Creator 插件监听的端口
- * @type {number}
- */
-const COCOS_PORT = 3456;
-
-/**
- * 发送调试日志到标准的错误输出流水
- * @param {string} msg 日志消息
- */
-function debugLog(msg) {
- process.stderr.write(`[代理调试] ${msg}\n`);
-}
-
-// 监听标准输入以获取 MCP 请求
-process.stdin.on("data", (data) => {
- const lines = data.toString().split("\n");
- lines.forEach((line) => {
- if (!line.trim()) return;
- try {
- const request = JSON.parse(line);
- handleRequest(request);
- } catch (e) {
- // 忽略非 JSON 输入
- }
- });
-});
-
-/**
- * 处理 JSON-RPC 请求
- * @param {Object} req RPC 请求对象
- */
-function handleRequest(req) {
- const { method, id, params } = req;
-
- // 处理握手初始化
- if (method === "initialize") {
- sendToAI({
- jsonrpc: "2.0",
- id: id,
- result: {
- protocolVersion: "2024-11-05",
- capabilities: { tools: {} },
- serverInfo: { name: "cocos-bridge", version: "1.0.0" },
- },
- });
- return;
- }
-
- // 获取工具列表
- if (method === "tools/list") {
- forwardToCocos("/list-tools", null, id, "GET");
- return;
- }
-
- // 执行具体工具
- if (method === "tools/call") {
- forwardToCocos(
- "/call-tool",
- {
- name: params.name,
- arguments: params.arguments,
- },
- id,
- "POST",
- );
- return;
- }
-
- // 默认空响应
- if (id !== undefined) sendToAI({ jsonrpc: "2.0", id: id, result: {} });
-}
-
-/**
- * 将请求通过 HTTP 转发给 Cocos Creator 插件
- * @param {string} path API 路径
- * @param {Object|null} payload 发送的数据体
- * @param {string|number} id RPC 请求标识符
- * @param {string} method HTTP 方法 (默认 POST)
- */
-function forwardToCocos(path, payload, id, method = "POST") {
- const postData = payload ? JSON.stringify(payload) : "";
-
- const options = {
- hostname: "127.0.0.1",
- port: COCOS_PORT,
- path: path,
- method: method,
- headers: { "Content-Type": "application/json" },
- };
-
- if (postData) {
- options.headers["Content-Length"] = Buffer.byteLength(postData);
- }
-
- const request = http.request(options, (res) => {
- let resData = "";
- res.on("data", (d) => (resData += d));
- res.on("end", () => {
- try {
- const cocosRes = JSON.parse(resData);
-
- // 检查关键字段，确保 Cocos 插件返回了期望的数据格式
- if (path === "/list-tools" && !cocosRes.tools) {
- debugLog(`致命错误: Cocos 未返回工具列表。接收内容: ${resData}`);
- sendError(id, -32603, "Cocos 响应无效：缺少 tools 数组");
- } else {
- sendToAI({ jsonrpc: "2.0", id: id, result: cocosRes });
- }
- } catch (e) {
- debugLog(`JSON 解析错误。Cocos 发送内容: ${resData}`);
- sendError(id, -32603, "Cocos 返回了非 JSON 数据");
- }
- });
- });
-
- request.on("error", (e) => {
- debugLog(`Cocos 插件已离线: ${e.message}`);
- sendError(id, -32000, "Cocos 插件离线");
- });
-
- if (postData) request.write(postData);
- request.end();
-}
-
-/**
- * 将结果发送给 AI (通过标准输出)
- * @param {Object} obj 结果对象
- */
-function sendToAI(obj) {
- process.stdout.write(JSON.stringify(obj) + "\n");
-}
-
-/**
- * 发送 RPC 错误响应
- * @param {string|number} id RPC 请求标识符
- * @param {number} code 错误码
- * @param {string} message 错误消息
- */
-function sendError(id, code, message) {
- sendToAI({ jsonrpc: "2.0", id: id, error: { code, message } });
-}
diff --git a/package.json b/package.json
index 44e2752..f9d156e 100644
--- a/package.json
+++ b/package.json
@@ -3,8 +3,8 @@
"version": "1.0.0",
"description": "Cocos Creator MCP 桥接插件",
"author": "Firekula",
- "main": "main.js",
- "scene-script": "scene-script.js",
+ "main": "src/main.js",
+ "scene-script": "src/scene-script.js",
"main-menu": {
"MCP 桥接器/开启测试面板": {
"message": "mcp-bridge:open-test-panel"
diff --git a/panel/index.js b/panel/index.js
index 14d4b4a..a0fb0b7 100644
--- a/panel/index.js
+++ b/panel/index.js
@@ -6,323 +6,335 @@
*/
const fs = require("fs");
-const { IpcUi } = require("../dist/IpcUi");
+const { IpcUi } = require("../src/IpcUi");
Editor.Panel.extend({
- /**
- * 面板 CSS 样式
- */
- style: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
+ /**
+ * 面板 CSS 样式
+ */
+ style: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
- /**
- * 面板 HTML 模板
- */
- template: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
+ /**
+ * 面板 HTML 模板
+ */
+ template: fs.readFileSync(Editor.url("packages://mcp-bridge/panel/index.html"), "utf-8"),
- /**
- * 监听来自主进程的消息
- */
- messages: {
- /**
- * 接收并渲染日志
- * @param {Object} event IPC 事件对象
- * @param {Object} log 日志数据
- */
- "mcp-bridge:on-log"(event, log) {
- this.renderLog(log);
- },
+ /**
+ * 监听来自主进程的消息
+ */
+ messages: {
+ /**
+ * 接收并渲染日志
+ * @param {Object} event IPC 事件对象
+ * @param {Object} log 日志数据
+ */
+ "mcp-bridge:on-log"(event, log) {
+ this.renderLog(log);
+ },
- /**
- * 服务器状态变更通知
- * @param {Object} event IPC 事件对象
- * @param {Object} config 服务器配置
- */
- "mcp-bridge:state-changed"(event, config) {
- this.updateUI(config.active);
- // 如果服务器已启动，更新面板显示的端口为实际运行端口
- if (config.active && config.port) {
- const portInput = this.shadowRoot.querySelector("#portInput");
- if (portInput) portInput.value = config.port;
- }
- },
- },
+ /**
+ * 服务器状态变更通知
+ * @param {Object} event IPC 事件对象
+ * @param {Object} config 服务器配置
+ */
+ "mcp-bridge:state-changed"(event, config) {
+ this.updateUI(config.active);
+ // 如果服务器已启动，更新面板显示的端口为实际运行端口
+ if (config.active && config.port) {
+ const portInput = this.shadowRoot.querySelector("#portInput");
+ if (portInput) portInput.value = config.port;
+ }
+ },
+ },
- /**
- * 面板就绪回调，进行 DOM 绑定与事件初始化
- */
- ready() {
- const root = this.shadowRoot;
- // 获取 DOM 元素映射
- 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"),
- tabIpc: root.querySelector("#tabIpc"),
- panelMain: root.querySelector("#panelMain"),
- panelTest: root.querySelector("#panelTest"),
- panelIpc: root.querySelector("#panelIpc"),
- 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"),
- };
+ /**
+ * 面板就绪回调，进行 DOM 绑定与事件初始化
+ */
+ ready() {
+ const root = this.shadowRoot;
+ // 获取 DOM 元素映射
+ 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"),
+ tabIpc: root.querySelector("#tabIpc"),
+ panelMain: root.querySelector("#panelMain"),
+ panelTest: root.querySelector("#panelTest"),
+ panelIpc: root.querySelector("#panelIpc"),
+ 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));
+ }
+ });
- // 初始化 IPC 调试专用 UI (由 TypeScript 编写并编译到 dist)
- new IpcUi(root);
+ // 初始化 IPC 调试专用 UI
+ new IpcUi(root);
- // 2. 标签页切换逻辑
- els.tabMain.addEventListener("confirm", () => {
- els.tabMain.classList.add("active");
- els.tabTest.classList.remove("active");
- els.tabIpc.classList.remove("active");
- els.panelMain.classList.add("active");
- els.panelTest.classList.remove("active");
- els.panelIpc.classList.remove("active");
- });
+ // 2. 标签页切换逻辑
+ els.tabMain.addEventListener("confirm", () => {
+ els.tabMain.classList.add("active");
+ els.tabTest.classList.remove("active");
+ els.tabIpc.classList.remove("active");
+ els.panelMain.classList.add("active");
+ els.panelTest.classList.remove("active");
+ els.panelIpc.classList.remove("active");
+ });
- els.tabTest.addEventListener("confirm", () => {
- els.tabTest.classList.add("active");
- els.tabMain.classList.remove("active");
- els.tabIpc.classList.remove("active");
- els.panelTest.classList.add("active");
- els.panelMain.classList.remove("active");
- els.panelIpc.classList.remove("active");
- this.fetchTools(els); // 切换到测试页时自动拉取工具列表
- });
+ els.tabTest.addEventListener("confirm", () => {
+ els.tabTest.classList.add("active");
+ els.tabMain.classList.remove("active");
+ els.tabIpc.classList.remove("active");
+ els.panelTest.classList.add("active");
+ els.panelMain.classList.remove("active");
+ els.panelIpc.classList.remove("active");
+ this.fetchTools(els); // 切换到测试页时自动拉取工具列表
+ });
- els.tabIpc.addEventListener("confirm", () => {
- els.tabIpc.classList.add("active");
- els.tabMain.classList.remove("active");
- els.tabTest.classList.remove("active");
- els.panelIpc.classList.add("active");
- els.panelMain.classList.remove("active");
- els.panelTest.classList.remove("active");
- });
+ els.tabIpc.addEventListener("confirm", () => {
+ els.tabIpc.classList.add("active");
+ els.tabMain.classList.remove("active");
+ els.tabTest.classList.remove("active");
+ els.panelIpc.classList.add("active");
+ els.panelMain.classList.remove("active");
+ els.panelTest.classList.remove("active");
+ });
- // 3. 基础控制按钮逻辑
- els.btnToggle.addEventListener("confirm", () => {
- Editor.Ipc.sendToMain("mcp-bridge:toggle-server", parseInt(els.port.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("#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("日志已复制到剪贴板");
- });
+ root.querySelector("#btnCopy").addEventListener("confirm", () => {
+ require("electron").clipboard.writeText(els.logView.innerText);
+ Editor.success("日志已复制到剪贴板");
+ });
- els.autoStart.addEventListener("change", (e) => {
- Editor.Ipc.sendToMain("mcp-bridge:set-auto-start", e.target.value);
- });
+ els.autoStart.addEventListener("change", (e) => {
+ Editor.Ipc.sendToMain("mcp-bridge:set-auto-start", e.target.value);
+ });
- // 4. API 测试页交互逻辑
- els.listBtn.addEventListener("confirm", () => this.fetchTools(els));
- els.clearBtn.addEventListener("confirm", () => {
- els.result.value = "";
- });
- els.testBtn.addEventListener("confirm", () => this.runTest(els));
+ // 4. API 测试页交互逻辑
+ els.listBtn.addEventListener("confirm", () => this.fetchTools(els));
+ els.clearBtn.addEventListener("confirm", () => {
+ els.result.value = "";
+ });
+ els.testBtn.addEventListener("confirm", () => this.runTest(els));
- // API 探查功能 (辅助开发者发现可用内部 IPC)
- const probeBtn = root.querySelector("#probeApisBtn");
- if (probeBtn) {
- probeBtn.addEventListener("confirm", () => {
- Editor.Ipc.sendToMain("mcp-bridge:inspect-apis");
- els.result.value = "API 探查指令已发送。请查看编辑器控制台 (Console) 获取详细报告。";
- });
- }
+ // API 探查功能 (辅助开发者发现可用内部 IPC)
+ const probeBtn = root.querySelector("#probeApisBtn");
+ if (probeBtn) {
+ probeBtn.addEventListener("confirm", () => {
+ Editor.Ipc.sendToMain("mcp-bridge:inspect-apis");
+ els.result.value = "API 探查指令已发送。请查看编辑器控制台 (Console) 获取详细报告。";
+ });
+ }
- // 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";
+ });
+ }
+ },
- /**
- * 从本地服务器获取 MCP 工具列表并渲染
- * @param {Object} els DOM 元素映射
- */
- fetchTools(els) {
- const url = `http://localhost:${els.port.value}/list-tools`;
- els.result.value = "正在获取工具列表...";
- 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 = `成功：加载了 ${data.tools.length} 个工具。`;
- })
- .catch((e) => {
- els.result.value = "获取失败: " + e.message;
- });
- },
+ /**
+ * 从本地服务器获取 MCP 工具列表并渲染
+ * @param {Object} els DOM 元素映射
+ */
+ fetchTools(els) {
+ const url = `http://localhost:${els.port.value}/list-tools`;
+ els.result.value = "正在获取工具列表...";
+ 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 = `成功：加载了 ${data.tools.length} 个工具。`;
+ })
+ .catch((e) => {
+ els.result.value = "获取失败: " + e.message;
+ });
+ },
- /**
- * 在面板中展示工具的详细描述与参数定义
- * @param {Object} els DOM 元素映射
- * @param {Object} tool 工具定义对象
- */
- showToolDescription(els, tool) {
- if (!tool) {
- els.toolDescription.textContent = "选择工具以查看说明";
- return;
- }
+ /**
+ * 在面板中展示工具的详细描述与参数定义
+ * @param {Object} els DOM 元素映射
+ * @param {Object} tool 工具定义对象
+ */
+ showToolDescription(els, tool) {
+ if (!tool) {
+ els.toolDescription.textContent = "选择工具以查看说明";
+ return;
+ }
- let description = tool.description || "暂无描述";
- let inputSchema = tool.inputSchema;
+ 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);
- }
- }
+ 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("
")}`;
- },
+ els.toolDescription.innerHTML = `${description}
${details.join("
")}`;
+ },
- /**
- * 执行工具测试请求
- * @param {Object} els DOM 元素映射
- */
- runTest(els) {
- const url = `http://localhost:${els.port.value}/call-tool`;
- let args;
- try {
- args = JSON.parse(els.toolParams.value || "{}");
- } catch (e) {
- els.result.value = "JSON 格式错误: " + e.message;
- return;
- }
+ /**
+ * 执行工具测试请求
+ * @param {Object} els DOM 元素映射
+ */
+ runTest(els) {
+ const url = `http://localhost:${els.port.value}/call-tool`;
+ let args;
+ try {
+ args = JSON.parse(els.toolParams.value || "{}");
+ } catch (e) {
+ els.result.value = "JSON 格式错误: " + e.message;
+ return;
+ }
- const body = { name: els.toolName.value, arguments: args };
- els.result.value = "正在发送请求...";
- 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 = "测试异常: " + e.message;
- });
- },
+ const body = { name: els.toolName.value, arguments: args };
+ els.result.value = "正在发送请求...";
+ 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 = "测试异常: " + e.message;
+ });
+ },
- /**
- * 获取指定工具的示例参数
- * @param {string} name 工具名称
- * @returns {Object} 示例参数对象
- */
- getExample(name) {
- const examples = {
- set_node_name: { id: "节点-UUID", newName: "新名称" },
- update_node_transform: { id: "节点-UUID", x: 0, y: 0, color: "#FF0000" },
- create_node: { name: "新节点", type: "sprite", parentId: "" },
- open_scene: { url: "db://assets/Scene.fire" },
- open_prefab: { url: "db://assets/MyPrefab.prefab" },
- manage_editor: { action: "get_selection" },
- find_gameobjects: { conditions: { name: "MyNode", 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: "// 测试注释\n" }],
- },
- read_console: { limit: 10, type: "log" },
- validate_script: { filePath: "db://assets/scripts/TestScript.ts" },
- };
- return examples[name] || {};
- },
+ /**
+ * 获取指定工具的示例参数
+ * @param {string} name 工具名称
+ * @returns {Object} 示例参数对象
+ */
+ getExample(name) {
+ const examples = {
+ set_node_name: { id: "节点-UUID", newName: "新名称" },
+ update_node_transform: { id: "节点-UUID", x: 0, y: 0, color: "#FF0000" },
+ create_node: { name: "新节点", type: "sprite", parentId: "" },
+ open_scene: { url: "db://assets/Scene.fire" },
+ open_prefab: { url: "db://assets/MyPrefab.prefab" },
+ manage_editor: { action: "get_selection" },
+ find_gameobjects: { conditions: { name: "MyNode", 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: "// 测试注释\n" }],
+ },
+ read_console: { limit: 10, type: "log" },
+ validate_script: { filePath: "db://assets/scripts/TestScript.ts" },
+ };
+ return examples[name] || {};
+ },
- /**
- * 将日志条目渲染至面板控制台
- * @param {Object} log 日志对象
- */
- 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;
- },
+ /**
+ * 将日志条目渲染至面板控制台
+ * @param {Object} log 日志对象
+ */
+ renderLog(log) {
+ const view = this.shadowRoot.querySelector("#logConsole");
+ if (!view) return;
+ // 限制面板日志 DOM 节点数量，防止长时间运行后面板卡顿
+ while (view.childNodes.length > 1000) {
+ view.removeChild(view.firstChild);
+ }
+ const atBottom = view.scrollHeight - view.scrollTop <= view.clientHeight + 50;
+ const el = document.createElement("div");
+ el.className = `log-item ${log.type}`;
+ // 使用 textContent 代替 innerHTML 防止 XSS 注入
+ const timeSpan = document.createElement("span");
+ timeSpan.className = "time";
+ timeSpan.textContent = log.time;
+ const msgSpan = document.createElement("span");
+ msgSpan.className = "msg";
+ msgSpan.textContent = log.content;
+ el.appendChild(timeSpan);
+ el.appendChild(msgSpan);
+ view.appendChild(el);
+ if (atBottom) view.scrollTop = view.scrollHeight;
+ },
- /**
- * 根据服务器运行状态更新 UI 按钮文字与样式
- * @param {boolean} active 服务器是否处于激活状态
- */
- updateUI(active) {
- const btn = this.shadowRoot.querySelector("#btnToggle");
- if (!btn) return;
- btn.innerText = active ? "停止" : "启动";
- btn.style.backgroundColor = active ? "#aa4444" : "#44aa44";
- },
+ /**
+ * 根据服务器运行状态更新 UI 按钮文字与样式
+ * @param {boolean} active 服务器是否处于激活状态
+ */
+ updateUI(active) {
+ const btn = this.shadowRoot.querySelector("#btnToggle");
+ if (!btn) return;
+ btn.innerText = active ? "停止" : "启动";
+ btn.style.backgroundColor = active ? "#aa4444" : "#44aa44";
+ },
});
diff --git a/src/IpcManager.js b/src/IpcManager.js
new file mode 100644
index 0000000..082ac01
--- /dev/null
+++ b/src/IpcManager.js
@@ -0,0 +1,95 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * IPC 消息管理器
+ * 负责解析 IPC 文档并执行消息测试
+ */
+class IpcManager {
+ /**
+ * 获取所有 IPC 消息列表
+ * @returns {Array} 消息定义列表
+ */
+ static getIpcMessages() {
+ // 获取文档路径
+ const docPath = Editor.url("packages://mcp-bridge/docs/IPC_MESSAGES.md");
+ if (!fs.existsSync(docPath)) {
+ Editor.error(`[IPC 管理器] 找不到文档文件: ${docPath}`);
+ return [];
+ }
+
+ const content = fs.readFileSync(docPath, "utf-8");
+ const messages = [];
+
+ // 正则匹配 ### `message-name`
+ const regex = /### `(.*?)`\r?\n([\s\S]*?)(?=### `|$)/g;
+ let match;
+
+ while ((match = regex.exec(content)) !== null) {
+ const name = match[1];
+ const body = match[2];
+
+ // 解析用途
+ const purposeMatch = body.match(/- \*\*用途\*\*: (.*)/);
+ const description = purposeMatch ? purposeMatch[1].trim() : "无描述";
+
+ // 解析参数
+ const paramsMatch = body.match(/- \*\*参数\*\*: (.*)/);
+ const params = paramsMatch ? paramsMatch[1].trim() : "无";
+
+ // 解析返回值
+ const returnMatch = body.match(/- \*\*返回值\*\*: (.*)/);
+ const returns = returnMatch ? returnMatch[1].trim() : "无";
+
+ // 解析类型
+ const typeMatch = body.match(/- \*\*类型\*\*: (.*)/);
+ const type = typeMatch ? typeMatch[1].trim() : "未定义";
+
+ // 解析状态
+ const statusMatch = body.match(/- \*\*状态\*\*: (.*)/);
+ const status = statusMatch ? statusMatch[1].trim() : "未测试";
+
+ // 过滤掉广播事件和渲染进程监听的事件
+ if (type === "广播事件" || type === "Events listened by Renderer Process" || type === "渲染进程监听") {
+ continue;
+ }
+
+ messages.push({
+ name,
+ description,
+ params,
+ returns,
+ type,
+ status,
+ });
+ }
+
+ return messages;
+ }
+
+ /**
+ * 测试发送 IPC 消息
+ * @param {string} name 消息名称
+ * @param {*} args 参数
+ * @returns {Promise} 测试结果
+ */
+ static testIpcMessage(name, args) {
+ if (args === undefined) args = null;
+ return new Promise((resolve) => {
+ try {
+ if (Editor.Ipc.sendToMain) {
+ Editor.Ipc.sendToMain(name, args);
+ resolve({ success: true, message: "消息已发送 (sendToMain)" });
+ } else {
+ resolve({ success: false, message: "Editor.Ipc.sendToMain 不可用" });
+ }
+ } catch (e) {
+ resolve({ success: false, message: `错误: ${e.message}` });
+ }
+ });
+ }
+}
+
+module.exports = { IpcManager };
diff --git a/src/IpcManager.ts b/src/IpcManager.ts
deleted file mode 100644
index 5a3a309..0000000
--- a/src/IpcManager.ts
+++ /dev/null
@@ -1,106 +0,0 @@
-// @ts-ignore
-const fs = require("fs");
-// @ts-ignore
-const path = require("path");
-
-/**
- * IPC 消息管理器
- * 负责解析 IPC 文档并执行消息测试
- */
-export class IpcManager {
- /**
- * 获取所有 IPC 消息列表
- * @returns 消息定义列表
- */
- public static getIpcMessages(): any[] {
- // 获取文档路径
- // @ts-ignore
- const docPath = Editor.url("packages://mcp-bridge/IPC_MESSAGES.md");
- if (!fs.existsSync(docPath)) {
- // @ts-ignore
- Editor.error(`[IPC 管理器] 找不到文档文件: ${docPath}`);
- return [];
- }
-
- const content = fs.readFileSync(docPath, "utf-8");
- const messages: any[] = [];
-
- // 正则匹配 ### `message-name`
- const regex = /### `(.*?)`\r?\n([\s\S]*?)(?=### `|$)/g;
- let match;
-
- while ((match = regex.exec(content)) !== null) {
- const name = match[1];
- const body = match[2];
-
- // 解析用途
- const purposeMatch = body.match(/- \*\*用途\*\*: (.*)/);
- const description = purposeMatch ? purposeMatch[1].trim() : "无描述";
-
- // 解析参数
- const paramsMatch = body.match(/- \*\*参数\*\*: (.*)/);
- const params = paramsMatch ? paramsMatch[1].trim() : "无";
-
- // 解析返回值
- const returnMatch = body.match(/- \*\*返回值\*\*: (.*)/);
- const returns = returnMatch ? returnMatch[1].trim() : "无";
-
- // 解析类型
- const typeMatch = body.match(/- \*\*类型\*\*: (.*)/);
- const type = typeMatch ? typeMatch[1].trim() : "未定义";
-
- // 解析状态
- const statusMatch = body.match(/- \*\*状态\*\*: (.*)/);
- const status = statusMatch ? statusMatch[1].trim() : "未测试";
-
- // 过滤掉广播事件和渲染进程监听的事件
- if (type === "广播事件" || type === "Events listened by Renderer Process" || type === "渲染进程监听") {
- continue;
- }
-
- messages.push({
- name,
- description,
- params,
- returns,
- type,
- status,
- });
- }
-
- return messages;
- }
-
- /**
- * 测试发送 IPC 消息
- * @param name 消息名称
- * @param args 参数
- * @returns Promise 测试结果
- */
- public static async testIpcMessage(name: string, args: any = null): Promise {
- return new Promise((resolve) => {
- // 简单防呆：防止执行危险操作
- // 如果消息包含 "delete", "remove", "close", "stop" 且没有明确参数确认，则警告
- // 但用户要求"快速验证"，所以我们默认允许，但如果是无参调用可能有风险
- // 这里我们尝试使用 Editor.Ipc.sendToMain 或 requestToMain
-
- // @ts-ignore
- // 简单的测试：只是发送看看是否报错。
- // 对于 request 类型的消息，我们期望有回调
- // Cocos Creator 2.4 API: Editor.Ipc.sendToMain(message, ...args)
-
- try {
- // @ts-ignore
- if (Editor.Ipc.sendToMain) {
- // @ts-ignore
- Editor.Ipc.sendToMain(name, args);
- resolve({ success: true, message: "消息已发送 (sendToMain)" });
- } else {
- resolve({ success: false, message: "Editor.Ipc.sendToMain 不可用" });
- }
- } catch (e: any) {
- resolve({ success: false, message: `错误: ${e.message}` });
- }
- });
- }
-}
diff --git a/src/IpcUi.js b/src/IpcUi.js
new file mode 100644
index 0000000..d5568c6
--- /dev/null
+++ b/src/IpcUi.js
@@ -0,0 +1,226 @@
+"use strict";
+
+/**
+ * IPC 测试面板 UI 管理器
+ * 负责在面板中展示和测试 IPC 消息
+ */
+class IpcUi {
+ /**
+ * 构造函数
+ * @param {ShadowRoot} root Shadow UI 根节点
+ */
+ constructor(root) {
+ this.root = root;
+ this.logArea = null;
+ this.ipcList = null;
+ this.allMessages = [];
+ this.filterSelect = null;
+ this.paramInput = null;
+ this.bindEvents();
+ }
+
+ /**
+ * 绑定 UI 事件
+ */
+ bindEvents() {
+ const btnScan = this.root.querySelector("#btnScanIpc");
+ const btnTest = this.root.querySelector("#btnTestIpc");
+ const cbSelectAll = this.root.querySelector("#cbSelectAllIpc");
+ this.logArea = this.root.querySelector("#ipcLog");
+ this.ipcList = this.root.querySelector("#ipcList");
+ this.filterSelect = this.root.querySelector("#ipcFilter");
+ this.paramInput = this.root.querySelector("#ipcParams");
+
+ if (btnScan) {
+ btnScan.addEventListener("confirm", () => this.scanMessages());
+ }
+ if (btnTest) {
+ btnTest.addEventListener("confirm", () => this.testSelected());
+ }
+ if (cbSelectAll) {
+ cbSelectAll.addEventListener("change", (e) =>
+ this.toggleAll(e.detail ? e.detail.value : e.target.value === "true" || e.target.checked),
+ );
+ }
+ if (this.filterSelect) {
+ this.filterSelect.addEventListener("change", () => this.filterMessages());
+ }
+ }
+
+ /**
+ * 扫描 IPC 消息
+ */
+ scanMessages() {
+ this.log("正在扫描 IPC 消息...");
+ Editor.Ipc.sendToMain("mcp-bridge:scan-ipc-messages", (err, msgs) => {
+ if (err) {
+ this.log(`扫描错误: ${err}`);
+ return;
+ }
+ if (msgs) {
+ this.allMessages = msgs;
+ this.filterMessages();
+ this.log(`找到 ${msgs.length} 条消息。`);
+ } else {
+ this.log("未找到任何消息。");
+ }
+ });
+ }
+
+ /**
+ * 根据当前选择器过滤消息列表
+ */
+ filterMessages() {
+ if (!this.allMessages) return;
+ const filter = this.filterSelect ? this.filterSelect.value : "all";
+
+ let filtered = this.allMessages;
+ if (filter === "available") {
+ filtered = this.allMessages.filter((m) => m.status === "可用");
+ } else if (filter === "unavailable") {
+ filtered = this.allMessages.filter((m) => m.status && m.status.includes("不可用"));
+ } else if (filter === "untested") {
+ filtered = this.allMessages.filter((m) => !m.status || m.status === "未测试");
+ }
+
+ this.renderList(filtered);
+ }
+
+ /**
+ * 渲染消息列表 UI
+ * @param {Array} msgs 消息对象数组
+ */
+ renderList(msgs) {
+ if (!this.ipcList) return;
+ this.ipcList.innerHTML = "";
+
+ msgs.forEach((msg) => {
+ const item = document.createElement("div");
+ item.className = "ipc-item";
+ item.style.padding = "4px";
+ item.style.borderBottom = "1px solid #333";
+ item.style.display = "flex";
+ item.style.alignItems = "center";
+
+ // 复选框
+ const checkbox = document.createElement("ui-checkbox");
+ checkbox.value = false;
+ checkbox.setAttribute("data-name", msg.name);
+ checkbox.style.marginRight = "8px";
+
+ // 内容区域
+ const content = document.createElement("div");
+ content.style.flex = "1";
+ content.style.fontSize = "11px";
+
+ let statusColor = "#888"; // 未测试
+ if (msg.status === "可用")
+ statusColor = "#4CAF50"; // 绿色
+ else if (msg.status && msg.status.includes("不可用")) statusColor = "#F44336"; // 红色
+
+ content.innerHTML = `
+
+ ${msg.name}
+ ${msg.status || "未测试"}
+
+ ${msg.description || "无描述"}
+ 参数: ${msg.params || "无"}
+ `;
+
+ // 执行按钮
+ const btnRun = document.createElement("ui-button");
+ btnRun.innerText = "执行";
+ btnRun.className = "tiny";
+ btnRun.style.height = "20px";
+ btnRun.style.lineHeight = "20px";
+ btnRun.addEventListener("confirm", () => {
+ this.runTest(msg.name);
+ });
+
+ item.appendChild(checkbox);
+ item.appendChild(content);
+ item.appendChild(btnRun);
+ this.ipcList.appendChild(item);
+ });
+ }
+
+ /**
+ * 测试所有选中的 IPC 消息
+ */
+ async testSelected() {
+ const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
+ const toTest = [];
+ checkboxes.forEach((cb) => {
+ // 在 Cocos 2.x 中, ui-checkbox 的值是布尔型
+ if (cb.checked || cb.value === true) {
+ toTest.push(cb.getAttribute("data-name"));
+ }
+ });
+
+ if (toTest.length === 0) {
+ this.log("未选择任何消息。");
+ return;
+ }
+
+ this.log(`开始批量测试 ${toTest.length} 条消息...`);
+ for (const name of toTest) {
+ await this.runTest(name);
+ }
+ this.log("批量测试完成。");
+ }
+
+ /**
+ * 运行单个测试请求
+ * @param {string} name 消息名称
+ * @returns {Promise}
+ */
+ runTest(name) {
+ return new Promise((resolve) => {
+ let params = null;
+ if (this.paramInput && this.paramInput.value.trim()) {
+ try {
+ params = JSON.parse(this.paramInput.value.trim());
+ } catch (e) {
+ this.log(`[错误] 无效的 JSON 参数: ${e}`);
+ resolve();
+ return;
+ }
+ }
+
+ this.log(`正在测试: ${name}，参数: ${JSON.stringify(params)}...`);
+ Editor.Ipc.sendToMain("mcp-bridge:test-ipc-message", { name, params }, (err, result) => {
+ if (err) {
+ this.log(`[${name}] 失败: ${err}`);
+ } else {
+ this.log(`[${name}] 成功: ${JSON.stringify(result)}`);
+ }
+ resolve();
+ });
+ });
+ }
+
+ /**
+ * 全选/取消全选
+ * @param {boolean} checked 是否选中
+ */
+ toggleAll(checked) {
+ const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
+ checkboxes.forEach((cb) => {
+ cb.value = checked;
+ });
+ }
+
+ /**
+ * 输出日志到界面
+ * @param {string} msg 日志消息
+ */
+ log(msg) {
+ if (this.logArea) {
+ const time = new Date().toLocaleTimeString();
+ this.logArea.value += `[${time}] ${msg}\n`;
+ this.logArea.scrollTop = this.logArea.scrollHeight;
+ }
+ }
+}
+
+module.exports = { IpcUi };
diff --git a/src/IpcUi.ts b/src/IpcUi.ts
deleted file mode 100644
index eb23128..0000000
--- a/src/IpcUi.ts
+++ /dev/null
@@ -1,226 +0,0 @@
-// @ts-ignore
-const Editor = window.Editor;
-
-export class IpcUi {
- private root: ShadowRoot;
- private logArea: HTMLTextAreaElement | null = null;
- private ipcList: HTMLElement | null = null;
- private allMessages: any[] = [];
- private filterSelect: HTMLSelectElement | null = null;
- private paramInput: HTMLTextAreaElement | null = null;
-
- /**
- * 构造函数
- * @param root Shadow UI 根节点
- */
- constructor(root: ShadowRoot) {
- this.root = root;
- this.bindEvents();
- }
-
- /**
- * 绑定 UI 事件
- */
- private bindEvents() {
- const btnScan = this.root.querySelector("#btnScanIpc");
- const btnTest = this.root.querySelector("#btnTestIpc");
- const cbSelectAll = this.root.querySelector("#cbSelectAllIpc");
- this.logArea = this.root.querySelector("#ipcLog") as HTMLTextAreaElement;
- this.ipcList = this.root.querySelector("#ipcList") as HTMLElement;
- this.filterSelect = this.root.querySelector("#ipcFilter") as HTMLSelectElement;
- this.paramInput = this.root.querySelector("#ipcParams") as HTMLTextAreaElement;
-
- if (btnScan) {
- btnScan.addEventListener("confirm", () => this.scanMessages());
- }
- if (btnTest) {
- btnTest.addEventListener("confirm", () => this.testSelected());
- }
- if (cbSelectAll) {
- cbSelectAll.addEventListener("change", (e: any) =>
- this.toggleAll(e.detail ? e.detail.value : e.target.value === "true" || e.target.checked),
- );
- }
- if (this.filterSelect) {
- this.filterSelect.addEventListener("change", () => this.filterMessages());
- }
- }
-
- /**
- * 扫描 IPC 消息
- */
- private scanMessages() {
- this.log("正在扫描 IPC 消息...");
- // @ts-ignore
- Editor.Ipc.sendToMain("mcp-bridge:scan-ipc-messages", (err: any, msgs: any[]) => {
- if (err) {
- this.log(`扫描错误: ${err}`);
- return;
- }
- if (msgs) {
- this.allMessages = msgs;
- this.filterMessages();
- this.log(`找到 ${msgs.length} 条消息。`);
- } else {
- this.log("未找到任何消息。");
- }
- });
- }
-
- /**
- * 根据当前选择器过滤消息列表
- */
- private filterMessages() {
- if (!this.allMessages) return;
- const filter = this.filterSelect ? this.filterSelect.value : "all";
-
- let filtered = this.allMessages;
- if (filter === "available") {
- filtered = this.allMessages.filter((m) => m.status === "可用");
- } else if (filter === "unavailable") {
- filtered = this.allMessages.filter((m) => m.status && m.status.includes("不可用"));
- } else if (filter === "untested") {
- filtered = this.allMessages.filter((m) => !m.status || m.status === "未测试");
- }
-
- this.renderList(filtered);
- }
-
- /**
- * 渲染消息列表 UI
- * @param msgs 消息对象数组
- */
- private renderList(msgs: any[]) {
- if (!this.ipcList) return;
- this.ipcList.innerHTML = "";
-
- msgs.forEach((msg) => {
- const item = document.createElement("div");
- item.className = "ipc-item";
- item.style.padding = "4px";
- item.style.borderBottom = "1px solid #333";
- item.style.display = "flex";
- item.style.alignItems = "center";
-
- // 复选框
- const checkbox = document.createElement("ui-checkbox");
- // @ts-ignore
- checkbox.value = false;
- checkbox.setAttribute("data-name", msg.name);
- checkbox.style.marginRight = "8px";
-
- // 内容区域
- const content = document.createElement("div");
- content.style.flex = "1";
- content.style.fontSize = "11px";
-
- let statusColor = "#888"; // 未测试
- if (msg.status === "可用")
- statusColor = "#4CAF50"; // 绿色
- else if (msg.status && msg.status.includes("不可用")) statusColor = "#F44336"; // 红色
-
- content.innerHTML = `
-
- ${msg.name}
- ${msg.status || "未测试"}
-
- ${msg.description || "无描述"}
- 参数: ${msg.params || "无"}
- `;
-
- // 执行按钮
- const btnRun = document.createElement("ui-button");
- btnRun.innerText = "执行";
- btnRun.className = "tiny";
- btnRun.style.height = "20px";
- btnRun.style.lineHeight = "20px";
- btnRun.addEventListener("confirm", () => {
- this.runTest(msg.name);
- });
-
- item.appendChild(checkbox);
- item.appendChild(content);
- item.appendChild(btnRun);
- this.ipcList!.appendChild(item);
- });
- }
-
- /**
- * 测试所有选中的 IPC 消息
- */
- private async testSelected() {
- const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
- const toTest: string[] = [];
- checkboxes.forEach((cb: any) => {
- // 在 Cocos 2.x 中, ui-checkbox 的值是布尔型
- if (cb.checked || cb.value === true) {
- toTest.push(cb.getAttribute("data-name"));
- }
- });
-
- if (toTest.length === 0) {
- this.log("未选择任何消息。");
- return;
- }
-
- this.log(`开始批量测试 ${toTest.length} 条消息...`);
- for (const name of toTest) {
- await this.runTest(name);
- }
- this.log("批量测试完成。");
- }
-
- /**
- * 运行单个测试请求
- * @param name 消息名称
- */
- private runTest(name: string): Promise {
- return new Promise((resolve) => {
- let params = null;
- if (this.paramInput && this.paramInput.value.trim()) {
- try {
- params = JSON.parse(this.paramInput.value.trim());
- } catch (e) {
- this.log(`[错误] 无效的 JSON 参数: ${e}`);
- resolve();
- return;
- }
- }
-
- this.log(`正在测试: ${name}，参数: ${JSON.stringify(params)}...`);
- // @ts-ignore
- Editor.Ipc.sendToMain("mcp-bridge:test-ipc-message", { name, params }, (err: any, result: any) => {
- if (err) {
- this.log(`[${name}] 失败: ${err}`);
- } else {
- this.log(`[${name}] 成功: ${JSON.stringify(result)}`);
- }
- resolve();
- });
- });
- }
-
- /**
- * 全选/取消全选
- * @param checked 是否选中
- */
- private toggleAll(checked: boolean) {
- const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
- checkboxes.forEach((cb: any) => {
- cb.value = checked;
- });
- }
-
- /**
- * 输出日志到界面
- * @param msg 日志消息
- */
- private log(msg: string) {
- if (this.logArea) {
- // @ts-ignore
- const time = new Date().toLocaleTimeString();
- this.logArea.value += `[${time}] ${msg}\n`;
- this.logArea.scrollTop = this.logArea.scrollHeight;
- }
- }
-}
diff --git a/main.js b/src/main.js
similarity index 96%
rename from main.js
rename to src/main.js
index 07b92b7..1f5646b 100644
--- a/main.js
+++ b/src/main.js
@@ -1,5 +1,5 @@
"use strict";
-const { IpcManager } = require("./dist/IpcManager");
+const { IpcManager } = require("./IpcManager");
const http = require("http");
const pathModule = require("path");
@@ -29,7 +29,14 @@ let isProcessingCommand = false;
*/
function enqueueCommand(fn) {
return new Promise((resolve) => {
- commandQueue.push({ fn, resolve });
+ // 兜底超时保护：防止 fn 内部未调用 done() 导致队列永久停滞
+ const timeoutId = setTimeout(() => {
+ addLog("error", "[CommandQueue] 指令执行超时(60s)，强制释放队列");
+ isProcessingCommand = false;
+ resolve();
+ processNextCommand();
+ }, 60000);
+ commandQueue.push({ fn, resolve, timeoutId });
processNextCommand();
});
}
@@ -40,15 +47,17 @@ function enqueueCommand(fn) {
function processNextCommand() {
if (isProcessingCommand || commandQueue.length === 0) return;
isProcessingCommand = true;
- const { fn, resolve } = commandQueue.shift();
+ const { fn, resolve, timeoutId } = commandQueue.shift();
try {
fn(() => {
+ clearTimeout(timeoutId);
isProcessingCommand = false;
resolve();
processNextCommand();
});
} catch (e) {
// 防止队列因未捕获异常永久阻塞
+ clearTimeout(timeoutId);
addLog("error", `[CommandQueue] 指令执行异常: ${e.message}`);
isProcessingCommand = false;
resolve();
@@ -92,25 +101,85 @@ function callSceneScriptWithTimeout(pluginName, method, args, callback, timeout
}
/**
- * 封装日志函数，同时发送给面板、保存到内存并在编辑器控制台打印
- * @param {'info' | 'success' | 'warn' | 'error'} type 日志类型
+ * 日志文件路径（懒初始化，在项目 settings 目录下）
+ * @type {string|null}
+ */
+let _logFilePath = null;
+
+/**
+ * 获取日志文件路径
+ * @returns {string|null}
+ */
+function getLogFilePath() {
+ if (_logFilePath) return _logFilePath;
+ try {
+ const assetsPath = Editor.assetdb.urlToFspath("db://assets");
+ if (assetsPath) {
+ const projectRoot = pathModule.dirname(assetsPath);
+ const settingsDir = pathModule.join(projectRoot, "settings");
+ if (!fs.existsSync(settingsDir)) {
+ fs.mkdirSync(settingsDir, { recursive: true });
+ }
+ _logFilePath = pathModule.join(settingsDir, "mcp-bridge.log");
+ // 日志轮转: 超过 2MB 时备份旧日志并创建新文件
+ try {
+ if (fs.existsSync(_logFilePath)) {
+ const stats = fs.statSync(_logFilePath);
+ if (stats.size > 2 * 1024 * 1024) {
+ const backupPath = _logFilePath + ".old";
+ if (fs.existsSync(backupPath)) fs.unlinkSync(backupPath);
+ fs.renameSync(_logFilePath, backupPath);
+ }
+ }
+ } catch (e) {
+ /* 轮转失败不影响主流程 */
+ }
+ return _logFilePath;
+ }
+ } catch (e) {
+ // 静默失败，不影响主流程
+ }
+ return null;
+}
+
+/**
+ * 封装日志函数
+ * - 所有日志发送到 MCP 测试面板 + 内存缓存
+ * - 仅 error / warn 输出到编辑器控制台（防止刷屏）
+ * - 所有日志实时追加写入项目内 settings/mcp-bridge.log 文件（持久化）
+ * @param {'info' | 'success' | 'warn' | 'error' | 'mcp'} type 日志类型
* @param {string} message 日志内容
*/
function addLog(type, message) {
const logEntry = {
- time: new Date().toLocaleTimeString(),
+ time: new Date().toISOString().replace("T", " ").substring(0, 23),
type: type,
content: message,
};
logBuffer.push(logEntry);
+ // 防止内存泄漏：限制日志缓存上限
+ if (logBuffer.length > 2000) {
+ logBuffer = logBuffer.slice(-1500);
+ }
+ // 发送到面板
Editor.Ipc.sendToPanel("mcp-bridge", "mcp-bridge:on-log", logEntry);
- // 【修改】确保所有日志都输出到编辑器控制台，以便用户查看
+ // 仅关键信息输出到编辑器控制台（error / warn）
if (type === "error") {
Editor.error(`[MCP] ${message}`);
} else if (type === "warn") {
Editor.warn(`[MCP] ${message}`);
- } else {
+ }
+
+ // 持久化到日志文件（实时写入，确保闪退时不丢失）
+ try {
+ const logPath = getLogFilePath();
+ if (logPath) {
+ const line = `[${logEntry.time}] [${type}] ${message}\n`;
+ fs.appendFileSync(logPath, line, "utf8");
+ }
+ } catch (e) {
+ // 文件写入失败时静默，不影响主流程
}
}
@@ -816,11 +885,21 @@ module.exports = {
res.setHeader("Content-Type", "application/json");
res.setHeader("Access-Control-Allow-Origin", "*");
+ const MAX_BODY_SIZE = 5 * 1024 * 1024; // 5MB 请求体上限
let body = "";
+ let aborted = false;
req.on("data", (chunk) => {
body += chunk;
+ if (body.length > MAX_BODY_SIZE) {
+ aborted = true;
+ addLog("error", `[HTTP] 请求体超过 ${MAX_BODY_SIZE} 字节上限，已拒绝`);
+ res.writeHead(413);
+ res.end(JSON.stringify({ error: "请求体过大" }));
+ req.destroy();
+ }
});
req.on("end", () => {
+ if (aborted) return;
const url = req.url;
if (url === "/list-tools") {
const tools = getToolsList();
diff --git a/src/mcp-proxy.js b/src/mcp-proxy.js
new file mode 100644
index 0000000..b7b0553
--- /dev/null
+++ b/src/mcp-proxy.js
@@ -0,0 +1,150 @@
+/**
+ * MCP 桥接代理脚本
+ * 负责在标准 MCP 客户端 (stdin/stdout) 与 Cocos Creator 插件 (HTTP) 之间转发请求。
+ */
+
+const http = require("http");
+
+/**
+ * 当前 Cocos Creator 插件监听的端口
+ * 支持通过环境变量 MCP_BRIDGE_PORT 或命令行参数指定端口
+ * @type {number}
+ */
+const COCOS_PORT = parseInt(process.env.MCP_BRIDGE_PORT || process.argv[2] || "3456", 10);
+
+/**
+ * 发送调试日志到标准的错误输出流水
+ * @param {string} msg 日志消息
+ */
+function debugLog(msg) {
+ process.stderr.write(`[代理调试] ${msg}\n`);
+}
+
+// 监听标准输入以获取 MCP 请求
+process.stdin.on("data", (data) => {
+ const lines = data.toString().split("\n");
+ lines.forEach((line) => {
+ if (!line.trim()) return;
+ try {
+ const request = JSON.parse(line);
+ handleRequest(request);
+ } catch (e) {
+ // 忽略非 JSON 输入
+ }
+ });
+});
+
+/**
+ * 处理 JSON-RPC 请求
+ * @param {Object} req RPC 请求对象
+ */
+function handleRequest(req) {
+ const { method, id, params } = req;
+
+ // 处理握手初始化
+ if (method === "initialize") {
+ sendToAI({
+ jsonrpc: "2.0",
+ id: id,
+ result: {
+ protocolVersion: "2024-11-05",
+ capabilities: { tools: {} },
+ serverInfo: { name: "cocos-bridge", version: "1.0.0" },
+ },
+ });
+ return;
+ }
+
+ // 获取工具列表
+ if (method === "tools/list") {
+ forwardToCocos("/list-tools", null, id, "GET");
+ return;
+ }
+
+ // 执行具体工具
+ if (method === "tools/call") {
+ forwardToCocos(
+ "/call-tool",
+ {
+ name: params.name,
+ arguments: params.arguments,
+ },
+ id,
+ "POST",
+ );
+ return;
+ }
+
+ // 默认空响应
+ if (id !== undefined) sendToAI({ jsonrpc: "2.0", id: id, result: {} });
+}
+
+/**
+ * 将请求通过 HTTP 转发给 Cocos Creator 插件
+ * @param {string} path API 路径
+ * @param {Object|null} payload 发送的数据体
+ * @param {string|number} id RPC 请求标识符
+ * @param {string} method HTTP 方法 (默认 POST)
+ */
+function forwardToCocos(path, payload, id, method = "POST") {
+ const postData = payload ? JSON.stringify(payload) : "";
+
+ const options = {
+ hostname: "127.0.0.1",
+ port: COCOS_PORT,
+ path: path,
+ method: method,
+ headers: { "Content-Type": "application/json" },
+ };
+
+ if (postData) {
+ options.headers["Content-Length"] = Buffer.byteLength(postData);
+ }
+
+ const request = http.request(options, (res) => {
+ let resData = "";
+ res.on("data", (d) => (resData += d));
+ res.on("end", () => {
+ try {
+ const cocosRes = JSON.parse(resData);
+
+ // 检查关键字段，确保 Cocos 插件返回了期望的数据格式
+ if (path === "/list-tools" && !cocosRes.tools) {
+ debugLog(`致命错误: Cocos 未返回工具列表。接收内容: ${resData}`);
+ sendError(id, -32603, "Cocos 响应无效：缺少 tools 数组");
+ } else {
+ sendToAI({ jsonrpc: "2.0", id: id, result: cocosRes });
+ }
+ } catch (e) {
+ debugLog(`JSON 解析错误。Cocos 发送内容: ${resData}`);
+ sendError(id, -32603, "Cocos 返回了非 JSON 数据");
+ }
+ });
+ });
+
+ request.on("error", (e) => {
+ debugLog(`Cocos 插件已离线: ${e.message}`);
+ sendError(id, -32000, "Cocos 插件离线");
+ });
+
+ if (postData) request.write(postData);
+ request.end();
+}
+
+/**
+ * 将结果发送给 AI (通过标准输出)
+ * @param {Object} obj 结果对象
+ */
+function sendToAI(obj) {
+ process.stdout.write(JSON.stringify(obj) + "\n");
+}
+
+/**
+ * 发送 RPC 错误响应
+ * @param {string|number} id RPC 请求标识符
+ * @param {number} code 错误码
+ * @param {string} message 错误消息
+ */
+function sendError(id, code, message) {
+ sendToAI({ jsonrpc: "2.0", id: id, error: { code, message } });
+}
diff --git a/scene-script.js b/src/scene-script.js
similarity index 97%
rename from scene-script.js
rename to src/scene-script.js
index ff55868..8562b4c 100644
--- a/scene-script.js
+++ b/src/scene-script.js
@@ -143,13 +143,10 @@ module.exports = {
*/
"update-node-transform": function (event, args) {
const { id, x, y, scaleX, scaleY, color } = args;
- Editor.log(`[scene-script] update-node-transform called for ${id} with args: ${JSON.stringify(args)}`);
let node = findNode(id);
if (node) {
- Editor.log(`[scene-script] 找到节点: ${node.name}, 当前坐标: (${node.x}, ${node.y})`);
-
// 使用 scene:set-property 实现支持 Undo 的属性修改
// 注意：IPC 消息需要发送到 'scene' 面板
if (x !== undefined) {
@@ -213,7 +210,6 @@ module.exports = {
Editor.Ipc.sendToMain("scene:dirty");
Editor.Ipc.sendToAll("scene:node-changed", { uuid: id });
- Editor.log(`[scene-script] 更新完成。新坐标: (${node.x}, ${node.y})`);
if (event.reply) event.reply(null, "变换信息已更新");
} else {
if (event.reply) event.reply(new Error("找不到节点"));
@@ -369,7 +365,6 @@ module.exports = {
if (targetNode) {
handler.target = targetNode;
- Editor.log(`[scene-script] Resolved event target: ${targetNode.name}`);
}
}
@@ -477,7 +472,6 @@ module.exports = {
asset = new cc.SpriteFrame(asset);
}
loadedAssets[idx] = asset;
- Editor.log(`[scene-script] 成功为 ${key}[${idx}] 加载资源: ${asset.name}`);
} else {
Editor.warn(`[scene-script] 未能为 ${key}[${idx}] 加载资源 ${uuid}: ${err}`);
}
@@ -529,7 +523,6 @@ module.exports = {
);
}
}
- Editor.log(`[scene-script] 已应用 ${key} 的引用: ${targetNode.name}`);
} else if (value && value.length > 20) {
// 如果明确是组件/节点类型但找不到，才报错
Editor.warn(`[scene-script] 无法解析 ${key} 的目标节点/组件: ${value}`);
@@ -540,7 +533,6 @@ module.exports = {
const targetNode = findNode(value);
if (targetNode) {
finalValue = targetNode;
- Editor.log(`[scene-script] 启发式解析 ${key} 的节点: ${targetNode.name}`);
} else {
// 找不到节点且是 UUID -> 视为资源
const compIndex = node._components.indexOf(component);
@@ -552,9 +544,8 @@ module.exports = {
value: { uuid: value },
isSubProp: false,
});
- Editor.log(`[scene-script] 通过 IPC 启发式解析 ${key} 的资源: ${value}`);
}
- return;
+ continue;
}
}
}
@@ -853,7 +844,7 @@ module.exports = {
}
// 设置父节点
- let parent = parentId ? cc.engine.getInstanceById(parentId) : scene;
+ let parent = parentId ? findNode(parentId) : scene;
if (parent) {
instance.parent = parent;
diff --git a/tsconfig.json b/tsconfig.json
deleted file mode 100644
index 1255432..0000000
--- a/tsconfig.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
- "compilerOptions": {
- "module": "commonjs",
- "lib": [
- "dom",
- "es5",
- "es2015.promise"
- ],
- "target": "es5",
- "experimentalDecorators": true,
- "skipLibCheck": true,
- "outDir": "./dist",
- "rootDir": "./src",
- "forceConsistentCasingInFileNames": true,
- "strict": false
- },
- "include": [
- "src/**/*"
- ]
-}
\ No newline at end of file