@hangox/mg-cli 1.0.2 → 1.0.5

package/dist/cli.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/cli/commands/server.ts
 import { Command } from "commander";
 
 // src/server/daemon.ts
 import { spawn } from "child_process";
-import { fileURLToPath } from "url";
-import { dirname as dirname3, join as join2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname4, join as join3 } from "path";
 
 // src/shared/utils.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs";
@@ -175,6 +175,152 @@ function extractFileId(input) {
   }
   return extractFileIdFromUrl(trimmed);
 }
+var NUMERIC_FIELDS = [
+  "x",
+  "y",
+  "width",
+  "height",
+  "rotation",
+  "opacity",
+  "cornerRadius",
+  "topLeftRadius",
+  "topRightRadius",
+  "bottomLeftRadius",
+  "bottomRightRadius",
+  "strokeWeight",
+  "strokeTopWeight",
+  "strokeLeftWeight",
+  "strokeBottomWeight",
+  "strokeRightWeight",
+  "paddingTop",
+  "paddingRight",
+  "paddingBottom",
+  "paddingLeft",
+  "itemSpacing",
+  "crossAxisSpacing",
+  "flexGrow"
+];
+function roundToOneDecimal(value) {
+  return Math.round(value * 10) / 10;
+}
+var NODE_DEFAULTS = {
+  // Scene Node 属性
+  visible: true,
+  isVisible: true,
+  isLocked: false,
+  // Blend 属性
+  opacity: 1,
+  blendMode: "NORMAL",
+  isMask: false,
+  isMaskOutline: false,
+  isMaskVisible: false,
+  effectStyleId: "",
+  // Geometry 属性
+  strokeStyle: "SOLID",
+  strokeWeight: 0,
+  strokeTopWeight: 0,
+  strokeLeftWeight: 0,
+  strokeBottomWeight: 0,
+  strokeRightWeight: 0,
+  strokeAlign: "CENTER",
+  strokeCap: "NONE",
+  strokeJoin: "MITER",
+  dashCap: "NONE",
+  fillStyleId: "",
+  strokeStyleId: "",
+  // Corner 属性
+  cornerSmooth: 0,
+  cornerRadius: 0,
+  topLeftRadius: 0,
+  topRightRadius: 0,
+  bottomLeftRadius: 0,
+  bottomRightRadius: 0,
+  // Layout 属性
+  rotation: 0,
+  flexGrow: 0,
+  alignSelf: "INHERIT",
+  layoutPositioning: "AUTO",
+  constrainProportions: false,
+  // 容器专属属性 (FrameNode)
+  flexMode: "NONE",
+  flexWrap: "NO_WRAP",
+  itemSpacing: 0,
+  crossAxisSpacing: 0,
+  paddingTop: 0,
+  paddingRight: 0,
+  paddingBottom: 0,
+  paddingLeft: 0,
+  clipsContent: false,
+  itemReverseZIndex: false,
+  strokesIncludedInLayout: false,
+  // 其他属性
+  componentPropertyReferences: null
+};
+var EMPTY_ARRAY_FIELDS = [
+  "fills",
+  "strokes",
+  "effects",
+  "strokeDashes",
+  "exportSettings",
+  "reactions",
+  "attachedConnectors"
+];
+function isEmptyArray(value) {
+  return Array.isArray(value) && value.length === 0;
+}
+function isEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return a === b;
+  if (typeof a !== typeof b) return false;
+  return false;
+}
+function trimNodeDefaults(node) {
+  const result = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (key === "children" && Array.isArray(value)) {
+      const trimmedChildren = value.map(
+        (child) => typeof child === "object" && child !== null ? trimNodeDefaults(child) : child
+      );
+      if (trimmedChildren.length > 0) {
+        result[key] = trimmedChildren;
+      }
+      continue;
+    }
+    if (EMPTY_ARRAY_FIELDS.includes(key) && isEmptyArray(value)) {
+      continue;
+    }
+    if (NUMERIC_FIELDS.includes(key) && typeof value === "number") {
+      const roundedValue = roundToOneDecimal(value);
+      if (key in NODE_DEFAULTS && isEqual(roundedValue, NODE_DEFAULTS[key])) {
+        continue;
+      }
+      result[key] = roundedValue;
+      continue;
+    }
+    if (key in NODE_DEFAULTS) {
+      const defaultValue = NODE_DEFAULTS[key];
+      if (isEqual(value, defaultValue)) {
+        continue;
+      }
+    }
+    result[key] = value;
+  }
+  return result;
+}
+function extractSpaceInfo(node) {
+  const result = {
+    id: node.id,
+    name: node.name,
+    x: roundToOneDecimal(typeof node.x === "number" ? node.x : 0),
+    y: roundToOneDecimal(typeof node.y === "number" ? node.y : 0),
+    width: roundToOneDecimal(typeof node.width === "number" ? node.width : 0),
+    height: roundToOneDecimal(typeof node.height === "number" ? node.height : 0)
+  };
+  if (node.children && Array.isArray(node.children) && node.children.length > 0) {
+    result.children = node.children.map((child) => extractSpaceInfo(child));
+  }
+  return result;
+}
 
 // src/shared/errors.ts
 var ErrorNames = {
@@ -608,6 +754,57 @@ var RequestHandler = class {
   }
 };
 
