@hangox/mg-cli 1.0.9 → 1.1.0

package/dist/cli.js

@@ -1,7 +1,139 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
+
+// src/cli/version-check.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join as join2 } from "path";
+import { execSync } from "child_process";
+
+// src/shared/version.ts
+import { readFileSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var cachedVersion = null;
+function getVersion() {
+  if (cachedVersion !== null) {
+    return cachedVersion;
+  }
+  try {
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = dirname(currentFile);
+    const packageJsonPaths = [
+      join(currentDir, "..", "package.json"),
+      // dist/xxx.js -> ../package.json
+      join(currentDir, "..", "..", "package.json")
+      // src/shared/version.ts -> ../../package.json
+    ];
+    for (const packageJsonPath of packageJsonPaths) {
+      if (existsSync(packageJsonPath)) {
+        const packageJson = JSON.parse(readFileSync(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;
+  }
+}
+var DEV_VERSION = "9.9.9";
+function isVersionMatch(version1, version2) {
+  if (version1 === DEV_VERSION || version2 === DEV_VERSION) {
+    return true;
+  }
+  return version1 === version2;
+}
+
+// src/cli/version-check.ts
+var CONFIG_DIR = join2(homedir(), ".config", "mg-cli");
+var CHECK_FILE = join2(CONFIG_DIR, "last-version-check");
+var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
+function readCheckData() {
+  try {
+    if (!existsSync2(CHECK_FILE)) {
+      return null;
+    }
+    const content = readFileSync2(CHECK_FILE, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function writeCheckData(data) {
+  try {
+    if (!existsSync2(CONFIG_DIR)) {
+      mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CHECK_FILE, JSON.stringify(data), "utf-8");
+  } catch {
+  }
+}
+function getRemoteVersion() {
+  try {
+    const result = execSync("npm view @hangox/mg-cli version", {
+      encoding: "utf-8",
+      timeout: 5e3,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return result.trim();
+  } catch {
+    return null;
+  }
+}
+function isNewerVersion(local, remote) {
+  const localParts = local.split(".").map(Number);
+  const remoteParts = remote.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const l = localParts[i] || 0;
+    const r = remoteParts[i] || 0;
+    if (r > l) return true;
+    if (r < l) return false;
+  }
+  return false;
+}
+function checkForUpdates() {
+  try {
+    const now = Date.now();
+    const checkData = readCheckData();
+    if (checkData && now - checkData.timestamp < CHECK_INTERVAL) {
+      if (checkData.remoteVersion && isNewerVersion(getVersion(), checkData.remoteVersion)) {
+        printUpdateNotice(checkData.remoteVersion);
+      }
+      return;
+    }
+    const remoteVersion = getRemoteVersion();
+    if (remoteVersion) {
+      writeCheckData({
+        timestamp: now,
+        remoteVersion
+      });
+      if (isNewerVersion(getVersion(), remoteVersion)) {
+        printUpdateNotice(remoteVersion);
+      }
+    } else {
+      writeCheckData({
+        timestamp: now
+      });
+    }
+  } catch {
+  }
+}
+function printUpdateNotice(remoteVersion) {
+  const localVersion = getVersion();
+  console.log("");
+  console.log(`\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510`);
+  console.log(`\u2502  \u53D1\u73B0\u65B0\u7248\u672C ${remoteVersion}\uFF08\u5F53\u524D ${localVersion}\uFF09`);
+  console.log(`\u2502  \u8FD0\u884C npm install -g @hangox/mg-cli \u66F4\u65B0`);
+  console.log(`\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518`);
+  console.log("");
+}
 
 // src/cli/commands/server.ts
 import { Command } from "commander";
@@ -9,15 +141,15 @@ import { Command } from "commander";
 // src/server/daemon.ts
 import { spawn } from "child_process";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname4, join as join3 } from "path";
+import { dirname as dirname4, join as join4 } from "path";
 
 // src/shared/utils.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs";
-import { dirname, resolve, isAbsolute } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2, unlinkSync } from "fs";
+import { dirname as dirname2, resolve, isAbsolute } from "path";
 
 // src/shared/constants.ts
-import { homedir } from "os";
-import { join } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join3 } from "path";
 var IS_DEV_MODE = process.env.MG_DEV_MODE === "true";
 var PROD_DEFAULT_PORT = 9527;
 var PROD_PORT_RANGE_START = 9527;
@@ -29,10 +161,10 @@ var DEFAULT_PORT = IS_DEV_MODE ? DEV_DEFAULT_PORT : PROD_DEFAULT_PORT;
 var PORT_RANGE_START = IS_DEV_MODE ? DEV_PORT_RANGE_START : PROD_PORT_RANGE_START;
 var PORT_RANGE_END = IS_DEV_MODE ? DEV_PORT_RANGE_END : PROD_PORT_RANGE_END;
 var PORT_SCAN_TIMEOUT = 500;
-var CONFIG_DIR = join(homedir(), ".mg-plugin");
-var SERVER_INFO_FILE = join(CONFIG_DIR, "server.json");
-var LOG_DIR = join(CONFIG_DIR, "logs");
-var SERVER_LOG_FILE = join(LOG_DIR, "server.log");
+var CONFIG_DIR2 = join3(homedir2(), ".mg-plugin");
+var SERVER_INFO_FILE = join3(CONFIG_DIR2, "server.json");
+var LOG_DIR = join3(CONFIG_DIR2, "logs");
+var SERVER_LOG_FILE = join3(LOG_DIR, "server.log");
 var HEARTBEAT_INTERVAL = 3e4;
 var HEARTBEAT_TIMEOUT = 9e4;
 var REQUEST_TIMEOUT = 3e4;
@@ -42,20 +174,20 @@ var MAX_RETRY_COUNT = 3;
 
 // src/shared/utils.ts
 function ensureDir(dir) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
+  if (!existsSync3(dir)) {
+    mkdirSync2(dir, { recursive: true });
   }
 }
 function ensureConfigDir() {
-  ensureDir(CONFIG_DIR);
+  ensureDir(CONFIG_DIR2);
   ensureDir(LOG_DIR);
 }
 function readServerInfo() {
   try {
-    if (!existsSync(SERVER_INFO_FILE)) {
+    if (!existsSync3(SERVER_INFO_FILE)) {
       return null;
     }
-    const content = readFileSync(SERVER_INFO_FILE, "utf-8");
+    const content = readFileSync3(SERVER_INFO_FILE, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -63,11 +195,11 @@ function readServerInfo() {
 }
 function writeServerInfo(info) {
   ensureConfigDir();
-  writeFileSync(SERVER_INFO_FILE, JSON.stringify(info, null, 2), "utf-8");
+  writeFileSync2(SERVER_INFO_FILE, JSON.stringify(info, null, 2), "utf-8");
 }
 function deleteServerInfo() {
   try {
-    if (existsSync(SERVER_INFO_FILE)) {
+    if (existsSync3(SERVER_INFO_FILE)) {
       unlinkSync(SERVER_INFO_FILE);
     }
   } catch {
@@ -428,8 +560,8 @@ var MGError = class extends Error {
 import { WebSocketServer } from "ws";
 
 // src/server/logger.ts
-import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
-import { dirname as dirname2 } from "path";
+import { appendFileSync, existsSync as existsSync4, mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname3 } from "path";
 var levelPriority = {
   ["DEBUG" /* DEBUG */]: 0,
   ["INFO" /* INFO */]: 1,
@@ -446,9 +578,9 @@ var Logger = class {
       minLevel: options.minLevel ?? "INFO" /* INFO */
     };
     if (this.options.file) {
-      const dir = dirname2(this.options.filePath);
-      if (!existsSync2(dir)) {
-        mkdirSync2(dir, { recursive: true });
+      const dir = dirname3(this.options.filePath);
+      if (!existsSync4(dir)) {
+        mkdirSync3(dir, { recursive: true });
       }
     }
   }
@@ -889,48 +1021,6 @@ 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 packageJsonPaths = [
-      join2(currentDir, "..", "package.json"),
-      // dist/xxx.js -> ../package.json
-      join2(currentDir, "..", "..", "package.json")
-      // src/shared/version.ts -> ../../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;
-  }
-}
-var DEV_VERSION = "9.9.9";
-function isVersionMatch(version1, version2) {
-  if (version1 === DEV_VERSION || version2 === DEV_VERSION) {
-    return true;
-  }
-  return version1 === version2;
-}
-
 // src/server/websocket-server.ts
 var MGServer = class {
   wss = null;
@@ -954,7 +1044,7 @@ var MGServer = class {
       throw new MGError("E016" /* SERVER_ALREADY_RUNNING */, "Server \u5DF2\u5728\u8FD0\u884C\u4E2D");
     }
     const port = await this.findAvailablePort();
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       this.wss = new WebSocketServer({ port });
       this.wss.on("listening", () => {
         this.port = port;
@@ -962,7 +1052,7 @@ var MGServer = class {
         this.startedAt = /* @__PURE__ */ new Date();
         this.logger.info(`Server \u542F\u52A8\u6210\u529F\uFF0C\u76D1\u542C\u7AEF\u53E3: ${port}`);
         this.connectionManager.startHeartbeatCheck(HEARTBEAT_INTERVAL);
-        resolve8(port);
+        resolve9(port);
       });
       this.wss.on("error", (error) => {
         this.logger.error("Server \u9519\u8BEF:", error);
@@ -993,14 +1083,14 @@ var MGServer = class {
    * 检查端口是否可用
    */
   isPortAvailable(port) {
-    return new Promise((resolve8) => {
+    return new Promise((resolve9) => {
       const testServer = new WebSocketServer({ port });
       testServer.on("listening", () => {
         testServer.close();
-        resolve8(true);
+        resolve9(true);
       });
       testServer.on("error", () => {
-        resolve8(false);
+        resolve9(false);
       });
     });
   }
@@ -1318,12 +1408,12 @@ var MGServer = class {
     this.logger.info("\u6B63\u5728\u505C\u6B62 Server...");
     this.requestHandler.cleanupAll();
     this.connectionManager.closeAll();
-    return new Promise((resolve8) => {
+    return new Promise((resolve9) => {
       this.wss.close(() => {
         this.isRunning = false;
         this.wss = null;
         this.logger.info("Server \u5DF2\u505C\u6B62");
-        resolve8();
+        resolve9();
       });
     });
   }
@@ -1424,7 +1514,7 @@ async function startServerDaemon(port) {
   ensureConfigDir();
   const currentFile = fileURLToPath2(import.meta.url);
   const currentDir = dirname4(currentFile);
-  const serverScript = join3(currentDir, "daemon-runner.js");
+  const serverScript = join4(currentDir, "daemon-runner.js");
   const args = ["--foreground"];
   if (port) {
     args.push("--port", String(port));
@@ -1440,7 +1530,7 @@ async function startServerDaemon(port) {
   child.unref();
   const startTime = Date.now();
   while (Date.now() - startTime < SERVER_START_TIMEOUT) {
-    await new Promise((resolve8) => setTimeout(resolve8, 200));
+    await new Promise((resolve9) => setTimeout(resolve9, 200));
     const { running: running2, info: info2 } = isServerRunning();
     if (running2 && info2) {
       return info2;
@@ -1461,7 +1551,7 @@ function stopServer() {
 }
 async function restartServer(port) {
   const { info: oldInfo } = stopServer();
-  await new Promise((resolve8) => setTimeout(resolve8, 500));
+  await new Promise((resolve9) => setTimeout(resolve9, 500));
   return startServerDaemon(port || oldInfo?.port);
 }
 function getServerStatus() {
@@ -1534,7 +1624,7 @@ var MGClient = class {
    * 尝试连接指定端口
    */
   tryConnect(port) {
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       const ws = new WebSocket2(`ws://localhost:${port}`);
       const timer = setTimeout(() => {
         ws.close();
@@ -1544,7 +1634,7 @@ var MGClient = class {
         clearTimeout(timer);
         this.ws = ws;
         this.register();
-        resolve8();
+        resolve9();
       });
       ws.on("error", (error) => {
         clearTimeout(timer);
@@ -1597,7 +1687,7 @@ var MGClient = class {
       pageUrl,
       timestamp: Date.now()
     };
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       const timer = setTimeout(() => {
         reject(new MGError("E012" /* REQUEST_TIMEOUT */, ErrorMessages["E012" /* REQUEST_TIMEOUT */]));
       }, REQUEST_TIMEOUT);
@@ -1608,7 +1698,7 @@ var MGClient = class {
             clearTimeout(timer);
             this.ws?.off("message", messageHandler);
             if (response.success) {
-              resolve8(response.data);
+              resolve9(response.data);
             } else {
               const error = response.error;
               reject(
@@ -1790,9 +1880,9 @@ function createServerCommand() {
 
 // src/cli/commands/get-node-by-id.ts
 import { Command as Command2 } from "commander";
-import { writeFileSync as writeFileSync2 } from "fs";
+import { writeFileSync as writeFileSync3 } from "fs";
 import { resolve as resolve2, dirname as dirname5 } from "path";
-import { mkdirSync as mkdirSync3 } from "fs";
+import { mkdirSync as mkdirSync4 } 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("--raw", "\u4FDD\u7559\u539F\u59CB\u6570\u636E\uFF0C\u4E0D\u7CBE\u7B80\u9ED8\u8BA4\u503C\u5B57\u6BB5", false).option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09", 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);
@@ -1819,9 +1909,9 @@ async function handleGetNodeById(options) {
     const outputData = options.raw ? data : trimNodeDefaults(data);
     const outputPath = resolve2(options.output);
     const outputDir = dirname5(outputPath);
-    mkdirSync3(outputDir, { recursive: true });
+    mkdirSync4(outputDir, { recursive: true });
     const jsonContent = JSON.stringify(outputData, null, options.pretty ? 2 : 0);
-    writeFileSync2(outputPath, jsonContent, "utf-8");
+    writeFileSync3(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
     console.log(`\u6587\u4EF6\u8DEF\u5F84: ${outputPath}`);
@@ -1842,9 +1932,9 @@ 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 { writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve3, dirname as dirname6 } from "path";
-import { mkdirSync as mkdirSync4 } from "fs";
+import { mkdirSync as mkdirSync5 } from "fs";
 function createGetNodeByLinkCommand() {
   return new Command3("get_node_by_link").description("\u89E3\u6790 mgp:// \u534F\u8BAE\u94FE\u63A5\u5E76\u83B7\u53D6\u8282\u70B9/\u9875\u9762\u4FE1\u606F").requiredOption("--link <url>", "mgp:// \u534F\u8BAE\u94FE\u63A5\uFF08\u652F\u6301 nodeId \u548C pageId\uFF09").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("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09", 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);
@@ -1895,9 +1985,9 @@ async function handleGetNodeByLink(options) {
     const outputData = options.raw ? data : trimNodeDefaults(data);
     const outputPath = resolve3(options.output);
     const outputDir = dirname6(outputPath);
-    mkdirSync4(outputDir, { recursive: true });
+    mkdirSync5(outputDir, { recursive: true });
     const jsonContent = JSON.stringify(outputData, null, options.pretty ? 2 : 0);
-    writeFileSync3(outputPath, jsonContent, "utf-8");
+    writeFileSync4(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
     console.log(`\u6587\u4EF6\u8DEF\u5F84: ${outputPath}`);
@@ -1930,9 +2020,9 @@ async function handleGetNodeByLink(options) {
 
 // src/cli/commands/get-all-nodes.ts
 import { Command as Command4 } from "commander";
-import { writeFileSync as writeFileSync4 } from "fs";
+import { writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve4, dirname as dirname7 } from "path";
-import { mkdirSync as mkdirSync5 } from "fs";
+import { mkdirSync as mkdirSync6 } 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("--raw", "\u4FDD\u7559\u539F\u59CB\u6570\u636E\uFF0C\u4E0D\u7CBE\u7B80\u9ED8\u8BA4\u503C\u5B57\u6BB5", false).option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09", 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);
@@ -1953,9 +2043,9 @@ async function handleGetAllNodes(options) {
     const outputData = options.raw ? data : Array.isArray(data) ? data.map((node) => trimNodeDefaults(node)) : trimNodeDefaults(data);
     const outputPath = resolve4(options.output);
     const outputDir = dirname7(outputPath);
-    mkdirSync5(outputDir, { recursive: true });
+    mkdirSync6(outputDir, { recursive: true });
     const jsonContent = JSON.stringify(outputData, null, options.pretty ? 2 : 0);
-    writeFileSync4(outputPath, jsonContent, "utf-8");
+    writeFileSync5(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
     const nodeCount = Array.isArray(data) ? data.length : 1;
@@ -1977,9 +2067,9 @@ async function handleGetAllNodes(options) {
 
 // src/cli/commands/export-image.ts
 import { Command as Command5 } from "commander";
-import { writeFileSync as writeFileSync5, unlinkSync as unlinkSync2 } from "fs";
+import { writeFileSync as writeFileSync6, unlinkSync as unlinkSync2 } from "fs";
 import { resolve as resolve5, dirname as dirname8, extname, basename } from "path";
-import { mkdirSync as mkdirSync6 } from "fs";
+import { mkdirSync as mkdirSync7 } from "fs";
 import { tmpdir } from "os";
 import { vdConvert } from "vd-tool";
 function createExportImageCommand() {
@@ -2069,23 +2159,23 @@ async function handleExportImage(options) {
       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 = dirname8(outputPath);
-    mkdirSync6(outputDir, { recursive: true });
+    mkdirSync7(outputDir, { recursive: true });
     const buffer = Buffer.from(response.data, "base64");
     let finalPath = outputPath;
     let finalSize = buffer.length;
     if (isVectorFormat) {
       const tempSvgPath = resolve5(tmpdir(), `temp_${Date.now()}.svg`);
-      writeFileSync5(tempSvgPath, buffer);
+      writeFileSync6(tempSvgPath, buffer);
       try {
         const vectorOutputDir = dirname8(outputPath);
         const convertedPath = await convertSvgToVector(tempSvgPath, vectorOutputDir);
         const expectedOutputName = basename(tempSvgPath, ".svg") + ".xml";
         const expectedOutputPath = resolve5(vectorOutputDir, expectedOutputName);
         if (expectedOutputPath !== outputPath) {
-          const { renameSync, existsSync: existsSync4 } = await import("fs");
-          if (existsSync4(expectedOutputPath)) {
+          const { renameSync, existsSync: existsSync5 } = await import("fs");
+          if (existsSync5(expectedOutputPath)) {
             renameSync(expectedOutputPath, outputPath);
-          } else if (existsSync4(convertedPath)) {
+          } else if (existsSync5(convertedPath)) {
             renameSync(convertedPath, outputPath);
           }
         }
@@ -2099,7 +2189,7 @@ async function handleExportImage(options) {
         }
       }
     } else {
-      writeFileSync5(outputPath, buffer);
+      writeFileSync6(outputPath, buffer);
     }
     const sizeKB = (finalSize / 1024).toFixed(2);
     console.log(`\u6587\u4EF6\u8DEF\u5F84: ${finalPath}`);
@@ -2210,9 +2300,9 @@ 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 { writeFileSync as writeFileSync7 } from "fs";
 import { resolve as resolve6, dirname as dirname9 } from "path";
-import { mkdirSync as mkdirSync7 } from "fs";
+import { mkdirSync as mkdirSync8 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
 function createGetAllPagesCommand() {
   return new Command7("get_all_pages").description("\u83B7\u53D6 MasterGo \u6587\u6863\u7684\u6240\u6709\u9875\u9762\u4FE1\u606F\u3002\u4E0D\u6307\u5B9A --output \u65F6\u4FDD\u5B58\u5230\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55").option("--link <url>", "\u9875\u9762\u94FE\u63A5\u3002\u652F\u6301\u5B8C\u6574 URL \u6216 mgp:// \u534F\u8BAE").option("--fileId <id>", "\u6587\u4EF6 ID\uFF08\u7EAF\u6570\u5B57\uFF09\u3002\u4ECE URL \u4E2D /file/ \u540E\u9762\u7684\u6570\u5B57").option("--domain <domain>", "MasterGo \u57DF\u540D\uFF0C\u9ED8\u8BA4 mastergo.netease.com\u3002\u4E0E --fileId \u914D\u5408\u4F7F\u7528", "mastergo.netease.com").option("--output <path>", "\u8F93\u51FA JSON \u6587\u4EF6\u8DEF\u5F84\u3002\u4E0D\u6307\u5B9A\u5219\u4FDD\u5B58\u5230\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55").option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09", false).option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
@@ -2260,9 +2350,9 @@ async function handleGetAllPages(options) {
       outputPath = resolve6(tmpdir2(), filename);
     }
     const outputDir = dirname9(outputPath);
-    mkdirSync7(outputDir, { recursive: true });
+    mkdirSync8(outputDir, { recursive: true });
     const jsonContent = JSON.stringify(data, null, options.pretty ? 2 : 0);
-    writeFileSync6(outputPath, jsonContent, "utf-8");
+    writeFileSync7(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
     console.log(`\u6587\u4EF6\u8DEF\u5F84: ${outputPath}`);
@@ -2280,9 +2370,9 @@ 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 { writeFileSync as writeFileSync8 } from "fs";
 import { resolve as resolve7, dirname as dirname10 } from "path";
-import { mkdirSync as mkdirSync8 } from "fs";
+import { mkdirSync as mkdirSync9 } from "fs";
 function createGetNodeForSpaceCommand() {
   return new Command8("get_node_for_space").description("\u83B7\u53D6\u8282\u70B9\u6216\u9875\u9762\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\u3002\u652F\u6301 nodeId \u548C pageId \u94FE\u63A5").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\uFF08\u652F\u6301 nodeId \u548C pageId\uFF09\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("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09", 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);
@@ -2362,9 +2452,9 @@ async function handleGetNodeForSpace(options) {
     const spaceData = extractSpaceInfo(data);
     const outputPath = resolve7(options.output);
     const outputDir = dirname10(outputPath);
-    mkdirSync8(outputDir, { recursive: true });
+    mkdirSync9(outputDir, { recursive: true });
     const jsonContent = JSON.stringify(spaceData, null, options.pretty ? 2 : 0);
-    writeFileSync7(outputPath, jsonContent, "utf-8");
+    writeFileSync8(outputPath, jsonContent, "utf-8");
     const size = jsonContent.length;
     const sizeKB = (size / 1024).toFixed(2);
     console.log(`\u6587\u4EF6\u8DEF\u5F84: ${outputPath}`);
@@ -2616,8 +2706,374 @@ async function handleNavigateToNode(options) {
   }
 }
 
+// src/cli/commands/visualize.ts
+import { Command as Command12 } from "commander";
+import { writeFileSync as writeFileSync9 } from "fs";
+import { resolve as resolve8, dirname as dirname11 } from "path";
+import { mkdirSync as mkdirSync10 } from "fs";
+
+// src/shared/ascii-renderer.ts
+var defaultRenderOptions = {
+  showId: true,
+  showSize: true,
+  showPadding: true,
+  showRadius: true,
+  showLayout: true,
+  showGap: true,
+  compact: true
+};
+function nodeToRenderNode(node) {
+  const renderNode = {
+    id: node.id,
+    name: node.name,
+    type: node.type,
+    width: Math.round(node.width ?? 0),
+    height: Math.round(node.height ?? 0),
+    x: Math.round(node.x ?? 0),
+    y: Math.round(node.y ?? 0)
+  };
+  const cornerRadius = node.cornerRadius;
+  if (cornerRadius && cornerRadius > 0) {
+    renderNode.cornerRadius = Math.round(cornerRadius);
+  }
+  const paddingTop = node.paddingTop;
+  const paddingRight = node.paddingRight;
+  const paddingBottom = node.paddingBottom;
+  const paddingLeft = node.paddingLeft;
+  if (paddingTop || paddingRight || paddingBottom || paddingLeft) {
+    renderNode.padding = {
+      top: Math.round(paddingTop ?? 0),
+      right: Math.round(paddingRight ?? 0),
+      bottom: Math.round(paddingBottom ?? 0),
+      left: Math.round(paddingLeft ?? 0)
+    };
+  }
+  const flexMode = node.flexMode;
+  if (flexMode === "HORIZONTAL") {
+    renderNode.flexMode = "H";
+  } else if (flexMode === "VERTICAL") {
+    renderNode.flexMode = "V";
+  } else {
+    renderNode.flexMode = "none";
+  }
+  const itemSpacing = node.itemSpacing;
+  if (itemSpacing && itemSpacing > 0) {
+    renderNode.itemSpacing = Math.round(itemSpacing);
+  }
+  if (node.type === "TEXT") {
+    const textStyles = node.textStyles;
+    if (textStyles && textStyles.length > 0) {
+      const firstStyle = textStyles[0];
+      const fontFamily = firstStyle.textStyle?.fontName?.family;
+      const fontSize = firstStyle.textStyle?.fontSize;
+      if (fontFamily && fontSize) {
+        renderNode.font = {
+          family: fontFamily,
+          size: Math.round(fontSize)
+        };
+      }
+    }
+  }
+  if (node.children && node.children.length > 0) {
+    renderNode.children = node.children.map(nodeToRenderNode);
+  }
+  return renderNode;
+}
+var CompactRenderer = class {
+  options;
+  treeChars = {
+    branch: "\u251C\u2500 ",
+    lastBranch: "\u2514\u2500 ",
+    vertical: "\u2502  ",
+    space: "   "
+  };
+  gapChars = {
+    vertical: "\u2195",
+    horizontal: "\u2194"
+  };
+  constructor(options = {}) {
+    this.options = { ...defaultRenderOptions, ...options, compact: true };
+  }
+  /**
+   * 渲染节点为树形结构
+   */
+  render(node) {
+    const lines = [];
+    lines.push(this.buildLine(node));
+    if (node.children && node.children.length > 0) {
+      this.renderChildren(node, "", lines);
+    }
+    return lines;
+  }
+  renderChildren(parent, prefix, lines) {
+    if (!parent.children) return;
+    const gapSymbol = parent.flexMode === "H" ? this.gapChars.horizontal : this.gapChars.vertical;
+    parent.children.forEach((child, index) => {
+      const isLastChild = index === parent.children.length - 1;
+      const connector = isLastChild ? this.treeChars.lastBranch : this.treeChars.branch;
+      lines.push(prefix + connector + this.buildLine(child));
+      if (child.children && child.children.length > 0) {
+        const childPrefix = prefix + (isLastChild ? this.treeChars.space : this.treeChars.vertical);
+        this.renderChildren(child, childPrefix, lines);
+      }
+      if (this.options.showGap && parent.itemSpacing && parent.itemSpacing > 0 && index < parent.children.length - 1) {
+        const gapLinePrefix = prefix + this.treeChars.vertical;
+        lines.push(gapLinePrefix + `  ${gapSymbol} gap:${parent.itemSpacing}`);
+      }
+    });
+  }
+  buildLine(node) {
+    const parts = [];
+    let typeName = `${node.type} "${node.name}"`;
+    if (this.options.showId) {
+      typeName += ` [${node.id}]`;
+    }
+    parts.push(typeName);
+    if (this.options.showSize) {
+      parts.push(`${node.width}\xD7${node.height}`);
+    }
+    if (this.options.showRadius && node.cornerRadius) {
+      parts.push(`r:${node.cornerRadius}`);
+    }
+    if (this.options.showPadding && node.padding) {
+      const { top, right, bottom, left } = node.padding;
+      if (top === right && right === bottom && bottom === left && top > 0) {
+        parts.push(`p:${top}`);
+      } else if (top > 0 || right > 0 || bottom > 0 || left > 0) {
+        parts.push(`p:${top}/${right}/${bottom}/${left}`);
+      }
+    }
+    if (this.options.showLayout && node.flexMode && node.flexMode !== "none") {
+      parts.push(`flex:${node.flexMode}`);
+    }
+    if (this.options.showGap && node.itemSpacing && node.itemSpacing > 0) {
+      parts.push(`gap:${node.itemSpacing}`);
+    }
+    if (node.font) {
+      parts.push(`font:${node.font.family}/${node.font.size}px`);
+    }
+    parts.push(`@(${node.x},${node.y})`);
+    return parts.join(" ");
+  }
+};
+var BoxRenderer = class {
+  options;
+  boxChars = {
+    topLeft: "\u250C",
+    topRight: "\u2510",
+    bottomLeft: "\u2514",
+    bottomRight: "\u2518",
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    teeRight: "\u251C",
+    teeLeft: "\u2524"
+  };
+  gapChars = {
+    vertical: "\u2195",
+    horizontal: "\u2194"
+  };
+  /** 固定总宽度，确保右边框对齐 */
+  totalWidth = 80;
+  constructor(options = {}) {
+    this.options = { ...defaultRenderOptions, ...options, compact: false };
+  }
+  /**
+   * 渲染节点为框图
+   */
+  render(node) {
+    this.totalWidth = Math.max(80, this.calculateMaxWidth(node, 0));
+    return this.renderNode(node, 0);
+  }
+  /**
+   * 计算整棵树需要的最大宽度
+   */
+  calculateMaxWidth(node, indent) {
+    const indentWidth = indent * 4;
+    const title = this.buildTitle(node);
+    const props = this.buildPropsLine(node);
+    const nodeWidth = Math.max(title.length + 6, props.length + 6) + indentWidth;
+    let maxWidth = nodeWidth;
+    if (node.children) {
+      for (const child of node.children) {
+        const childWidth = this.calculateMaxWidth(child, indent + 1);
+        maxWidth = Math.max(maxWidth, childWidth);
+      }
+    }
+    return maxWidth;
+  }
+  renderNode(node, indent) {
+    const lines = [];
+    const indentWidth = indent * 4;
+    const contentWidth = this.totalWidth - indentWidth - 2;
+    const indentStr = "  ".repeat(indent);
+    const title = this.buildTitle(node);
+    const props = this.buildPropsLine(node);
+    const titlePadding = contentWidth - title.length - 4;
+    lines.push(
+      indentStr + this.boxChars.topLeft + this.boxChars.horizontal + " " + title + " " + this.boxChars.horizontal.repeat(Math.max(0, titlePadding)) + this.boxChars.topRight
+    );
+    lines.push(
+      indentStr + this.boxChars.vertical + "  " + props.padEnd(contentWidth - 2) + this.boxChars.vertical
+    );
+    lines.push(
+      indentStr + this.boxChars.teeRight + this.boxChars.horizontal.repeat(contentWidth) + this.boxChars.teeLeft
+    );
+    if (node.children && node.children.length > 0) {
+      lines.push(
+        indentStr + this.boxChars.vertical + " ".repeat(contentWidth) + this.boxChars.vertical
+      );
+      const gapSymbol = node.flexMode === "H" ? this.gapChars.horizontal : this.gapChars.vertical;
+      node.children.forEach((child, index) => {
+        const childLines = this.renderNode(child, indent + 1);
+        for (const childLine of childLines) {
+          const paddedLine = "  " + childLine.padEnd(contentWidth - 2);
+          lines.push(indentStr + this.boxChars.vertical + paddedLine + this.boxChars.vertical);
+        }
+        if (this.options.showGap && node.itemSpacing && node.itemSpacing > 0 && index < node.children.length - 1) {
+          const gapText = `${gapSymbol} gap:${node.itemSpacing}`;
+          const gapPadding = Math.floor((contentWidth - gapText.length) / 2);
+          const gapLine = " ".repeat(gapPadding) + gapText;
+          lines.push(
+            indentStr + this.boxChars.vertical + gapLine.padEnd(contentWidth) + this.boxChars.vertical
+          );
+        } else {
+          lines.push(
+            indentStr + this.boxChars.vertical + " ".repeat(contentWidth) + this.boxChars.vertical
+          );
+        }
+      });
+    }
+    lines.push(
+      indentStr + this.boxChars.bottomLeft + this.boxChars.horizontal.repeat(contentWidth) + this.boxChars.bottomRight
+    );
+    return lines;
+  }
+  buildTitle(node) {
+    let title = `${node.type} "${node.name}"`;
+    if (this.options.showId) {
+      title += ` [${node.id}]`;
+    }
+    return title;
+  }
+  buildPropsLine(node) {
+    const parts = [];
+    if (this.options.showSize) {
+      parts.push(`${node.width}\xD7${node.height}`);
+    }
+    if (this.options.showRadius && node.cornerRadius) {
+      parts.push(`r:${node.cornerRadius}`);
+    }
+    if (this.options.showPadding && node.padding) {
+      const { top, right, bottom, left } = node.padding;
+      if (top === right && right === bottom && bottom === left && top > 0) {
+        parts.push(`p:${top}`);
+      } else if (top > 0 || right > 0 || bottom > 0 || left > 0) {
+        parts.push(`p:${top}/${right}/${bottom}/${left}`);
+      }
+    }
+    if (this.options.showLayout && node.flexMode && node.flexMode !== "none") {
+      parts.push(`flex:${node.flexMode}`);
+    }
+    if (this.options.showGap && node.itemSpacing && node.itemSpacing > 0) {
+      parts.push(`gap:${node.itemSpacing}`);
+    }
+    if (node.font) {
+      parts.push(`font:${node.font.family}/${node.font.size}px`);
+    }
+    parts.push(`pos:(${node.x},${node.y})`);
+    return parts.join("  ");
+  }
+};
+function renderAscii(node, options = {}) {
+  const renderNode = nodeToRenderNode(node);
+  const mergedOptions = { ...defaultRenderOptions, ...options };
+  let lines;
+  if (mergedOptions.compact) {
+    const renderer = new CompactRenderer(mergedOptions);
+    lines = renderer.render(renderNode);
+  } else {
+    const renderer = new BoxRenderer(mergedOptions);
+    lines = renderer.render(renderNode);
+  }
+  return lines.join("\n");
+}
+
+// src/cli/commands/visualize.ts
+function createVisualizeCommand() {
+  return new Command12("visualize").description("\u5C06 MasterGo \u8BBE\u8BA1\u7A3F\u8282\u70B9\u6E32\u67D3\u4E3A ASCII \u793A\u610F\u56FE").requiredOption("--link <url>", "mgp:// \u534F\u8BAE\u94FE\u63A5").option("--output <path>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u4E0D\u6307\u5B9A\u5219\u8F93\u51FA\u5230\u7EC8\u7AEF\uFF09").option("--maxDepth <number>", "\u904D\u5386\u6DF1\u5EA6", "3").option("--no-show-id", "\u9690\u85CF\u8282\u70B9 ID").option("--no-show-size", "\u9690\u85CF\u5C3A\u5BF8").option("--no-show-padding", "\u9690\u85CF padding").option("--no-show-radius", "\u9690\u85CF\u5706\u89D2").option("--no-show-layout", "\u9690\u85CF\u5E03\u5C40\u65B9\u5411").option("--no-show-gap", "\u9690\u85CF gap \u53EF\u89C6\u5316").option("--no-compact", "\u4F7F\u7528\u6846\u56FE\u6A21\u5F0F\uFF08\u4EBA\u7C7B\u9605\u8BFB\u4F18\u5316\uFF09").option("--no-auto-start", "\u7981\u7528\u81EA\u52A8\u542F\u52A8 Server").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").action(async (options) => {
+    await handleVisualize(options);
+  });
+}
+async function handleVisualize(options) {
+  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:`);
+    console.error(`  \u8282\u70B9\u94FE\u63A5: mgp://[mastergo_page_url]?nodeId=[\u8282\u70B9ID]`);
+    console.error(`  \u9875\u9762\u94FE\u63A5: mgp://[mastergo_page_url]?pageId=[\u9875\u9762ID]`);
+    process.exit(1);
+  }
+  const { pageUrl, nodeId, pageId } = parsed;
+  const isPageLink = !!pageId;
+  const client = new MGClient({
+    noAutoStart: options.noAutoStart,
+    noRetry: options.noRetry
+  });
+  try {
+    await client.connect();
+    let data;
+    if (isPageLink) {
+      const params = {
+        pageId,
+        maxDepth: parseInt(options.maxDepth || "3", 10),
+        includeInvisible: false
+      };
+      data = await client.requestWithRetry("get_page_by_id" /* GET_PAGE_BY_ID */, params, pageUrl);
+    } else {
+      const params = {
+        nodeId,
+        maxDepth: parseInt(options.maxDepth || "3", 10),
+        includeInvisible: false
+      };
+      data = await client.requestWithRetry("get_node_by_id" /* GET_NODE_BY_ID */, params, pageUrl);
+    }
+    const renderOptions = {
+      showId: options.showId !== false,
+      showSize: options.showSize !== false,
+      showPadding: options.showPadding !== false,
+      showRadius: options.showRadius !== false,
+      showLayout: options.showLayout !== false,
+      showGap: options.showGap !== false,
+      compact: options.compact !== false
+    };
+    const asciiOutput = renderAscii(data, renderOptions);
+    if (options.output) {
+      const outputPath = resolve8(options.output);
+      const outputDir = dirname11(outputPath);
+      mkdirSync10(outputDir, { recursive: true });
+      writeFileSync9(outputPath, asciiOutput, "utf-8");
+      console.log(`ASCII \u793A\u610F\u56FE\u5DF2\u4FDD\u5B58\u5230: ${outputPath}`);
+      console.log(`Link: ${options.link}`);
+      console.log(`\u6A21\u5F0F: ${options.compact ? "\u7D27\u51D1" : "\u6807\u51C6"}`);
+      console.log(`\u904D\u5386\u6DF1\u5EA6: ${options.maxDepth || "3"}`);
+    } else {
+      console.log(asciiOutput);
+    }
+  } 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 Command12();
+var program = new Command13();
 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());
@@ -2630,5 +3086,7 @@ program.addCommand(createGetNodeForSpaceCommand());
 program.addCommand(createListExtensionsCommand());
 program.addCommand(createOpenPageCommand());
 program.addCommand(createNavigateToNodeCommand());
+program.addCommand(createVisualizeCommand());
+checkForUpdates();
 program.parse();
 //# sourceMappingURL=cli.js.map