{
+ 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)
+ // @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: any) {
- resolve({ success: false, message: `Error: ${e.message}` });
- }
- });
- }
+ 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.ts b/src/IpcUi.ts
index df228b5..eb23128 100644
--- a/src/IpcUi.ts
+++ b/src/IpcUi.ts
@@ -1,192 +1,226 @@
-
// @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;
+ 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;
- constructor(root: ShadowRoot) {
- this.root = root;
- this.bindEvents();
- }
+ /**
+ * 构造函数
+ * @param root Shadow UI 根节点
+ */
+ constructor(root: ShadowRoot) {
+ this.root = root;
+ this.bindEvents();
+ }
- 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;
+ /**
+ * 绑定 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());
- }
- }
+ 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());
+ }
+ }
- private scanMessages() {
- this.log("Scanning IPC messages...");
- // @ts-ignore
- Editor.Ipc.sendToMain("mcp-bridge:scan-ipc-messages", (err: any, msgs: any[]) => {
- if (err) {
- this.log(`Scan Error: ${err}`);
- return;
- }
- if (msgs) {
- this.allMessages = msgs;
- this.filterMessages();
- this.log(`Found ${msgs.length} messages.`);
- } else {
- this.log("No messages found.");
- }
- });
- }
+ /**
+ * 扫描 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";
+ /**
+ * 根据当前选择器过滤消息列表
+ */
+ 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 === "未测试");
- }
+ 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);
- }
+ this.renderList(filtered);
+ }
- private renderList(msgs: any[]) {
- if (!this.ipcList) return;
- this.ipcList.innerHTML = "";
+ /**
+ * 渲染消息列表 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";
+ 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";
- // Checkbox
- const checkbox = document.createElement("ui-checkbox");
- // @ts-ignore
- checkbox.value = false;
- checkbox.setAttribute("data-name", msg.name);
- checkbox.style.marginRight = "8px";
+ // 复选框
+ const checkbox = document.createElement("ui-checkbox");
+ // @ts-ignore
+ checkbox.value = false;
+ checkbox.setAttribute("data-name", msg.name);
+ checkbox.style.marginRight = "8px";
- // Content
- const content = document.createElement("div");
- content.style.flex = "1";
- content.style.fontSize = "11px";
+ // 内容区域
+ const content = document.createElement("div");
+ content.style.flex = "1";
+ content.style.fontSize = "11px";
- let statusColor = "#888"; // Untested
- if (msg.status === "可用") statusColor = "#4CAF50"; // Green
- else if (msg.status && msg.status.includes("不可用")) statusColor = "#F44336"; // Red
+ let statusColor = "#888"; // 未测试
+ if (msg.status === "可用")
+ statusColor = "#4CAF50"; // 绿色
+ else if (msg.status && msg.status.includes("不可用")) statusColor = "#F44336"; // 红色
- content.innerHTML = `
+ content.innerHTML = `
${msg.name}
${msg.status || "未测试"}
- ${msg.description || "No desc"}
- Params: ${msg.params || "None"}
+ ${msg.description || "无描述"}
+ 参数: ${msg.params || "无"}
`;
- // Action Button
- const btnRun = document.createElement("ui-button");
- btnRun.innerText = "Run";
- btnRun.className = "tiny";
- btnRun.style.height = "20px";
- btnRun.style.lineHeight = "20px";
- btnRun.addEventListener("confirm", () => {
- this.runTest(msg.name);
- });
+ // 执行按钮
+ 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);
- });
- }
+ item.appendChild(checkbox);
+ item.appendChild(content);
+ item.appendChild(btnRun);
+ this.ipcList!.appendChild(item);
+ });
+ }
- private async testSelected() {
- const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
- const toTest: string[] = [];
- checkboxes.forEach((cb: any) => {
- // In Cocos 2.x, ui-checkbox value is boolean
- if (cb.checked || cb.value === true) {
- toTest.push(cb.getAttribute("data-name"));
- }
- });
+ /**
+ * 测试所有选中的 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("No messages selected.");
- return;
- }
+ if (toTest.length === 0) {
+ this.log("未选择任何消息。");
+ return;
+ }
- this.log(`Starting batch test for ${toTest.length} messages...`);
- for (const name of toTest) {
- await this.runTest(name);
- }
- this.log("Batch test completed.");
- }
+ this.log(`开始批量测试 ${toTest.length} 条消息...`);
+ for (const name of toTest) {
+ await this.runTest(name);
+ }
+ this.log("批量测试完成。");
+ }
- 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(`[Error] Invalid JSON Params: ${e}`);
- resolve();
- return;
- }
- }
+ /**
+ * 运行单个测试请求
+ * @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(`Testing: ${name} with params: ${JSON.stringify(params)}...`);
- // @ts-ignore
- Editor.Ipc.sendToMain("mcp-bridge:test-ipc-message", { name, params }, (err: any, result: any) => {
- if (err) {
- this.log(`[${name}] Failed: ${err}`);
- } else {
- this.log(`[${name}] Success: ${JSON.stringify(result)}`);
- }
- resolve();
- });
- });
- }
+ 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();
+ });
+ });
+ }
- private toggleAll(checked: boolean) {
- const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
- checkboxes.forEach((cb: any) => {
- cb.value = checked;
- });
- }
+ /**
+ * 全选/取消全选
+ * @param checked 是否选中
+ */
+ private toggleAll(checked: boolean) {
+ const checkboxes = this.root.querySelectorAll("#ipcList ui-checkbox");
+ checkboxes.forEach((cb: any) => {
+ cb.value = checked;
+ });
+ }
- 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;
- }
- }
+ /**
+ * 输出日志到界面
+ * @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;
+ }
+ }
}