vite-plugin-aipanel 1.2.9 → 1.2.10

package/es/core/official-meta.d.ts

@@ -0,0 +1,9 @@
+/** AUTO-GENERATED by packages/vite/scripts/sync-official-meta.mjs (build) — 不手改；升级 chrome-devtools-mcp 后重跑构建即可。 */
+export interface OfficialToolMeta {
+    name: string;
+    category: "INPUT" | "NAVIGATION" | "EMULATION" | "PERFORMANCE" | "NETWORK" | "DEBUGGING" | "EXTENSIONS" | "THIRD_PARTY" | "MEMORY" | "WEBMCP" | "PWA" | "";
+    readOnlyHint: boolean;
+    pageScoped: boolean;
+    conditions: string[];
+}
+export declare const OFFICIAL_TOOL_META: OfficialToolMeta[];

package/es/core/official-meta.mjs

@@ -0,0 +1,62 @@
+const OFFICIAL_TOOL_META = [
+  { name: "click", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "click_at", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: ["experimentalVision"] },
+  { name: "close_heapsnapshot", category: "MEMORY", readOnlyHint: false, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "close_page", category: "NAVIGATION", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "compare_heapsnapshots", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "drag", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "emulate", category: "EMULATION", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "evaluate_script", category: "DEBUGGING", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "execute_3p_developer_tool", category: "THIRD_PARTY", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "execute_webmcp_tool", category: "WEBMCP", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "fill", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "fill_form", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "get_console_message", category: "DEBUGGING", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "get_heapsnapshot_class_nodes", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_details", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_dominators", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_duplicate_strings", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_edges", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_object_details", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_retainers", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_retaining_paths", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_summary", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_network_request", category: "NETWORK", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "get_os_app_state", category: "PWA", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "get_tab_id", category: "NAVIGATION", readOnlyHint: true, pageScoped: true, conditions: ["experimentalInteropTools"] },
+  { name: "handle_dialog", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "hover", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "install_extension", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "install_pwa", category: "PWA", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "launch_pwa", category: "PWA", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "lighthouse_audit", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "list_3p_developer_tools", category: "THIRD_PARTY", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "list_extensions", category: "EXTENSIONS", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "list_network_requests", category: "NETWORK", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "list_pages", category: "NAVIGATION", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "list_webmcp_tools", category: "WEBMCP", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "navigate_page", category: "NAVIGATION", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "new_page", category: "NAVIGATION", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "performance_analyze_insight", category: "PERFORMANCE", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "performance_start_trace", category: "PERFORMANCE", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "performance_stop_trace", category: "PERFORMANCE", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "press_key", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "query_heapsnapshot_objects", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "reload_extension", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "resize_page", category: "EMULATION", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "screencast_start", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: ["experimentalScreencast"] },
+  { name: "screencast_stop", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: ["experimentalScreencast"] },
+  { name: "select_page", category: "NAVIGATION", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "take_heapsnapshot", category: "MEMORY", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "take_screenshot", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "take_snapshot", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "trigger_extension_action", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "type_text", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "uninstall_extension", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "uninstall_pwa", category: "PWA", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "upload_file", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "wait_for", category: "NAVIGATION", readOnlyHint: true, pageScoped: true, conditions: [] }
+];
+export {
+  OFFICIAL_TOOL_META
+};

package/es/core/official-tools.d.ts

@@ -0,0 +1,7 @@
+import { type CustomTool } from "./mcp-tools";
+import type { McpProxy } from "./mcp-proxy";
+/**
+ * 项目白名单的官方工具集（英文 schema/描述，已追加 pageId）。
+ * 官方当前版本缺失某名时跳过（名称跟随官方，不本地复制）。
+ */
+export declare function getOfficialProjectTools(mcp: McpProxy): Promise<CustomTool[]>;

package/es/core/official-tools.mjs

@@ -0,0 +1,54 @@
+import { createLogger } from "@aipanel/core/node";
+import {
+  MCP_PREFIX,
+  OFFICIAL_NO_PAGE_TOOLS,
+  PROJECT_DESCRIPTION_NOTES,
+  currentOfficialShorts,
+  displayToolName,
+  withPageIdSchema
+} from "./mcp-tools.mjs";
+const log = createLogger("OfficialChromeTools");
+let cached = null;
+async function fetchOfficialEntries(mcp) {
+  const res = await mcp.call("tools/list", {});
+  const map = /* @__PURE__ */ new Map();
+  for (const t of res?.result?.tools ?? []) {
+    const raw = String(t?.name ?? "");
+    const short = raw.startsWith(MCP_PREFIX) ? raw.slice(MCP_PREFIX.length) : raw;
+    if (!short) continue;
+    const schema = t?.inputSchema ?? { type: "object", properties: {} };
+    map.set(short, { short, description: String(t?.description ?? ""), schema });
+  }
+  return map;
+}
+function ensureOfficialEntries(mcp) {
+  if (!cached) {
+    cached = fetchOfficialEntries(mcp).catch((e) => {
+      cached = null;
+      log.warn("Failed to fetch official chrome-devtools-mcp tools", {
+        error: e instanceof Error ? e.message : String(e)
+      });
+      throw e;
+    });
+  }
+  return cached;
+}
+async function getOfficialProjectTools(mcp) {
+  const map = await ensureOfficialEntries(mcp);
+  const tools = [];
+  for (const short of currentOfficialShorts()) {
+    const entry = map.get(short);
+    if (!entry) {
+      log.warn("Requested official tool missing from server tools/list (skip)", { short });
+      continue;
+    }
+    const schema = OFFICIAL_NO_PAGE_TOOLS.has(short) ? entry.schema : withPageIdSchema(entry.schema);
+    const note = PROJECT_DESCRIPTION_NOTES[short];
+    const description = note ? entry.description ? `${entry.description} ${note}` : note : entry.description;
+    tools.push({ name: displayToolName(short), description, inputSchema: schema });
+  }
+  return tools;
+}
+export {
+  getOfficialProjectTools
+};

package/es/core/service.mjs

@@ -2,9 +2,8 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { randomUUID } from "node:crypto";
-import { DEFAULT_PROXY_PORT, SERVER_START_TIMEOUT, ChromeMcpWarmupErrorType } from "@aipanel/core";
-import { createLogger, findAvailablePort } from "@aipanel/core/node";
-import { findGitRoot, waitForServer } from "../utils/system.mjs";
+import { DEFAULT_PROXY_PORT, SERVER_START_TIMEOUT, SSE_EVENT_TYPES, ChromeMcpWarmupErrorType } from "@aipanel/core";
+import { createLogger, findAvailablePort, findGitRoot, waitForServer } from "@aipanel/core/node";
 import { startProxyServer } from "./proxy-server.mjs";
 const log = createLogger("Service");
 class AIPanelService {
@@ -43,7 +42,7 @@ class AIPanelService {
     this.currentTask = { task, ...data };
     this.sseClients.forEach((client) => {
       try {
-        client.write(`data: ${JSON.stringify({ type: "TASK_UPDATE", task, ...data })}
+        client.write(`data: ${JSON.stringify({ type: SSE_EVENT_TYPES.TASK_UPDATE, task, ...data })}
 
 `);
       } catch (e) {
@@ -230,7 +229,7 @@ class AIPanelService {
   pushProviderEvent(event) {
     this.sseClients.forEach((client) => {
       try {
-        client.write(`data: ${JSON.stringify({ type: "SESSION_EVENT", event })}
+        client.write(`data: ${JSON.stringify({ type: SSE_EVENT_TYPES.SESSION_EVENT, event })}
 
 `);
       } catch (e) {

package/es/endpoints/context.mjs

@@ -1,4 +1,4 @@
-import { CONTEXT_API_PATH } from "@aipanel/core";
+import { CONTEXT_API_PATH, SSE_EVENT_TYPES } from "@aipanel/core";
 import { RequestContext, createLogger } from "@aipanel/core/node";
 import { ensureNodeId } from "@aipanel/core";
 const log = createLogger("Endpoints:Context");
@@ -28,7 +28,7 @@ function setupContextEndpoint(server, ctx) {
       let sentCount = 0;
       ctx.sseClients.forEach((client) => {
         try {
-          client.write(`data: ${JSON.stringify({ type: "CLEAR_ELEMENTS" })}
+          client.write(`data: ${JSON.stringify({ type: SSE_EVENT_TYPES.CLEAR_ELEMENTS })}
 
 `);
           sentCount++;

package/es/endpoints/host-events.mjs

@@ -1,6 +1,5 @@
 import { HOST_EVENTS_API_PATH } from "@aipanel/core";
-import { RequestContext, createLogger } from "@aipanel/core/node";
-const log = createLogger("Endpoints:HostEvents");
+import { RequestContext } from "@aipanel/core/node";
 function setupHostEventsEndpoint(server, ctx) {
   server.middlewares.use(HOST_EVENTS_API_PATH, async (req, res) => {
     const reqCtx = new RequestContext(req.method || "GET", HOST_EVENTS_API_PATH);

package/es/endpoints/index.d.ts

@@ -3,7 +3,7 @@ import type { EndpointContext } from "./types";
 import { MCP_API_PATH } from "./mcp";
 import { VUE_DEVTOOLS_API_PATH } from "./vue-devtools";
 import type { McpProxy } from "../core/mcp-proxy";
-import { LOGS_API_PATH, type LogFileConfig } from "@aipanel/core";
+import { LOGS_API_PATH, type ChromeProjectOptions, type LogFileConfig } from "@aipanel/core";
 export * from "./types";
 export { LOGS_API_PATH, MCP_API_PATH, VUE_DEVTOOLS_API_PATH };
-export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy, logFiles?: LogFileConfig[]): void;
+export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions): void;

package/es/endpoints/index.mjs

@@ -10,7 +10,7 @@ import { setupMcpEndpoint, MCP_API_PATH } from "./mcp.mjs";
 import { setupVueDevtoolsEndpoint, VUE_DEVTOOLS_API_PATH } from "./vue-devtools.mjs";
 import { LOGS_API_PATH } from "@aipanel/core";
 export * from "./types.mjs";
-function setupMiddlewares(server, ctx, mcp, logFiles) {
+function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject) {
   setupWidgetEndpoints(server, ctx);
   setupContextEndpoint(server, ctx);
   setupStartEndpoint(server, ctx);
@@ -20,7 +20,7 @@ function setupMiddlewares(server, ctx, mcp, logFiles) {
   setupWarmupEndpoint(server, ctx);
   setupLogsEndpoint(server);
   if (mcp) {
-    setupMcpEndpoint(server, mcp, () => ctx.getPageContext(), logFiles ?? []);
+    setupMcpEndpoint(server, mcp, () => ctx.getPageContext(), logFiles ?? [], chromeProject);
     setupVueDevtoolsEndpoint(server, mcp);
   }
 }

package/es/endpoints/mcp.d.ts

@@ -1,6 +1,6 @@
 import type { ViteDevServer } from "vite";
-import type { LogFileConfig, PageContext } from "@aipanel/core";
+import type { ChromeProjectOptions, LogFileConfig, PageContext } from "@aipanel/core";
 import { MCP_API_PATH } from "@aipanel/core";
 import { McpProxy } from "../core/mcp-proxy";
 export { MCP_API_PATH };
-export declare function setupMcpEndpoint(server: ViteDevServer, mcp: McpProxy, getPageContext: () => PageContext, logFiles?: LogFileConfig[]): void;
+export declare function setupMcpEndpoint(server: ViteDevServer, mcp: McpProxy, getPageContext: () => PageContext, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions): void;

package/es/endpoints/mcp.mjs

@@ -1,4 +1,4 @@
-import { MCP_API_PATH, VUE_DEVTOOLS_ACTIONS, sleep } from "@aipanel/core";
+import { MCP_API_PATH, VUE_DEVTOOLS_ACTIONS } from "@aipanel/core";
 import {
   createLogger,
   getProcessLogBuffer,
@@ -7,15 +7,17 @@ import {
 import {
   parseListPages,
   resolveChromePageId,
-  getProjectOrigins,
+  isPageAllowed,
   isProjectPage,
   validatePageId
 } from "../core/mcp-chrome.mjs";
-import { CUSTOM_TOOLS } from "../core/mcp-tools.mjs";
+import { resolveProjectScope } from "../core/chrome-project.mjs";
+import { CUSTOM_TOOLS, isAllowedToolName } from "../core/mcp-tools.mjs";
+import { getOfficialProjectTools } from "../core/official-tools.mjs";
 import { executeAction } from "./vue-devtools.mjs";
-import { findGitRoot } from "../utils/system.mjs";
+import { findGitRoot } from "@aipanel/core/node";
 const log = createLogger("McpEndpoint");
-function setupMcpEndpoint(server, mcp, getPageContext, logFiles = []) {
+function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProject) {
   const projectRoot = findGitRoot(process.cwd());
   server.middlewares.use(async (req, res, next) => {
     if (!req.url?.startsWith(MCP_API_PATH)) return next();
@@ -38,11 +40,14 @@ function setupMcpEndpoint(server, mcp, getPageContext, logFiles = []) {
       return;
     }
     if (req.method === "POST") {
+      const scope = resolveProjectScope(server, chromeProject);
       await handlePost(
         req,
         res,
         mcp,
-        getProjectOrigins(server),
+        scope.origins,
+        scope.operationsOrigins,
+        scope.includeExtensions,
         getPageContext,
         logFiles,
         projectRoot
@@ -63,7 +68,7 @@ function handleGetSse(req, res, mcp) {
   const keepAlive = setInterval(() => res.write(":ping\n\n"), 15e3);
   req.on("close", () => clearInterval(keepAlive));
 }
-async function handlePost(req, res, mcp, projectOrigins, getPageContext, logFiles, projectRoot) {
+async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot) {
   try {
     const body = await readBody(req);
     if (!body) {
@@ -75,7 +80,7 @@ async function handlePost(req, res, mcp, projectOrigins, getPageContext, logFile
     log.debug("MCP request", { method, body: body.substring(0, 150) });
     switch (method) {
       case "tools/list":
-        return handleToolsList(res, id, mcp.sessionId, logFiles);
+        return await handleToolsList(res, id, mcp, logFiles);
       case "tools/call":
         return await handleToolsCall(
           res,
@@ -83,6 +88,8 @@ async function handlePost(req, res, mcp, projectOrigins, getPageContext, logFile
           body,
           mcp,
           projectOrigins,
+          operationsOrigins,
+          includeExtensions,
           getPageContext,
           logFiles,
           projectRoot
@@ -98,16 +105,24 @@ async function handlePost(req, res, mcp, projectOrigins, getPageContext, logFile
     });
   }
 }
-function handleToolsList(res, id, sessionId, logFiles) {
-  const tools = [...CUSTOM_TOOLS, ...buildServiceLogTools(logFiles)];
-  sendMcpJson(res, 200, { jsonrpc: "2.0", id, result: { tools } }, sessionId);
+async function handleToolsList(res, id, mcp, logFiles) {
+  let official = [];
+  try {
+    official = await getOfficialProjectTools(mcp);
+  } catch (e) {
+    log.warn("official chrome tools unavailable for tools/list", {
+      error: e instanceof Error ? e.message : String(e)
+    });
+  }
+  const tools = [...official, ...CUSTOM_TOOLS, ...buildServiceLogTools(logFiles)];
+  sendMcpJson(res, 200, { jsonrpc: "2.0", id, result: { tools } }, mcp.sessionId);
 }
-function handleToolsCall(res, id, body, mcp, projectOrigins, getPageContext, logFiles, projectRoot) {
+function handleToolsCall(res, id, body, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot) {
   const params = tryParseParams(body);
   const toolName = params?.name;
   const args = params?.arguments ?? {};
   if (toolName === "chrome-devtools_current_page") {
-    return handleGetPageContext(res, id, mcp, projectOrigins, getPageContext);
+    return handleGetPageContext(res, id, mcp, operationsOrigins, includeExtensions, getPageContext);
   }
   if (toolName?.startsWith("vue-devtools_")) {
     return handleVueDevtoolsTool(res, id, mcp, projectOrigins, toolName, args);
@@ -121,25 +136,40 @@ function handleToolsCall(res, id, body, mcp, projectOrigins, getPageContext, log
   if (toolName?.startsWith("chrome-devtools_")) {
     const mapped = toolName.slice("chrome-devtools_".length);
     if (toolName === "chrome-devtools_list_pages") {
-      return handleListPages(res, id, mcp, projectOrigins, getPageContext);
+      return handleListPages(res, id, mcp, operationsOrigins, includeExtensions, getPageContext);
     }
     if (toolName === "chrome-devtools_new_page") {
-      return handleNewPage(res, id, mcp, args, projectOrigins, getPageContext);
+      return handleNewPage(res, id, mcp, args, projectOrigins, operationsOrigins);
     }
-    return handleDevTool(res, id, mcp, mapped, args, projectOrigins, toolName);
+    if (!isAllowedToolName(toolName)) {
+      return sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
+    }
+    return handleDevTool(
+      res,
+      id,
+      mcp,
+      mapped,
+      args,
+      operationsOrigins,
+      includeExtensions,
+      projectRoot,
+      toolName
+    );
   }
   sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
 }
-async function resolveProjectPages(mcp, projectOrigins, getPageContext) {
+async function resolveProjectPages(mcp, operationsOrigins, includeExtensions, getPageContext) {
   const listResult = await mcp.callChromeDevTool("list_pages", {});
   if (listResult?.error || !listResult?.result) {
     throw new Error(listResult?.error?.message ?? "\u65E0\u6CD5\u83B7\u53D6 Chrome \u9875\u9762\u5217\u8868");
   }
   const text = listResult?.result?.content?.[0]?.text;
   const allPages = text ? parseListPages(text) : [];
-  const filtered = allPages.filter((p) => isProjectPage(p.url, projectOrigins));
+  const filtered = allPages.filter(
+    (p) => isPageAllowed(p.url, operationsOrigins, includeExtensions)
+  );
   log.debug("Chrome pages", { total: allPages.length, urls: allPages.map((p) => p.url) });
-  log.debug("project origins", { origins: projectOrigins });
+  log.debug("operations origins", { origins: operationsOrigins });
   log.debug("filtered pages", { count: filtered.length, pageIds: filtered.map((p) => p.pageId) });
   let activePageId = null;
   let activePageError;
@@ -150,7 +180,7 @@ async function resolveProjectPages(mcp, projectOrigins, getPageContext) {
       mcp,
       pc.url,
       pc.title,
-      projectOrigins,
+      operationsOrigins,
       pc.sessionId,
       filtered,
       chromeSelectedPageId
@@ -160,37 +190,21 @@ async function resolveProjectPages(mcp, projectOrigins, getPageContext) {
   }
   return { filtered, activePageId, activePageError };
 }
-async function confirmOpenProjectPages(mcp, projectOrigins, getPageContext) {
-  let pages = [];
-  let ok = false;
-  for (let attempt = 0; attempt < 3; attempt++) {
-    try {
-      ({ filtered: pages } = await resolveProjectPages(mcp, projectOrigins, getPageContext));
-      ok = true;
-      break;
-    } catch {
-      if (attempt < 2) await sleep(500);
-    }
-  }
-  if (!ok) return null;
-  if (pages.length === 0) {
-    await sleep(500);
-    try {
-      ({ filtered: pages } = await resolveProjectPages(mcp, projectOrigins, getPageContext));
-    } catch {
-    }
-  }
-  return pages;
-}
-async function handleListPages(res, id, mcp, projectOrigins, getPageContext) {
+async function handleListPages(res, id, mcp, operationsOrigins, includeExtensions, getPageContext) {
   try {
     const { filtered, activePageId } = await resolveProjectPages(
       mcp,
-      projectOrigins,
+      operationsOrigins,
+      includeExtensions,
       getPageContext
     );
     if (filtered.length === 0) {
-      sendMcpResult(res, id, "\u6682\u65E0\u9879\u76EE\u9875\u9762\uFF0C\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u672C\u5730\u5F00\u53D1\u9875\u9762", mcp.sessionId);
+      sendMcpResult(
+        res,
+        id,
+        "\u6682\u65E0\u53EF\u7528\u9875\u9762\uFF08\u9879\u76EE\u9875\u6216 allowOrigins \u767D\u540D\u5355\u9875\uFF09\uFF0C\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u76F8\u5E94\u9875\u9762",
+        mcp.sessionId
+      );
       return;
     }
     const pageList = filtered.map((p) => ({
@@ -206,15 +220,21 @@ async function handleListPages(res, id, mcp, projectOrigins, getPageContext) {
     sendMcpError(res, id, -32603, `MCP \u8C03\u7528\u5931\u8D25: ${e.message}`, mcp.sessionId);
   }
 }
-async function handleGetPageContext(res, id, mcp, projectOrigins, getPageContext) {
+async function handleGetPageContext(res, id, mcp, operationsOrigins, includeExtensions, getPageContext) {
   try {
     const { filtered, activePageId, activePageError } = await resolveProjectPages(
       mcp,
-      projectOrigins,
+      operationsOrigins,
+      includeExtensions,
       getPageContext
     );
     if (filtered.length === 0) {
-      sendMcpResult(res, id, "\u6682\u65E0\u9879\u76EE\u9875\u9762\uFF0C\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u672C\u5730\u5F00\u53D1\u9875\u9762", mcp.sessionId);
+      sendMcpResult(
+        res,
+        id,
+        "\u6682\u65E0\u53EF\u7528\u9875\u9762\uFF08\u9879\u76EE\u9875\u6216 allowOrigins \u767D\u540D\u5355\u9875\uFF09\uFF0C\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u76F8\u5E94\u9875\u9762",
+        mcp.sessionId
+      );
       return;
     }
     const pc = getPageContext();
@@ -251,48 +271,54 @@ async function handleGetPageContext(res, id, mcp, projectOrigins, getPageContext
     sendMcpError(res, id, -32603, `MCP \u8C03\u7528\u5931\u8D25: ${e.message}`, mcp.sessionId);
   }
 }
-async function handleNewPage(res, id, mcp, args, projectOrigins, getPageContext) {
+async function handleNewPage(res, id, mcp, args, projectOrigins, operationsOrigins) {
   try {
     const url = args["url"];
     if (typeof url !== "string" || url.trim().length === 0) {
       sendMcpError(res, id, -32e3, "\u7F3A\u5C11 url \u53C2\u6570\uFF0C\u8BF7\u63D0\u4F9B\u8981\u6253\u5F00\u7684\u9875\u9762 URL", mcp.sessionId);
       return;
     }
-    if (!isProjectPage(url, projectOrigins)) {
+    if (!isProjectPage(url, operationsOrigins)) {
       sendMcpError(
         res,
         id,
         -32e3,
-        `\u4E0D\u5141\u8BB8\u6253\u5F00\u975E\u672C\u9879\u76EE\u9875\u9762: ${url}\u3002\u4EC5\u5141\u8BB8\u6253\u5F00\u9879\u76EE\u9875\u9762 (${projectOrigins.join(", ")})`,
+        `\u4E0D\u5141\u8BB8\u6253\u5F00\u8BE5\u9875\u9762: ${url}\u3002\u4EC5\u5141\u8BB8\u9879\u76EE\u9875\u6216 allowOrigins \u767D\u540D\u5355\u9875 (${operationsOrigins.join(", ")})`,
         mcp.sessionId
       );
       return;
     }
-    const projectPages = await confirmOpenProjectPages(mcp, projectOrigins, getPageContext);
-    if (projectPages === null) {
-      sendMcpError(
-        res,
-        id,
-        -32e3,
-        `\u65E0\u6CD5\u786E\u8BA4\u5F53\u524D\u9879\u76EE\u9875\u9762\u72B6\u6001\uFF0C\u4E3A\u907F\u514D\u91CD\u590D\u6253\u5F00\uFF0C\u8BF7\u786E\u8BA4 Chrome DevTools \u5DF2\u8FDE\u63A5\u540E\u91CD\u8BD5`,
-        mcp.sessionId
+    if (isProjectPage(url, projectOrigins)) {
+      const listResult = await mcp.callChromeDevTool("list_pages", {});
+      if (listResult?.error || !listResult?.result) {
+        sendMcpError(
+          res,
+          id,
+          -32e3,
+          `\u65E0\u6CD5\u786E\u8BA4\u5F53\u524D\u9879\u76EE\u9875\u9762\u72B6\u6001\uFF0C\u4E3A\u907F\u514D\u91CD\u590D\u6253\u5F00\uFF0C\u8BF7\u786E\u8BA4 Chrome DevTools \u5DF2\u8FDE\u63A5\u540E\u91CD\u8BD5`,
+          mcp.sessionId
+        );
+        return;
+      }
+      const text = listResult?.result?.content?.[0]?.text;
+      const projectOpen = (text ? parseListPages(text) : []).filter(
+        (p) => isProjectPage(p.url, projectOrigins)
       );
-      return;
-    }
-    if (projectPages.length > 0) {
-      const existing = projectPages.map((p) => `- ${p.title} (${p.url}) [pageId: ${p.pageId}]`).join("\n");
-      sendMcpResult(
-        res,
-        id,
-        `\u5F53\u524D\u9879\u76EE\u5DF2\u6709\u6253\u5F00\u7684\u9875\u9762\uFF0C\u65E0\u9700\u91CD\u590D\u6253\u5F00\u3002
+      if (projectOpen.length > 0) {
+        const existing = projectOpen.map((p) => `- ${p.title} (${p.url}) [pageId: ${p.pageId}]`).join("\n");
+        sendMcpResult(
+          res,
+          id,
+          `\u5F53\u524D\u9879\u76EE\u5DF2\u6709\u6253\u5F00\u7684\u9875\u9762\uFF0C\u65E0\u9700\u91CD\u590D\u6253\u5F00\u3002
 
 \u5DF2\u6253\u5F00\u7684\u9875\u9762\uFF1A
 ${existing}
 
 \u5982\u9700\u64CD\u4F5C\u73B0\u6709\u9875\u9762\uFF0C\u8BF7\u4F7F\u7528 chrome-devtools_list_pages \u83B7\u53D6\u9875\u9762 ID\uFF0C\u518D\u914D\u5408\u5176\u4ED6 chrome-devtools_* \u5DE5\u5177\u4F7F\u7528\u3002`,
-        mcp.sessionId
-      );
-      return;
+          mcp.sessionId
+        );
+        return;
+      }
     }
     const forwardBody = JSON.stringify({
       jsonrpc: "2.0",
@@ -308,37 +334,40 @@ ${existing}
     sendMcpError(res, id, -32603, `MCP \u8C03\u7528\u5931\u8D25: ${e.message}`, mcp.sessionId);
   }
 }
-async function handleDevTool(res, id, mcp, mapped, args, projectOrigins, toolName) {
+async function handleDevTool(res, id, mcp, mapped, args, operationsOrigins, includeExtensions, projectRoot, toolName) {
   try {
     const pageId = args["pageId"];
     if (typeof pageId !== "number") {
       sendMcpError(res, id, -32e3, "\u7F3A\u5C11 pageId \u53C2\u6570\uFF0C\u8BF7\u5148\u83B7\u53D6\u9875\u9762 ID", mcp.sessionId);
       return;
     }
-    const validation = await validatePageId(mcp, pageId, projectOrigins);
+    const validation = await validatePageId(mcp, pageId, operationsOrigins, includeExtensions);
     log.debug("handleDevTool validation", {
       pageId,
-      projectPages: validation.projectPages.length,
-      projectPageIds: validation.projectPages.map((p) => p.pageId),
-      origins: projectOrigins,
+      allowedPages: validation.allowedPages.length,
+      allowedPageIds: validation.allowedPages.map((p) => p.pageId),
+      origins: operationsOrigins,
       isValid: validation.valid
     });
     if (!validation.valid) {
       sendMcpError(res, id, -32e3, validation.error, mcp.sessionId);
       return;
     }
-    if (toolName === "chrome-devtools_navigate_page" && args["type"] === "url") {
-      const targetUrl = args["url"];
-      if (typeof targetUrl === "string" && targetUrl.length > 0) {
-        if (!isProjectPage(targetUrl, projectOrigins)) {
-          sendMcpError(
-            res,
-            id,
-            -32e3,
-            `\u4E0D\u5141\u8BB8\u8DF3\u8F6C\u5230\u975E\u672C\u9879\u76EE\u9875\u9762: ${targetUrl}\u3002\u4EC5\u5141\u8BB8\u5BFC\u822A\u5230\u9879\u76EE\u9875\u9762 (${projectOrigins.join(", ")})`,
-            mcp.sessionId
-          );
-          return;
+    if (toolName === "chrome-devtools_navigate_page") {
+      const navType = typeof args["type"] === "string" ? args["type"] : "url";
+      if (navType === "url") {
+        const targetUrl = args["url"];
+        if (typeof targetUrl === "string" && targetUrl.length > 0) {
+          if (!isProjectPage(targetUrl, operationsOrigins)) {
+            sendMcpError(
+              res,
+              id,
+              -32e3,
+              `\u4E0D\u5141\u8BB8\u8DF3\u8F6C\u5230\u8BE5\u9875\u9762: ${targetUrl}\u3002\u4EC5\u5141\u8BB8\u5BFC\u822A\u5230\u9879\u76EE\u9875\u6216 allowOrigins \u767D\u540D\u5355\u9875 (${operationsOrigins.join(", ")})`,
+              mcp.sessionId
+            );
+            return;
+          }
         }
       }
     }

package/es/endpoints/sse.mjs

@@ -1,4 +1,4 @@
-import { SSE_EVENTS_PATH } from "@aipanel/core";
+import { SSE_EVENT_TYPES, SSE_EVENTS_PATH } from "@aipanel/core";
 import { RequestContext, createLogger } from "@aipanel/core/node";
 const log = createLogger("Endpoints:SSE");
 function setupSseEndpoint(server, ctx) {
@@ -12,10 +12,10 @@ function setupSseEndpoint(server, ctx) {
     });
     ctx.sseClients.add(res);
     log.debug("SSE client connected", { totalClients: ctx.sseClients.size });
-    res.write(`data: ${JSON.stringify({ type: "CONNECTED" })}
+    res.write(`data: ${JSON.stringify({ type: SSE_EVENT_TYPES.CONNECTED })}
 
 `);
-    const statusPayload = { type: "STATUS_SYNC" };
+    const statusPayload = { type: SSE_EVENT_TYPES.STATUS_SYNC };
     if (ctx.isServiceStarted !== void 0) {
       statusPayload.isStarted = ctx.isServiceStarted;
     }

package/es/endpoints/vue-devtools.d.ts

@@ -4,6 +4,9 @@
  */
 import type { ViteDevServer } from "vite";
 import type { McpProxy } from "../core/mcp-proxy";
-export declare const VUE_DEVTOOLS_API_PATH = "/__aipanel_vue_devtools__";
+import { VUE_DEVTOOLS_API_PATH } from "@aipanel/core";
+export { VUE_DEVTOOLS_API_PATH };
 export declare function setupVueDevtoolsEndpoint(server: ViteDevServer, mcp: McpProxy): void;
-export declare function executeAction(action: string, args: Record<string, unknown> | undefined, mcp: McpProxy, projectOrigins: string[]): Promise<unknown>;
+export declare function executeAction(action: string, args: Record<string, unknown> | undefined, mcp: McpProxy, 
+/** vue-devtools 桥只注入在项目页面，范围为自动项目页 origins */
+projectOrigins: string[]): Promise<unknown>;