@hangox/mg-cli 1.0.5 → 1.0.7

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

@@ -3,12 +3,26 @@ import { WebSocket } from 'ws';
 /**
  * MG Plugin 常量定义
  */
-/** 默认端口 */
-declare const DEFAULT_PORT = 9527;
-/** 端口范围：起始 */
-declare const PORT_RANGE_START = 9527;
-/** 端口范围：结束 */
-declare const PORT_RANGE_END = 9536;
+/** 是否为开发模式（通过环境变量 MG_DEV_MODE=true 设置） */
+declare const IS_DEV_MODE: boolean;
+/** 生产环境默认端口 */
+declare const PROD_DEFAULT_PORT = 9527;
+/** 生产环境端口范围：起始 */
+declare const PROD_PORT_RANGE_START = 9527;
+/** 生产环境端口范围：结束 */
+declare const PROD_PORT_RANGE_END = 9536;
+/** 开发环境默认端口 */
+declare const DEV_DEFAULT_PORT = 19527;
+/** 开发环境端口范围：起始 */
+declare const DEV_PORT_RANGE_START = 19527;
+/** 开发环境端口范围：结束 */
+declare const DEV_PORT_RANGE_END = 19536;
+/** 默认端口（根据运行模式自动选择） */
+declare const DEFAULT_PORT: number;
+/** 端口范围：起始（根据运行模式自动选择） */
+declare const PORT_RANGE_START: number;
+/** 端口范围：结束（根据运行模式自动选择） */
+declare const PORT_RANGE_END: number;
 /** 最大尝试端口数 */
 declare const MAX_PORT_ATTEMPTS = 10;
 /** 端口扫描超时（毫秒） */
