@hangox/mg-cli 1.1.1 → 1.1.3

package/dist/cli.js

@@ -231,17 +231,22 @@ function parseMgpLink(link) {
     if (questionMarkIndex === -1) {
       return null;
     }
-    const pageUrl = urlPart.slice(0, questionMarkIndex);
+    const basePath = urlPart.slice(0, questionMarkIndex);
     const queryString = urlPart.slice(questionMarkIndex + 1);
     const params = new URLSearchParams(queryString);
     const encodedNodeId = params.get("nodeId");
     const encodedPageId = params.get("pageId");
+    const mgPageId = params.get("page_id");
     if (!encodedNodeId && !encodedPageId) {
       return null;
     }
     if (encodedNodeId && encodedPageId) {
       return null;
     }
+    let pageUrl = basePath;
+    if (mgPageId) {
+      pageUrl = `${basePath}?page_id=${mgPageId}`;
+    }
     if (encodedNodeId) {
       const nodeId = decodeURIComponent(encodedNodeId);
       if (!/^(\d+:\d+)(\/\d+:\d+)*$/.test(nodeId)) {
@@ -256,10 +261,19 @@ function parseMgpLink(link) {
           return null;
         }
       }
+      const childNodeIdsRaw = params.get("childNodeIds");
+      let childNodeIds;
+      if (childNodeIdsRaw) {
+        childNodeIds = childNodeIdsRaw.split(",").map((id) => decodeURIComponent(id));
+        if (!childNodeIds.every((id) => /^(\d+:\d+)(\/\d+:\d+)*$/.test(id))) {
+          return null;
+        }
+      }
       return {
         pageUrl,
         nodeId,
-        nodePath
+        nodePath,
+        childNodeIds
       };
     }
     if (encodedPageId) {
@@ -384,6 +398,8 @@ var NODE_DEFAULTS = {
   dashCap: "NONE",
   fillStyleId: "",
   strokeStyleId: "",
+  strokeFillStyleId: "",
+  strokeWidthStyleId: "",
   // Corner 属性
   cornerSmooth: 0,
   cornerRadius: 0,
@@ -391,6 +407,7 @@ var NODE_DEFAULTS = {
   topRightRadius: 0,
   bottomLeftRadius: 0,
   bottomRightRadius: 0,
+  cornerRadiusStyleId: "",
   // Layout 属性
   rotation: 0,
   flexGrow: 0,
@@ -406,9 +423,13 @@ var NODE_DEFAULTS = {
   paddingRight: 0,
   paddingBottom: 0,
   paddingLeft: 0,
+  paddingStyleId: "",
+  spacingStyleId: "",
   clipsContent: false,
   itemReverseZIndex: false,
   strokesIncludedInLayout: false,
+  overflowDirection: "NONE",
+  gridStyleId: "",
   // 其他属性
   componentPropertyReferences: null
 };
@@ -419,7 +440,8 @@ var EMPTY_ARRAY_FIELDS = [
   "strokeDashes",
   "exportSettings",
   "reactions",
-  "attachedConnectors"
+  "attachedConnectors",
+  "layoutGrids"
 ];
 function isEmptyArray(value) {
   return Array.isArray(value) && value.length === 0;
@@ -648,8 +670,8 @@ var ConnectionManager = class {
   allConnections = /* @__PURE__ */ new Map();
   /** 心跳检查定时器 */
   heartbeatTimer = null;
-  constructor(logger) {
-    this.logger = logger;
+  constructor(logger2) {
+    this.logger = logger2;
   }
   /**
    * 启动心跳检查
@@ -876,9 +898,9 @@ var RequestHandler = class {
   connectionManager;
   /** 待处理的请求 */
   pendingRequests = /* @__PURE__ */ new Map();
-  constructor(connectionManager, logger) {
+  constructor(connectionManager, logger2) {
     this.connectionManager = connectionManager;
-    this.logger = logger;
+    this.logger = logger2;
   }
   /**
    * 处理 Consumer 请求
@@ -1021,6 +1043,60 @@ var RequestHandler = class {
   }
 };
 
+// src/server/analytics.ts
+import { PostHog } from "posthog-node";
+var POSTHOG_API_KEY = "phc_cSZZIxZOPhWOlsw92Wz8tmKQ5z8eQYsI3m9aM2Ujia9";
+var POSTHOG_HOST = "https://us.i.posthog.com";
+var posthogClient = null;
+var logger = null;
+function isTelemetryDisabled() {
+  return process.env.MG_TELEMETRY_DISABLED === "1" || process.env.MG_TELEMETRY_DISABLED === "true" || process.env.DO_NOT_TRACK === "1" || process.env.DO_NOT_TRACK === "true";
+}
+function initServerAnalytics(serverLogger) {
+  logger = serverLogger;
+  if (isTelemetryDisabled()) {
+    logger.info("\u9065\u6D4B\u5DF2\u7981\u7528 (MG_TELEMETRY_DISABLED \u6216 DO_NOT_TRACK)");
+    return;
+  }
+  if (!posthogClient) {
+    posthogClient = new PostHog(POSTHOG_API_KEY, {
+      host: POSTHOG_HOST,
+      // Server 端使用批量模式，减少网络请求
+      flushAt: 10,
+      flushInterval: 3e4
+      // 30 秒
+    });
+    logger.info("PostHog Analytics \u5DF2\u521D\u59CB\u5316");
+  }
+}
+function trackEvent(eventData) {
+  if (!posthogClient) {
+    return;
+  }
+  try {
+    posthogClient.capture({
+      distinctId: eventData.distinctId,
+      event: eventData.event,
+      properties: eventData.properties
+    });
+    logger?.info(`\u7EDF\u8BA1\u4E8B\u4EF6\u5DF2\u8BB0\u5F55: ${eventData.event}`, eventData.properties);
+  } catch (error) {
+    logger?.error("\u7EDF\u8BA1\u4E8B\u4EF6\u8BB0\u5F55\u5931\u8D25:", error);
+  }
+}
+async function shutdownServerAnalytics() {
+  if (posthogClient) {
+    try {
+      logger?.info("\u6B63\u5728\u53D1\u9001\u5269\u4F59\u7EDF\u8BA1\u4E8B\u4EF6...");
+      await posthogClient.shutdown();
+      logger?.info("PostHog Analytics \u5DF2\u5173\u95ED");
+    } catch (error) {
+      logger?.error("\u5173\u95ED PostHog \u5931\u8D25:", error);
+    }
+    posthogClient = null;
+  }
+}
+
 // src/server/websocket-server.ts
 var MGServer = class {
   wss = null;
@@ -1052,6 +1128,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);
+        initServerAnalytics(this.logger);
         resolve9(port);
       });
       this.wss.on("error", (error) => {
@@ -1111,6 +1188,10 @@ var MGServer = class {
           this.handleRegister(ws, message);
           return;
         }
+        if (message.type === "track_analytics" /* TRACK_ANALYTICS */) {
+          this.handleTrackAnalytics(message);
+          return;
+        }
         const managedWs = ws;
         if (!managedWs.connectionId) {
           this.logger.warn("\u672A\u6CE8\u518C\u7684\u8FDE\u63A5\u53D1\u9001\u6D88\u606F\uFF0C\u5FFD\u7565");
@@ -1188,6 +1269,9 @@ var MGServer = class {
       case "navigate_to_node" /* NAVIGATE_TO_NODE */:
         this.handleNavigateToNode(ws, message);
         break;
+      case "track_analytics" /* TRACK_ANALYTICS */:
+        this.handleTrackAnalytics(message);
+        break;
       case "response" /* RESPONSE */:
       case "error" /* ERROR */:
         this.requestHandler.handleResponse(message);
@@ -1333,6 +1417,15 @@ var MGServer = class {
       }
     });
   }
+  /**
+   * 处理统计事件
+   */
+  handleTrackAnalytics(message) {
+    const eventData = message.data;
+    if (eventData) {
+      trackEvent(eventData);
+    }
+  }
   /**
    * 处理节点导航请求
    */
@@ -1406,6 +1499,7 @@ var MGServer = class {
       return;
     }
     this.logger.info("\u6B63\u5728\u505C\u6B62 Server...");
+    await shutdownServerAnalytics();
     this.requestHandler.cleanupAll();
     this.connectionManager.closeAll();
     return new Promise((resolve9) => {
@@ -1466,14 +1560,14 @@ async function startServerForeground(port) {
     );
   }
   ensureConfigDir();
-  const logger = createLogger({
+  const logger2 = createLogger({
     console: true,
     file: true,
     minLevel: "INFO" /* INFO */
   });
   const server = createServer({
     port: port || DEFAULT_PORT,
-    logger
+    logger: logger2
   });
   const cleanup = async () => {
     console.log("\n\u6B63\u5728\u505C\u6B62 Server...");
@@ -1499,7 +1593,7 @@ MG Server \u542F\u52A8\u6210\u529F`);
     console.log(`
 \u6309 Ctrl+C \u505C\u6B62...`);
   } catch (error) {
-    logger.error("Server \u542F\u52A8\u5931\u8D25:", error);
+    logger2.error("Server \u542F\u52A8\u5931\u8D25:", error);
     throw error;
   }
 }
@@ -1758,10 +1852,106 @@ var MGClient = class {
   }
 };
 
+// src/cli/analytics.ts
+import { WebSocket as WebSocket3 } from "ws";
+import { createHash } from "crypto";
+import { hostname, userInfo, platform, release } from "os";
+var machineId = null;
+function isTelemetryDisabled2() {
+  return process.env.MG_TELEMETRY_DISABLED === "1" || process.env.MG_TELEMETRY_DISABLED === "true" || process.env.DO_NOT_TRACK === "1" || process.env.DO_NOT_TRACK === "true";
+}
+function getMachineId() {
+  if (machineId) {
+    return machineId;
+  }
+  try {
+    const hostName = hostname();
+    const userName = userInfo().username;
+    const raw = `${hostName}-${userName}-mg-cli`;
+    machineId = createHash("sha256").update(raw).digest("hex").substring(0, 16);
+  } catch {
+    machineId = createHash("sha256").update(Math.random().toString()).digest("hex").substring(0, 16);
+  }
+  return machineId;
+}
+function sendToServer(eventData) {
+  try {
+    const serverInfo = readServerInfo();
+    if (!serverInfo) {
+      return;
+    }
+    if (!isProcessRunning(serverInfo.pid)) {
+      return;
+    }
+    const ws = new WebSocket3(`ws://localhost:${serverInfo.port}`);
+    const timeout = setTimeout(() => {
+      ws.close();
+    }, 1e3);
+    ws.on("open", () => {
+      const message = {
+        type: "track_analytics" /* TRACK_ANALYTICS */,
+        data: eventData
+      };
+      ws.send(JSON.stringify(message));
+      clearTimeout(timeout);
+      ws.close();
+    });
+    ws.on("error", () => {
+      clearTimeout(timeout);
+    });
+  } catch {
+  }
+}
+function trackCommand(properties) {
+  if (isTelemetryDisabled2()) {
+    return;
+  }
+  const eventData = {
+    distinctId: getMachineId(),
+    event: "cli_command",
+    properties: {
+      ...properties,
+      version: getVersion(),
+      os: platform(),
+      os_release: release(),
+      node_version: process.version
+    }
+  };
+  sendToServer(eventData);
+}
+function createCommandTracker(commandName) {
+  const startTime = Date.now();
+  return {
+    /**
+     * 记录命令成功
+     */
+    success() {
+      trackCommand({
+        command: commandName,
+        success: true,
+        duration_ms: Date.now() - startTime
+      });
+    },
+    /**
+     * 记录命令失败
+     */
+    failure(error) {
+      trackCommand({
+        command: commandName,
+        success: false,
+        duration_ms: Date.now() - startTime,
+        error_code: error && "code" in error ? String(error.code) : void 0,
+        error_message: error?.message
+      });
+    }
+  };
+}
+
 // 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) => {
+    const tracker = createCommandTracker("server_start");
     try {
       if (options.foreground) {
         await startServerForeground(options.port);
@@ -1773,12 +1963,15 @@ function createServerCommand() {
         console.log(`\u8FDB\u7A0B PID: ${info.pid}`);
         console.log(`\u8FD0\u884C\u6A21\u5F0F: \u5B88\u62A4\u8FDB\u7A0B`);
       }
+      tracker.success();
     } catch (error) {
       console.error(`\u9519\u8BEF: ${error.message}`);
+      tracker.failure(error);
       process.exit(1);
     }
   });
   serverCmd.command("stop").description("\u505C\u6B62 MG Server").action(() => {
+    const tracker = createCommandTracker("server_stop");
     try {
       const { stopped, info } = stopServer();
       if (stopped && info) {
@@ -1800,12 +1993,15 @@ function createServerCommand() {
       } else {
         console.log("MG Server \u672A\u8FD0\u884C");
       }
+      tracker.success();
     } catch (error) {
       console.error(`\u9519\u8BEF: ${error.message}`);
+      tracker.failure(error);
       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) => {
+    const tracker = createCommandTracker("server_restart");
     try {
       const status = getServerStatus();
       if (status.running) {
@@ -1816,17 +2012,21 @@ function createServerCommand() {
       console.log(`\u7248\u672C: ${info.version}`);
       console.log(`\u76D1\u542C\u7AEF\u53E3: ${info.port}`);
       console.log(`\u65B0\u8FDB\u7A0B PID: ${info.pid}`);
+      tracker.success();
     } catch (error) {
       console.error(`\u9519\u8BEF: ${error.message}`);
+      tracker.failure(error);
       process.exit(1);
     }
   });
   serverCmd.command("status").description("\u67E5\u770B Server \u8FD0\u884C\u72B6\u6001").action(async () => {
+    const tracker = createCommandTracker("server_status");
     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");
+        tracker.success();
         return;
       }
       try {
@@ -1858,6 +2058,7 @@ function createServerCommand() {
           console.log(`\u63D0\u793A: \u8BF7\u5B89\u88C5 MG Plugin \u6D4F\u89C8\u5668\u6269\u5C55\u5E76\u5728 Chrome \u4E2D\u6253\u5F00 MasterGo \u9875\u9762`);
           console.log(`      \u63D2\u4EF6\u5730\u5740: https://chromewebstore.google.com/detail/mg-plugin/ddhihanlpcdneicohnglnaliefnkaeja`);
         }
+        tracker.success();
       } catch {
         console.log("MG Server \u72B6\u6001: \u8FD0\u884C\u4E2D \u2713");
         if (basicStatus.version) {
@@ -1869,9 +2070,11 @@ function createServerCommand() {
         console.log(`\u8FD0\u884C\u65F6\u957F: ${basicStatus.uptime}`);
         console.log(``);
         console.log(`\u6CE8\u610F: \u65E0\u6CD5\u83B7\u53D6\u8BE6\u7EC6\u8FDE\u63A5\u4FE1\u606F`);
+        tracker.success();
       }
     } catch (error) {
       console.error(`\u9519\u8BEF: ${error.message}`);
+      tracker.failure(error);
       process.exit(1);
     }
   });
@@ -1889,6 +2092,7 @@ function createGetNodeByIdCommand() {
   });
 }
 async function handleGetNodeById(options) {
+  const tracker = createCommandTracker("get_node_by_id");
   const client = new MGClient({
     noAutoStart: options.noAutoStart,
     noRetry: options.noRetry
@@ -1922,8 +2126,10 @@ async function handleGetNodeById(options) {
     if (!options.raw) {
       console.log(`\u6570\u636E\u6A21\u5F0F: \u7CBE\u7B80\u6A21\u5F0F (\u4F7F\u7528 --raw \u83B7\u53D6\u5B8C\u6574\u6570\u636E)`);
     }
+    tracker.success();
   } catch (error) {
     console.error(`\u9519\u8BEF: ${error instanceof Error ? error.message : error}`);
+    tracker.failure(error instanceof Error ? error : void 0);
     process.exit(1);
   } finally {
     client.close();
@@ -1941,6 +2147,7 @@ function createGetNodeByLinkCommand() {
   });
 }
 async function handleGetNodeByLink(options) {
+  const tracker = createCommandTracker("get_node_by_link");
   const parsed = parseMgpLink(options.link);
   if (!parsed) {
     console.error(`\u9519\u8BEF [${"E010" /* INVALID_LINK */}]: \u65E0\u6548\u7684 mgp:// \u94FE\u63A5\u683C\u5F0F`);
@@ -1948,10 +2155,12 @@ async function handleGetNodeByLink(options) {
     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]`);
+    tracker.failure({ code: "E010" /* INVALID_LINK */, message: "\u65E0\u6548\u7684 mgp:// \u94FE\u63A5\u683C\u5F0F" });
     process.exit(1);
   }
-  const { pageUrl, nodeId, pageId } = parsed;
+  const { pageUrl, nodeId, pageId, childNodeIds } = parsed;
   const isPageLink = !!pageId;
+  const isMultiSelect = childNodeIds && childNodeIds.length > 0;
   const client = new MGClient({
     noAutoStart: options.noAutoStart,
     noRetry: options.noRetry
@@ -1974,7 +2183,9 @@ async function handleGetNodeByLink(options) {
       const params = {
         nodeId,
         maxDepth: parseInt(options.maxDepth || "1", 10),
-        includeInvisible: options.includeInvisible || false
+        includeInvisible: options.includeInvisible || false,
+        // 多选模式：传递 childNodeIds 进行过滤
+        ...isMultiSelect && { childNodeIds }
       };
       data = await client.requestWithRetry(
         "get_node_by_id" /* GET_NODE_BY_ID */,
@@ -1998,7 +2209,12 @@ async function handleGetNodeByLink(options) {
       console.log(`\u7C7B\u578B: \u9875\u9762`);
     } else {
       console.log(`\u8282\u70B9 ID: ${nodeId}`);
-      console.log(`\u7C7B\u578B: \u8282\u70B9`);
+      if (isMultiSelect) {
+        console.log(`\u7C7B\u578B: \u591A\u9009\u8282\u70B9 (\u516C\u5171\u7236\u5143\u7D20)`);
+        console.log(`\u9009\u4E2D\u5B50\u8282\u70B9: ${childNodeIds.length} \u4E2A`);
+      } else {
+        console.log(`\u7C7B\u578B: \u8282\u70B9`);
+      }
     }
     console.log(`\u6570\u636E\u5927\u5C0F: ${size.toLocaleString()} \u5B57\u7B26 (\u7EA6 ${sizeKB} KB)`);
     console.log(`\u904D\u5386\u6DF1\u5EA6: ${options.maxDepth || "1"}`);
@@ -2006,11 +2222,14 @@ async function handleGetNodeByLink(options) {
     if (!options.raw) {
       console.log(`\u6570\u636E\u6A21\u5F0F: \u7CBE\u7B80\u6A21\u5F0F (\u4F7F\u7528 --raw \u83B7\u53D6\u5B8C\u6574\u6570\u636E)`);
     }
+    tracker.success();
   } catch (error) {
     if (error instanceof MGError) {
       console.error(`\u9519\u8BEF [${error.code}]: ${error.message}`);
+      tracker.failure(error);
     } else {
       console.error(`\u9519\u8BEF: ${error instanceof Error ? error.message : error}`);
+      tracker.failure(error instanceof Error ? error : void 0);
     }
     process.exit(1);
   } finally {
@@ -2390,6 +2609,7 @@ async function handleGetNodeForSpace(options) {
   let pageUrl;
   let nodeId;
   let pageId;
+  let childNodeIds;
   let isPageMode = false;
   if (options.link) {
     const parsed = parseMgpLink(options.link);
@@ -2400,6 +2620,7 @@ async function handleGetNodeForSpace(options) {
       process.exit(1);
     }
     pageUrl = parsed.pageUrl;
+    childNodeIds = parsed.childNodeIds;
     if (parsed.pageId) {
       isPageMode = true;
       pageId = parsed.pageId;
@@ -2438,10 +2659,13 @@ async function handleGetNodeForSpace(options) {
         pageUrl
       );
     } else {
+      const isMultiSelect = childNodeIds && childNodeIds.length > 0;
       const params = {
         nodeId,
         maxDepth,
-        includeInvisible
+        includeInvisible,
+        // 多选模式：传递 childNodeIds 进行过滤
+        ...isMultiSelect && { childNodeIds }
       };
       data = await client.requestWithRetry(
         "get_node_by_id" /* GET_NODE_BY_ID */,
@@ -3014,8 +3238,9 @@ async function handleVisualize(options) {
     console.error(`  \u9875\u9762\u94FE\u63A5: mgp://[mastergo_page_url]?pageId=[\u9875\u9762ID]`);
     process.exit(1);
   }
-  const { pageUrl, nodeId, pageId } = parsed;
+  const { pageUrl, nodeId, pageId, childNodeIds } = parsed;
   const isPageLink = !!pageId;
+  const isMultiSelect = childNodeIds && childNodeIds.length > 0;
   const client = new MGClient({
     noAutoStart: options.noAutoStart,
     noRetry: options.noRetry
@@ -3034,7 +3259,9 @@ async function handleVisualize(options) {
       const params = {
         nodeId,
         maxDepth: parseInt(options.maxDepth || "3", 10),
-        includeInvisible: false
+        includeInvisible: false,
+        // 多选模式：传递 childNodeIds 进行过滤
+        ...isMultiSelect && { childNodeIds }
       };
       data = await client.requestWithRetry("get_node_by_id" /* GET_NODE_BY_ID */, params, pageUrl);
     }