+// src/shared/version.ts
+import { readFileSync as readFileSync2, existsSync as existsSync3 } from "fs";
+import { fileURLToPath } from "url";
+import { dirname as dirname3, join as join2 } from "path";
+var cachedVersion = null;
+function getVersion() {
+  if (cachedVersion !== null) {
+    return cachedVersion;
+  }
+  try {
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = dirname3(currentFile);
+    const versionFilePaths = [
+      join2(currentDir, "..", "VERSION"),
+      // dist/xxx.js -> ../VERSION
+      join2(currentDir, "..", "..", "VERSION")
+      // src/shared/version.ts -> ../../VERSION
+    ];
+    for (const versionFilePath of versionFilePaths) {
+      if (existsSync3(versionFilePath)) {
+        const version = readFileSync2(versionFilePath, "utf-8").trim();
+        if (version) {
+          cachedVersion = version;
+          return cachedVersion;
+        }
+      }
+    }
+    const packageJsonPaths = [
+      join2(currentDir, "..", "package.json"),
+      join2(currentDir, "..", "..", "package.json")
+    ];
+    for (const packageJsonPath of packageJsonPaths) {
+      if (existsSync3(packageJsonPath)) {
+        const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
+        if (packageJson.name === "@hangox/mg-cli") {
+          cachedVersion = packageJson.version || "0.0.0";
+          return cachedVersion;
+        }
+      }
+    }
+    cachedVersion = "0.0.0";
+    return cachedVersion;
+  } catch {
+    cachedVersion = "0.0.0";
+    return cachedVersion;
+  }
+}
+function isVersionMatch(version1, version2) {
+  return version1 === version2;
+}
+
 // src/server/websocket-server.ts
 var MGServer = class {
   wss = null;
@@ -616,6 +813,7 @@ var MGServer = class {
   requestHandler;
   port;
   isRunning = false;
+  startedAt = null;
   constructor(options = {}) {
     this.port = options.port || DEFAULT_PORT;
     this.logger = options.logger || createLogger();
@@ -630,14 +828,15 @@ var MGServer = class {
       throw new MGError("E016" /* SERVER_ALREADY_RUNNING */, "Server \u5DF2\u5728\u8FD0\u884C\u4E2D");
     }
     const port = await this.findAvailablePort();
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve8, reject) => {
       this.wss = new WebSocketServer({ port });
       this.wss.on("listening", () => {
         this.port = port;
         this.isRunning = true;
+        this.startedAt = /* @__PURE__ */ new Date();
         this.logger.info(`Server \u542F\u52A8\u6210\u529F\uFF0C\u76D1\u542C\u7AEF\u53E3: ${port}`);
         this.connectionManager.startHeartbeatCheck(HEARTBEAT_INTERVAL);
-        resolve7(port);
+        resolve8(port);
       });
       this.wss.on("error", (error) => {
         this.logger.error("Server \u9519\u8BEF:", error);
@@ -668,14 +867,14 @@ var MGServer = class {
    * 检查端口是否可用
    */
   isPortAvailable(port) {
-    return new Promise((resolve7) => {
+    return new Promise((resolve8) => {
       const testServer = new WebSocketServer({ port });
       testServer.on("listening", () => {
         testServer.close();
-        resolve7(true);
+        resolve8(true);
       });
       testServer.on("error", () => {
-        resolve7(false);
+        resolve8(false);
       });
     });
   }
@@ -735,7 +934,8 @@ var MGServer = class {
       success: true,
       data: {
         connectionId: managedWs.connectionId,
-        pageUrl
+        pageUrl,
+        serverVersion: getVersion()
       }
     };
     ws.send(JSON.stringify(ack));
@@ -749,6 +949,9 @@ var MGServer = class {
       case "ping" /* PING */:
         this.handlePing(ws, message);
         break;
+      case "get_server_status" /* GET_SERVER_STATUS */:
+        this.handleGetServerStatus(ws, message);
+        break;
       case "response" /* RESPONSE */:
       case "error" /* ERROR */:
         this.requestHandler.handleResponse(message);
@@ -770,6 +973,37 @@ var MGServer = class {
     };
     ws.send(JSON.stringify(pong));
   }
+  /**
+   * 处理 Server 状态查询
+   */
+  handleGetServerStatus(ws, message) {
+    const providers = this.connectionManager.getAllProviders();
+    const stats = this.connectionManager.getStats();
+    const connectedPages = providers.map((info) => ({
+      pageUrl: info.pageUrl || "",
+      connectedAt: info.connectedAt.toISOString(),
+      lastActiveAt: info.lastActiveAt.toISOString()
+    }));
+    const uptimeMs = this.startedAt ? Date.now() - this.startedAt.getTime() : 0;
+    const statusData = {
+      running: this.isRunning,
+      port: this.port,
+      pid: process.pid,
+      startedAt: this.startedAt?.toISOString() || "",
+      uptime: formatDuration(uptimeMs),
+      version: getVersion(),
+      stats,
+      connectedPages
+    };
+    const response = {
+      id: message.id || "",
+      type: "response" /* RESPONSE */,
+      success: true,
+      data: statusData
+    };
+    ws.send(JSON.stringify(response));
+    this.logger.info("\u8FD4\u56DE Server \u72B6\u6001\u4FE1\u606F");
+  }
   /**
    * 停止服务器
    */
@@ -780,12 +1014,12 @@ var MGServer = class {
     this.logger.info("\u6B63\u5728\u505C\u6B62 Server...");
     this.requestHandler.cleanupAll();
     this.connectionManager.closeAll();
-    return new Promise((resolve7) => {
+    return new Promise((resolve8) => {
       this.wss.close(() => {
         this.isRunning = false;
         this.wss = null;
         this.logger.info("Server \u5DF2\u505C\u6B62");
-        resolve7();
+        resolve8();
       });
     });
   }
@@ -860,7 +1094,8 @@ async function startServerForeground(port) {
     writeServerInfo({
       port: actualPort,
       pid: process.pid,
-      startedAt: getCurrentISOTime()
+      startedAt: getCurrentISOTime(),
+      version: getVersion()
     });
     console.log(`
 MG Server \u542F\u52A8\u6210\u529F`);
@@ -883,9 +1118,9 @@ async function startServerDaemon(port) {
     );
   }
   ensureConfigDir();
-  const currentFile = fileURLToPath(import.meta.url);
-  const currentDir = dirname3(currentFile);
-  const serverScript = join2(currentDir, "daemon-runner.js");
+  const currentFile = fileURLToPath2(import.meta.url);
+  const currentDir = dirname4(currentFile);
+  const serverScript = join3(currentDir, "daemon-runner.js");
   const args = ["--foreground"];
   if (port) {
     args.push("--port", String(port));
@@ -901,7 +1136,7 @@ async function startServerDaemon(port) {
   child.unref();
   const startTime = Date.now();
   while (Date.now() - startTime < SERVER_START_TIMEOUT) {
-    await new Promise((resolve7) => setTimeout(resolve7, 200));
+    await new Promise((resolve8) => setTimeout(resolve8, 200));
     const { running: running2, info: info2 } = isServerRunning();
     if (running2 && info2) {
       return info2;
@@ -922,7 +1157,7 @@ function stopServer() {
 }
 async function restartServer(port) {
   const { info: oldInfo } = stopServer();
-  await new Promise((resolve7) => setTimeout(resolve7, 500));
+  await new Promise((resolve8) => setTimeout(resolve8, 500));
   return startServerDaemon(port || oldInfo?.port);
 }
 function getServerStatus() {
@@ -936,98 +1171,11 @@ function getServerStatus() {
     port: info.port,
     pid: info.pid,
     startedAt: info.startedAt,
-    uptime: formatDuration(uptimeMs)
+    uptime: formatDuration(uptimeMs),
+    version: info.version
   };
 }
 
-// src/cli/commands/server.ts
-function createServerCommand() {
-  const serverCmd = new Command("server").description("Server \u7BA1\u7406\u547D\u4EE4");
-  serverCmd.command("start").description("\u542F\u52A8 MG Server").option("--port <number>", "\u6307\u5B9A\u542F\u52A8\u7AEF\u53E3", (value) => parseInt(value, 10)).option("--foreground", "\u524D\u53F0\u6A21\u5F0F\u8FD0\u884C\uFF08\u4E0D\u4F5C\u4E3A\u5B88\u62A4\u8FDB\u7A0B\uFF09", false).action(async (options) => {
-    try {
-      if (options.foreground) {
-        await startServerForeground(options.port);
-      } else {
-        const info = await startServerDaemon(options.port);
-        console.log("MG Server \u542F\u52A8\u6210\u529F");
-        console.log(`\u76D1\u542C\u7AEF\u53E3: ${info.port}`);
-        console.log(`\u8FDB\u7A0B PID: ${info.pid}`);
-        console.log(`\u8FD0\u884C\u6A21\u5F0F: \u5B88\u62A4\u8FDB\u7A0B`);
-      }
-    } catch (error) {
-      console.error(`\u9519\u8BEF: ${error.message}`);
-      process.exit(1);
-    }
-  });
-  serverCmd.command("stop").description("\u505C\u6B62 MG Server").action(() => {
-    try {
-      const { stopped, info } = stopServer();
-      if (stopped && info) {
-        console.log("MG Server \u5DF2\u505C\u6B62");
-        console.log(`PID: ${info.pid}`);
-        const uptimeMs = Date.now() - new Date(info.startedAt).getTime();
-        const seconds = Math.floor(uptimeMs / 1e3);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        let uptime = "";
-        if (hours > 0) {
-          uptime = `${hours} \u5C0F\u65F6 ${minutes % 60} \u5206\u949F`;
-        } else if (minutes > 0) {
-          uptime = `${minutes} \u5206\u949F ${seconds % 60} \u79D2`;
-        } else {
-          uptime = `${seconds} \u79D2`;
-        }
-        console.log(`\u8FD0\u884C\u65F6\u957F: ${uptime}`);
-      } else {
-        console.log("MG Server \u672A\u8FD0\u884C");
-      }
-    } catch (error) {
-      console.error(`\u9519\u8BEF: ${error.message}`);
-      process.exit(1);
-    }
-  });
-  serverCmd.command("restart").description("\u91CD\u542F MG Server").option("--port <number>", "\u91CD\u542F\u540E\u4F7F\u7528\u7684\u7AEF\u53E3", (value) => parseInt(value, 10)).action(async (options) => {
-    try {
-      const status = getServerStatus();
-      if (status.running) {
-        console.log(`\u6B63\u5728\u505C\u6B62 MG Server (PID: ${status.pid})...`);
-      }
-      const info = await restartServer(options.port);
-      console.log("MG Server \u5DF2\u91CD\u542F");
-      console.log(`\u76D1\u542C\u7AEF\u53E3: ${info.port}`);
-      console.log(`\u65B0\u8FDB\u7A0B PID: ${info.pid}`);
-    } catch (error) {
-      console.error(`\u9519\u8BEF: ${error.message}`);
-      process.exit(1);
-    }
-  });
-  serverCmd.command("status").description("\u67E5\u770B Server \u8FD0\u884C\u72B6\u6001").action(() => {
-    try {
-      const status = getServerStatus();
-      if (status.running) {
-        console.log("MG Server \u72B6\u6001: \u8FD0\u884C\u4E2D \u2713");
-        console.log(`\u76D1\u542C\u7AEF\u53E3: ${status.port}`);
-        console.log(`\u8FDB\u7A0B PID: ${status.pid}`);
-        console.log(`\u542F\u52A8\u65F6\u95F4: ${status.startedAt}`);
-        console.log(`\u8FD0\u884C\u65F6\u957F: ${status.uptime}`);
-      } else {
-        console.log("MG Server \u72B6\u6001: \u672A\u8FD0\u884C \u2717");
-        console.log("\u63D0\u793A: \u4F7F\u7528 'mg-cli server start' \u542F\u52A8 Server");
-      }
-    } catch (error) {
-      console.error(`\u9519\u8BEF: ${error.message}`);
-      process.exit(1);
-    }
-  });
-  return serverCmd;
-}
-
-// src/cli/commands/get-node-by-id.ts
-import { Command as Command2 } from "commander";
-import { writeFileSync as writeFileSync2 } from "fs";
-import { resolve as resolve2, dirname as dirname4 } from "path";
-import { mkdirSync as mkdirSync3 } from "fs";
-
 // src/cli/client.ts
 import WebSocket2 from "ws";
 var MGClient = class {
@@ -1042,10 +1190,28 @@ var MGClient = class {
   async connect() {
     const serverInfo = readServerInfo();
     if (serverInfo) {
-      try {
-        await this.tryConnect(serverInfo.port);
-        return;
-      } catch {
+      if (isProcessRunning(serverInfo.pid)) {
+        const currentVersion = getVersion();
+        if (!isVersionMatch(currentVersion, serverInfo.version)) {
+          console.log(`\u7248\u672C\u4E0D\u5339\u914D: CLI ${currentVersion} vs Server ${serverInfo.version}`);
+          console.log("\u6B63\u5728\u91CD\u542F Server \u4EE5\u5BF9\u9F50\u7248\u672C...");
+          try {
+            const newInfo = await restartServer(serverInfo.port);
+            console.log(`Server \u5DF2\u91CD\u542F\uFF0C\u7248\u672C: ${newInfo.version}`);
+            await this.waitForServer(newInfo.port);
+            return;
+          } catch (error) {
+            throw new MGError(
+              "E015" /* SERVER_START_FAILED */,
+              `\u91CD\u542F Server \u5931\u8D25: ${error instanceof Error ? error.message : error}`
+            );
+          }
+        }
+        try {
+          await this.tryConnect(serverInfo.port);
+          return;
+        } catch {
+        }
       }
     }
     for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port++) {
@@ -1075,7 +1241,7 @@ var MGClient = class {
    * 尝试连接指定端口
    */
   tryConnect(port) {
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve8, reject) => {
       const ws = new WebSocket2(`ws://localhost:${port}`);
       const timer = setTimeout(() => {
         ws.close();
@@ -1085,7 +1251,7 @@ var MGClient = class {
         clearTimeout(timer);
         this.ws = ws;
         this.register();
-        resolve7();
+        resolve8();
       });
       ws.on("error", (error) => {
         clearTimeout(timer);
@@ -1138,7 +1304,7 @@ var MGClient = class {
       pageUrl,
       timestamp: Date.now()
     };
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve8, reject) => {
       const timer = setTimeout(() => {
         reject(new MGError("E012" /* REQUEST_TIMEOUT */, ErrorMessages["E012" /* REQUEST_TIMEOUT */]));
       }, REQUEST_TIMEOUT);
@@ -1149,7 +1315,7 @@ var MGClient = class {
             clearTimeout(timer);
             this.ws?.off("message", messageHandler);
             if (response.success) {
-              resolve7(response.data);
+              resolve8(response.data);
             } else {
               const error = response.error;
               reject(
@@ -1209,9 +1375,132 @@ var MGClient = class {
   }
 };
 
+// src/cli/commands/server.ts
+function createServerCommand() {
+  const serverCmd = new Command("server").description("Server \u7BA1\u7406\u547D\u4EE4");
+  serverCmd.command("start").description("\u542F\u52A8 MG Server").option("--port <number>", "\u6307\u5B9A\u542F\u52A8\u7AEF\u53E3", (value) => parseInt(value, 10)).option("--foreground", "\u524D\u53F0\u6A21\u5F0F\u8FD0\u884C\uFF08\u4E0D\u4F5C\u4E3A\u5B88\u62A4\u8FDB\u7A0B\uFF09", false).action(async (options) => {
+    try {
+      if (options.foreground) {
+        await startServerForeground(options.port);
+      } else {
+        const info = await startServerDaemon(options.port);
+        console.log("MG Server \u542F\u52A8\u6210\u529F");
+        console.log(`\u7248\u672C: ${info.version}`);
+        console.log(`\u76D1\u542C\u7AEF\u53E3: ${info.port}`);
+        console.log(`\u8FDB\u7A0B PID: ${info.pid}`);
+        console.log(`\u8FD0\u884C\u6A21\u5F0F: \u5B88\u62A4\u8FDB\u7A0B`);
+      }
+    } catch (error) {
+      console.error(`\u9519\u8BEF: ${error.message}`);
+      process.exit(1);
+    }
+  });
+  serverCmd.command("stop").description("\u505C\u6B62 MG Server").action(() => {
+    try {
+      const { stopped, info } = stopServer();
+      if (stopped && info) {
+        console.log("MG Server \u5DF2\u505C\u6B62");
+        console.log(`PID: ${info.pid}`);
+        const uptimeMs = Date.now() - new Date(info.startedAt).getTime();
+        const seconds = Math.floor(uptimeMs / 1e3);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        let uptime = "";
+        if (hours > 0) {
+          uptime = `${hours} \u5C0F\u65F6 ${minutes % 60} \u5206\u949F`;
+        } else if (minutes > 0) {
+          uptime = `${minutes} \u5206\u949F ${seconds % 60} \u79D2`;
+        } else {
+          uptime = `${seconds} \u79D2`;
+        }
+        console.log(`\u8FD0\u884C\u65F6\u957F: ${uptime}`);
+      } else {
+        console.log("MG Server \u672A\u8FD0\u884C");
+      }
+    } catch (error) {
+      console.error(`\u9519\u8BEF: ${error.message}`);
+      process.exit(1);
+    }
+  });
+  serverCmd.command("restart").description("\u91CD\u542F MG Server").option("--port <number>", "\u91CD\u542F\u540E\u4F7F\u7528\u7684\u7AEF\u53E3", (value) => parseInt(value, 10)).action(async (options) => {
+    try {
+      const status = getServerStatus();
+      if (status.running) {
+        console.log(`\u6B63\u5728\u505C\u6B62 MG Server (PID: ${status.pid})...`);
+      }
+      const info = await restartServer(options.port);
+      console.log("MG Server \u5DF2\u91CD\u542F");
+      console.log(`\u7248\u672C: ${info.version}`);
+      console.log(`\u76D1\u542C\u7AEF\u53E3: ${info.port}`);
+      console.log(`\u65B0\u8FDB\u7A0B PID: ${info.pid}`);
+    } catch (error) {
+      console.error(`\u9519\u8BEF: ${error.message}`);
+      process.exit(1);
+    }
+  });
+  serverCmd.command("status").description("\u67E5\u770B Server \u8FD0\u884C\u72B6\u6001").action(async () => {
+    try {
+      const basicStatus = getServerStatus();
+      if (!basicStatus.running) {
+        console.log("MG Server \u72B6\u6001: \u672A\u8FD0\u884C \u2717");
+        console.log("\u63D0\u793A: \u4F7F\u7528 'mg-cli server start' \u542F\u52A8 Server");
+        return;
+      }
+      try {
+        const client = new MGClient({ noAutoStart: true });
+        await client.connect();
+        const status = await client.request(
+          "get_server_status" /* GET_SERVER_STATUS */
+        );
+        client.close();
+        console.log("MG Server \u72B6\u6001: \u8FD0\u884C\u4E2D \u2713");
+        console.log(`\u7248\u672C: ${status.version}`);
+        console.log(`\u76D1\u542C\u7AEF\u53E3: ${status.port}`);
+        console.log(`\u8FDB\u7A0B PID: ${status.pid}`);
+        console.log(`\u542F\u52A8\u65F6\u95F4: ${status.startedAt}`);
+        console.log(`\u8FD0\u884C\u65F6\u957F: ${status.uptime}`);
+        console.log(``);
+        console.log(`\u8FDE\u63A5\u7EDF\u8BA1:`);
+        console.log(`  Provider \u6570\u91CF: ${status.stats.providers}`);
+        console.log(`  Consumer \u6570\u91CF: ${status.stats.consumers}`);
+        if (status.connectedPages.length > 0) {
+          console.log(``);
+          console.log(`\u5DF2\u8FDE\u63A5\u9875\u9762 (${status.connectedPages.length}):`);
+          for (const page of status.connectedPages) {
+            console.log(`  - ${page.pageUrl}`);
+          }
+        } else {
+          console.log(``);
+          console.log(`\u5DF2\u8FDE\u63A5\u9875\u9762: \u65E0`);
+          console.log(`\u63D0\u793A: \u8BF7\u5728 Chrome \u4E2D\u6253\u5F00 MasterGo \u9875\u9762\u5E76\u786E\u4FDD\u63D2\u4EF6\u5DF2\u542F\u7528`);
+        }
+      } catch {
+        console.log("MG Server \u72B6\u6001: \u8FD0\u884C\u4E2D \u2713");
+        if (basicStatus.version) {
+          console.log(`\u7248\u672C: ${basicStatus.version}`);
+        }
+        console.log(`\u76D1\u542C\u7AEF\u53E3: ${basicStatus.port}`);
+        console.log(`\u8FDB\u7A0B PID: ${basicStatus.pid}`);
+        console.log(`\u542F\u52A8\u65F6\u95F4: ${basicStatus.startedAt}`);
+        console.log(`\u8FD0\u884C\u65F6\u957F: ${basicStatus.uptime}`);
+        console.log(``);
+        console.log(`\u6CE8\u610F: \u65E0\u6CD5\u83B7\u53D6\u8BE6\u7EC6\u8FDE\u63A5\u4FE1\u606F`);
+      }
+    } catch (error) {
+      console.error(`\u9519\u8BEF: ${error.message}`);
+      process.exit(1);
+    }
+  });
+  return serverCmd;
+}
+
 // src/cli/commands/get-node-by-id.ts
+import { Command as Command2 } from "commander";
+import { writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve2, dirname as dirname5 } from "path";
+import { mkdirSync as mkdirSync3 } from "fs";
 function createGetNodeByIdCommand() {
-  return new Command2("get_node_by_id").description("\u6839\u636E\u8282\u70B9 ID \u83B7\u53D6\u8282\u70B9\u8BE6\u7EC6\u4FE1\u606F\u3002\u6570\u636E\u4FDD\u5B58\u5230\u6307\u5B9A JSON \u6587\u4EF6\uFF0C\u8FD4\u56DE\u6587\u4EF6\u8DEF\u5F84\u548C\u5927\u5C0F\u4FE1\u606F\u3002\u5982\u9700\u901A\u8FC7\u94FE\u63A5\u83B7\u53D6\uFF0C\u8BF7\u4F7F\u7528 get_node_by_link \u547D\u4EE4").requiredOption("--nodeId <id>", "\u8282\u70B9 ID\uFF0C\u683C\u5F0F\u5982 123:456\u3002\u53EF\u4ECE MasterGo \u6D6E\u7A97\u94FE\u63A5\u4E2D\u83B7\u53D6").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84\u3002\u652F\u6301\u7EDD\u5BF9\u8DEF\u5F84\u6216\u76F8\u5BF9\u8DEF\u5F84").option("--domain <domain>", "MasterGo \u57DF\u540D\uFF0C\u9ED8\u8BA4 mastergo.netease.com\u3002\u4E0E --fileId \u914D\u5408\u4F7F\u7528", "mastergo.netease.com").option("--fileId <id>", "\u6587\u4EF6 ID\uFF08\u7EAF\u6570\u5B57\uFF09\uFF0C\u4E0E --domain \u914D\u5408\u6307\u5B9A\u76EE\u6807\u9875\u9762").option("--maxDepth <number>", "\u904D\u5386\u6DF1\u5EA6\uFF0C\u9ED8\u8BA4 1\u3002\u589E\u52A0\u6DF1\u5EA6\u4F1A\u663E\u8457\u589E\u52A0\u6570\u636E\u91CF", "1").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9\uFF08visible: false\uFF09\uFF0C\u9ED8\u8BA4\u4E0D\u5305\u542B", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
+  return new Command2("get_node_by_id").description("\u6839\u636E\u8282\u70B9 ID \u83B7\u53D6\u8282\u70B9\u8BE6\u7EC6\u4FE1\u606F\u3002\u6570\u636E\u4FDD\u5B58\u5230\u6307\u5B9A JSON \u6587\u4EF6\uFF0C\u8FD4\u56DE\u6587\u4EF6\u8DEF\u5F84\u548C\u5927\u5C0F\u4FE1\u606F\u3002\u5982\u9700\u901A\u8FC7\u94FE\u63A5\u83B7\u53D6\uFF0C\u8BF7\u4F7F\u7528 get_node_by_link \u547D\u4EE4").requiredOption("--nodeId <id>", "\u8282\u70B9 ID\uFF0C\u683C\u5F0F\u5982 123:456\u3002\u53EF\u4ECE MasterGo \u6D6E\u7A97\u94FE\u63A5\u4E2D\u83B7\u53D6").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84\u3002\u652F\u6301\u7EDD\u5BF9\u8DEF\u5F84\u6216\u76F8\u5BF9\u8DEF\u5F84").option("--domain <domain>", "MasterGo \u57DF\u540D\uFF0C\u9ED8\u8BA4 mastergo.netease.com\u3002\u4E0E --fileId \u914D\u5408\u4F7F\u7528", "mastergo.netease.com").option("--fileId <id>", "\u6587\u4EF6 ID\uFF08\u7EAF\u6570\u5B57\uFF09\uFF0C\u4E0E --domain \u914D\u5408\u6307\u5B9A\u76EE\u6807\u9875\u9762").option("--maxDepth <number>", "\u904D\u5386\u6DF1\u5EA6\uFF0C\u9ED8\u8BA4 1\u3002\u589E\u52A0\u6DF1\u5EA6\u4F1A\u663E\u8457\u589E\u52A0\u6570\u636E\u91CF", "1").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9\uFF08visible: false\uFF09\uFF0C\u9ED8\u8BA4\u4E0D\u5305\u542B", false).option("--raw", "\u4FDD\u7559\u539F\u59CB\u6570\u636E\uFF0C\u4E0D\u7CBE\u7B80\u9ED8\u8BA4\u503C\u5B57\u6BB5", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
     await handleGetNodeById(options);
   });
 }
@@ -1233,10 +1522,11 @@ async function handleGetNodeById(options) {
       includeInvisible: options.includeInvisible || false
     };
     const data = await client.requestWithRetry("get_node_by_id" /* GET_NODE_BY_ID */, params, pageUrl);
+    const outputData = options.raw ? data : trimNodeDefaults(data);
     const outputPath = resolve2(options.output);
-    const outputDir = dirname4(outputPath);
+    const outputDir = dirname5(outputPath);
     mkdirSync3(outputDir, { recursive: true });
-    const jsonContent = JSON.stringify(data, null, 2);
+    const jsonContent = JSON.stringify(outputData, null, 2);
     writeFileSync2(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
@@ -1244,6 +1534,9 @@ async function handleGetNodeById(options) {
     console.log(`\u8282\u70B9 ID: ${options.nodeId}`);
     console.log(`\u6570\u636E\u5927\u5C0F: ${size.toLocaleString()} \u5B57\u7B26 (\u7EA6 ${sizeKB} KB)`);
     console.log(`\u8282\u70B9\u6DF1\u5EA6: ${params.maxDepth}`);
+    if (!options.raw) {
+      console.log(`\u6570\u636E\u6A21\u5F0F: \u7CBE\u7B80\u6A21\u5F0F (\u4F7F\u7528 --raw \u83B7\u53D6\u5B8C\u6574\u6570\u636E)`);
+    }
   } catch (error) {
     console.error(`\u9519\u8BEF: ${error instanceof Error ? error.message : error}`);
     process.exit(1);
@@ -1255,10 +1548,10 @@ async function handleGetNodeById(options) {
 // src/cli/commands/get-node-by-link.ts
 import { Command as Command3 } from "commander";
 import { writeFileSync as writeFileSync3 } from "fs";
-import { resolve as resolve3, dirname as dirname5 } from "path";
+import { resolve as resolve3, dirname as dirname6 } from "path";
 import { mkdirSync as mkdirSync4 } from "fs";
 function createGetNodeByLinkCommand() {
-  return new Command3("get_node_by_link").description("\u89E3\u6790 mgp:// \u534F\u8BAE\u94FE\u63A5\u5E76\u83B7\u53D6\u8282\u70B9\u4FE1\u606F").requiredOption("--link <url>", "mgp:// \u534F\u8BAE\u94FE\u63A5").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84").option("--maxDepth <number>", "\u904D\u5386\u6DF1\u5EA6", "1").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
+  return new Command3("get_node_by_link").description("\u89E3\u6790 mgp:// \u534F\u8BAE\u94FE\u63A5\u5E76\u83B7\u53D6\u8282\u70B9\u4FE1\u606F").requiredOption("--link <url>", "mgp:// \u534F\u8BAE\u94FE\u63A5").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84").option("--maxDepth <number>", "\u904D\u5386\u6DF1\u5EA6", "1").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9", false).option("--raw", "\u4FDD\u7559\u539F\u59CB\u6570\u636E\uFF0C\u4E0D\u7CBE\u7B80\u9ED8\u8BA4\u503C\u5B57\u6BB5", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
     await handleGetNodeByLink(options);
   });
 }
@@ -1287,10 +1580,11 @@ async function handleGetNodeByLink(options) {
       params,
       pageUrl
     );
+    const outputData = options.raw ? data : trimNodeDefaults(data);
     const outputPath = resolve3(options.output);
-    const outputDir = dirname5(outputPath);
+    const outputDir = dirname6(outputPath);
     mkdirSync4(outputDir, { recursive: true });
-    const jsonContent = JSON.stringify(data, null, 2);
+    const jsonContent = JSON.stringify(outputData, null, 2);
     writeFileSync3(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
@@ -1300,6 +1594,9 @@ async function handleGetNodeByLink(options) {
     console.log(`\u8282\u70B9 ID: ${nodeId}`);
     console.log(`\u6570\u636E\u5927\u5C0F: ${size.toLocaleString()} \u5B57\u7B26 (\u7EA6 ${sizeKB} KB)`);
     console.log(`\u8282\u70B9\u6DF1\u5EA6: ${params.maxDepth}`);
+    if (!options.raw) {
+      console.log(`\u6570\u636E\u6A21\u5F0F: \u7CBE\u7B80\u6A21\u5F0F (\u4F7F\u7528 --raw \u83B7\u53D6\u5B8C\u6574\u6570\u636E)`);
+    }
   } catch (error) {
     if (error instanceof MGError) {
       console.error(`\u9519\u8BEF [${error.code}]: ${error.message}`);
@@ -1315,10 +1612,10 @@ async function handleGetNodeByLink(options) {
 // src/cli/commands/get-all-nodes.ts
 import { Command as Command4 } from "commander";
 import { writeFileSync as writeFileSync4 } from "fs";
-import { resolve as resolve4, dirname as dirname6 } from "path";
+import { resolve as resolve4, dirname as dirname7 } from "path";
 import { mkdirSync as mkdirSync5 } from "fs";
 function createGetAllNodesCommand() {
-  return new Command4("get_all_nodes").description("\u83B7\u53D6\u5F53\u524D\u9875\u9762\u7684\u6240\u6709\u8282\u70B9\u6811\u3002\u8B66\u544A\uFF1A\u6DF1\u5EA6\u6BCF\u589E\u52A0 1\uFF0C\u6570\u636E\u91CF\u53EF\u80FD\u5448\u6307\u6570\u7EA7\u589E\u957F\u3002\u5EFA\u8BAE\u4ECE maxDepth=1 \u5F00\u59CB").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84\u3002\u652F\u6301\u7EDD\u5BF9\u8DEF\u5F84\u6216\u76F8\u5BF9\u8DEF\u5F84").option("--maxDepth <number>", "\u6700\u5927\u6DF1\u5EA6\uFF0C\u9ED8\u8BA4 1\u3002\u6DF1\u5EA6 2 \u53EF\u80FD\u4EA7\u751F 100KB-500KB\uFF0C\u6DF1\u5EA6 3 \u53EF\u80FD\u8D85\u8FC7 1MB", "1").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9\uFF08visible: false\uFF09\uFF0C\u9ED8\u8BA4\u4E0D\u5305\u542B", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
+  return new Command4("get_all_nodes").description("\u83B7\u53D6\u5F53\u524D\u9875\u9762\u7684\u6240\u6709\u8282\u70B9\u6811\u3002\u8B66\u544A\uFF1A\u6DF1\u5EA6\u6BCF\u589E\u52A0 1\uFF0C\u6570\u636E\u91CF\u53EF\u80FD\u5448\u6307\u6570\u7EA7\u589E\u957F\u3002\u5EFA\u8BAE\u4ECE maxDepth=1 \u5F00\u59CB").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84\u3002\u652F\u6301\u7EDD\u5BF9\u8DEF\u5F84\u6216\u76F8\u5BF9\u8DEF\u5F84").option("--maxDepth <number>", "\u6700\u5927\u6DF1\u5EA6\uFF0C\u9ED8\u8BA4 1\u3002\u6DF1\u5EA6 2 \u53EF\u80FD\u4EA7\u751F 100KB-500KB\uFF0C\u6DF1\u5EA6 3 \u53EF\u80FD\u8D85\u8FC7 1MB", "1").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9\uFF08visible: false\uFF09\uFF0C\u9ED8\u8BA4\u4E0D\u5305\u542B", false).option("--raw", "\u4FDD\u7559\u539F\u59CB\u6570\u636E\uFF0C\u4E0D\u7CBE\u7B80\u9ED8\u8BA4\u503C\u5B57\u6BB5", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
     await handleGetAllNodes(options);
   });
 }
@@ -1334,10 +1631,11 @@ async function handleGetAllNodes(options) {
       includeInvisible: options.includeInvisible || false
     };
     const data = await client.requestWithRetry("get_all_nodes" /* GET_ALL_NODES */, params);
+    const outputData = options.raw ? data : Array.isArray(data) ? data.map((node) => trimNodeDefaults(node)) : trimNodeDefaults(data);
     const outputPath = resolve4(options.output);
-    const outputDir = dirname6(outputPath);
+    const outputDir = dirname7(outputPath);
     mkdirSync5(outputDir, { recursive: true });
-    const jsonContent = JSON.stringify(data, null, 2);
+    const jsonContent = JSON.stringify(outputData, null, 2);
     writeFileSync4(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
@@ -1346,6 +1644,9 @@ async function handleGetAllNodes(options) {
     console.log(`\u8282\u70B9\u6570\u91CF: ${nodeCount}`);
     console.log(`\u6570\u636E\u5927\u5C0F: ${size.toLocaleString()} \u5B57\u7B26 (\u7EA6 ${sizeKB} KB)`);
     console.log(`\u8282\u70B9\u6DF1\u5EA6: ${params.maxDepth}`);
+    if (!options.raw) {
+      console.log(`\u6570\u636E\u6A21\u5F0F: \u7CBE\u7B80\u6A21\u5F0F (\u4F7F\u7528 --raw \u83B7\u53D6\u5B8C\u6574\u6570\u636E)`);
+    }
   } catch (error) {
     console.error(`\u9519\u8BEF: ${error instanceof Error ? error.message : error}`);
     process.exit(1);
@@ -1357,11 +1658,11 @@ async function handleGetAllNodes(options) {
 // src/cli/commands/export-image.ts
 import { Command as Command5 } from "commander";
 import { writeFileSync as writeFileSync5 } from "fs";
-import { resolve as resolve5, dirname as dirname7, extname } from "path";
+import { resolve as resolve5, dirname as dirname8, extname } from "path";
 import { mkdirSync as mkdirSync6 } from "fs";
 import { tmpdir } from "os";
 function createExportImageCommand() {
-  return new Command5("export_image").description("\u5BFC\u51FA MasterGo \u8282\u70B9\u4E3A\u56FE\u7247\u6587\u4EF6\u3002\u5F3A\u70C8\u5EFA\u8BAE\u6307\u5B9A --output\uFF0C\u5426\u5219\u4FDD\u5B58\u5230\u4E34\u65F6\u76EE\u5F55\u53EF\u80FD\u88AB\u7CFB\u7EDF\u6E05\u7406").option("--output <path>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\u3002\u5F3A\u70C8\u5EFA\u8BAE\u6307\u5B9A\uFF0C\u5426\u5219\u4FDD\u5B58\u5230\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55\u53EF\u80FD\u88AB\u6E05\u7406").option("--link <mgp-link>", "mgp:// \u534F\u8BAE\u94FE\u63A5\u3002\u4E0D\u6307\u5B9A\u5219\u5BFC\u51FA\u5F53\u524D\u9009\u4E2D\u8282\u70B9").option("--format <type>", "\u5BFC\u51FA\u683C\u5F0F\uFF1APNG\uFF08\u65E0\u635F\u900F\u660E\uFF09\u3001JPG\uFF08\u6709\u635F\uFF09\u3001SVG\uFF08\u77E2\u91CF\uFF09\u3001PDF\u3001WEBP", "PNG").option("--scale <number>", "\u7F29\u653E\u500D\u7387\uFF08\u5982 1\u30012\u30013\uFF09\u3002\u4E0E width/height \u4E92\u65A5").option("--width <number>", "\u56FA\u5B9A\u5BBD\u5EA6\uFF08\u50CF\u7D20\uFF09\u3002\u4E0E scale/height \u4E92\u65A5").option("--height <number>", "\u56FA\u5B9A\u9AD8\u5EA6\uFF08\u50CF\u7D20\uFF09\u3002\u4E0E scale/width \u4E92\u65A5").option("--useAbsoluteBounds", "\u4F7F\u7528\u5B8C\u6574\u5C3A\u5BF8\u3002true: \u5305\u542B\u88AB\u88C1\u526A\u90E8\u5206\uFF0Cfalse: \u53EA\u5BFC\u51FA\u53EF\u89C1\u533A\u57DF", false).option("--no-use-render-bounds", "\u4E0D\u5305\u542B\u7279\u6548\u548C\u5916\u63CF\u8FB9\u3002\u9ED8\u8BA4\u5305\u542B\u9634\u5F71\u3001\u5916\u63CF\u8FB9\u7B49").option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
+  return new Command5("export_image").description("\u5BFC\u51FA MasterGo \u8282\u70B9\u4E3A\u56FE\u7247\u6587\u4EF6\u3002\u5F3A\u70C8\u5EFA\u8BAE\u6307\u5B9A --output\uFF0C\u5426\u5219\u4FDD\u5B58\u5230\u4E34\u65F6\u76EE\u5F55\u53EF\u80FD\u88AB\u7CFB\u7EDF\u6E05\u7406").option("--output <path>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\u3002\u5F3A\u70C8\u5EFA\u8BAE\u6307\u5B9A\uFF0C\u5426\u5219\u4FDD\u5B58\u5230\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55\u53EF\u80FD\u88AB\u6E05\u7406").option("--link <mgp-link>", "mgp:// \u534F\u8BAE\u94FE\u63A5\u3002\u4E0E --nodeId/--domain/--fileId \u4E8C\u9009\u4E00").option("--nodeId <id>", "\u8282\u70B9 ID\uFF0C\u683C\u5F0F\u5982 123:456\u3002\u4E0E --domain/--fileId \u914D\u5408\u4F7F\u7528").option("--domain <domain>", "MasterGo \u57DF\u540D\uFF0C\u9ED8\u8BA4 mastergo.netease.com", "mastergo.netease.com").option("--fileId <id>", "\u6587\u4EF6 ID\uFF08\u7EAF\u6570\u5B57\uFF09\uFF0C\u4E0E --domain \u914D\u5408\u6307\u5B9A\u76EE\u6807\u9875\u9762").option("--format <type>", "\u5BFC\u51FA\u683C\u5F0F\uFF1APNG\uFF08\u65E0\u635F\u900F\u660E\uFF09\u3001JPG\uFF08\u6709\u635F\uFF09\u3001SVG\uFF08\u77E2\u91CF\uFF09\u3001PDF\u3001WEBP", "PNG").option("--scale <number>", "\u7F29\u653E\u500D\u7387\uFF08\u5982 1\u30012\u30013\uFF09\u3002\u4E0E width/height \u4E92\u65A5").option("--width <number>", "\u56FA\u5B9A\u5BBD\u5EA6\uFF08\u50CF\u7D20\uFF09\u3002\u4E0E scale/height \u4E92\u65A5").option("--height <number>", "\u56FA\u5B9A\u9AD8\u5EA6\uFF08\u50CF\u7D20\uFF09\u3002\u4E0E scale/width \u4E92\u65A5").option("--useAbsoluteBounds", "\u4F7F\u7528\u5B8C\u6574\u5C3A\u5BF8\u3002true: \u5305\u542B\u88AB\u88C1\u526A\u90E8\u5206\uFF0Cfalse: \u53EA\u5BFC\u51FA\u53EF\u89C1\u533A\u57DF", false).option("--no-use-render-bounds", "\u4E0D\u5305\u542B\u7279\u6548\u548C\u5916\u63CF\u8FB9\u3002\u9ED8\u8BA4\u5305\u542B\u9634\u5F71\u3001\u5916\u63CF\u8FB9\u7B49").option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
     await handleExportImage(options);
   });
 }
@@ -1378,16 +1679,30 @@ async function handleExportImage(options) {
     console.error("\u9519\u8BEF: scale\u3001width\u3001height \u4E09\u8005\u4E92\u65A5\uFF0C\u53EA\u80FD\u6307\u5B9A\u5176\u4E2D\u4E00\u4E2A");
     process.exit(1);
   }
+  if (options.link && (options.nodeId || options.fileId)) {
+    console.error(`\u9519\u8BEF [${"E011" /* INVALID_PARAMS */}]: --link \u548C --nodeId/--fileId \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528`);
+    process.exit(1);
+  }
   let pageUrl;
   let nodeId;
   if (options.link) {
     const linkInfo = parseMgpLink(options.link);
     if (!linkInfo) {
-      console.error(`\u9519\u8BEF: \u65E0\u6548\u7684 mgp:// \u94FE\u63A5\u683C\u5F0F: ${options.link}`);
+      console.error(`\u9519\u8BEF [${"E010" /* INVALID_LINK */}]: \u65E0\u6548\u7684 mgp:// \u94FE\u63A5\u683C\u5F0F`);
+      console.error(`\u63D0\u4F9B\u7684\u94FE\u63A5: ${options.link}`);
+      console.error(`\u671F\u671B\u683C\u5F0F: mgp://[mastergo_page_url]?nodeId=xxx`);
       process.exit(1);
     }
     pageUrl = linkInfo.pageUrl;
     nodeId = linkInfo.nodeId;
+  } else {
+    if (options.nodeId) {
+      nodeId = options.nodeId;
+    }
+    if (options.fileId) {
+      const domain = options.domain || "mastergo.netease.com";
+      pageUrl = `${domain}/file/${options.fileId}`;
+    }
   }
   const client = new MGClient({
     noAutoStart: options.noAutoStart,
@@ -1429,7 +1744,7 @@ async function handleExportImage(options) {
       outputPath = resolve5(tmpdir(), filename);
       console.log("\u8B66\u544A: \u672A\u6307\u5B9A --output\uFF0C\u6587\u4EF6\u5C06\u4FDD\u5B58\u5230\u4E34\u65F6\u76EE\u5F55\uFF0C\u53EF\u80FD\u4F1A\u88AB\u7CFB\u7EDF\u6E05\u7406");
     }
-    const outputDir = dirname7(outputPath);
+    const outputDir = dirname8(outputPath);
     mkdirSync6(outputDir, { recursive: true });
     const buffer = Buffer.from(response.data, "base64");
     writeFileSync5(outputPath, buffer);
@@ -1470,18 +1785,36 @@ function getExtension(format) {
 // src/cli/commands/execute-code.ts
 import { Command as Command6 } from "commander";
 function createExecuteCodeCommand() {
-  return new Command6("execute_code").description("\u5728 MasterGo \u9875\u9762\u6267\u884C\u81EA\u5B9A\u4E49 JavaScript \u4EE3\u7801\u3002\u901A\u8FC7 mg \u53D8\u91CF\u8BBF\u95EE MasterGo API\uFF0C\u7ED3\u679C\u4F1A\u88AB JSON \u5E8F\u5217\u5316\u8FD4\u56DE").argument("<code>", "\u8981\u6267\u884C\u7684\u4EE3\u7801\u3002\u53EF\u4F7F\u7528 mg \u53D8\u91CF\uFF0C\u5982 mg.currentPage.name\u3001mg.currentPage.selection").option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (code, options) => {
+  return new Command6("execute_code").description("\u5728 MasterGo \u9875\u9762\u6267\u884C\u81EA\u5B9A\u4E49 JavaScript \u4EE3\u7801\u3002\u901A\u8FC7 mg \u53D8\u91CF\u8BBF\u95EE MasterGo API\uFF0C\u7ED3\u679C\u4F1A\u88AB JSON \u5E8F\u5217\u5316\u8FD4\u56DE").argument("<code>", "\u8981\u6267\u884C\u7684\u4EE3\u7801\u3002\u53EF\u4F7F\u7528 mg \u53D8\u91CF\uFF0C\u5982 mg.currentPage.name\u3001mg.currentPage.selection").option("--link <url>", "mgp:// \u534F\u8BAE\u94FE\u63A5\uFF0C\u7528\u4E8E\u6307\u5B9A\u76EE\u6807\u9875\u9762\u3002\u4E0E --domain/--fileId \u4E8C\u9009\u4E00").option("--domain <domain>", "MasterGo \u57DF\u540D\uFF0C\u9ED8\u8BA4 mastergo.netease.com", "mastergo.netease.com").option("--fileId <id>", "\u6587\u4EF6 ID\uFF08\u7EAF\u6570\u5B57\uFF09\uFF0C\u4E0E --domain \u914D\u5408\u6307\u5B9A\u76EE\u6807\u9875\u9762").option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (code, options) => {
     await handleExecuteCode(code, options);
   });
 }
 async function handleExecuteCode(code, options) {
+  if (options.link && options.fileId) {
+    console.error(`\u9519\u8BEF [${"E011" /* INVALID_PARAMS */}]: --link \u548C --fileId \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528`);
+    process.exit(1);
+  }
+  let pageUrl;
+  if (options.link) {
+    const parsed = parseMgpLink(options.link);
+    if (!parsed) {
+      console.error(`\u9519\u8BEF [${"E010" /* INVALID_LINK */}]: \u65E0\u6548\u7684 mgp:// \u94FE\u63A5\u683C\u5F0F`);
+      console.error(`\u63D0\u4F9B\u7684\u94FE\u63A5: ${options.link}`);
+      console.error(`\u671F\u671B\u683C\u5F0F: mgp://[mastergo_page_url]?nodeId=xxx`);
+      process.exit(1);
+    }
+    pageUrl = parsed.pageUrl;
+  } else if (options.fileId) {
+    const domain = options.domain || "mastergo.netease.com";
+    pageUrl = `${domain}/file/${options.fileId}`;
+  }
   const client = new MGClient({
     noAutoStart: options.noAutoStart,
     noRetry: options.noRetry
   });
   try {
     await client.connect();
-    const result = await client.requestWithRetry("execute_code" /* EXECUTE_CODE */, { code });
+    const result = await client.requestWithRetry("execute_code" /* EXECUTE_CODE */, { code }, pageUrl);
     if (result === null || result === void 0) {
       console.log("\u6267\u884C\u5B8C\u6210\uFF08\u65E0\u8FD4\u56DE\u503C\uFF09");
     } else if (typeof result === "object") {
@@ -1500,7 +1833,7 @@ async function handleExecuteCode(code, options) {
 // src/cli/commands/get-all-pages.ts
 import { Command as Command7 } from "commander";
 import { writeFileSync as writeFileSync6 } from "fs";
-import { resolve as resolve6, dirname as dirname8 } from "path";
+import { resolve as resolve6, dirname as dirname9 } from "path";
 import { mkdirSync as mkdirSync7 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
 function createGetAllPagesCommand() {
@@ -1548,7 +1881,7 @@ async function handleGetAllPages(options) {
       const filename = `pages_${fileId || "current"}_${Date.now()}.json`;
       outputPath = resolve6(tmpdir2(), filename);
     }
-    const outputDir = dirname8(outputPath);
+    const outputDir = dirname9(outputPath);
     mkdirSync7(outputDir, { recursive: true });
     const jsonContent = JSON.stringify(data, null, 2);
     writeFileSync6(outputPath, jsonContent, "utf-8");
@@ -1566,8 +1899,91 @@ async function handleGetAllPages(options) {
   }
 }
 
+// src/cli/commands/get-node-for-space.ts
+import { Command as Command8 } from "commander";
+import { writeFileSync as writeFileSync7 } from "fs";
+import { resolve as resolve7, dirname as dirname10 } from "path";
+import { mkdirSync as mkdirSync8 } from "fs";
+function createGetNodeForSpaceCommand() {
+  return new Command8("get_node_for_space").description("\u83B7\u53D6\u8282\u70B9\u7684\u7A7A\u95F4\u4F4D\u7F6E\u4FE1\u606F\uFF08id\u3001name\u3001x\u3001y\u3001width\u3001height\uFF09\uFF0C\u7528\u4E8E AI \u7406\u89E3\u5143\u7D20\u5E03\u5C40\u3002\u9ED8\u8BA4\u83B7\u53D6\u6700\u6DF1\u5C42\u7EA7").option("--nodeId <id>", "\u8282\u70B9 ID\uFF0C\u683C\u5F0F\u5982 123:456\u3002\u4E0E --link \u4E8C\u9009\u4E00").option("--link <url>", "mgp:// \u534F\u8BAE\u94FE\u63A5\u3002\u4E0E --nodeId \u4E8C\u9009\u4E00").requiredOption("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84").option("--domain <domain>", "MasterGo \u57DF\u540D\uFF0C\u9ED8\u8BA4 mastergo.netease.com\u3002\u4E0E --nodeId \u914D\u5408\u4F7F\u7528", "mastergo.netease.com").option("--fileId <id>", "\u6587\u4EF6 ID\uFF08\u7EAF\u6570\u5B57\uFF09\uFF0C\u4E0E --domain \u548C --nodeId \u914D\u5408\u4F7F\u7528").option("--maxDepth <number>", "\u904D\u5386\u6DF1\u5EA6\uFF0C\u9ED8\u8BA4 99\uFF08\u83B7\u53D6\u6700\u6DF1\u5C42\u7EA7\uFF09", "99").option("--includeInvisible", "\u5305\u542B\u4E0D\u53EF\u89C1\u8282\u70B9", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
+    await handleGetNodeForSpace(options);
+  });
+}
+async function handleGetNodeForSpace(options) {
+  if (!options.nodeId && !options.link) {
+    console.error(`\u9519\u8BEF [${"E011" /* INVALID_PARAMS */}]: \u5FC5\u987B\u63D0\u4F9B --nodeId \u6216 --link \u53C2\u6570`);
+    process.exit(1);
+  }
+  if (options.nodeId && options.link) {
+    console.error(`\u9519\u8BEF [${"E011" /* INVALID_PARAMS */}]: --nodeId \u548C --link \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528`);
+    process.exit(1);
+  }
+  let pageUrl;
+  let nodeId;
+  if (options.link) {
+    const parsed = parseMgpLink(options.link);
+    if (!parsed) {
+      console.error(`\u9519\u8BEF [${"E010" /* INVALID_LINK */}]: \u65E0\u6548\u7684 mgp:// \u94FE\u63A5\u683C\u5F0F`);
+      console.error(`\u63D0\u4F9B\u7684\u94FE\u63A5: ${options.link}`);
+      console.error(`\u671F\u671B\u683C\u5F0F: mgp://[mastergo_page_url]?nodeId=xxx`);
+      process.exit(1);
+    }
+    pageUrl = parsed.pageUrl;
+    nodeId = parsed.nodeId;
+  } else {
+    nodeId = options.nodeId;
+    if (options.fileId) {
+      const domain = options.domain || "mastergo.netease.com";
+      pageUrl = `${domain}/file/${options.fileId}`;
+    }
+  }
+  const client = new MGClient({
+    noAutoStart: options.noAutoStart,
+    noRetry: options.noRetry
+  });
+  try {
+    await client.connect();
+    const params = {
+      nodeId,
+      maxDepth: parseInt(options.maxDepth || "99", 10),
+      includeInvisible: options.includeInvisible || false
+    };
+    const data = await client.requestWithRetry(
+      "get_node_by_id" /* GET_NODE_BY_ID */,
+      params,
+      pageUrl
+    );
+    const spaceData = extractSpaceInfo(data);
+    const outputPath = resolve7(options.output);
+    const outputDir = dirname10(outputPath);
+    mkdirSync8(outputDir, { recursive: true });
+    const jsonContent = JSON.stringify(spaceData, null, 2);
+    writeFileSync7(outputPath, jsonContent, "utf-8");
+    const size = jsonContent.length;
+    const sizeKB = (size / 1024).toFixed(2);
+    console.log(`\u6587\u4EF6\u8DEF\u5F84: ${outputPath}`);
+    if (options.link) {
+      console.log(`Link: ${options.link}`);
+      console.log(`\u9875\u9762 URL: ${pageUrl}`);
+    }
+    console.log(`\u8282\u70B9 ID: ${nodeId}`);
+    console.log(`\u6570\u636E\u5927\u5C0F: ${size.toLocaleString()} \u5B57\u7B26 (\u7EA6 ${sizeKB} KB)`);
+    console.log(`\u8282\u70B9\u6DF1\u5EA6: ${params.maxDepth}`);
+    console.log(`\u6570\u636E\u6A21\u5F0F: \u7A7A\u95F4\u4FE1\u606F (\u4EC5 id, name, x, y, width, height)`);
+  } catch (error) {
+    if (error instanceof MGError) {
+      console.error(`\u9519\u8BEF [${error.code}]: ${error.message}`);
+    } else {
+      console.error(`\u9519\u8BEF: ${error instanceof Error ? error.message : error}`);
+    }
+    process.exit(1);
+  } finally {
+    client.close();
+  }
+}
+
 // src/cli/index.ts
-var program = new Command8();
+var program = new Command9();
 program.name("mg-cli").description("MasterGo CLI \u5DE5\u5177 - \u7528\u4E8E Claude Code \u4E0E MasterGo \u901A\u4FE1").version("1.0.0");
 program.addCommand(createServerCommand());
 program.addCommand(createGetNodeByIdCommand());
@@ -1576,5 +1992,6 @@ program.addCommand(createGetAllNodesCommand());
 program.addCommand(createExportImageCommand());
 program.addCommand(createExecuteCodeCommand());
 program.addCommand(createGetAllPagesCommand());
+program.addCommand(createGetNodeForSpaceCommand());
 program.parse();
 //# sourceMappingURL=cli.js.map