@@ -47,6 +61,7 @@ declare enum MessageType {
     REGISTER = "register",
     REGISTER_ACK = "register_ack",
     GET_NODE_BY_ID = "get_node_by_id",
+    GET_PAGE_BY_ID = "get_page_by_id",
     GET_ALL_NODES = "get_all_nodes",
     GET_SELECTION = "get_selection",
     EXPORT_IMAGE = "export_image",
@@ -216,7 +231,139 @@ interface ConnectionInfo {
     /** 最后活跃时间 */
     lastActiveAt: Date;
 }
-/** 节点信息（简化版） */
+/**
+ * 节点信息
+ *
+ * 包含 MasterGo 节点的所有属性，根据节点类型不同，可用属性也不同。
+ *
+ * ## 通用属性 (所有节点)
+ * - `id`: 节点唯一标识
+ * - `name`: 节点名称
+ * - `type`: 节点类型 (FRAME, TEXT, RECTANGLE, ELLIPSE, POLYGON, STAR, LINE, PEN, COMPONENT, COMPONENT_SET, INSTANCE, GROUP, BOOLEAN_OPERATION, SLICE, CONNECTOR, SECTION)
+ * - `visible`: 是否可见
+ * - `isLocked`: 是否锁定
+ * - `slotInfo`: 插槽信息
+ * - `componentPropertyReferences`: 组件属性引用
+ * - `attachedConnectorIds`: 连接的连接线 ID 数组
+ *
+ * ## 布局属性 (LayoutMixin)
+ * - `x`, `y`: 坐标
+ * - `width`, `height`: 尺寸
+ * - `rotation`: 旋转角度
+ * - `absoluteTransform`: 绝对变换矩阵
+ * - `relativeTransform`: 相对变换矩阵
+ * - `absoluteRenderBounds`: 渲染边界（含阴影/外描边）
+ * - `absoluteBoundingBox`: 绝对边界框
+ * - `bound`: 边界
+ * - `minWidth`, `maxWidth`, `minHeight`, `maxHeight`: 尺寸约束
+ * - `constrainProportions`: 锁定宽高比
+ * - `layoutPositioning`: 布局定位方式 (AUTO | ABSOLUTE)
+ * - `alignSelf`: 交叉轴对齐 (STRETCH | INHERIT)
+ * - `flexGrow`: 弹性增长 (0 | 1)
+ * - `scaleFactor`: 缩放因子
+ *
+ * ## 混合属性 (BlendMixin)
+ * - `opacity`: 不透明度
+ * - `blendMode`: 混合模式
+ * - `isMask`: 是否蒙版
+ * - `isMaskOutline`: 轮廓蒙版
+ * - `isMaskVisible`: 蒙版可见
+ * - `effects`: 效果数组（阴影、模糊等）
+ * - `effectStyleId`: 效果样式 ID
+ *
+ * ## 几何属性 (GeometryMixin)
+ * - `fills`: 填充数组
+ * - `strokes`: 描边数组
+ * - `strokeWeight`: 描边粗细
+ * - `strokeAlign`: 描边对齐 (CENTER | INSIDE | OUTSIDE)
+ * - `strokeCap`: 端点装饰
+ * - `strokeJoin`: 拐角装饰
+ * - `strokeStyle`: 描边样式 (SOLID | DASH | CUSTOM)
+ * - `dashCap`: 虚线端点
+ * - `strokeDashes`: 虚线数组
+ * - `fillStyleId`: 填充样式 ID
+ * - `strokeFillStyleId`: 描边填充样式 ID
+ * - `strokeWidthStyleId`: 描边宽度样式 ID
+ * - `paddingStyleId`: 内边距样式 ID
+ * - `spacingStyleId`: 间距样式 ID
+ * - `cornerRadiusStyleId`: 圆角样式 ID
+ *
+ * ## 矩形描边属性 (RectangleStrokeWeightMixin)
+ * - `strokeTopWeight`, `strokeLeftWeight`, `strokeBottomWeight`, `strokeRightWeight`: 各边描边粗细
+ *
+ * ## 圆角属性 (CornerMixin)
+ * - `cornerSmooth`: 角平滑度
+ * - `cornerRadius`: 统一圆角
+ * - `topLeftRadius`, `topRightRadius`, `bottomLeftRadius`, `bottomRightRadius`: 各角圆角
+ *
+ * ## 约束属性 (ConstraintMixin)
+ * - `constraints`: 约束设置 { horizontal, vertical }
+ *
+ * ## 容器属性 (ContainerMixin)
+ * - `expanded`: 是否展开
+ *
+ * ## 自动布局属性 (FrameContainerMixin)
+ * - `flexMode`: 自动布局方向 (NONE | HORIZONTAL | VERTICAL)
+ * - `flexWrap`: 换行设置 (WRAP | NO_WRAP)
+ * - `itemSpacing`: 主轴间距
+ * - `crossAxisSpacing`: 交叉轴间距
+ * - `mainAxisAlignItems`: 主轴对齐
+ * - `crossAxisAlignItems`: 交叉轴对齐
+ * - `mainAxisSizingMode`: 主轴尺寸模式 (FIXED | AUTO)
+ * - `crossAxisSizingMode`: 交叉轴尺寸模式 (FIXED | AUTO)
+ * - `crossAxisAlignContent`: 多行对齐
+ * - `strokesIncludedInLayout`: 描边计入布局
+ * - `itemReverseZIndex`: 反转堆叠
+ * - `paddingTop`, `paddingRight`, `paddingBottom`, `paddingLeft`: 内边距
+ * - `clipsContent`: 裁剪内容
+ * - `layoutGrids`: 布局网格
+ * - `gridStyleId`: 网格样式 ID
+ * - `overflowDirection`: 溢出方向
+ *
+ * ## 原型交互属性 (ReactionMixin)
+ * - `reactions`: 原型交互数组
+ *
+ * ## 导出属性 (ExportMixin)
+ * - `exportSettings`: 导出设置数组
+ *
+ * ## TEXT 节点特有属性
+ * - `characters`: 文本内容
+ * - `hasMissingFont`: 缺失字体
+ * - `hyperlinks`: 超链接数组
+ * - `textAlignHorizontal`: 水平对齐
+ * - `textAlignVertical`: 垂直对齐
+ * - `textAutoResize`: 自动调整
+ * - `paragraphSpacing`: 段落间距
+ * - `textStyles`: 文本样式数组
+ * - `listStyles`: 列表样式数组
+ *
+ * ## COMPONENT/COMPONENT_SET 节点特有属性
+ * - `variantProperties`: 变体属性
+ * - `componentPropertyValues`: 组件属性值
+ * - `description`: 描述
+ * - `alias`: 别名
+ * - `documentationLinks`: 文档链接
+ * - `isExternal`: 是否团队库组件
+ * - `ukey`: 唯一键
+ * - `publishStatus`: 发布状态
+ *
+ * ## INSTANCE 节点特有属性
+ * - `componentProperties`: 组件属性
+ * - `exposedInstances`: 暴露的实例 ID 数组
+ * - `isExposedInstance`: 是否暴露的实例
+ * - `mainComponentId`: 主组件 ID
+ * - `mainComponentName`: 主组件名称
+ *
+ * ## 其他节点特有属性
+ * - ELLIPSE: `arcData`
+ * - POLYGON/STAR: `pointCount`
+ * - STAR: `innerRadius`
+ * - LINE: `leftStrokeCap`, `rightStrokeCap`
+ * - PEN: `penNetwork`, `penPaths`
+ * - BOOLEAN_OPERATION: `booleanOperation`
+ * - CONNECTOR: `connectorStart`, `connectorEnd`, `connectorStartStrokeCap`, `connectorEndStrokeCap`, `connectorText`
+ * - SLICE: `isPreserveRatio`
+ */
 interface NodeInfo {
     /** 节点 ID */
     id: string;
@@ -236,7 +383,7 @@ interface NodeInfo {
     height?: number;
     /** 子节点 */
     children?: NodeInfo[];
-    /** 其他属性 */
+    /** 其他属性（根据节点类型不同而不同） */
     [key: string]: unknown;
 }
 /** 空间节点信息（仅包含位置和尺寸，用于 AI 理解空间布局） */
@@ -267,6 +414,17 @@ interface GetNodeParams {
     /** 索引签名 */
     [key: string]: unknown;
 }
+/** 获取页面参数 */
+interface GetPageParams {
+    /** 页面 ID */
+    pageId: string;
+    /** 遍历深度 */
+    maxDepth?: number;
+    /** 是否包含不可见节点 */
+    includeInvisible?: boolean;
+    /** 索引签名 */
+    [key: string]: unknown;
+}
 /** 获取所有节点参数 */
 interface GetAllNodesParams {
     /** 遍历深度 */
@@ -518,7 +676,7 @@ interface ManagedWebSocket extends WebSocket {
  */
 declare class ConnectionManager {
     private logger;
-    /** Provider 连接（按页面 URL 索引） */
+    /** Provider 连接（按页面 URL 索引，支持同 URL 多个连接） */
     private providers;
     /** Consumer 连接 */
     private consumers;
@@ -552,7 +710,7 @@ declare class ConnectionManager {
      */
     updateLastActive(ws: ManagedWebSocket): void;
     /**
-     * 根据页面 URL 查找 Provider
+     * 根据页面 URL 查找 Provider（返回第一个可用的连接）
      */
     findProviderByPageUrl(pageUrl: string): ManagedWebSocket | undefined;
     /**
@@ -625,4 +783,4 @@ declare class RequestHandler {
     cleanupAll(): void;
 }
 
-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 };
+export { type ServerOptions as $, type PongMessage as A, type BaseMessage as B, CONFIG_DIR as C, DEV_DEFAULT_PORT as D, ErrorCode as E, type ConnectionInfo as F, type GetNodeParams as G, HEARTBEAT_INTERVAL as H, IS_DEV_MODE as I, type GetPageParams as J, type GetAllNodesParams as K, LOG_DIR as L, MAX_PORT_ATTEMPTS as M, type NodeInfo as N, type ExportImageParams as O, PROD_DEFAULT_PORT as P, type OutputFormatter as Q, REQUEST_TIMEOUT as R, type ServerInfo as S, type CliOptions as T, type RGBA as U, type MgPageInfo as V, type AllPagesInfo as W, type ConnectedPageInfo as X, type ServerStatusResponse as Y, MGServer as Z, createServer as _, type SpaceNodeInfo as a, ConnectionManager as a0, type ManagedWebSocket as a1, RequestHandler as a2, Logger as a3, createLogger as a4, LogLevel as a5, type LoggerOptions as a6, PROD_PORT_RANGE_START as b, PROD_PORT_RANGE_END as c, DEV_PORT_RANGE_START as d, DEV_PORT_RANGE_END as e, DEFAULT_PORT as f, PORT_RANGE_START as g, PORT_RANGE_END as h, PORT_SCAN_TIMEOUT as i, SERVER_INFO_FILE as j, SERVER_LOG_FILE as k, HEARTBEAT_TIMEOUT as l, SERVER_START_TIMEOUT as m, RETRY_INTERVALS as n, MAX_RETRY_COUNT as o, ConnectionType as p, MessageType as q, ErrorNames as r, ErrorMessages as s, MGError as t, createError as u, type RequestMessage as v, type ResponseMessage as w, type ErrorInfo as x, type RegisterMessage as y, type PingMessage as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 { S as ServerInfo, N as NodeInfo, a as SpaceNodeInfo } from './index-DUQN5gSR.js';
+export { W as AllPagesInfo, B as BaseMessage, C as CONFIG_DIR, T as CliOptions, X as ConnectedPageInfo, F as ConnectionInfo, a0 as ConnectionManager, p as ConnectionType, f as DEFAULT_PORT, D as DEV_DEFAULT_PORT, e as DEV_PORT_RANGE_END, d as DEV_PORT_RANGE_START, E as ErrorCode, x as ErrorInfo, s as ErrorMessages, r as ErrorNames, O as ExportImageParams, K as GetAllNodesParams, G as GetNodeParams, J as GetPageParams, H as HEARTBEAT_INTERVAL, l as HEARTBEAT_TIMEOUT, I as IS_DEV_MODE, L as LOG_DIR, a5 as LogLevel, a3 as Logger, a6 as LoggerOptions, M as MAX_PORT_ATTEMPTS, o as MAX_RETRY_COUNT, t as MGError, Z as MGServer, a1 as ManagedWebSocket, q as MessageType, V as MgPageInfo, Q as OutputFormatter, h as PORT_RANGE_END, g as PORT_RANGE_START, i as PORT_SCAN_TIMEOUT, P as PROD_DEFAULT_PORT, c as PROD_PORT_RANGE_END, b as PROD_PORT_RANGE_START, z as PingMessage, A as PongMessage, R as REQUEST_TIMEOUT, n as RETRY_INTERVALS, U as RGBA, y as RegisterMessage, a2 as RequestHandler, v as RequestMessage, w as ResponseMessage, j as SERVER_INFO_FILE, k as SERVER_LOG_FILE, m as SERVER_START_TIMEOUT, $ as ServerOptions, Y as ServerStatusResponse, u as createError, a4 as createLogger, _ as createServer } from './index-DUQN5gSR.js';
 import 'ws';
 
 /**
@@ -56,15 +56,18 @@ declare function isDesignPageUrl(url: string): boolean;
 /**
  * 解析 mgp:// 链接
  *
- * 支持的格式 (queryParams 格式，nodeId 需要 URL 编码):
+ * 支持的格式 (queryParams 格式，nodeId/pageId 需要 URL 编码):
  * - mgp://mastergo.netease.com/file/174135798361888?nodeId=123%3A456 (单个节点)
  * - mgp://mastergo.netease.com/file/174135798361888?nodeId=0%3A8633&nodePath=314%3A13190%2F0%3A8633 (带父节点路径)
+ * - mgp://mastergo.netease.com/file/174135798361888?pageId=0%3A1 (页面链接)
  *
  * 输出: { pageUrl: 'mastergo.netease.com/file/174135798361888', nodeId: '0:8633', nodePath: ['314:13190', '0:8633'] }
+ *       或 { pageUrl: 'mastergo.netease.com/file/174135798361888', pageId: '0:1' }
  */
 declare function parseMgpLink(link: string): {
     pageUrl: string;
-    nodeId: string;
+    nodeId?: string;
+    pageId?: string;
     nodePath?: string[];
 } | null;
 /**
@@ -75,6 +78,13 @@ declare function parseMgpLink(link: string): {
  * @param nodePath 可选的父节点路径（会被 URL 编码）
  */
 declare function generateMgpLink(pageUrl: string, nodeId: string, nodePath?: string[]): string;
+/**
+ * 生成 mgp:// 页面链接
+ *
+ * @param pageUrl 页面 URL（会被标准化）
+ * @param pageId 页面 ID（会被 URL 编码）
+ */
+declare function generatePageLink(pageUrl: string, pageId: string): string;
 /**
  * 格式化文件大小
  */
@@ -153,4 +163,4 @@ declare function trimNodeDefaults<T extends Record<string, unknown>>(node: T): T
  */
 declare function extractSpaceInfo(node: NodeInfo): SpaceNodeInfo;
 
-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 };
+export { NODE_DEFAULTS, NodeInfo, ServerInfo, SpaceNodeInfo, deleteServerInfo, ensureConfigDir, ensureDir, ensureOutputDir, extractFileId, extractFileIdFromMgpLink, extractFileIdFromUrl, extractSpaceInfo, formatDuration, formatFileSize, formatLogTime, generateId, generateMgpLink, generatePageLink, getCurrentISOTime, isDesignPageUrl, isProcessRunning, killProcess, normalizePageUrl, parseMgpLink, readServerInfo, resolveOutputPath, roundToOneDecimal, trimNodeDefaults, writeServerInfo };

package/dist/index.js

@@ -1,9 +1,16 @@
 // src/shared/constants.ts
 import { homedir } from "os";
 import { join } from "path";
-var DEFAULT_PORT = 9527;
-var PORT_RANGE_START = 9527;
-var PORT_RANGE_END = 9536;
+var IS_DEV_MODE = process.env.MG_DEV_MODE === "true";
+var PROD_DEFAULT_PORT = 9527;
+var PROD_PORT_RANGE_START = 9527;
+var PROD_PORT_RANGE_END = 9536;
+var DEV_DEFAULT_PORT = 19527;
+var DEV_PORT_RANGE_START = 19527;
+var DEV_PORT_RANGE_END = 19536;
+var DEFAULT_PORT = IS_DEV_MODE ? DEV_DEFAULT_PORT : PROD_DEFAULT_PORT;
+var PORT_RANGE_START = IS_DEV_MODE ? DEV_PORT_RANGE_START : PROD_PORT_RANGE_START;
+var PORT_RANGE_END = IS_DEV_MODE ? DEV_PORT_RANGE_END : PROD_PORT_RANGE_END;
 var MAX_PORT_ATTEMPTS = 10;
 var PORT_SCAN_TIMEOUT = 500;
 var CONFIG_DIR = join(homedir(), ".mg-plugin");
@@ -27,6 +34,7 @@ var MessageType = /* @__PURE__ */ ((MessageType2) => {
   MessageType2["REGISTER"] = "register";
   MessageType2["REGISTER_ACK"] = "register_ack";
   MessageType2["GET_NODE_BY_ID"] = "get_node_by_id";
+  MessageType2["GET_PAGE_BY_ID"] = "get_page_by_id";
   MessageType2["GET_ALL_NODES"] = "get_all_nodes";
   MessageType2["GET_SELECTION"] = "get_selection";
   MessageType2["EXPORT_IMAGE"] = "export_image";
@@ -83,7 +91,7 @@ var ErrorNames = {
 var ErrorMessages = {
   ["E001" /* CONNECTION_FAILED */]: "\u65E0\u6CD5\u8FDE\u63A5\u5230 MG Server",
   ["E002" /* CONNECTION_TIMEOUT */]: "\u8FDE\u63A5\u8D85\u65F6",
-  ["E003" /* NO_PAGE_CONNECTED */]: "\u6CA1\u6709 MasterGo \u9875\u9762\u8FDE\u63A5\u5230 Server",
+  ["E003" /* NO_PAGE_CONNECTED */]: "\u6CA1\u6709 MasterGo \u9875\u9762\u8FDE\u63A5\u5230 Server\u3002\u8BF7\u5B89\u88C5 MG Plugin \u6D4F\u89C8\u5668\u6269\u5C55: https://chromewebstore.google.com/detail/mg-plugin/ddhihanlpcdneicohnglnaliefnkaeja",
   ["E004" /* PAGE_NOT_FOUND */]: "\u672A\u627E\u5230\u5339\u914D\u7684\u9875\u9762",
   ["E005" /* NODE_NOT_FOUND */]: "\u8282\u70B9\u4E0D\u5B58\u5728",
   ["E006" /* NO_SELECTION */]: "\u6CA1\u6709\u9009\u4E2D\u4EFB\u4F55\u8282\u70B9",
@@ -218,27 +226,44 @@ function parseMgpLink(link) {
     const queryString = urlPart.slice(questionMarkIndex + 1);
     const params = new URLSearchParams(queryString);
     const encodedNodeId = params.get("nodeId");
-    if (!encodedNodeId) {
+    const encodedPageId = params.get("pageId");
+    if (!encodedNodeId && !encodedPageId) {
       return null;
     }
-    const nodeId = decodeURIComponent(encodedNodeId);
-    if (!/^(\d+:\d+)(\/\d+:\d+)*$/.test(nodeId)) {
+    if (encodedNodeId && encodedPageId) {
       return null;
     }
-    const encodedNodePath = params.get("nodePath");
-    let nodePath;
-    if (encodedNodePath) {
-      const decodedNodePath = decodeURIComponent(encodedNodePath);
-      nodePath = decodedNodePath.split("/").filter(Boolean);
-      if (!nodePath.every((segment) => /^\d+:\d+$/.test(segment))) {
+    if (encodedNodeId) {
+      const nodeId = decodeURIComponent(encodedNodeId);
+      if (!/^(\d+:\d+)(\/\d+:\d+)*$/.test(nodeId)) {
         return null;
       }
+      const encodedNodePath = params.get("nodePath");
+      let nodePath;
+      if (encodedNodePath) {
+        const decodedNodePath = decodeURIComponent(encodedNodePath);
+        nodePath = decodedNodePath.split("/").filter(Boolean);
+        if (!nodePath.every((segment) => /^\d+:\d+$/.test(segment))) {
+          return null;
+        }
+      }
+      return {
+        pageUrl,
+        nodeId,
+        nodePath
+      };
     }
-    return {
-      pageUrl,
-      nodeId,
-      nodePath
-    };
+    if (encodedPageId) {
+      const pageId = decodeURIComponent(encodedPageId);
+      if (!/^\d+:\d+$/.test(pageId)) {
+        return null;
+      }
+      return {
+        pageUrl,
+        pageId
+      };
+    }
+    return null;
   } catch {
     return null;
   }
@@ -253,6 +278,11 @@ function generateMgpLink(pageUrl, nodeId, nodePath) {
   }
   return link;
 }
+function generatePageLink(pageUrl, pageId) {
+  const normalizedUrl = normalizePageUrl(pageUrl);
+  const encodedPageId = encodeURIComponent(pageId);
+  return `mgp://${normalizedUrl}?pageId=${encodedPageId}`;
+}
 function formatFileSize(bytes) {
   if (bytes < 1024) {
     return `${bytes} \u5B57\u8282`;
@@ -550,7 +580,7 @@ function createLogger(options) {
 // src/server/connection-manager.ts
 var ConnectionManager = class {
   logger;
-  /** Provider 连接（按页面 URL 索引） */
+  /** Provider 连接（按页面 URL 索引，支持同 URL 多个连接） */
   providers = /* @__PURE__ */ new Map();
   /** Consumer 连接 */
   consumers = /* @__PURE__ */ new Map();
@@ -586,7 +616,8 @@ var ConnectionManager = class {
    */
   checkHeartbeats() {
     const now = Date.now();
-    for (const [id, ws] of this.allConnections) {
+    const entries = Array.from(this.allConnections.entries());
+    for (const [id, ws] of entries) {
       const lastActive = ws.connectionInfo.lastActiveAt.getTime();
       const elapsed = now - lastActive;
       if (elapsed > HEARTBEAT_TIMEOUT) {
@@ -616,14 +647,10 @@ var ConnectionManager = class {
     managedWs.isAlive = true;
     this.allConnections.set(connectionId, managedWs);
     if (type === "provider" /* PROVIDER */ && pageUrl) {
-      const existing = this.providers.get(pageUrl);
-      if (existing) {
-        this.logger.info(`\u9875\u9762 ${pageUrl} \u5DF2\u6709\u8FDE\u63A5\uFF0C\u66FF\u6362\u4E3A\u65B0\u8FDE\u63A5`);
-        this.removeConnection(existing);
-        existing.close();
-      }
-      this.providers.set(pageUrl, managedWs);
-      this.logger.info(`Provider \u8FDE\u63A5: ${pageUrl}`);
+      const existing = this.providers.get(pageUrl) || [];
+      existing.push(managedWs);
+      this.providers.set(pageUrl, existing);
+      this.logger.info(`Provider \u8FDE\u63A5: ${pageUrl} (\u5F53\u524D\u8BE5\u9875\u9762\u8FDE\u63A5\u6570: ${existing.length})`);
     } else if (type === "consumer" /* CONSUMER */) {
       this.consumers.set(connectionId, managedWs);
       this.logger.info(`Consumer \u8FDE\u63A5: ${connectionId}`);
@@ -637,8 +664,17 @@ var ConnectionManager = class {
     const { connectionId, connectionInfo } = ws;
     this.allConnections.delete(connectionId);
     if (connectionInfo.type === "provider" /* PROVIDER */ && connectionInfo.pageUrl) {
-      this.providers.delete(connectionInfo.pageUrl);
-      this.logger.info(`Provider \u65AD\u5F00: ${connectionInfo.pageUrl}`);
+      const connections = this.providers.get(connectionInfo.pageUrl);
+      if (connections) {
+        const index = connections.findIndex((c) => c.connectionId === connectionId);
+        if (index !== -1) {
+          connections.splice(index, 1);
+          if (connections.length === 0) {
+            this.providers.delete(connectionInfo.pageUrl);
+          }
+        }
+      }
+      this.logger.info(`Provider \u65AD\u5F00: ${connectionInfo.pageUrl} (\u8FDE\u63A5ID: ${connectionId})`);
     } else if (connectionInfo.type === "consumer" /* CONSUMER */) {
       this.consumers.delete(connectionId);
       this.logger.info(`Consumer \u65AD\u5F00: ${connectionId}`);
@@ -652,31 +688,48 @@ var ConnectionManager = class {
     ws.isAlive = true;
   }
   /**
-   * 根据页面 URL 查找 Provider
+   * 根据页面 URL 查找 Provider（返回第一个可用的连接）
    */
   findProviderByPageUrl(pageUrl) {
-    return this.providers.get(pageUrl);
+    const connections = this.providers.get(pageUrl);
+    return connections?.[0];
   }
   /**
    * 获取第一个可用的 Provider
    */
   getFirstProvider() {
-    const iterator = this.providers.values();
-    const first = iterator.next();
-    return first.value;
+    const allConnections = Array.from(this.providers.values());
+    for (const connections of allConnections) {
+      if (connections.length > 0) {
+        return connections[0];
+      }
+    }
+    return void 0;
   }
   /**
    * 获取所有 Provider 信息
    */
   getAllProviders() {
-    return Array.from(this.providers.values()).map((ws) => ws.connectionInfo);
+    const result = [];
+    const allConnections = Array.from(this.providers.values());
+    for (const connections of allConnections) {
+      for (const ws of connections) {
+        result.push(ws.connectionInfo);
+      }
+    }
+    return result;
   }
   /**
    * 获取连接统计
    */
   getStats() {
+    let providerCount = 0;
+    const allConnections = Array.from(this.providers.values());
+    for (const connections of allConnections) {
+      providerCount += connections.length;
+    }
     return {
-      providers: this.providers.size,
+      providers: providerCount,
       consumers: this.consumers.size,
       total: this.allConnections.size
     };
@@ -692,7 +745,8 @@ var ConnectionManager = class {
    */
   closeAll() {
     this.stopHeartbeatCheck();
-    for (const ws of this.allConnections.values()) {
+    const allWs = Array.from(this.allConnections.values());
+    for (const ws of allWs) {
       ws.close();
     }
     this.providers.clear();
@@ -728,7 +782,7 @@ var RequestHandler = class {
     } else {
       provider = this.connectionManager.getFirstProvider();
       if (!provider) {
-        this.sendError(consumer, requestId, "E003" /* NO_PAGE_CONNECTED */, "\u6CA1\u6709\u9875\u9762\u8FDE\u63A5\u5230 Server");
+        this.sendError(consumer, requestId, "E003" /* NO_PAGE_CONNECTED */, ErrorMessages["E003" /* NO_PAGE_CONNECTED */]);
         return;
       }
     }
@@ -846,24 +900,11 @@ function getVersion() {
   try {
     const currentFile = fileURLToPath(import.meta.url);
     const currentDir = dirname3(currentFile);
-    const versionFilePaths = [
-      join2(currentDir, "..", "VERSION"),
-      // dist/xxx.js -> ../VERSION
-      join2(currentDir, "..", "..", "VERSION")
-      // src/shared/version.ts -> ../../VERSION
-    ];
-    for (const versionFilePath of versionFilePaths) {
-      if (existsSync3(versionFilePath)) {
-        const version = readFileSync2(versionFilePath, "utf-8").trim();
-        if (version) {
-          cachedVersion = version;
-          return cachedVersion;
-        }
-      }
-    }
     const packageJsonPaths = [
       join2(currentDir, "..", "package.json"),
+      // dist/xxx.js -> ../package.json
       join2(currentDir, "..", "..", "package.json")
+      // src/shared/version.ts -> ../../package.json
     ];
     for (const packageJsonPath of packageJsonPaths) {
       if (existsSync3(packageJsonPath)) {
@@ -1132,11 +1173,15 @@ export {
   ConnectionManager,
   ConnectionType,
   DEFAULT_PORT,
+  DEV_DEFAULT_PORT,
+  DEV_PORT_RANGE_END,
+  DEV_PORT_RANGE_START,
   ErrorCode,
   ErrorMessages,
   ErrorNames,
   HEARTBEAT_INTERVAL,
   HEARTBEAT_TIMEOUT,
+  IS_DEV_MODE,
   LOG_DIR,
   LogLevel,
   Logger,
@@ -1149,6 +1194,9 @@ export {
   PORT_RANGE_END,
   PORT_RANGE_START,
   PORT_SCAN_TIMEOUT,
+  PROD_DEFAULT_PORT,
+  PROD_PORT_RANGE_END,
+  PROD_PORT_RANGE_START,
   REQUEST_TIMEOUT,
   RETRY_INTERVALS,
   RequestHandler,
@@ -1171,6 +1219,7 @@ export {
   formatLogTime,
   generateId,
   generateMgpLink,
+  generatePageLink,
   getCurrentISOTime,
   isDesignPageUrl,
   isProcessRunning,