@hangox/mg-cli 1.0.2 → 1.0.4

package/dist/daemon-runner.js

@@ -2,8 +2,8 @@
 
 // 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";
@@ -64,6 +64,22 @@ function isProcessRunning(pid) {
     return false;
   }
 }
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) {
+    return `${days} \u5929 ${hours % 24} \u5C0F\u65F6`;
+  }
+  if (hours > 0) {
+    return `${hours} \u5C0F\u65F6 ${minutes % 60} \u5206\u949F`;
+  }
+  if (minutes > 0) {
+    return `${minutes} \u5206\u949F ${seconds % 60} \u79D2`;
+  }
+  return `${seconds} \u79D2`;
+}
 function generateId() {
   return `${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
 }
@@ -512,6 +528,41 @@ 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 possiblePaths = [
+      join2(currentDir, "..", "package.json"),
+      // dist/xxx.js -> ../package.json
+      join2(currentDir, "..", "..", "package.json")
+      // src/shared/version.ts -> ../../package.json
+    ];
+    for (const packageJsonPath of possiblePaths) {
+      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;
+  }
+}
+
 // src/server/websocket-server.ts
 var MGServer = class {
   wss = null;
@@ -520,6 +571,7 @@ var MGServer = class {
   requestHandler;
   port;
   isRunning = false;
+  startedAt = null;
   constructor(options = {}) {
     this.port = options.port || DEFAULT_PORT;
     this.logger = options.logger || createLogger();
@@ -539,6 +591,7 @@ var MGServer = class {
       this.wss.on("listening", () => {
         this.port = port2;
         this.isRunning = true;
+        this.startedAt = /* @__PURE__ */ new Date();
         this.logger.info(`Server \u542F\u52A8\u6210\u529F\uFF0C\u76D1\u542C\u7AEF\u53E3: ${port2}`);
         this.connectionManager.startHeartbeatCheck(HEARTBEAT_INTERVAL);
         resolve2(port2);
@@ -639,7 +692,8 @@ var MGServer = class {
       success: true,
       data: {
         connectionId: managedWs.connectionId,
-        pageUrl
+        pageUrl,
+        serverVersion: getVersion()
       }
     };
     ws.send(JSON.stringify(ack));
@@ -653,6 +707,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);
@@ -674,6 +731,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");
+  }
   /**
    * 停止服务器
    */
@@ -764,7 +852,8 @@ async function startServerForeground(port2) {
     writeServerInfo({
       port: actualPort,
       pid: process.pid,
-      startedAt: getCurrentISOTime()
+      startedAt: getCurrentISOTime(),
+      version: getVersion()
     });
     console.log(`
 MG Server \u542F\u52A8\u6210\u529F`);

package/dist/daemon-runner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/daemon.ts","../src/shared/utils.ts","../src/shared/constants.ts","../src/shared/errors.ts","../src/server/websocket-server.ts","../src/server/logger.ts","../src/server/connection-manager.ts","../src/server/request-handler.ts","../src/server/daemon-runner.ts"],"sourcesContent":["/**\n * 守护进程管理\n */\n\nimport { spawn, ChildProcess } from 'node:child_process'\nimport { fileURLToPath } from 'node:url'\nimport { dirname, join } from 'node:path'\nimport {\n  readServerInfo,\n  writeServerInfo,\n  deleteServerInfo,\n  isProcessRunning,\n  killProcess,\n  ensureConfigDir,\n  getCurrentISOTime,\n  formatDuration,\n} from '../shared/utils.js'\nimport { SERVER_START_TIMEOUT, DEFAULT_PORT } from '../shared/constants.js'\nimport { ErrorCode, MGError } from '../shared/errors.js'\nimport type { ServerInfo } from '../shared/types.js'\nimport { createServer } from './websocket-server.js'\nimport { createLogger, LogLevel } from './logger.js'\n\n/**\n * 检查 Server 是否在运行\n */\nexport function isServerRunning(): { running: boolean; info: ServerInfo | null } {\n  const info = readServerInfo()\n\n  if (!info) {\n    return { running: false, info: null }\n  }\n\n  // 检查进程是否存在\n  if (!isProcessRunning(info.pid)) {\n    // 进程不存在，清理旧文件\n    deleteServerInfo()\n    return { running: false, info: null }\n  }\n\n  return { running: true, info }\n}\n\n/**\n * 启动 Server（前台模式）\n */\nexport async function startServerForeground(port?: number): Promise<void> {\n  const { running, info } = isServerRunning()\n\n  if (running && info) {\n    throw new MGError(\n      ErrorCode.SERVER_ALREADY_RUNNING,\n      `Server 已在运行中 (PID: ${info.pid}, 端口: ${info.port})`\n    )\n  }\n\n  ensureConfigDir()\n\n  const logger = createLogger({\n    console: true,\n    file: true,\n    minLevel: LogLevel.INFO,\n  })\n\n  const server = createServer({\n    port: port || DEFAULT_PORT,\n    logger,\n  })\n\n  // 注册信号处理\n  const cleanup = async () => {\n    console.log('\\n正在停止 Server...')\n    await server.stop()\n    deleteServerInfo()\n    process.exit(0)\n  }\n\n  process.on('SIGINT', cleanup)\n  process.on('SIGTERM', cleanup)\n\n  try {\n    const actualPort = await server.start()\n\n    // 写入 Server 信息\n    writeServerInfo({\n      port: actualPort,\n      pid: process.pid,\n      startedAt: getCurrentISOTime(),\n    })\n\n    console.log(`\\nMG Server 启动成功`)\n    console.log(`监听端口: ${actualPort}`)\n    console.log(`进程 PID: ${process.pid}`)\n    console.log(`运行模式: 前台`)\n    console.log(`\\n按 Ctrl+C 停止...`)\n  } catch (error) {\n    logger.error('Server 启动失败:', error)\n    throw error\n  }\n}\n\n/**\n * 启动 Server（守护进程模式）\n */\nexport async function startServerDaemon(port?: number): Promise<ServerInfo> {\n  const { running, info } = isServerRunning()\n\n  if (running && info) {\n    throw new MGError(\n      ErrorCode.SERVER_ALREADY_RUNNING,\n      `Server 已在运行中 (PID: ${info.pid}, 端口: ${info.port})`\n    )\n  }\n\n  ensureConfigDir()\n\n  // 获取当前模块的路径\n  const currentFile = fileURLToPath(import.meta.url)\n  const currentDir = dirname(currentFile)\n  const serverScript = join(currentDir, 'daemon-runner.js')\n\n  // 启动子进程\n  const args = ['--foreground']\n  if (port) {\n    args.push('--port', String(port))\n  }\n\n  const child: ChildProcess = spawn(process.execPath, [serverScript, ...args], {\n    detached: true,\n    stdio: 'ignore',\n    env: {\n      ...process.env,\n      MG_DAEMON: '1',\n    },\n  })\n\n  child.unref()\n\n  // 等待 Server 启动\n  const startTime = Date.now()\n  while (Date.now() - startTime < SERVER_START_TIMEOUT) {\n    await new Promise((resolve) => setTimeout(resolve, 200))\n\n    const { running, info } = isServerRunning()\n    if (running && info) {\n      return info\n    }\n  }\n\n  throw new MGError(ErrorCode.SERVER_START_FAILED, 'Server 启动超时')\n}\n\n/**\n * 停止 Server\n */\nexport function stopServer(): { stopped: boolean; info: ServerInfo | null } {\n  const { running, info } = isServerRunning()\n\n  if (!running || !info) {\n    return { stopped: false, info: null }\n  }\n\n  // 终止进程\n  const killed = killProcess(info.pid)\n\n  if (killed) {\n    deleteServerInfo()\n  }\n\n  return { stopped: killed, info }\n}\n\n/**\n * 重启 Server\n */\nexport async function restartServer(port?: number): Promise<ServerInfo> {\n  const { info: oldInfo } = stopServer()\n\n  // 等待旧进程完全停止\n  await new Promise((resolve) => setTimeout(resolve, 500))\n\n  // 启动新 Server\n  return startServerDaemon(port || oldInfo?.port)\n}\n\n/**\n * 获取 Server 状态\n */\nexport function getServerStatus(): {\n  running: boolean\n  port?: number\n  pid?: number\n  startedAt?: string\n  uptime?: string\n} {\n  const { running, info } = isServerRunning()\n\n  if (!running || !info) {\n    return { running: false }\n  }\n\n  const uptimeMs = Date.now() - new Date(info.startedAt).getTime()\n\n  return {\n    running: true,\n    port: info.port,\n    pid: info.pid,\n    startedAt: info.startedAt,\n    uptime: formatDuration(uptimeMs),\n  }\n}\n","/**\n * MG Plugin 工具函数\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs'\nimport { dirname, resolve, isAbsolute } from 'node:path'\nimport { CONFIG_DIR, SERVER_INFO_FILE, LOG_DIR } from './constants.js'\nimport type { ServerInfo } from './types.js'\n\n// ==================== 文件操作 ====================\n\n/**\n * 确保目录存在\n */\nexport function ensureDir(dir: string): void {\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true })\n  }\n}\n\n/**\n * 确保配置目录存在\n */\nexport function ensureConfigDir(): void {\n  ensureDir(CONFIG_DIR)\n  ensureDir(LOG_DIR)\n}\n\n/**\n * 读取 Server 信息文件\n */\nexport function readServerInfo(): ServerInfo | null {\n  try {\n    if (!existsSync(SERVER_INFO_FILE)) {\n      return null\n    }\n    const content = readFileSync(SERVER_INFO_FILE, 'utf-8')\n    return JSON.parse(content) as ServerInfo\n  } catch {\n    return null\n  }\n}\n\n/**\n * 写入 Server 信息文件\n */\nexport function writeServerInfo(info: ServerInfo): void {\n  ensureConfigDir()\n  writeFileSync(SERVER_INFO_FILE, JSON.stringify(info, null, 2), 'utf-8')\n}\n\n/**\n * 删除 Server 信息文件\n */\nexport function deleteServerInfo(): void {\n  try {\n    if (existsSync(SERVER_INFO_FILE)) {\n      unlinkSync(SERVER_INFO_FILE)\n    }\n  } catch {\n    // 忽略删除错误\n  }\n}\n\n/**\n * 解析输出路径（支持相对路径和绝对路径）\n */\nexport function resolveOutputPath(outputPath: string): string {\n  if (isAbsolute(outputPath)) {\n    return outputPath\n  }\n  return resolve(process.cwd(), outputPath)\n}\n\n/**\n * 确保输出路径的目录存在\n */\nexport function ensureOutputDir(outputPath: string): void {\n  const dir = dirname(outputPath)\n  ensureDir(dir)\n}\n\n// ==================== 进程管理 ====================\n\n/**\n * 检查进程是否存在\n */\nexport function isProcessRunning(pid: number): boolean {\n  try {\n    // 发送信号 0 不会终止进程，但如果进程不存在会抛出错误\n    process.kill(pid, 0)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * 终止进程\n */\nexport function killProcess(pid: number): boolean {\n  try {\n    process.kill(pid, 'SIGTERM')\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ==================== URL 处理 ====================\n\n/**\n * 标准化页面 URL\n *\n * 输入: https://mastergo.netease.com/file/174135798361888?fileOpenFrom=home&page_id=0%3A8347\n * 输出: mastergo.netease.com/file/174135798361888\n */\nexport function normalizePageUrl(url: string): string {\n  try {\n    const urlObj = new URL(url)\n    // 返回 host + pathname，去掉 https:// 前缀和查询参数\n    return urlObj.host + urlObj.pathname\n  } catch {\n    // 如果已经是标准化的格式，直接返回\n    return url\n  }\n}\n\n/**\n * 检查是否是设计页面 URL\n */\nexport function isDesignPageUrl(url: string): boolean {\n  // 匹配 /file/数字 格式\n  return /\\/file\\/\\d+/.test(url)\n}\n\n/**\n * 解析 mgp:// 链接\n *\n * 支持的格式 (queryParams 格式，nodeId 需要 URL 编码):\n * - mgp://mastergo.netease.com/file/174135798361888?nodeId=123%3A456 (单个节点)\n * - mgp://mastergo.netease.com/file/174135798361888?nodeId=0%3A8633&nodePath=314%3A13190%2F0%3A8633 (带父节点路径)\n *\n * 输出: { pageUrl: 'mastergo.netease.com/file/174135798361888', nodeId: '0:8633', nodePath: ['314:13190', '0:8633'] }\n */\nexport function parseMgpLink(link: string): { pageUrl: string; nodeId: string; nodePath?: string[] } | null {\n  // 检查是否是 mgp:// 协议\n  if (!link.startsWith('mgp://')) {\n    return null\n  }\n\n  try {\n    // 移除 mgp:// 前缀，构造为可解析的 URL\n    const urlPart = link.slice(6) // 移除 'mgp://'\n    const questionMarkIndex = urlPart.indexOf('?')\n\n    if (questionMarkIndex === -1) {\n      // 没有查询参数，无效格式\n      return null\n    }\n\n    const pageUrl = urlPart.slice(0, questionMarkIndex)\n    const queryString = urlPart.slice(questionMarkIndex + 1)\n\n    // 解析查询参数\n    const params = new URLSearchParams(queryString)\n    const encodedNodeId = params.get('nodeId')\n\n    if (!encodedNodeId) {\n      return null\n    }\n\n    // 解码 nodeId\n    const nodeId = decodeURIComponent(encodedNodeId)\n\n    // 验证 nodeId 格式：支持单个节点 (数字:数字) 或带路径的格式 (数字:数字/数字:数字/...)\n    if (!/^(\\d+:\\d+)(\\/\\d+:\\d+)*$/.test(nodeId)) {\n      return null\n    }\n\n    // 解析可选的 nodePath\n    const encodedNodePath = params.get('nodePath')\n    let nodePath: string[] | undefined\n\n    if (encodedNodePath) {\n      const decodedNodePath = decodeURIComponent(encodedNodePath)\n      nodePath = decodedNodePath.split('/').filter(Boolean)\n      // 验证每个路径段的格式\n      if (!nodePath.every(segment => /^\\d+:\\d+$/.test(segment))) {\n        return null\n      }\n    }\n\n    return {\n      pageUrl,\n      nodeId,\n      nodePath,\n    }\n  } catch {\n    return null\n  }\n}\n\n/**\n * 生成 mgp:// 链接\n *\n * @param pageUrl 页面 URL（会被标准化）\n * @param nodeId 节点 ID（会被 URL 编码）\n * @param nodePath 可选的父节点路径（会被 URL 编码）\n */\nexport function generateMgpLink(pageUrl: string, nodeId: string, nodePath?: string[]): string {\n  const normalizedUrl = normalizePageUrl(pageUrl)\n  const encodedNodeId = encodeURIComponent(nodeId)\n\n  let link = `mgp://${normalizedUrl}?nodeId=${encodedNodeId}`\n\n  if (nodePath && nodePath.length > 0) {\n    const encodedNodePath = encodeURIComponent(nodePath.join('/'))\n    link += `&nodePath=${encodedNodePath}`\n  }\n\n  return link\n}\n\n// ==================== 输出格式化 ====================\n\n/**\n * 格式化文件大小\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes < 1024) {\n    return `${bytes} 字节`\n  }\n  const kb = bytes / 1024\n  if (kb < 1024) {\n    return `${kb.toFixed(2)} KB`\n  }\n  const mb = kb / 1024\n  return `${mb.toFixed(2)} MB`\n}\n\n/**\n * 格式化时间间隔\n */\nexport function formatDuration(ms: number): string {\n  const seconds = Math.floor(ms / 1000)\n  const minutes = Math.floor(seconds / 60)\n  const hours = Math.floor(minutes / 60)\n  const days = Math.floor(hours / 24)\n\n  if (days > 0) {\n    return `${days} 天 ${hours % 24} 小时`\n  }\n  if (hours > 0) {\n    return `${hours} 小时 ${minutes % 60} 分钟`\n  }\n  if (minutes > 0) {\n    return `${minutes} 分钟 ${seconds % 60} 秒`\n  }\n  return `${seconds} 秒`\n}\n\n/**\n * 生成唯一 ID\n */\nexport function generateId(): string {\n  return `${Date.now()}_${Math.random().toString(36).substring(2, 9)}`\n}\n\n/**\n * 获取当前时间的 ISO 格式字符串\n */\nexport function getCurrentISOTime(): string {\n  return new Date().toISOString()\n}\n\n/**\n * 格式化日期时间用于日志\n */\nexport function formatLogTime(date: Date = new Date()): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  const hours = String(date.getHours()).padStart(2, '0')\n  const minutes = String(date.getMinutes()).padStart(2, '0')\n  const seconds = String(date.getSeconds()).padStart(2, '0')\n  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`\n}\n\n// ==================== FileId 提取 ====================\n\n/**\n * 从完整 URL 提取 fileId\n * \n * 支持格式:\n * - https://mastergo.netease.com/file/174875497054651?page_id=321%3A11979\n * - mastergo.netease.com/file/174875497054651\n * \n * @returns fileId 或 null\n */\nexport function extractFileIdFromUrl(url: string): string | null {\n  // 匹配 /file/数字 格式\n  const match = url.match(/\\/file\\/(\\d+)/)\n  return match ? match[1] : null\n}\n\n/**\n * 从 mgp:// 链接提取 fileId\n * \n * 支持格式:\n * - mgp://mastergo.netease.com/file/174875497054651?nodeId=xxx\n * \n * @returns fileId 或 null\n */\nexport function extractFileIdFromMgpLink(link: string): string | null {\n  if (!link.startsWith('mgp://')) {\n    return null\n  }\n  return extractFileIdFromUrl(link)\n}\n\n/**\n * 统一处理输入，提取 fileId\n * \n * 支持三种输入格式:\n * 1. 完整 URL: https://mastergo.netease.com/file/174875497054651?page_id=xxx\n * 2. mgp 协议: mgp://mastergo.netease.com/file/174875497054651?nodeId=xxx\n * 3. 纯 fileId: 174875497054651\n * \n * @returns fileId 或 null\n */\nexport function extractFileId(input: string): string | null {\n  const trimmed = input.trim()\n  \n  // 1. 纯数字 fileId\n  if (/^\\d+$/.test(trimmed)) {\n    return trimmed\n  }\n  \n  // 2. mgp:// 协议\n  if (trimmed.startsWith('mgp://')) {\n    return extractFileIdFromMgpLink(trimmed)\n  }\n  \n  // 3. 完整 URL (http:// 或 https://)\n  if (trimmed.startsWith('http://') || trimmed.startsWith('https://')) {\n    return extractFileIdFromUrl(trimmed)\n  }\n  \n  // 4. 尝试作为不带协议的 URL 解析\n  return extractFileIdFromUrl(trimmed)\n}\n","/**\n * MG Plugin 常量定义\n */\n\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\n// ==================== 端口配置 ====================\n\n/** 默认端口 */\nexport const DEFAULT_PORT = 9527\n\n/** 端口范围：起始 */\nexport const PORT_RANGE_START = 9527\n\n/** 端口范围：结束 */\nexport const PORT_RANGE_END = 9536\n\n/** 最大尝试端口数 */\nexport const MAX_PORT_ATTEMPTS = 10\n\n/** 端口扫描超时（毫秒） */\nexport const PORT_SCAN_TIMEOUT = 500\n\n// ==================== 路径配置 ====================\n\n/** 配置目录 */\nexport const CONFIG_DIR = join(homedir(), '.mg-plugin')\n\n/** Server 状态文件 */\nexport const SERVER_INFO_FILE = join(CONFIG_DIR, 'server.json')\n\n/** 日志目录 */\nexport const LOG_DIR = join(CONFIG_DIR, 'logs')\n\n/** Server 日志文件 */\nexport const SERVER_LOG_FILE = join(LOG_DIR, 'server.log')\n\n// ==================== 超时配置 ====================\n\n/** 心跳间隔（毫秒）- 30 秒 */\nexport const HEARTBEAT_INTERVAL = 30000\n\n/** 心跳超时（毫秒）- 90 秒（3 次心跳） */\nexport const HEARTBEAT_TIMEOUT = 90000\n\n/** 请求超时（毫秒）- 30 秒 */\nexport const REQUEST_TIMEOUT = 30000\n\n/** Server 启动等待超时（毫秒）- 5 秒 */\nexport const SERVER_START_TIMEOUT = 5000\n\n/** CLI 重试间隔（毫秒） */\nexport const RETRY_INTERVALS = [1000, 2000, 4000]\n\n/** 最大重试次数 */\nexport const MAX_RETRY_COUNT = 3\n\n// ==================== 连接类型 ====================\n\n/** 连接类型 */\nexport enum ConnectionType {\n  /** 获取端 (CLI/MCP) */\n  CONSUMER = 'consumer',\n  /** 提供端 (Injector) */\n  PROVIDER = 'provider',\n}\n\n// ==================== 消息类型 ====================\n\n/** WebSocket 消息类型 */\nexport enum MessageType {\n  // 系统消息\n  PING = 'ping',\n  PONG = 'pong',\n  REGISTER = 'register',\n  REGISTER_ACK = 'register_ack',\n\n  // 业务消息\n  GET_NODE_BY_ID = 'get_node_by_id',\n  GET_ALL_NODES = 'get_all_nodes',\n  GET_SELECTION = 'get_selection',\n  EXPORT_IMAGE = 'export_image',\n  EXECUTE_CODE = 'execute_code',\n  GET_ALL_PAGES = 'get_all_pages',\n\n  // 响应\n  RESPONSE = 'response',\n  ERROR = 'error',\n}\n","/**\n * MG Plugin 错误码定义\n */\n\n/** 错误码枚举 */\nexport enum ErrorCode {\n  /** 无法连接到 MG Server */\n  CONNECTION_FAILED = 'E001',\n  /** 连接超时 */\n  CONNECTION_TIMEOUT = 'E002',\n  /** 没有 MasterGo 页面连接到 Server */\n  NO_PAGE_CONNECTED = 'E003',\n  /** 未找到匹配的页面 */\n  PAGE_NOT_FOUND = 'E004',\n  /** 节点不存在 */\n  NODE_NOT_FOUND = 'E005',\n  /** 没有选中任何节点 */\n  NO_SELECTION = 'E006',\n  /** mg 对象不可用 */\n  MG_UNAVAILABLE = 'E007',\n  /** 导出图片失败 */\n  EXPORT_FAILED = 'E008',\n  /** 文件写入失败 */\n  FILE_WRITE_FAILED = 'E009',\n  /** 无效的 mgp:// 链接格式 */\n  INVALID_LINK = 'E010',\n  /** 参数校验失败 */\n  INVALID_PARAMS = 'E011',\n  /** 请求超时 */\n  REQUEST_TIMEOUT = 'E012',\n  /** 所有备选端口均被占用 */\n  PORT_EXHAUSTED = 'E013',\n  /** 无法发现 Server (端口扫描失败) */\n  SERVER_DISCOVERY_FAILED = 'E014',\n  /** 自动启动 Server 失败 */\n  SERVER_START_FAILED = 'E015',\n  /** Server 已在运行中 */\n  SERVER_ALREADY_RUNNING = 'E016',\n  /** 连接断开 */\n  CONNECTION_LOST = 'E017',\n  /** 未知错误 */\n  UNKNOWN_ERROR = 'E099',\n}\n\n/** 错误码对应的错误名称 */\nexport const ErrorNames: Record<ErrorCode, string> = {\n  [ErrorCode.CONNECTION_FAILED]: 'CONNECTION_FAILED',\n  [ErrorCode.CONNECTION_TIMEOUT]: 'CONNECTION_TIMEOUT',\n  [ErrorCode.NO_PAGE_CONNECTED]: 'NO_PAGE_CONNECTED',\n  [ErrorCode.PAGE_NOT_FOUND]: 'PAGE_NOT_FOUND',\n  [ErrorCode.NODE_NOT_FOUND]: 'NODE_NOT_FOUND',\n  [ErrorCode.NO_SELECTION]: 'NO_SELECTION',\n  [ErrorCode.MG_UNAVAILABLE]: 'MG_UNAVAILABLE',\n  [ErrorCode.EXPORT_FAILED]: 'EXPORT_FAILED',\n  [ErrorCode.FILE_WRITE_FAILED]: 'FILE_WRITE_FAILED',\n  [ErrorCode.INVALID_LINK]: 'INVALID_LINK',\n  [ErrorCode.INVALID_PARAMS]: 'INVALID_PARAMS',\n  [ErrorCode.REQUEST_TIMEOUT]: 'REQUEST_TIMEOUT',\n  [ErrorCode.PORT_EXHAUSTED]: 'PORT_EXHAUSTED',\n  [ErrorCode.SERVER_DISCOVERY_FAILED]: 'SERVER_DISCOVERY_FAILED',\n  [ErrorCode.SERVER_START_FAILED]: 'SERVER_START_FAILED',\n  [ErrorCode.SERVER_ALREADY_RUNNING]: 'SERVER_ALREADY_RUNNING',\n  [ErrorCode.CONNECTION_LOST]: 'CONNECTION_LOST',\n  [ErrorCode.UNKNOWN_ERROR]: 'UNKNOWN_ERROR',\n}\n\n/** 错误码对应的默认消息 */\nexport const ErrorMessages: Record<ErrorCode, string> = {\n  [ErrorCode.CONNECTION_FAILED]: '无法连接到 MG Server',\n  [ErrorCode.CONNECTION_TIMEOUT]: '连接超时',\n  [ErrorCode.NO_PAGE_CONNECTED]: '没有 MasterGo 页面连接到 Server',\n  [ErrorCode.PAGE_NOT_FOUND]: '未找到匹配的页面',\n  [ErrorCode.NODE_NOT_FOUND]: '节点不存在',\n  [ErrorCode.NO_SELECTION]: '没有选中任何节点',\n  [ErrorCode.MG_UNAVAILABLE]: 'mg 对象不可用',\n  [ErrorCode.EXPORT_FAILED]: '导出图片失败',\n  [ErrorCode.FILE_WRITE_FAILED]: '文件写入失败',\n  [ErrorCode.INVALID_LINK]: '无效的 mgp:// 链接格式',\n  [ErrorCode.INVALID_PARAMS]: '参数校验失败',\n  [ErrorCode.REQUEST_TIMEOUT]: '请求超时',\n  [ErrorCode.PORT_EXHAUSTED]: '所有备选端口均被占用',\n  [ErrorCode.SERVER_DISCOVERY_FAILED]: '无法发现 Server (端口扫描失败)',\n  [ErrorCode.SERVER_START_FAILED]: '自动启动 Server 失败',\n  [ErrorCode.SERVER_ALREADY_RUNNING]: 'Server 已在运行中',\n  [ErrorCode.CONNECTION_LOST]: '连接断开',\n  [ErrorCode.UNKNOWN_ERROR]: '未知错误',\n}\n\n/** MG Plugin 错误类 */\nexport class MGError extends Error {\n  /** 错误码 */\n  code: ErrorCode\n  /** 错误名称 */\n  errorName: string\n  /** 额外详情 */\n  details?: Record<string, unknown>\n\n  constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>) {\n    super(message || ErrorMessages[code])\n    this.name = 'MGError'\n    this.code = code\n    this.errorName = ErrorNames[code]\n    this.details = details\n  }\n\n  /** 转换为 JSON 格式 */\n  toJSON() {\n    return {\n      code: this.code,\n      name: this.errorName,\n      message: this.message,\n      details: this.details,\n    }\n  }\n\n  /** 格式化输出 */\n  toString() {\n    return `错误 [${this.code}]: ${this.message}`\n  }\n}\n\n/**\n * 创建错误\n */\nexport function createError(\n  code: ErrorCode,\n  message?: string,\n  details?: Record<string, unknown>\n): MGError {\n  return new MGError(code, message, details)\n}\n","/**\n * WebSocket 服务器\n */\n\nimport { WebSocketServer, WebSocket } from 'ws'\nimport type { IncomingMessage } from 'node:http'\nimport {\n  ConnectionType,\n  MessageType,\n  DEFAULT_PORT,\n  PORT_RANGE_START,\n  PORT_RANGE_END,\n  HEARTBEAT_INTERVAL,\n} from '../shared/constants.js'\nimport { ErrorCode, MGError } from '../shared/errors.js'\nimport type { BaseMessage, RegisterMessage, ResponseMessage } from '../shared/types.js'\nimport { Logger, createLogger } from './logger.js'\nimport { ConnectionManager, ManagedWebSocket } from './connection-manager.js'\nimport { RequestHandler } from './request-handler.js'\n\nexport interface ServerOptions {\n  /** 监听端口 */\n  port?: number\n  /** 日志选项 */\n  logger?: Logger\n}\n\n/**\n * MG WebSocket 服务器\n */\nexport class MGServer {\n  private wss: WebSocketServer | null = null\n  private logger: Logger\n  private connectionManager: ConnectionManager\n  private requestHandler: RequestHandler\n\n  private port: number\n  private isRunning = false\n\n  constructor(options: ServerOptions = {}) {\n    this.port = options.port || DEFAULT_PORT\n    this.logger = options.logger || createLogger()\n    this.connectionManager = new ConnectionManager(this.logger)\n    this.requestHandler = new RequestHandler(this.connectionManager, this.logger)\n  }\n\n  /**\n   * 启动服务器\n   */\n  async start(): Promise<number> {\n    if (this.isRunning) {\n      throw new MGError(ErrorCode.SERVER_ALREADY_RUNNING, 'Server 已在运行中')\n    }\n\n    // 尝试绑定端口\n    const port = await this.findAvailablePort()\n\n    return new Promise((resolve, reject) => {\n      this.wss = new WebSocketServer({ port })\n\n      this.wss.on('listening', () => {\n        this.port = port\n        this.isRunning = true\n        this.logger.info(`Server 启动成功，监听端口: ${port}`)\n\n        // 启动心跳检查\n        this.connectionManager.startHeartbeatCheck(HEARTBEAT_INTERVAL)\n\n        resolve(port)\n      })\n\n      this.wss.on('error', (error: NodeJS.ErrnoException) => {\n        this.logger.error('Server 错误:', error)\n        reject(error)\n      })\n\n      this.wss.on('connection', (ws: WebSocket, request: IncomingMessage) => {\n        this.handleConnection(ws, request)\n      })\n    })\n  }\n\n  /**\n   * 查找可用端口\n   */\n  private async findAvailablePort(): Promise<number> {\n    for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port++) {\n      const available = await this.isPortAvailable(port)\n      if (available) {\n        return port\n      }\n      this.logger.debug(`端口 ${port} 被占用，尝试下一个`)\n    }\n\n    throw new MGError(\n      ErrorCode.PORT_EXHAUSTED,\n      `端口 ${PORT_RANGE_START}-${PORT_RANGE_END} 均被占用`\n    )\n  }\n\n  /**\n   * 检查端口是否可用\n   */\n  private isPortAvailable(port: number): Promise<boolean> {\n    return new Promise((resolve) => {\n      const testServer = new WebSocketServer({ port })\n\n      testServer.on('listening', () => {\n        testServer.close()\n        resolve(true)\n      })\n\n      testServer.on('error', () => {\n        resolve(false)\n      })\n    })\n  }\n\n  /**\n   * 处理新连接\n   */\n  private handleConnection(ws: WebSocket, _request: IncomingMessage): void {\n    this.logger.info('新连接建立')\n\n    // 等待注册消息\n    const registerTimeout = setTimeout(() => {\n      this.logger.warn('连接注册超时，关闭连接')\n      ws.close()\n    }, 5000)\n\n    ws.on('message', (data) => {\n      try {\n        const message = JSON.parse(data.toString()) as BaseMessage\n\n        // 处理注册消息\n        if (message.type === MessageType.REGISTER) {\n          clearTimeout(registerTimeout)\n          this.handleRegister(ws, message as RegisterMessage)\n          return\n        }\n\n        // 其他消息需要已注册\n        const managedWs = ws as ManagedWebSocket\n        if (!managedWs.connectionId) {\n          this.logger.warn('未注册的连接发送消息，忽略')\n          return\n        }\n\n        this.handleMessage(managedWs, message)\n      } catch (error) {\n        this.logger.error('消息解析失败:', error)\n      }\n    })\n\n    ws.on('close', () => {\n      clearTimeout(registerTimeout)\n      const managedWs = ws as ManagedWebSocket\n      if (managedWs.connectionId) {\n        this.requestHandler.cleanupConnectionRequests(managedWs.connectionId)\n        this.connectionManager.removeConnection(managedWs)\n      }\n    })\n\n    ws.on('error', (error) => {\n      this.logger.error('WebSocket 错误:', error)\n    })\n  }\n\n  /**\n   * 处理注册消息\n   */\n  private handleRegister(ws: WebSocket, message: RegisterMessage): void {\n    const { connectionType, pageUrl, pageId } = message.data\n\n    const managedWs = this.connectionManager.addConnection(\n      ws,\n      connectionType,\n      pageUrl,\n      pageId\n    )\n\n    // 发送注册确认\n    const ack: ResponseMessage = {\n      id: message.id || '',\n      type: MessageType.REGISTER_ACK,\n      success: true,\n      data: {\n        connectionId: managedWs.connectionId,\n        pageUrl,\n      },\n    }\n\n    ws.send(JSON.stringify(ack))\n  }\n\n  /**\n   * 处理消息\n   */\n  private handleMessage(ws: ManagedWebSocket, message: BaseMessage): void {\n    this.connectionManager.updateLastActive(ws)\n\n    switch (message.type) {\n      case MessageType.PING:\n        this.handlePing(ws, message)\n        break\n\n      case MessageType.RESPONSE:\n      case MessageType.ERROR:\n        // Provider 返回的响应\n        this.requestHandler.handleResponse(message as ResponseMessage)\n        break\n\n      default:\n        // Consumer 发送的请求\n        if (ws.connectionInfo.type === ConnectionType.CONSUMER) {\n          this.requestHandler.handleRequest(ws, message as any)\n        }\n        break\n    }\n  }\n\n  /**\n   * 处理心跳\n   */\n  private handlePing(ws: ManagedWebSocket, message: BaseMessage): void {\n    const pong = {\n      type: MessageType.PONG,\n      timestamp: (message as any).timestamp || Date.now(),\n    }\n    ws.send(JSON.stringify(pong))\n  }\n\n  /**\n   * 停止服务器\n   */\n  async stop(): Promise<void> {\n    if (!this.isRunning || !this.wss) {\n      return\n    }\n\n    this.logger.info('正在停止 Server...')\n\n    // 清理所有请求\n    this.requestHandler.cleanupAll()\n\n    // 关闭所有连接\n    this.connectionManager.closeAll()\n\n    // 关闭服务器\n    return new Promise((resolve) => {\n      this.wss!.close(() => {\n        this.isRunning = false\n        this.wss = null\n        this.logger.info('Server 已停止')\n        resolve()\n      })\n    })\n  }\n\n  /**\n   * 获取运行状态\n   */\n  getStatus(): {\n    running: boolean\n    port: number\n    stats: { providers: number; consumers: number; total: number }\n    connectedPages: string[]\n  } {\n    return {\n      running: this.isRunning,\n      port: this.port,\n      stats: this.connectionManager.getStats(),\n      connectedPages: this.connectionManager.getConnectedPageUrls(),\n    }\n  }\n\n  /**\n   * 获取端口\n   */\n  getPort(): number {\n    return this.port\n  }\n\n  /**\n   * 是否运行中\n   */\n  isServerRunning(): boolean {\n    return this.isRunning\n  }\n}\n\n/**\n * 创建服务器实例\n */\nexport function createServer(options?: ServerOptions): MGServer {\n  return new MGServer(options)\n}\n","/**\n * 日志模块\n */\n\nimport { appendFileSync, existsSync, mkdirSync } from 'node:fs'\nimport { dirname } from 'node:path'\nimport { SERVER_LOG_FILE } from '../shared/constants.js'\nimport { formatLogTime } from '../shared/utils.js'\n\nexport enum LogLevel {\n  DEBUG = 'DEBUG',\n  INFO = 'INFO',\n  WARN = 'WARN',\n  ERROR = 'ERROR',\n}\n\nexport interface LoggerOptions {\n  /** 是否输出到控制台 */\n  console?: boolean\n  /** 是否输出到文件 */\n  file?: boolean\n  /** 日志文件路径 */\n  filePath?: string\n  /** 最小日志级别 */\n  minLevel?: LogLevel\n}\n\nconst levelPriority: Record<LogLevel, number> = {\n  [LogLevel.DEBUG]: 0,\n  [LogLevel.INFO]: 1,\n  [LogLevel.WARN]: 2,\n  [LogLevel.ERROR]: 3,\n}\n\n/**\n * 日志记录器\n */\nexport class Logger {\n  private options: Required<LoggerOptions>\n\n  constructor(options: LoggerOptions = {}) {\n    this.options = {\n      console: options.console ?? true,\n      file: options.file ?? false,\n      filePath: options.filePath ?? SERVER_LOG_FILE,\n      minLevel: options.minLevel ?? LogLevel.INFO,\n    }\n\n    // 确保日志目录存在\n    if (this.options.file) {\n      const dir = dirname(this.options.filePath)\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true })\n      }\n    }\n  }\n\n  /**\n   * 记录日志\n   */\n  private log(level: LogLevel, message: string, ...args: unknown[]): void {\n    // 检查日志级别\n    if (levelPriority[level] < levelPriority[this.options.minLevel]) {\n      return\n    }\n\n    const timestamp = formatLogTime()\n    const formattedMessage = `[${timestamp}] [${level}] ${message}`\n\n    // 输出到控制台\n    if (this.options.console) {\n      const consoleMethod = level === LogLevel.ERROR ? console.error : console.log\n      if (args.length > 0) {\n        consoleMethod(formattedMessage, ...args)\n      } else {\n        consoleMethod(formattedMessage)\n      }\n    }\n\n    // 输出到文件\n    if (this.options.file) {\n      try {\n        const fileMessage =\n          args.length > 0\n            ? `${formattedMessage} ${JSON.stringify(args)}\\n`\n            : `${formattedMessage}\\n`\n        appendFileSync(this.options.filePath, fileMessage)\n      } catch (error) {\n        // 文件写入失败时静默处理\n        if (this.options.console) {\n          console.error('日志文件写入失败:', error)\n        }\n      }\n    }\n  }\n\n  debug(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.DEBUG, message, ...args)\n  }\n\n  info(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.INFO, message, ...args)\n  }\n\n  warn(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.WARN, message, ...args)\n  }\n\n  error(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.ERROR, message, ...args)\n  }\n}\n\n/** 创建默认日志记录器 */\nexport function createLogger(options?: LoggerOptions): Logger {\n  return new Logger(options)\n}\n","/**\n * 连接管理器\n * 管理 Provider 和 Consumer 的 WebSocket 连接\n */\n\nimport type { WebSocket } from 'ws'\nimport { ConnectionType, HEARTBEAT_TIMEOUT } from '../shared/constants.js'\nimport type { ConnectionInfo } from '../shared/types.js'\nimport { generateId } from '../shared/utils.js'\nimport { Logger } from './logger.js'\n\n/** 带连接信息的 WebSocket */\nexport interface ManagedWebSocket extends WebSocket {\n  /** 连接 ID */\n  connectionId: string\n  /** 连接信息 */\n  connectionInfo: ConnectionInfo\n  /** 是否存活 */\n  isAlive: boolean\n}\n\n/**\n * 连接管理器\n */\nexport class ConnectionManager {\n  private logger: Logger\n\n  /** Provider 连接（按页面 URL 索引） */\n  private providers = new Map<string, ManagedWebSocket>()\n\n  /** Consumer 连接 */\n  private consumers = new Map<string, ManagedWebSocket>()\n\n  /** 所有连接（按 ID 索引） */\n  private allConnections = new Map<string, ManagedWebSocket>()\n\n  /** 心跳检查定时器 */\n  private heartbeatTimer: NodeJS.Timeout | null = null\n\n  constructor(logger: Logger) {\n    this.logger = logger\n  }\n\n  /**\n   * 启动心跳检查\n   */\n  startHeartbeatCheck(interval: number = 30000): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n    }\n\n    this.heartbeatTimer = setInterval(() => {\n      this.checkHeartbeats()\n    }, interval)\n  }\n\n  /**\n   * 停止心跳检查\n   */\n  stopHeartbeatCheck(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n      this.heartbeatTimer = null\n    }\n  }\n\n  /**\n   * 检查所有连接的心跳\n   */\n  private checkHeartbeats(): void {\n    const now = Date.now()\n\n    for (const [id, ws] of this.allConnections) {\n      const lastActive = ws.connectionInfo.lastActiveAt.getTime()\n      const elapsed = now - lastActive\n\n      if (elapsed > HEARTBEAT_TIMEOUT) {\n        this.logger.warn(`连接 ${id} 心跳超时，关闭连接`)\n        this.removeConnection(ws)\n        ws.terminate()\n      }\n    }\n  }\n\n  /**\n   * 添加连接\n   */\n  addConnection(\n    ws: WebSocket,\n    type: ConnectionType,\n    pageUrl?: string,\n    pageId?: string\n  ): ManagedWebSocket {\n    const connectionId = generateId()\n    const now = new Date()\n\n    const connectionInfo: ConnectionInfo = {\n      id: connectionId,\n      type,\n      pageUrl,\n      pageId,\n      connectedAt: now,\n      lastActiveAt: now,\n    }\n\n    const managedWs = ws as ManagedWebSocket\n    managedWs.connectionId = connectionId\n    managedWs.connectionInfo = connectionInfo\n    managedWs.isAlive = true\n\n    this.allConnections.set(connectionId, managedWs)\n\n    if (type === ConnectionType.PROVIDER && pageUrl) {\n      // 如果已有同页面的连接，先移除旧的\n      const existing = this.providers.get(pageUrl)\n      if (existing) {\n        this.logger.info(`页面 ${pageUrl} 已有连接，替换为新连接`)\n        this.removeConnection(existing)\n        existing.close()\n      }\n      this.providers.set(pageUrl, managedWs)\n      this.logger.info(`Provider 连接: ${pageUrl}`)\n    } else if (type === ConnectionType.CONSUMER) {\n      this.consumers.set(connectionId, managedWs)\n      this.logger.info(`Consumer 连接: ${connectionId}`)\n    }\n\n    return managedWs\n  }\n\n  /**\n   * 移除连接\n   */\n  removeConnection(ws: ManagedWebSocket): void {\n    const { connectionId, connectionInfo } = ws\n\n    this.allConnections.delete(connectionId)\n\n    if (connectionInfo.type === ConnectionType.PROVIDER && connectionInfo.pageUrl) {\n      this.providers.delete(connectionInfo.pageUrl)\n      this.logger.info(`Provider 断开: ${connectionInfo.pageUrl}`)\n    } else if (connectionInfo.type === ConnectionType.CONSUMER) {\n      this.consumers.delete(connectionId)\n      this.logger.info(`Consumer 断开: ${connectionId}`)\n    }\n  }\n\n  /**\n   * 更新连接活跃时间\n   */\n  updateLastActive(ws: ManagedWebSocket): void {\n    ws.connectionInfo.lastActiveAt = new Date()\n    ws.isAlive = true\n  }\n\n  /**\n   * 根据页面 URL 查找 Provider\n   */\n  findProviderByPageUrl(pageUrl: string): ManagedWebSocket | undefined {\n    return this.providers.get(pageUrl)\n  }\n\n  /**\n   * 获取第一个可用的 Provider\n   */\n  getFirstProvider(): ManagedWebSocket | undefined {\n    const iterator = this.providers.values()\n    const first = iterator.next()\n    return first.value\n  }\n\n  /**\n   * 获取所有 Provider 信息\n   */\n  getAllProviders(): ConnectionInfo[] {\n    return Array.from(this.providers.values()).map((ws) => ws.connectionInfo)\n  }\n\n  /**\n   * 获取连接统计\n   */\n  getStats(): { providers: number; consumers: number; total: number } {\n    return {\n      providers: this.providers.size,\n      consumers: this.consumers.size,\n      total: this.allConnections.size,\n    }\n  }\n\n  /**\n   * 获取所有已连接的页面 URL\n   */\n  getConnectedPageUrls(): string[] {\n    return Array.from(this.providers.keys())\n  }\n\n  /**\n   * 关闭所有连接\n   */\n  closeAll(): void {\n    this.stopHeartbeatCheck()\n\n    for (const ws of this.allConnections.values()) {\n      ws.close()\n    }\n\n    this.providers.clear()\n    this.consumers.clear()\n    this.allConnections.clear()\n  }\n}\n","/**\n * 请求处理器\n * 处理 Consumer 请求，转发给 Provider\n */\n\nimport type { ManagedWebSocket } from './connection-manager.js'\nimport { ConnectionManager } from './connection-manager.js'\nimport { Logger } from './logger.js'\nimport { MessageType, REQUEST_TIMEOUT } from '../shared/constants.js'\nimport { ErrorCode, MGError } from '../shared/errors.js'\nimport type { RequestMessage, ResponseMessage } from '../shared/types.js'\nimport { generateId } from '../shared/utils.js'\n\n/** 待处理的请求 */\ninterface PendingRequest {\n  /** 请求 ID */\n  id: string\n  /** Consumer WebSocket */\n  consumer: ManagedWebSocket\n  /** 超时定时器 */\n  timer: NodeJS.Timeout\n  /** 请求时间 */\n  timestamp: number\n}\n\n/**\n * 请求处理器\n */\nexport class RequestHandler {\n  private logger: Logger\n  private connectionManager: ConnectionManager\n\n  /** 待处理的请求 */\n  private pendingRequests = new Map<string, PendingRequest>()\n\n  constructor(connectionManager: ConnectionManager, logger: Logger) {\n    this.connectionManager = connectionManager\n    this.logger = logger\n  }\n\n  /**\n   * 处理 Consumer 请求\n   */\n  async handleRequest(consumer: ManagedWebSocket, message: RequestMessage): Promise<void> {\n    const requestId = message.id || generateId()\n    const { type, pageUrl, params } = message\n\n    this.logger.info(`收到请求: ${type} (${requestId})`, { pageUrl })\n\n    // 查找目标 Provider\n    let provider: ManagedWebSocket | undefined\n\n    if (pageUrl) {\n      provider = this.connectionManager.findProviderByPageUrl(pageUrl)\n      if (!provider) {\n        this.sendError(consumer, requestId, ErrorCode.PAGE_NOT_FOUND, `未找到页面: ${pageUrl}`)\n        return\n      }\n    } else {\n      // 没有指定 pageUrl，使用第一个可用的 Provider\n      provider = this.connectionManager.getFirstProvider()\n      if (!provider) {\n        this.sendError(consumer, requestId, ErrorCode.NO_PAGE_CONNECTED, '没有页面连接到 Server')\n        return\n      }\n    }\n\n    // 创建超时定时器\n    const timer = setTimeout(() => {\n      this.handleTimeout(requestId)\n    }, REQUEST_TIMEOUT)\n\n    // 保存待处理请求\n    this.pendingRequests.set(requestId, {\n      id: requestId,\n      consumer,\n      timer,\n      timestamp: Date.now(),\n    })\n\n    // 转发请求给 Provider\n    const forwardMessage: RequestMessage = {\n      id: requestId,\n      type,\n      pageUrl: pageUrl || provider.connectionInfo.pageUrl,\n      params,\n      timestamp: Date.now(),\n    }\n\n    try {\n      provider.send(JSON.stringify(forwardMessage))\n      this.logger.info(`请求转发: ${type} -> ${provider.connectionInfo.pageUrl}`)\n    } catch {\n      this.cleanupRequest(requestId)\n      this.sendError(consumer, requestId, ErrorCode.CONNECTION_FAILED, '转发请求失败')\n    }\n  }\n\n  /**\n   * 处理 Provider 响应\n   */\n  handleResponse(response: ResponseMessage): void {\n    const { id } = response\n    const pending = this.pendingRequests.get(id)\n\n    if (!pending) {\n      this.logger.warn(`收到未知请求的响应: ${id}`)\n      return\n    }\n\n    this.cleanupRequest(id)\n\n    // 转发响应给 Consumer\n    try {\n      pending.consumer.send(JSON.stringify(response))\n      this.logger.info(\n        `响应返回: ${id} (${response.success ? '成功' : '失败'})`\n      )\n    } catch (error) {\n      this.logger.error(`响应转发失败: ${id}`, error)\n    }\n  }\n\n  /**\n   * 处理请求超时\n   */\n  private handleTimeout(requestId: string): void {\n    const pending = this.pendingRequests.get(requestId)\n    if (!pending) return\n\n    this.logger.warn(`请求超时: ${requestId}`)\n    this.cleanupRequest(requestId)\n\n    this.sendError(pending.consumer, requestId, ErrorCode.REQUEST_TIMEOUT, '请求超时')\n  }\n\n  /**\n   * 清理请求\n   */\n  private cleanupRequest(requestId: string): void {\n    const pending = this.pendingRequests.get(requestId)\n    if (pending) {\n      clearTimeout(pending.timer)\n      this.pendingRequests.delete(requestId)\n    }\n  }\n\n  /**\n   * 发送错误响应\n   */\n  private sendError(\n    consumer: ManagedWebSocket,\n    requestId: string,\n    code: ErrorCode,\n    message: string\n  ): void {\n    const error = new MGError(code, message)\n    const response: ResponseMessage = {\n      id: requestId,\n      type: MessageType.ERROR,\n      success: false,\n      data: null,\n      error: error.toJSON(),\n    }\n\n    try {\n      consumer.send(JSON.stringify(response))\n    } catch (err) {\n      this.logger.error(`发送错误响应失败: ${requestId}`, err)\n    }\n  }\n\n  /**\n   * 清理特定连接的所有待处理请求\n   */\n  cleanupConnectionRequests(connectionId: string): void {\n    for (const [requestId, pending] of this.pendingRequests) {\n      if (pending.consumer.connectionId === connectionId) {\n        this.cleanupRequest(requestId)\n      }\n    }\n  }\n\n  /**\n   * 清理所有待处理请求\n   */\n  cleanupAll(): void {\n    for (const [requestId] of this.pendingRequests) {\n      this.cleanupRequest(requestId)\n    }\n  }\n}\n","/**\n * 守护进程启动脚本\n * 这个脚本被 daemon.ts 作为子进程启动\n */\n\nimport { startServerForeground } from './daemon.js'\n\n// 解析命令行参数\nconst args = process.argv.slice(2)\nlet port: number | undefined\n\nfor (let i = 0; i < args.length; i++) {\n  if (args[i] === '--port' && args[i + 1]) {\n    port = parseInt(args[i + 1], 10)\n  }\n}\n\n// 启动 Server\nstartServerForeground(port).catch((error) => {\n  console.error('守护进程启动失败:', error)\n  process.exit(1)\n})\n"],"mappings":"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","names":["dirname","join","existsSync","mkdirSync","dirname","dirname","existsSync","mkdirSync","args","port","resolve","port"]}
+{"version":3,"sources":["../src/server/daemon.ts","../src/shared/utils.ts","../src/shared/constants.ts","../src/shared/errors.ts","../src/server/websocket-server.ts","../src/server/logger.ts","../src/server/connection-manager.ts","../src/server/request-handler.ts","../src/shared/version.ts","../src/server/daemon-runner.ts"],"sourcesContent":["/**\n * 守护进程管理\n */\n\nimport { spawn, ChildProcess } from 'node:child_process'\nimport { fileURLToPath } from 'node:url'\nimport { dirname, join } from 'node:path'\nimport {\n  readServerInfo,\n  writeServerInfo,\n  deleteServerInfo,\n  isProcessRunning,\n  killProcess,\n  ensureConfigDir,\n  getCurrentISOTime,\n  formatDuration,\n} from '../shared/utils.js'\nimport { SERVER_START_TIMEOUT, DEFAULT_PORT } from '../shared/constants.js'\nimport { ErrorCode, MGError } from '../shared/errors.js'\nimport type { ServerInfo } from '../shared/types.js'\nimport { createServer } from './websocket-server.js'\nimport { createLogger, LogLevel } from './logger.js'\nimport { getVersion } from '../shared/version.js'\n\n/**\n * 检查 Server 是否在运行\n */\nexport function isServerRunning(): { running: boolean; info: ServerInfo | null } {\n  const info = readServerInfo()\n\n  if (!info) {\n    return { running: false, info: null }\n  }\n\n  // 检查进程是否存在\n  if (!isProcessRunning(info.pid)) {\n    // 进程不存在，清理旧文件\n    deleteServerInfo()\n    return { running: false, info: null }\n  }\n\n  return { running: true, info }\n}\n\n/**\n * 启动 Server（前台模式）\n */\nexport async function startServerForeground(port?: number): Promise<void> {\n  const { running, info } = isServerRunning()\n\n  if (running && info) {\n    throw new MGError(\n      ErrorCode.SERVER_ALREADY_RUNNING,\n      `Server 已在运行中 (PID: ${info.pid}, 端口: ${info.port})`\n    )\n  }\n\n  ensureConfigDir()\n\n  const logger = createLogger({\n    console: true,\n    file: true,\n    minLevel: LogLevel.INFO,\n  })\n\n  const server = createServer({\n    port: port || DEFAULT_PORT,\n    logger,\n  })\n\n  // 注册信号处理\n  const cleanup = async () => {\n    console.log('\\n正在停止 Server...')\n    await server.stop()\n    deleteServerInfo()\n    process.exit(0)\n  }\n\n  process.on('SIGINT', cleanup)\n  process.on('SIGTERM', cleanup)\n\n  try {\n    const actualPort = await server.start()\n\n    // 写入 Server 信息（包含版本号）\n    writeServerInfo({\n      port: actualPort,\n      pid: process.pid,\n      startedAt: getCurrentISOTime(),\n      version: getVersion(),\n    })\n\n    console.log(`\\nMG Server 启动成功`)\n    console.log(`监听端口: ${actualPort}`)\n    console.log(`进程 PID: ${process.pid}`)\n    console.log(`运行模式: 前台`)\n    console.log(`\\n按 Ctrl+C 停止...`)\n  } catch (error) {\n    logger.error('Server 启动失败:', error)\n    throw error\n  }\n}\n\n/**\n * 启动 Server（守护进程模式）\n */\nexport async function startServerDaemon(port?: number): Promise<ServerInfo> {\n  const { running, info } = isServerRunning()\n\n  if (running && info) {\n    throw new MGError(\n      ErrorCode.SERVER_ALREADY_RUNNING,\n      `Server 已在运行中 (PID: ${info.pid}, 端口: ${info.port})`\n    )\n  }\n\n  ensureConfigDir()\n\n  // 获取当前模块的路径\n  const currentFile = fileURLToPath(import.meta.url)\n  const currentDir = dirname(currentFile)\n  const serverScript = join(currentDir, 'daemon-runner.js')\n\n  // 启动子进程\n  const args = ['--foreground']\n  if (port) {\n    args.push('--port', String(port))\n  }\n\n  const child: ChildProcess = spawn(process.execPath, [serverScript, ...args], {\n    detached: true,\n    stdio: 'ignore',\n    env: {\n      ...process.env,\n      MG_DAEMON: '1',\n    },\n  })\n\n  child.unref()\n\n  // 等待 Server 启动\n  const startTime = Date.now()\n  while (Date.now() - startTime < SERVER_START_TIMEOUT) {\n    await new Promise((resolve) => setTimeout(resolve, 200))\n\n    const { running, info } = isServerRunning()\n    if (running && info) {\n      return info\n    }\n  }\n\n  throw new MGError(ErrorCode.SERVER_START_FAILED, 'Server 启动超时')\n}\n\n/**\n * 停止 Server\n */\nexport function stopServer(): { stopped: boolean; info: ServerInfo | null } {\n  const { running, info } = isServerRunning()\n\n  if (!running || !info) {\n    return { stopped: false, info: null }\n  }\n\n  // 终止进程\n  const killed = killProcess(info.pid)\n\n  if (killed) {\n    deleteServerInfo()\n  }\n\n  return { stopped: killed, info }\n}\n\n/**\n * 重启 Server\n */\nexport async function restartServer(port?: number): Promise<ServerInfo> {\n  const { info: oldInfo } = stopServer()\n\n  // 等待旧进程完全停止\n  await new Promise((resolve) => setTimeout(resolve, 500))\n\n  // 启动新 Server\n  return startServerDaemon(port || oldInfo?.port)\n}\n\n/**\n * 获取 Server 状态\n */\nexport function getServerStatus(): {\n  running: boolean\n  port?: number\n  pid?: number\n  startedAt?: string\n  uptime?: string\n  version?: string\n} {\n  const { running, info } = isServerRunning()\n\n  if (!running || !info) {\n    return { running: false }\n  }\n\n  const uptimeMs = Date.now() - new Date(info.startedAt).getTime()\n\n  return {\n    running: true,\n    port: info.port,\n    pid: info.pid,\n    startedAt: info.startedAt,\n    uptime: formatDuration(uptimeMs),\n    version: info.version,\n  }\n}\n","/**\n * MG Plugin 工具函数\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs'\nimport { dirname, resolve, isAbsolute } from 'node:path'\nimport { CONFIG_DIR, SERVER_INFO_FILE, LOG_DIR } from './constants.js'\nimport type { ServerInfo, SpaceNodeInfo, NodeInfo } from './types.js'\n\n// ==================== 文件操作 ====================\n\n/**\n * 确保目录存在\n */\nexport function ensureDir(dir: string): void {\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true })\n  }\n}\n\n/**\n * 确保配置目录存在\n */\nexport function ensureConfigDir(): void {\n  ensureDir(CONFIG_DIR)\n  ensureDir(LOG_DIR)\n}\n\n/**\n * 读取 Server 信息文件\n */\nexport function readServerInfo(): ServerInfo | null {\n  try {\n    if (!existsSync(SERVER_INFO_FILE)) {\n      return null\n    }\n    const content = readFileSync(SERVER_INFO_FILE, 'utf-8')\n    return JSON.parse(content) as ServerInfo\n  } catch {\n    return null\n  }\n}\n\n/**\n * 写入 Server 信息文件\n */\nexport function writeServerInfo(info: ServerInfo): void {\n  ensureConfigDir()\n  writeFileSync(SERVER_INFO_FILE, JSON.stringify(info, null, 2), 'utf-8')\n}\n\n/**\n * 删除 Server 信息文件\n */\nexport function deleteServerInfo(): void {\n  try {\n    if (existsSync(SERVER_INFO_FILE)) {\n      unlinkSync(SERVER_INFO_FILE)\n    }\n  } catch {\n    // 忽略删除错误\n  }\n}\n\n/**\n * 解析输出路径（支持相对路径和绝对路径）\n */\nexport function resolveOutputPath(outputPath: string): string {\n  if (isAbsolute(outputPath)) {\n    return outputPath\n  }\n  return resolve(process.cwd(), outputPath)\n}\n\n/**\n * 确保输出路径的目录存在\n */\nexport function ensureOutputDir(outputPath: string): void {\n  const dir = dirname(outputPath)\n  ensureDir(dir)\n}\n\n// ==================== 进程管理 ====================\n\n/**\n * 检查进程是否存在\n */\nexport function isProcessRunning(pid: number): boolean {\n  try {\n    // 发送信号 0 不会终止进程，但如果进程不存在会抛出错误\n    process.kill(pid, 0)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * 终止进程\n */\nexport function killProcess(pid: number): boolean {\n  try {\n    process.kill(pid, 'SIGTERM')\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ==================== URL 处理 ====================\n\n/**\n * 标准化页面 URL\n *\n * 输入: https://mastergo.netease.com/file/174135798361888?fileOpenFrom=home&page_id=0%3A8347\n * 输出: mastergo.netease.com/file/174135798361888\n */\nexport function normalizePageUrl(url: string): string {\n  try {\n    const urlObj = new URL(url)\n    // 返回 host + pathname，去掉 https:// 前缀和查询参数\n    return urlObj.host + urlObj.pathname\n  } catch {\n    // 如果已经是标准化的格式，直接返回\n    return url\n  }\n}\n\n/**\n * 检查是否是设计页面 URL\n */\nexport function isDesignPageUrl(url: string): boolean {\n  // 匹配 /file/数字 格式\n  return /\\/file\\/\\d+/.test(url)\n}\n\n/**\n * 解析 mgp:// 链接\n *\n * 支持的格式 (queryParams 格式，nodeId 需要 URL 编码):\n * - mgp://mastergo.netease.com/file/174135798361888?nodeId=123%3A456 (单个节点)\n * - mgp://mastergo.netease.com/file/174135798361888?nodeId=0%3A8633&nodePath=314%3A13190%2F0%3A8633 (带父节点路径)\n *\n * 输出: { pageUrl: 'mastergo.netease.com/file/174135798361888', nodeId: '0:8633', nodePath: ['314:13190', '0:8633'] }\n */\nexport function parseMgpLink(link: string): { pageUrl: string; nodeId: string; nodePath?: string[] } | null {\n  // 检查是否是 mgp:// 协议\n  if (!link.startsWith('mgp://')) {\n    return null\n  }\n\n  try {\n    // 移除 mgp:// 前缀，构造为可解析的 URL\n    const urlPart = link.slice(6) // 移除 'mgp://'\n    const questionMarkIndex = urlPart.indexOf('?')\n\n    if (questionMarkIndex === -1) {\n      // 没有查询参数，无效格式\n      return null\n    }\n\n    const pageUrl = urlPart.slice(0, questionMarkIndex)\n    const queryString = urlPart.slice(questionMarkIndex + 1)\n\n    // 解析查询参数\n    const params = new URLSearchParams(queryString)\n    const encodedNodeId = params.get('nodeId')\n\n    if (!encodedNodeId) {\n      return null\n    }\n\n    // 解码 nodeId\n    const nodeId = decodeURIComponent(encodedNodeId)\n\n    // 验证 nodeId 格式：支持单个节点 (数字:数字) 或带路径的格式 (数字:数字/数字:数字/...)\n    if (!/^(\\d+:\\d+)(\\/\\d+:\\d+)*$/.test(nodeId)) {\n      return null\n    }\n\n    // 解析可选的 nodePath\n    const encodedNodePath = params.get('nodePath')\n    let nodePath: string[] | undefined\n\n    if (encodedNodePath) {\n      const decodedNodePath = decodeURIComponent(encodedNodePath)\n      nodePath = decodedNodePath.split('/').filter(Boolean)\n      // 验证每个路径段的格式\n      if (!nodePath.every(segment => /^\\d+:\\d+$/.test(segment))) {\n        return null\n      }\n    }\n\n    return {\n      pageUrl,\n      nodeId,\n      nodePath,\n    }\n  } catch {\n    return null\n  }\n}\n\n/**\n * 生成 mgp:// 链接\n *\n * @param pageUrl 页面 URL（会被标准化）\n * @param nodeId 节点 ID（会被 URL 编码）\n * @param nodePath 可选的父节点路径（会被 URL 编码）\n */\nexport function generateMgpLink(pageUrl: string, nodeId: string, nodePath?: string[]): string {\n  const normalizedUrl = normalizePageUrl(pageUrl)\n  const encodedNodeId = encodeURIComponent(nodeId)\n\n  let link = `mgp://${normalizedUrl}?nodeId=${encodedNodeId}`\n\n  if (nodePath && nodePath.length > 0) {\n    const encodedNodePath = encodeURIComponent(nodePath.join('/'))\n    link += `&nodePath=${encodedNodePath}`\n  }\n\n  return link\n}\n\n// ==================== 输出格式化 ====================\n\n/**\n * 格式化文件大小\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes < 1024) {\n    return `${bytes} 字节`\n  }\n  const kb = bytes / 1024\n  if (kb < 1024) {\n    return `${kb.toFixed(2)} KB`\n  }\n  const mb = kb / 1024\n  return `${mb.toFixed(2)} MB`\n}\n\n/**\n * 格式化时间间隔\n */\nexport function formatDuration(ms: number): string {\n  const seconds = Math.floor(ms / 1000)\n  const minutes = Math.floor(seconds / 60)\n  const hours = Math.floor(minutes / 60)\n  const days = Math.floor(hours / 24)\n\n  if (days > 0) {\n    return `${days} 天 ${hours % 24} 小时`\n  }\n  if (hours > 0) {\n    return `${hours} 小时 ${minutes % 60} 分钟`\n  }\n  if (minutes > 0) {\n    return `${minutes} 分钟 ${seconds % 60} 秒`\n  }\n  return `${seconds} 秒`\n}\n\n/**\n * 生成唯一 ID\n */\nexport function generateId(): string {\n  return `${Date.now()}_${Math.random().toString(36).substring(2, 9)}`\n}\n\n/**\n * 获取当前时间的 ISO 格式字符串\n */\nexport function getCurrentISOTime(): string {\n  return new Date().toISOString()\n}\n\n/**\n * 格式化日期时间用于日志\n */\nexport function formatLogTime(date: Date = new Date()): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  const hours = String(date.getHours()).padStart(2, '0')\n  const minutes = String(date.getMinutes()).padStart(2, '0')\n  const seconds = String(date.getSeconds()).padStart(2, '0')\n  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`\n}\n\n// ==================== FileId 提取 ====================\n\n/**\n * 从完整 URL 提取 fileId\n * \n * 支持格式:\n * - https://mastergo.netease.com/file/174875497054651?page_id=321%3A11979\n * - mastergo.netease.com/file/174875497054651\n * \n * @returns fileId 或 null\n */\nexport function extractFileIdFromUrl(url: string): string | null {\n  // 匹配 /file/数字 格式\n  const match = url.match(/\\/file\\/(\\d+)/)\n  return match ? match[1] : null\n}\n\n/**\n * 从 mgp:// 链接提取 fileId\n * \n * 支持格式:\n * - mgp://mastergo.netease.com/file/174875497054651?nodeId=xxx\n * \n * @returns fileId 或 null\n */\nexport function extractFileIdFromMgpLink(link: string): string | null {\n  if (!link.startsWith('mgp://')) {\n    return null\n  }\n  return extractFileIdFromUrl(link)\n}\n\n/**\n * 统一处理输入，提取 fileId\n * \n * 支持三种输入格式:\n * 1. 完整 URL: https://mastergo.netease.com/file/174875497054651?page_id=xxx\n * 2. mgp 协议: mgp://mastergo.netease.com/file/174875497054651?nodeId=xxx\n * 3. 纯 fileId: 174875497054651\n * \n * @returns fileId 或 null\n */\nexport function extractFileId(input: string): string | null {\n  const trimmed = input.trim()\n  \n  // 1. 纯数字 fileId\n  if (/^\\d+$/.test(trimmed)) {\n    return trimmed\n  }\n  \n  // 2. mgp:// 协议\n  if (trimmed.startsWith('mgp://')) {\n    return extractFileIdFromMgpLink(trimmed)\n  }\n  \n  // 3. 完整 URL (http:// 或 https://)\n  if (trimmed.startsWith('http://') || trimmed.startsWith('https://')) {\n    return extractFileIdFromUrl(trimmed)\n  }\n  \n  // 4. 尝试作为不带协议的 URL 解析\n  return extractFileIdFromUrl(trimmed)\n}\n\n// ==================== 节点数据精简 ====================\n\n/**\n * 需要四舍五入的数值字段\n */\nconst NUMERIC_FIELDS = [\n  'x', 'y', 'width', 'height',\n  'rotation',\n  'opacity',\n  'cornerRadius', 'topLeftRadius', 'topRightRadius', 'bottomLeftRadius', 'bottomRightRadius',\n  'strokeWeight', 'strokeTopWeight', 'strokeLeftWeight', 'strokeBottomWeight', 'strokeRightWeight',\n  'paddingTop', 'paddingRight', 'paddingBottom', 'paddingLeft',\n  'itemSpacing', 'crossAxisSpacing',\n  'flexGrow',\n]\n\n/**\n * 四舍五入到一位小数\n * 25.666667938232422 -> 25.7\n */\nexport function roundToOneDecimal(value: number): number {\n  return Math.round(value * 10) / 10\n}\n\n/**\n * MasterGo 节点属性默认值\n * 基于官方文档定义，当值等于默认值时可以省略以减少 JSON 体积\n */\nexport const NODE_DEFAULTS: Record<string, unknown> = {\n  // Scene Node 属性\n  visible: true,\n  isVisible: true,\n  isLocked: false,\n\n  // Blend 属性\n  opacity: 1,\n  blendMode: 'NORMAL',\n  isMask: false,\n  isMaskOutline: false,\n  isMaskVisible: false,\n  effectStyleId: '',\n\n  // Geometry 属性\n  strokeStyle: 'SOLID',\n  strokeWeight: 0,\n  strokeTopWeight: 0,\n  strokeLeftWeight: 0,\n  strokeBottomWeight: 0,\n  strokeRightWeight: 0,\n  strokeAlign: 'CENTER',\n  strokeCap: 'NONE',\n  strokeJoin: 'MITER',\n  dashCap: 'NONE',\n  fillStyleId: '',\n  strokeStyleId: '',\n\n  // Corner 属性\n  cornerSmooth: 0,\n  cornerRadius: 0,\n  topLeftRadius: 0,\n  topRightRadius: 0,\n  bottomLeftRadius: 0,\n  bottomRightRadius: 0,\n\n  // Layout 属性\n  rotation: 0,\n  flexGrow: 0,\n  alignSelf: 'INHERIT',\n  layoutPositioning: 'AUTO',\n  constrainProportions: false,\n\n  // 容器专属属性 (FrameNode)\n  flexMode: 'NONE',\n  flexWrap: 'NO_WRAP',\n  itemSpacing: 0,\n  crossAxisSpacing: 0,\n  paddingTop: 0,\n  paddingRight: 0,\n  paddingBottom: 0,\n  paddingLeft: 0,\n  clipsContent: false,\n  itemReverseZIndex: false,\n  strokesIncludedInLayout: false,\n\n  // 其他属性\n  componentPropertyReferences: null,\n}\n\n/**\n * 需要检查是否为空数组的字段\n */\nconst EMPTY_ARRAY_FIELDS = [\n  'fills',\n  'strokes',\n  'effects',\n  'strokeDashes',\n  'exportSettings',\n  'reactions',\n  'attachedConnectors',\n]\n\n/**\n * 检查值是否为空数组\n */\nfunction isEmptyArray(value: unknown): boolean {\n  return Array.isArray(value) && value.length === 0\n}\n\n/**\n * 检查两个值是否相等（简单比较）\n */\nfunction isEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true\n  if (a === null || b === null) return a === b\n  if (typeof a !== typeof b) return false\n  return false\n}\n\n/**\n * 精简节点数据，移除等于默认值的字段\n * 递归处理 children 数组\n *\n * @param node 原始节点数据\n * @returns 精简后的节点数据\n */\nexport function trimNodeDefaults<T extends Record<string, unknown>>(node: T): T {\n  const result: Record<string, unknown> = {}\n\n  for (const [key, value] of Object.entries(node)) {\n    // 递归处理 children 数组\n    if (key === 'children' && Array.isArray(value)) {\n      const trimmedChildren = value.map((child) =>\n        typeof child === 'object' && child !== null\n          ? trimNodeDefaults(child as Record<string, unknown>)\n          : child\n      )\n      // 只有非空时才保留\n      if (trimmedChildren.length > 0) {\n        result[key] = trimmedChildren\n      }\n      continue\n    }\n\n    // 检查是否是需要检查空数组的字段\n    if (EMPTY_ARRAY_FIELDS.includes(key) && isEmptyArray(value)) {\n      continue // 跳过空数组\n    }\n\n    // 对数值字段进行四舍五入\n    if (NUMERIC_FIELDS.includes(key) && typeof value === 'number') {\n      const roundedValue = roundToOneDecimal(value)\n      // 检查四舍五入后是否等于默认值\n      if (key in NODE_DEFAULTS && isEqual(roundedValue, NODE_DEFAULTS[key])) {\n        continue // 跳过等于默认值的字段\n      }\n      result[key] = roundedValue\n      continue\n    }\n\n    // 检查是否有默认值定义\n    if (key in NODE_DEFAULTS) {\n      const defaultValue = NODE_DEFAULTS[key]\n      if (isEqual(value, defaultValue)) {\n        continue // 跳过等于默认值的字段\n      }\n    }\n\n    // 保留此字段\n    result[key] = value\n  }\n\n  return result as T\n}\n\n// ==================== 空间信息提取 ====================\n\n/**\n * 提取节点的空间信息\n * 只保留 id、name、x、y、width、height 和 children 字段\n * 用于让 AI 以最少的字段理解节点的空间布局关系\n *\n * @param node 原始节点数据\n * @returns 精简的空间节点信息\n */\nexport function extractSpaceInfo(node: NodeInfo): SpaceNodeInfo {\n  const result: SpaceNodeInfo = {\n    id: node.id,\n    name: node.name,\n    x: roundToOneDecimal(typeof node.x === 'number' ? node.x : 0),\n    y: roundToOneDecimal(typeof node.y === 'number' ? node.y : 0),\n    width: roundToOneDecimal(typeof node.width === 'number' ? node.width : 0),\n    height: roundToOneDecimal(typeof node.height === 'number' ? node.height : 0),\n  }\n\n  // 递归处理 children\n  if (node.children && Array.isArray(node.children) && node.children.length > 0) {\n    result.children = node.children.map((child) => extractSpaceInfo(child))\n  }\n\n  return result\n}\n","/**\n * MG Plugin 常量定义\n */\n\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\n// ==================== 端口配置 ====================\n\n/** 默认端口 */\nexport const DEFAULT_PORT = 9527\n\n/** 端口范围：起始 */\nexport const PORT_RANGE_START = 9527\n\n/** 端口范围：结束 */\nexport const PORT_RANGE_END = 9536\n\n/** 最大尝试端口数 */\nexport const MAX_PORT_ATTEMPTS = 10\n\n/** 端口扫描超时（毫秒） */\nexport const PORT_SCAN_TIMEOUT = 500\n\n// ==================== 路径配置 ====================\n\n/** 配置目录 */\nexport const CONFIG_DIR = join(homedir(), '.mg-plugin')\n\n/** Server 状态文件 */\nexport const SERVER_INFO_FILE = join(CONFIG_DIR, 'server.json')\n\n/** 日志目录 */\nexport const LOG_DIR = join(CONFIG_DIR, 'logs')\n\n/** Server 日志文件 */\nexport const SERVER_LOG_FILE = join(LOG_DIR, 'server.log')\n\n// ==================== 超时配置 ====================\n\n/** 心跳间隔（毫秒）- 30 秒 */\nexport const HEARTBEAT_INTERVAL = 30000\n\n/** 心跳超时（毫秒）- 90 秒（3 次心跳） */\nexport const HEARTBEAT_TIMEOUT = 90000\n\n/** 请求超时（毫秒）- 30 秒 */\nexport const REQUEST_TIMEOUT = 30000\n\n/** Server 启动等待超时（毫秒）- 5 秒 */\nexport const SERVER_START_TIMEOUT = 5000\n\n/** CLI 重试间隔（毫秒） */\nexport const RETRY_INTERVALS = [1000, 2000, 4000]\n\n/** 最大重试次数 */\nexport const MAX_RETRY_COUNT = 3\n\n// ==================== 连接类型 ====================\n\n/** 连接类型 */\nexport enum ConnectionType {\n  /** 获取端 (CLI/MCP) */\n  CONSUMER = 'consumer',\n  /** 提供端 (Injector) */\n  PROVIDER = 'provider',\n}\n\n// ==================== 消息类型 ====================\n\n/** WebSocket 消息类型 */\nexport enum MessageType {\n  // 系统消息\n  PING = 'ping',\n  PONG = 'pong',\n  REGISTER = 'register',\n  REGISTER_ACK = 'register_ack',\n\n  // 业务消息\n  GET_NODE_BY_ID = 'get_node_by_id',\n  GET_ALL_NODES = 'get_all_nodes',\n  GET_SELECTION = 'get_selection',\n  EXPORT_IMAGE = 'export_image',\n  EXECUTE_CODE = 'execute_code',\n  GET_ALL_PAGES = 'get_all_pages',\n\n  // Server 状态消息（本地请求，不转发到 Provider）\n  GET_SERVER_STATUS = 'get_server_status',\n\n  // 响应\n  RESPONSE = 'response',\n  ERROR = 'error',\n}\n","/**\n * MG Plugin 错误码定义\n */\n\n/** 错误码枚举 */\nexport enum ErrorCode {\n  /** 无法连接到 MG Server */\n  CONNECTION_FAILED = 'E001',\n  /** 连接超时 */\n  CONNECTION_TIMEOUT = 'E002',\n  /** 没有 MasterGo 页面连接到 Server */\n  NO_PAGE_CONNECTED = 'E003',\n  /** 未找到匹配的页面 */\n  PAGE_NOT_FOUND = 'E004',\n  /** 节点不存在 */\n  NODE_NOT_FOUND = 'E005',\n  /** 没有选中任何节点 */\n  NO_SELECTION = 'E006',\n  /** mg 对象不可用 */\n  MG_UNAVAILABLE = 'E007',\n  /** 导出图片失败 */\n  EXPORT_FAILED = 'E008',\n  /** 文件写入失败 */\n  FILE_WRITE_FAILED = 'E009',\n  /** 无效的 mgp:// 链接格式 */\n  INVALID_LINK = 'E010',\n  /** 参数校验失败 */\n  INVALID_PARAMS = 'E011',\n  /** 请求超时 */\n  REQUEST_TIMEOUT = 'E012',\n  /** 所有备选端口均被占用 */\n  PORT_EXHAUSTED = 'E013',\n  /** 无法发现 Server (端口扫描失败) */\n  SERVER_DISCOVERY_FAILED = 'E014',\n  /** 自动启动 Server 失败 */\n  SERVER_START_FAILED = 'E015',\n  /** Server 已在运行中 */\n  SERVER_ALREADY_RUNNING = 'E016',\n  /** 连接断开 */\n  CONNECTION_LOST = 'E017',\n  /** 未知错误 */\n  UNKNOWN_ERROR = 'E099',\n}\n\n/** 错误码对应的错误名称 */\nexport const ErrorNames: Record<ErrorCode, string> = {\n  [ErrorCode.CONNECTION_FAILED]: 'CONNECTION_FAILED',\n  [ErrorCode.CONNECTION_TIMEOUT]: 'CONNECTION_TIMEOUT',\n  [ErrorCode.NO_PAGE_CONNECTED]: 'NO_PAGE_CONNECTED',\n  [ErrorCode.PAGE_NOT_FOUND]: 'PAGE_NOT_FOUND',\n  [ErrorCode.NODE_NOT_FOUND]: 'NODE_NOT_FOUND',\n  [ErrorCode.NO_SELECTION]: 'NO_SELECTION',\n  [ErrorCode.MG_UNAVAILABLE]: 'MG_UNAVAILABLE',\n  [ErrorCode.EXPORT_FAILED]: 'EXPORT_FAILED',\n  [ErrorCode.FILE_WRITE_FAILED]: 'FILE_WRITE_FAILED',\n  [ErrorCode.INVALID_LINK]: 'INVALID_LINK',\n  [ErrorCode.INVALID_PARAMS]: 'INVALID_PARAMS',\n  [ErrorCode.REQUEST_TIMEOUT]: 'REQUEST_TIMEOUT',\n  [ErrorCode.PORT_EXHAUSTED]: 'PORT_EXHAUSTED',\n  [ErrorCode.SERVER_DISCOVERY_FAILED]: 'SERVER_DISCOVERY_FAILED',\n  [ErrorCode.SERVER_START_FAILED]: 'SERVER_START_FAILED',\n  [ErrorCode.SERVER_ALREADY_RUNNING]: 'SERVER_ALREADY_RUNNING',\n  [ErrorCode.CONNECTION_LOST]: 'CONNECTION_LOST',\n  [ErrorCode.UNKNOWN_ERROR]: 'UNKNOWN_ERROR',\n}\n\n/** 错误码对应的默认消息 */\nexport const ErrorMessages: Record<ErrorCode, string> = {\n  [ErrorCode.CONNECTION_FAILED]: '无法连接到 MG Server',\n  [ErrorCode.CONNECTION_TIMEOUT]: '连接超时',\n  [ErrorCode.NO_PAGE_CONNECTED]: '没有 MasterGo 页面连接到 Server',\n  [ErrorCode.PAGE_NOT_FOUND]: '未找到匹配的页面',\n  [ErrorCode.NODE_NOT_FOUND]: '节点不存在',\n  [ErrorCode.NO_SELECTION]: '没有选中任何节点',\n  [ErrorCode.MG_UNAVAILABLE]: 'mg 对象不可用',\n  [ErrorCode.EXPORT_FAILED]: '导出图片失败',\n  [ErrorCode.FILE_WRITE_FAILED]: '文件写入失败',\n  [ErrorCode.INVALID_LINK]: '无效的 mgp:// 链接格式',\n  [ErrorCode.INVALID_PARAMS]: '参数校验失败',\n  [ErrorCode.REQUEST_TIMEOUT]: '请求超时',\n  [ErrorCode.PORT_EXHAUSTED]: '所有备选端口均被占用',\n  [ErrorCode.SERVER_DISCOVERY_FAILED]: '无法发现 Server (端口扫描失败)',\n  [ErrorCode.SERVER_START_FAILED]: '自动启动 Server 失败',\n  [ErrorCode.SERVER_ALREADY_RUNNING]: 'Server 已在运行中',\n  [ErrorCode.CONNECTION_LOST]: '连接断开',\n  [ErrorCode.UNKNOWN_ERROR]: '未知错误',\n}\n\n/** MG Plugin 错误类 */\nexport class MGError extends Error {\n  /** 错误码 */\n  code: ErrorCode\n  /** 错误名称 */\n  errorName: string\n  /** 额外详情 */\n  details?: Record<string, unknown>\n\n  constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>) {\n    super(message || ErrorMessages[code])\n    this.name = 'MGError'\n    this.code = code\n    this.errorName = ErrorNames[code]\n    this.details = details\n  }\n\n  /** 转换为 JSON 格式 */\n  toJSON() {\n    return {\n      code: this.code,\n      name: this.errorName,\n      message: this.message,\n      details: this.details,\n    }\n  }\n\n  /** 格式化输出 */\n  toString() {\n    return `错误 [${this.code}]: ${this.message}`\n  }\n}\n\n/**\n * 创建错误\n */\nexport function createError(\n  code: ErrorCode,\n  message?: string,\n  details?: Record<string, unknown>\n): MGError {\n  return new MGError(code, message, details)\n}\n","/**\n * WebSocket 服务器\n */\n\nimport { WebSocketServer, WebSocket } from 'ws'\nimport type { IncomingMessage } from 'node:http'\nimport {\n  ConnectionType,\n  MessageType,\n  DEFAULT_PORT,\n  PORT_RANGE_START,\n  PORT_RANGE_END,\n  HEARTBEAT_INTERVAL,\n} from '../shared/constants.js'\nimport { ErrorCode, MGError } from '../shared/errors.js'\nimport type { BaseMessage, RegisterMessage, ResponseMessage, ServerStatusResponse, ConnectedPageInfo } from '../shared/types.js'\nimport { formatDuration } from '../shared/utils.js'\nimport { Logger, createLogger } from './logger.js'\nimport { ConnectionManager, ManagedWebSocket } from './connection-manager.js'\nimport { RequestHandler } from './request-handler.js'\nimport { getVersion } from '../shared/version.js'\n\nexport interface ServerOptions {\n  /** 监听端口 */\n  port?: number\n  /** 日志选项 */\n  logger?: Logger\n}\n\n/**\n * MG WebSocket 服务器\n */\nexport class MGServer {\n  private wss: WebSocketServer | null = null\n  private logger: Logger\n  private connectionManager: ConnectionManager\n  private requestHandler: RequestHandler\n\n  private port: number\n  private isRunning = false\n  private startedAt: Date | null = null\n\n  constructor(options: ServerOptions = {}) {\n    this.port = options.port || DEFAULT_PORT\n    this.logger = options.logger || createLogger()\n    this.connectionManager = new ConnectionManager(this.logger)\n    this.requestHandler = new RequestHandler(this.connectionManager, this.logger)\n  }\n\n  /**\n   * 启动服务器\n   */\n  async start(): Promise<number> {\n    if (this.isRunning) {\n      throw new MGError(ErrorCode.SERVER_ALREADY_RUNNING, 'Server 已在运行中')\n    }\n\n    // 尝试绑定端口\n    const port = await this.findAvailablePort()\n\n    return new Promise((resolve, reject) => {\n      this.wss = new WebSocketServer({ port })\n\n      this.wss.on('listening', () => {\n        this.port = port\n        this.isRunning = true\n        this.startedAt = new Date()\n        this.logger.info(`Server 启动成功，监听端口: ${port}`)\n\n        // 启动心跳检查\n        this.connectionManager.startHeartbeatCheck(HEARTBEAT_INTERVAL)\n\n        resolve(port)\n      })\n\n      this.wss.on('error', (error: NodeJS.ErrnoException) => {\n        this.logger.error('Server 错误:', error)\n        reject(error)\n      })\n\n      this.wss.on('connection', (ws: WebSocket, request: IncomingMessage) => {\n        this.handleConnection(ws, request)\n      })\n    })\n  }\n\n  /**\n   * 查找可用端口\n   */\n  private async findAvailablePort(): Promise<number> {\n    for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port++) {\n      const available = await this.isPortAvailable(port)\n      if (available) {\n        return port\n      }\n      this.logger.debug(`端口 ${port} 被占用，尝试下一个`)\n    }\n\n    throw new MGError(\n      ErrorCode.PORT_EXHAUSTED,\n      `端口 ${PORT_RANGE_START}-${PORT_RANGE_END} 均被占用`\n    )\n  }\n\n  /**\n   * 检查端口是否可用\n   */\n  private isPortAvailable(port: number): Promise<boolean> {\n    return new Promise((resolve) => {\n      const testServer = new WebSocketServer({ port })\n\n      testServer.on('listening', () => {\n        testServer.close()\n        resolve(true)\n      })\n\n      testServer.on('error', () => {\n        resolve(false)\n      })\n    })\n  }\n\n  /**\n   * 处理新连接\n   */\n  private handleConnection(ws: WebSocket, _request: IncomingMessage): void {\n    this.logger.info('新连接建立')\n\n    // 等待注册消息\n    const registerTimeout = setTimeout(() => {\n      this.logger.warn('连接注册超时，关闭连接')\n      ws.close()\n    }, 5000)\n\n    ws.on('message', (data) => {\n      try {\n        const message = JSON.parse(data.toString()) as BaseMessage\n\n        // 处理注册消息\n        if (message.type === MessageType.REGISTER) {\n          clearTimeout(registerTimeout)\n          this.handleRegister(ws, message as RegisterMessage)\n          return\n        }\n\n        // 其他消息需要已注册\n        const managedWs = ws as ManagedWebSocket\n        if (!managedWs.connectionId) {\n          this.logger.warn('未注册的连接发送消息，忽略')\n          return\n        }\n\n        this.handleMessage(managedWs, message)\n      } catch (error) {\n        this.logger.error('消息解析失败:', error)\n      }\n    })\n\n    ws.on('close', () => {\n      clearTimeout(registerTimeout)\n      const managedWs = ws as ManagedWebSocket\n      if (managedWs.connectionId) {\n        this.requestHandler.cleanupConnectionRequests(managedWs.connectionId)\n        this.connectionManager.removeConnection(managedWs)\n      }\n    })\n\n    ws.on('error', (error) => {\n      this.logger.error('WebSocket 错误:', error)\n    })\n  }\n\n  /**\n   * 处理注册消息\n   */\n  private handleRegister(ws: WebSocket, message: RegisterMessage): void {\n    const { connectionType, pageUrl, pageId } = message.data\n\n    const managedWs = this.connectionManager.addConnection(\n      ws,\n      connectionType,\n      pageUrl,\n      pageId\n    )\n\n    // 发送注册确认（包含 Server 版本信息）\n    const ack: ResponseMessage = {\n      id: message.id || '',\n      type: MessageType.REGISTER_ACK,\n      success: true,\n      data: {\n        connectionId: managedWs.connectionId,\n        pageUrl,\n        serverVersion: getVersion(),\n      },\n    }\n\n    ws.send(JSON.stringify(ack))\n  }\n\n  /**\n   * 处理消息\n   */\n  private handleMessage(ws: ManagedWebSocket, message: BaseMessage): void {\n    this.connectionManager.updateLastActive(ws)\n\n    switch (message.type) {\n      case MessageType.PING:\n        this.handlePing(ws, message)\n        break\n\n      case MessageType.GET_SERVER_STATUS:\n        // 直接处理 Server 状态查询，不转发给 Provider\n        this.handleGetServerStatus(ws, message)\n        break\n\n      case MessageType.RESPONSE:\n      case MessageType.ERROR:\n        // Provider 返回的响应\n        this.requestHandler.handleResponse(message as ResponseMessage)\n        break\n\n      default:\n        // Consumer 发送的请求\n        if (ws.connectionInfo.type === ConnectionType.CONSUMER) {\n          this.requestHandler.handleRequest(ws, message as any)\n        }\n        break\n    }\n  }\n\n  /**\n   * 处理心跳\n   */\n  private handlePing(ws: ManagedWebSocket, message: BaseMessage): void {\n    const pong = {\n      type: MessageType.PONG,\n      timestamp: (message as any).timestamp || Date.now(),\n    }\n    ws.send(JSON.stringify(pong))\n  }\n\n  /**\n   * 处理 Server 状态查询\n   */\n  private handleGetServerStatus(ws: ManagedWebSocket, message: BaseMessage): void {\n    const providers = this.connectionManager.getAllProviders()\n    const stats = this.connectionManager.getStats()\n\n    // 构建连接页面信息\n    const connectedPages: ConnectedPageInfo[] = providers.map((info) => ({\n      pageUrl: info.pageUrl || '',\n      connectedAt: info.connectedAt.toISOString(),\n      lastActiveAt: info.lastActiveAt.toISOString(),\n    }))\n\n    const uptimeMs = this.startedAt ? Date.now() - this.startedAt.getTime() : 0\n\n    const statusData: ServerStatusResponse = {\n      running: this.isRunning,\n      port: this.port,\n      pid: process.pid,\n      startedAt: this.startedAt?.toISOString() || '',\n      uptime: formatDuration(uptimeMs),\n      version: getVersion(),\n      stats,\n      connectedPages,\n    }\n\n    const response: ResponseMessage = {\n      id: message.id || '',\n      type: MessageType.RESPONSE,\n      success: true,\n      data: statusData,\n    }\n\n    ws.send(JSON.stringify(response))\n    this.logger.info('返回 Server 状态信息')\n  }\n\n  /**\n   * 停止服务器\n   */\n  async stop(): Promise<void> {\n    if (!this.isRunning || !this.wss) {\n      return\n    }\n\n    this.logger.info('正在停止 Server...')\n\n    // 清理所有请求\n    this.requestHandler.cleanupAll()\n\n    // 关闭所有连接\n    this.connectionManager.closeAll()\n\n    // 关闭服务器\n    return new Promise((resolve) => {\n      this.wss!.close(() => {\n        this.isRunning = false\n        this.wss = null\n        this.logger.info('Server 已停止')\n        resolve()\n      })\n    })\n  }\n\n  /**\n   * 获取运行状态\n   */\n  getStatus(): {\n    running: boolean\n    port: number\n    stats: { providers: number; consumers: number; total: number }\n    connectedPages: string[]\n  } {\n    return {\n      running: this.isRunning,\n      port: this.port,\n      stats: this.connectionManager.getStats(),\n      connectedPages: this.connectionManager.getConnectedPageUrls(),\n    }\n  }\n\n  /**\n   * 获取端口\n   */\n  getPort(): number {\n    return this.port\n  }\n\n  /**\n   * 是否运行中\n   */\n  isServerRunning(): boolean {\n    return this.isRunning\n  }\n}\n\n/**\n * 创建服务器实例\n */\nexport function createServer(options?: ServerOptions): MGServer {\n  return new MGServer(options)\n}\n","/**\n * 日志模块\n */\n\nimport { appendFileSync, existsSync, mkdirSync } from 'node:fs'\nimport { dirname } from 'node:path'\nimport { SERVER_LOG_FILE } from '../shared/constants.js'\nimport { formatLogTime } from '../shared/utils.js'\n\nexport enum LogLevel {\n  DEBUG = 'DEBUG',\n  INFO = 'INFO',\n  WARN = 'WARN',\n  ERROR = 'ERROR',\n}\n\nexport interface LoggerOptions {\n  /** 是否输出到控制台 */\n  console?: boolean\n  /** 是否输出到文件 */\n  file?: boolean\n  /** 日志文件路径 */\n  filePath?: string\n  /** 最小日志级别 */\n  minLevel?: LogLevel\n}\n\nconst levelPriority: Record<LogLevel, number> = {\n  [LogLevel.DEBUG]: 0,\n  [LogLevel.INFO]: 1,\n  [LogLevel.WARN]: 2,\n  [LogLevel.ERROR]: 3,\n}\n\n/**\n * 日志记录器\n */\nexport class Logger {\n  private options: Required<LoggerOptions>\n\n  constructor(options: LoggerOptions = {}) {\n    this.options = {\n      console: options.console ?? true,\n      file: options.file ?? false,\n      filePath: options.filePath ?? SERVER_LOG_FILE,\n      minLevel: options.minLevel ?? LogLevel.INFO,\n    }\n\n    // 确保日志目录存在\n    if (this.options.file) {\n      const dir = dirname(this.options.filePath)\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true })\n      }\n    }\n  }\n\n  /**\n   * 记录日志\n   */\n  private log(level: LogLevel, message: string, ...args: unknown[]): void {\n    // 检查日志级别\n    if (levelPriority[level] < levelPriority[this.options.minLevel]) {\n      return\n    }\n\n    const timestamp = formatLogTime()\n    const formattedMessage = `[${timestamp}] [${level}] ${message}`\n\n    // 输出到控制台\n    if (this.options.console) {\n      const consoleMethod = level === LogLevel.ERROR ? console.error : console.log\n      if (args.length > 0) {\n        consoleMethod(formattedMessage, ...args)\n      } else {\n        consoleMethod(formattedMessage)\n      }\n    }\n\n    // 输出到文件\n    if (this.options.file) {\n      try {\n        const fileMessage =\n          args.length > 0\n            ? `${formattedMessage} ${JSON.stringify(args)}\\n`\n            : `${formattedMessage}\\n`\n        appendFileSync(this.options.filePath, fileMessage)\n      } catch (error) {\n        // 文件写入失败时静默处理\n        if (this.options.console) {\n          console.error('日志文件写入失败:', error)\n        }\n      }\n    }\n  }\n\n  debug(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.DEBUG, message, ...args)\n  }\n\n  info(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.INFO, message, ...args)\n  }\n\n  warn(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.WARN, message, ...args)\n  }\n\n  error(message: string, ...args: unknown[]): void {\n    this.log(LogLevel.ERROR, message, ...args)\n  }\n}\n\n/** 创建默认日志记录器 */\nexport function createLogger(options?: LoggerOptions): Logger {\n  return new Logger(options)\n}\n","/**\n * 连接管理器\n * 管理 Provider 和 Consumer 的 WebSocket 连接\n */\n\nimport type { WebSocket } from 'ws'\nimport { ConnectionType, HEARTBEAT_TIMEOUT } from '../shared/constants.js'\nimport type { ConnectionInfo } from '../shared/types.js'\nimport { generateId } from '../shared/utils.js'\nimport { Logger } from './logger.js'\n\n/** 带连接信息的 WebSocket */\nexport interface ManagedWebSocket extends WebSocket {\n  /** 连接 ID */\n  connectionId: string\n  /** 连接信息 */\n  connectionInfo: ConnectionInfo\n  /** 是否存活 */\n  isAlive: boolean\n}\n\n/**\n * 连接管理器\n */\nexport class ConnectionManager {\n  private logger: Logger\n\n  /** Provider 连接（按页面 URL 索引） */\n  private providers = new Map<string, ManagedWebSocket>()\n\n  /** Consumer 连接 */\n  private consumers = new Map<string, ManagedWebSocket>()\n\n  /** 所有连接（按 ID 索引） */\n  private allConnections = new Map<string, ManagedWebSocket>()\n\n  /** 心跳检查定时器 */\n  private heartbeatTimer: NodeJS.Timeout | null = null\n\n  constructor(logger: Logger) {\n    this.logger = logger\n  }\n\n  /**\n   * 启动心跳检查\n   */\n  startHeartbeatCheck(interval: number = 30000): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n    }\n\n    this.heartbeatTimer = setInterval(() => {\n      this.checkHeartbeats()\n    }, interval)\n  }\n\n  /**\n   * 停止心跳检查\n   */\n  stopHeartbeatCheck(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n      this.heartbeatTimer = null\n    }\n  }\n\n  /**\n   * 检查所有连接的心跳\n   */\n  private checkHeartbeats(): void {\n    const now = Date.now()\n\n    for (const [id, ws] of this.allConnections) {\n      const lastActive = ws.connectionInfo.lastActiveAt.getTime()\n      const elapsed = now - lastActive\n\n      if (elapsed > HEARTBEAT_TIMEOUT) {\n        this.logger.warn(`连接 ${id} 心跳超时，关闭连接`)\n        this.removeConnection(ws)\n        ws.terminate()\n      }\n    }\n  }\n\n  /**\n   * 添加连接\n   */\n  addConnection(\n    ws: WebSocket,\n    type: ConnectionType,\n    pageUrl?: string,\n    pageId?: string\n  ): ManagedWebSocket {\n    const connectionId = generateId()\n    const now = new Date()\n\n    const connectionInfo: ConnectionInfo = {\n      id: connectionId,\n      type,\n      pageUrl,\n      pageId,\n      connectedAt: now,\n      lastActiveAt: now,\n    }\n\n    const managedWs = ws as ManagedWebSocket\n    managedWs.connectionId = connectionId\n    managedWs.connectionInfo = connectionInfo\n    managedWs.isAlive = true\n\n    this.allConnections.set(connectionId, managedWs)\n\n    if (type === ConnectionType.PROVIDER && pageUrl) {\n      // 如果已有同页面的连接，先移除旧的\n      const existing = this.providers.get(pageUrl)\n      if (existing) {\n        this.logger.info(`页面 ${pageUrl} 已有连接，替换为新连接`)\n        this.removeConnection(existing)\n        existing.close()\n      }\n      this.providers.set(pageUrl, managedWs)\n      this.logger.info(`Provider 连接: ${pageUrl}`)\n    } else if (type === ConnectionType.CONSUMER) {\n      this.consumers.set(connectionId, managedWs)\n      this.logger.info(`Consumer 连接: ${connectionId}`)\n    }\n\n    return managedWs\n  }\n\n  /**\n   * 移除连接\n   */\n  removeConnection(ws: ManagedWebSocket): void {\n    const { connectionId, connectionInfo } = ws\n\n    this.allConnections.delete(connectionId)\n\n    if (connectionInfo.type === ConnectionType.PROVIDER && connectionInfo.pageUrl) {\n      this.providers.delete(connectionInfo.pageUrl)\n      this.logger.info(`Provider 断开: ${connectionInfo.pageUrl}`)\n    } else if (connectionInfo.type === ConnectionType.CONSUMER) {\n      this.consumers.delete(connectionId)\n      this.logger.info(`Consumer 断开: ${connectionId}`)\n    }\n  }\n\n  /**\n   * 更新连接活跃时间\n   */\n  updateLastActive(ws: ManagedWebSocket): void {\n    ws.connectionInfo.lastActiveAt = new Date()\n    ws.isAlive = true\n  }\n\n  /**\n   * 根据页面 URL 查找 Provider\n   */\n  findProviderByPageUrl(pageUrl: string): ManagedWebSocket | undefined {\n    return this.providers.get(pageUrl)\n  }\n\n  /**\n   * 获取第一个可用的 Provider\n   */\n  getFirstProvider(): ManagedWebSocket | undefined {\n    const iterator = this.providers.values()\n    const first = iterator.next()\n    return first.value\n  }\n\n  /**\n   * 获取所有 Provider 信息\n   */\n  getAllProviders(): ConnectionInfo[] {\n    return Array.from(this.providers.values()).map((ws) => ws.connectionInfo)\n  }\n\n  /**\n   * 获取连接统计\n   */\n  getStats(): { providers: number; consumers: number; total: number } {\n    return {\n      providers: this.providers.size,\n      consumers: this.consumers.size,\n      total: this.allConnections.size,\n    }\n  }\n\n  /**\n   * 获取所有已连接的页面 URL\n   */\n  getConnectedPageUrls(): string[] {\n    return Array.from(this.providers.keys())\n  }\n\n  /**\n   * 关闭所有连接\n   */\n  closeAll(): void {\n    this.stopHeartbeatCheck()\n\n    for (const ws of this.allConnections.values()) {\n      ws.close()\n    }\n\n    this.providers.clear()\n    this.consumers.clear()\n    this.allConnections.clear()\n  }\n}\n","/**\n * 请求处理器\n * 处理 Consumer 请求，转发给 Provider\n */\n\nimport type { ManagedWebSocket } from './connection-manager.js'\nimport { ConnectionManager } from './connection-manager.js'\nimport { Logger } from './logger.js'\nimport { MessageType, REQUEST_TIMEOUT } from '../shared/constants.js'\nimport { ErrorCode, MGError } from '../shared/errors.js'\nimport type { RequestMessage, ResponseMessage } from '../shared/types.js'\nimport { generateId } from '../shared/utils.js'\n\n/** 待处理的请求 */\ninterface PendingRequest {\n  /** 请求 ID */\n  id: string\n  /** Consumer WebSocket */\n  consumer: ManagedWebSocket\n  /** 超时定时器 */\n  timer: NodeJS.Timeout\n  /** 请求时间 */\n  timestamp: number\n}\n\n/**\n * 请求处理器\n */\nexport class RequestHandler {\n  private logger: Logger\n  private connectionManager: ConnectionManager\n\n  /** 待处理的请求 */\n  private pendingRequests = new Map<string, PendingRequest>()\n\n  constructor(connectionManager: ConnectionManager, logger: Logger) {\n    this.connectionManager = connectionManager\n    this.logger = logger\n  }\n\n  /**\n   * 处理 Consumer 请求\n   */\n  async handleRequest(consumer: ManagedWebSocket, message: RequestMessage): Promise<void> {\n    const requestId = message.id || generateId()\n    const { type, pageUrl, params } = message\n\n    this.logger.info(`收到请求: ${type} (${requestId})`, { pageUrl })\n\n    // 查找目标 Provider\n    let provider: ManagedWebSocket | undefined\n\n    if (pageUrl) {\n      provider = this.connectionManager.findProviderByPageUrl(pageUrl)\n      if (!provider) {\n        this.sendError(consumer, requestId, ErrorCode.PAGE_NOT_FOUND, `未找到页面: ${pageUrl}`)\n        return\n      }\n    } else {\n      // 没有指定 pageUrl，使用第一个可用的 Provider\n      provider = this.connectionManager.getFirstProvider()\n      if (!provider) {\n        this.sendError(consumer, requestId, ErrorCode.NO_PAGE_CONNECTED, '没有页面连接到 Server')\n        return\n      }\n    }\n\n    // 创建超时定时器\n    const timer = setTimeout(() => {\n      this.handleTimeout(requestId)\n    }, REQUEST_TIMEOUT)\n\n    // 保存待处理请求\n    this.pendingRequests.set(requestId, {\n      id: requestId,\n      consumer,\n      timer,\n      timestamp: Date.now(),\n    })\n\n    // 转发请求给 Provider\n    const forwardMessage: RequestMessage = {\n      id: requestId,\n      type,\n      pageUrl: pageUrl || provider.connectionInfo.pageUrl,\n      params,\n      timestamp: Date.now(),\n    }\n\n    try {\n      provider.send(JSON.stringify(forwardMessage))\n      this.logger.info(`请求转发: ${type} -> ${provider.connectionInfo.pageUrl}`)\n    } catch {\n      this.cleanupRequest(requestId)\n      this.sendError(consumer, requestId, ErrorCode.CONNECTION_FAILED, '转发请求失败')\n    }\n  }\n\n  /**\n   * 处理 Provider 响应\n   */\n  handleResponse(response: ResponseMessage): void {\n    const { id } = response\n    const pending = this.pendingRequests.get(id)\n\n    if (!pending) {\n      this.logger.warn(`收到未知请求的响应: ${id}`)\n      return\n    }\n\n    this.cleanupRequest(id)\n\n    // 转发响应给 Consumer\n    try {\n      pending.consumer.send(JSON.stringify(response))\n      this.logger.info(\n        `响应返回: ${id} (${response.success ? '成功' : '失败'})`\n      )\n    } catch (error) {\n      this.logger.error(`响应转发失败: ${id}`, error)\n    }\n  }\n\n  /**\n   * 处理请求超时\n   */\n  private handleTimeout(requestId: string): void {\n    const pending = this.pendingRequests.get(requestId)\n    if (!pending) return\n\n    this.logger.warn(`请求超时: ${requestId}`)\n    this.cleanupRequest(requestId)\n\n    this.sendError(pending.consumer, requestId, ErrorCode.REQUEST_TIMEOUT, '请求超时')\n  }\n\n  /**\n   * 清理请求\n   */\n  private cleanupRequest(requestId: string): void {\n    const pending = this.pendingRequests.get(requestId)\n    if (pending) {\n      clearTimeout(pending.timer)\n      this.pendingRequests.delete(requestId)\n    }\n  }\n\n  /**\n   * 发送错误响应\n   */\n  private sendError(\n    consumer: ManagedWebSocket,\n    requestId: string,\n    code: ErrorCode,\n    message: string\n  ): void {\n    const error = new MGError(code, message)\n    const response: ResponseMessage = {\n      id: requestId,\n      type: MessageType.ERROR,\n      success: false,\n      data: null,\n      error: error.toJSON(),\n    }\n\n    try {\n      consumer.send(JSON.stringify(response))\n    } catch (err) {\n      this.logger.error(`发送错误响应失败: ${requestId}`, err)\n    }\n  }\n\n  /**\n   * 清理特定连接的所有待处理请求\n   */\n  cleanupConnectionRequests(connectionId: string): void {\n    for (const [requestId, pending] of this.pendingRequests) {\n      if (pending.consumer.connectionId === connectionId) {\n        this.cleanupRequest(requestId)\n      }\n    }\n  }\n\n  /**\n   * 清理所有待处理请求\n   */\n  cleanupAll(): void {\n    for (const [requestId] of this.pendingRequests) {\n      this.cleanupRequest(requestId)\n    }\n  }\n}\n","/**\n * 版本管理模块\n * 提供获取当前 CLI 版本的函数\n */\n\nimport { readFileSync, existsSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { dirname, join } from 'node:path'\n\n/** 缓存的版本号 */\nlet cachedVersion: string | null = null\n\n/**\n * 获取当前 CLI 版本号\n * 从 package.json 中读取版本号\n */\nexport function getVersion(): string {\n  if (cachedVersion !== null) {\n    return cachedVersion\n  }\n\n  try {\n    // 获取当前模块的目录\n    const currentFile = fileURLToPath(import.meta.url)\n    const currentDir = dirname(currentFile)\n\n    // 尝试多个可能的路径\n    // tsup 打包后: dist/cli.js -> ../package.json\n    // 源码开发时: src/shared/version.ts -> ../../package.json\n    const possiblePaths = [\n      join(currentDir, '..', 'package.json'),      // dist/xxx.js -> ../package.json\n      join(currentDir, '..', '..', 'package.json'), // src/shared/version.ts -> ../../package.json\n    ]\n\n    for (const packageJsonPath of possiblePaths) {\n      if (existsSync(packageJsonPath)) {\n        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'))\n        if (packageJson.name === '@hangox/mg-cli') {\n          cachedVersion = (packageJson.version as string) || '0.0.0'\n          return cachedVersion\n        }\n      }\n    }\n\n    // 如果都找不到，返回默认版本\n    cachedVersion = '0.0.0'\n    return cachedVersion\n  } catch {\n    // 如果读取失败，返回默认版本\n    cachedVersion = '0.0.0'\n    return cachedVersion\n  }\n}\n\n/**\n * 比较两个版本是否一致\n * 使用精确匹配，简单可靠\n */\nexport function isVersionMatch(version1: string, version2: string): boolean {\n  return version1 === version2\n}\n\n/**\n * 清除缓存的版本号（用于测试）\n */\nexport function clearVersionCache(): void {\n  cachedVersion = null\n}\n","/**\n * 守护进程启动脚本\n * 这个脚本被 daemon.ts 作为子进程启动\n */\n\nimport { startServerForeground } from './daemon.js'\n\n// 解析命令行参数\nconst args = process.argv.slice(2)\nlet port: number | undefined\n\nfor (let i = 0; i < args.length; i++) {\n  if (args[i] === '--port' && args[i + 1]) {\n    port = parseInt(args[i + 1], 10)\n  }\n}\n\n// 启动 Server\nstartServerForeground(port).catch((error) => {\n  console.error('守护进程启动失败:', error)\n  process.exit(1)\n})\n"],"mappings":"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","names":["fileURLToPath","dirname","join","existsSync","mkdirSync","dirname","dirname","existsSync","mkdirSync","args","readFileSync","existsSync","dirname","join","port","resolve","port"]}

package/dist/{index-DNrszrq9.d.ts → index--AigFaD9.d.ts}

@@ -52,6 +52,7 @@ declare enum MessageType {
     EXPORT_IMAGE = "export_image",
     EXECUTE_CODE = "execute_code",
     GET_ALL_PAGES = "get_all_pages",
+    GET_SERVER_STATUS = "get_server_status",
     RESPONSE = "response",
     ERROR = "error"
 }
@@ -138,6 +139,8 @@ interface ServerInfo {
     pid: number;
     /** 启动时间 (ISO 8601) */
     startedAt: string;
+    /** CLI 版本号 */
+    version: string;
 }
 /** 基础消息结构 */
 interface BaseMessage {
@@ -236,6 +239,23 @@ interface NodeInfo {
     /** 其他属性 */
     [key: string]: unknown;
 }
+/** 空间节点信息（仅包含位置和尺寸，用于 AI 理解空间布局） */
+interface SpaceNodeInfo {
+    /** 节点 ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** X 坐标 */
+    x: number;
+    /** Y 坐标 */
+    y: number;
+    /** 宽度 */
+    width: number;
+    /** 高度 */
+    height: number;
+    /** 子节点 */
+    children?: SpaceNodeInfo[];
+}
 /** 获取节点参数 */
 interface GetNodeParams {
     /** 节点 ID */
@@ -321,6 +341,41 @@ interface AllPagesInfo {
     /** 页面总数 */
     totalCount: number;
 }
+/** 已连接页面信息 */
+interface ConnectedPageInfo {
+    /** 页面 URL */
+    pageUrl: string;
+    /** 连接时间 (ISO 8601) */
+    connectedAt: string;
+    /** 最后活跃时间 (ISO 8601) */
+    lastActiveAt: string;
+}
+/** Server 状态响应 */
+interface ServerStatusResponse {
+    /** 是否运行中 */
+    running: boolean;
+    /** 监听端口 */
+    port: number;
+    /** 进程 PID */
+    pid: number;
+    /** 启动时间 (ISO 8601) */
+    startedAt: string;
+    /** 运行时长（人类可读） */
+    uptime: string;
+    /** CLI 版本号 */
+    version: string;
+    /** 统计信息 */
+    stats: {
+        /** Provider 数量 */
+        providers: number;
+        /** Consumer 数量 */
+        consumers: number;
+        /** 总连接数 */
+        total: number;
+    };
+    /** 已连接的页面列表 */
+    connectedPages: ConnectedPageInfo[];
+}
 
 /**
  * 日志模块
@@ -379,6 +434,7 @@ declare class MGServer {
     private requestHandler;
     private port;
     private isRunning;
+    private startedAt;
     constructor(options?: ServerOptions);
     /**
      * 启动服务器
@@ -408,6 +464,10 @@ declare class MGServer {
      * 处理心跳
      */
     private handlePing;
+    /**
+     * 处理 Server 状态查询
+     */
+    private handleGetServerStatus;
     /**
      * 停止服务器
      */
@@ -565,4 +625,4 @@ declare class RequestHandler {
     cleanupAll(): void;
 }
 
-export { type AllPagesInfo as A, type BaseMessage as B, CONFIG_DIR as C, DEFAULT_PORT as D, ErrorCode as E, MGServer as F, type GetNodeParams as G, HEARTBEAT_INTERVAL as H, createServer as I, type ServerOptions as J, ConnectionManager as K, LOG_DIR as L, MAX_PORT_ATTEMPTS as M, type NodeInfo as N, type OutputFormatter as O, PORT_RANGE_START as P, type ManagedWebSocket as Q, REQUEST_TIMEOUT as R, type ServerInfo as S, RequestHandler as T, Logger as U, createLogger as V, LogLevel as W, type LoggerOptions as X, PORT_RANGE_END as a, PORT_SCAN_TIMEOUT as b, SERVER_INFO_FILE as c, SERVER_LOG_FILE as d, HEARTBEAT_TIMEOUT as e, SERVER_START_TIMEOUT as f, RETRY_INTERVALS as g, MAX_RETRY_COUNT as h, ConnectionType as i, MessageType as j, ErrorNames as k, ErrorMessages as l, MGError as m, createError as n, type RequestMessage as o, type ResponseMessage as p, type ErrorInfo as q, type RegisterMessage as r, type PingMessage as s, type PongMessage as t, type ConnectionInfo as u, type GetAllNodesParams as v, type ExportImageParams as w, type CliOptions as x, type RGBA as y, type MgPageInfo as z };
+export { type MgPageInfo as A, type BaseMessage as B, CONFIG_DIR as C, DEFAULT_PORT as D, ErrorCode as E, type AllPagesInfo as F, type GetNodeParams as G, HEARTBEAT_INTERVAL as H, type ConnectedPageInfo as I, type ServerStatusResponse as J, MGServer as K, LOG_DIR as L, MAX_PORT_ATTEMPTS as M, type NodeInfo as N, type OutputFormatter as O, PORT_RANGE_START as P, createServer as Q, REQUEST_TIMEOUT as R, type ServerInfo as S, type ServerOptions as T, ConnectionManager as U, type ManagedWebSocket as V, RequestHandler as W, Logger as X, createLogger as Y, LogLevel as Z, type LoggerOptions as _, type SpaceNodeInfo as a, PORT_RANGE_END as b, PORT_SCAN_TIMEOUT as c, SERVER_INFO_FILE as d, SERVER_LOG_FILE as e, HEARTBEAT_TIMEOUT as f, SERVER_START_TIMEOUT as g, RETRY_INTERVALS as h, MAX_RETRY_COUNT as i, ConnectionType as j, MessageType as k, ErrorNames as l, ErrorMessages as m, MGError as n, createError as o, type RequestMessage as p, type ResponseMessage as q, type ErrorInfo as r, type RegisterMessage as s, type PingMessage as t, type PongMessage as u, type ConnectionInfo as v, type GetAllNodesParams as w, type ExportImageParams as x, type CliOptions as y, type RGBA as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ServerInfo } from './index-DNrszrq9.js';
-export { A as AllPagesInfo, B as BaseMessage, C as CONFIG_DIR, x as CliOptions, u as ConnectionInfo, K as ConnectionManager, i as ConnectionType, D as DEFAULT_PORT, E as ErrorCode, q as ErrorInfo, l as ErrorMessages, k as ErrorNames, w as ExportImageParams, v as GetAllNodesParams, G as GetNodeParams, H as HEARTBEAT_INTERVAL, e as HEARTBEAT_TIMEOUT, L as LOG_DIR, W as LogLevel, U as Logger, X as LoggerOptions, M as MAX_PORT_ATTEMPTS, h as MAX_RETRY_COUNT, m as MGError, F as MGServer, Q as ManagedWebSocket, j as MessageType, z as MgPageInfo, N as NodeInfo, O as OutputFormatter, a as PORT_RANGE_END, P as PORT_RANGE_START, b as PORT_SCAN_TIMEOUT, s as PingMessage, t as PongMessage, R as REQUEST_TIMEOUT, g as RETRY_INTERVALS, y as RGBA, r as RegisterMessage, T as RequestHandler, o as RequestMessage, p as ResponseMessage, c as SERVER_INFO_FILE, d as SERVER_LOG_FILE, f as SERVER_START_TIMEOUT, J as ServerOptions, n as createError, V as createLogger, I as createServer } from './index-DNrszrq9.js';
+import { S as ServerInfo, N as NodeInfo, a as SpaceNodeInfo } from './index--AigFaD9.js';
+export { F as AllPagesInfo, B as BaseMessage, C as CONFIG_DIR, y as CliOptions, I as ConnectedPageInfo, v as ConnectionInfo, U as ConnectionManager, j as ConnectionType, D as DEFAULT_PORT, E as ErrorCode, r as ErrorInfo, m as ErrorMessages, l as ErrorNames, x as ExportImageParams, w as GetAllNodesParams, G as GetNodeParams, H as HEARTBEAT_INTERVAL, f as HEARTBEAT_TIMEOUT, L as LOG_DIR, Z as LogLevel, X as Logger, _ as LoggerOptions, M as MAX_PORT_ATTEMPTS, i as MAX_RETRY_COUNT, n as MGError, K as MGServer, V as ManagedWebSocket, k as MessageType, A as MgPageInfo, O as OutputFormatter, b as PORT_RANGE_END, P as PORT_RANGE_START, c as PORT_SCAN_TIMEOUT, t as PingMessage, u as PongMessage, R as REQUEST_TIMEOUT, h as RETRY_INTERVALS, z as RGBA, s as RegisterMessage, W as RequestHandler, p as RequestMessage, q as ResponseMessage, d as SERVER_INFO_FILE, e as SERVER_LOG_FILE, g as SERVER_START_TIMEOUT, T as ServerOptions, J as ServerStatusResponse, o as createError, Y as createLogger, Q as createServer } from './index--AigFaD9.js';
 import 'ws';
 
 /**
@@ -125,5 +125,32 @@ declare function extractFileIdFromMgpLink(link: string): string | null;
  * @returns fileId 或 null
  */
 declare function extractFileId(input: string): string | null;
+/**
+ * 四舍五入到一位小数
+ * 25.666667938232422 -> 25.7
+ */
+declare function roundToOneDecimal(value: number): number;
+/**
+ * MasterGo 节点属性默认值
+ * 基于官方文档定义，当值等于默认值时可以省略以减少 JSON 体积
+ */
+declare const NODE_DEFAULTS: Record<string, unknown>;
+/**
+ * 精简节点数据，移除等于默认值的字段
+ * 递归处理 children 数组
+ *
+ * @param node 原始节点数据
+ * @returns 精简后的节点数据
+ */
+declare function trimNodeDefaults<T extends Record<string, unknown>>(node: T): T;
+/**
+ * 提取节点的空间信息
+ * 只保留 id、name、x、y、width、height 和 children 字段
+ * 用于让 AI 以最少的字段理解节点的空间布局关系
+ *
+ * @param node 原始节点数据
+ * @returns 精简的空间节点信息
+ */
+declare function extractSpaceInfo(node: NodeInfo): SpaceNodeInfo;
 
-export { ServerInfo, deleteServerInfo, ensureConfigDir, ensureDir, ensureOutputDir, extractFileId, extractFileIdFromMgpLink, extractFileIdFromUrl, formatDuration, formatFileSize, formatLogTime, generateId, generateMgpLink, getCurrentISOTime, isDesignPageUrl, isProcessRunning, killProcess, normalizePageUrl, parseMgpLink, readServerInfo, resolveOutputPath, writeServerInfo };
+export { NODE_DEFAULTS, NodeInfo, ServerInfo, SpaceNodeInfo, deleteServerInfo, ensureConfigDir, ensureDir, ensureOutputDir, extractFileId, extractFileIdFromMgpLink, extractFileIdFromUrl, extractSpaceInfo, formatDuration, formatFileSize, formatLogTime, generateId, generateMgpLink, getCurrentISOTime, isDesignPageUrl, isProcessRunning, killProcess, normalizePageUrl, parseMgpLink, readServerInfo, resolveOutputPath, roundToOneDecimal, trimNodeDefaults, writeServerInfo };