vite-plugin-aipanel 1.2.23 → 1.2.24

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

@@ -5,9 +5,17 @@
  * （schema/描述运行时同步自官方 tools/list，见 official-tools.ts）+ 本项目自定义工具。
  * 工具层限制（白名单、必填 pageId、仅项目页）由本文件 + endpoints/mcp.ts 的 tools/call 共同执行。
  */
+import { type VueDevtoolsAction } from "@aipanel/core";
 /** 模型可见名前缀：官方短名 → chrome-devtools_<name> */
 export declare const MCP_PREFIX = "chrome-devtools_";
 export declare function displayToolName(short: string): string;
+/** 本地桥接工具族前缀（tools/list 暴露面与 tools/call 路由共用） */
+export declare const VUE_DEVTOOLS_PREFIX = "vue-devtools_";
+export declare const LOGS_DEVTOOLS_PREFIX = "logs-devtools_";
+/** Vite 进程日志工具名（工具定义与调用路由共用） */
+export declare const VITE_LOGS_TOOL_NAME = "logs-devtools_vite_logs";
+/** 服务日志文件工具名（按 LogFileConfig.name 生成，暴露与路由共用） */
+export declare function serviceLogToolName(name: string): string;
 export interface CustomTool {
     name: string;
     description: string;
@@ -44,6 +52,20 @@ export declare function withPageIdSchema(schema: CustomTool["inputSchema"]): Cus
 export declare const PROJECT_DESCRIPTION_NOTES: Record<string, string>;
 /** 自定义工具（官方无对应，工具层本地实现） */
 export declare const CUSTOM_TOOLS: CustomTool[];
+/**
+ * 页面桥接工具：描述与输入 schema（模型可见）+ 后端 action（调用分发）单一来源。
+ * tools/list 与 tools/call 都取自本定义，避免"清单"与"路由"两份来源各自漂移。
+ * 只在注入 Vue DevTools 桥的项目（Vue 项目）暴露。
+ */
+export interface VueDevtoolsTool extends CustomTool {
+    /** 页面桥后端 action（endpoints/vue-devtools.ts executeAction） */
+    action: VueDevtoolsAction;
+}
+export declare const VUE_DEVTOOLS_TOOLS: readonly VueDevtoolsTool[];
+/** vue-devtools_* 工具名 → 定义（未知名称返回 undefined） */
+export declare function findVueDevtoolsTool(name: string): VueDevtoolsTool | undefined;
+/** vue-devtools_* 的 tools/list 暴露面（剥掉仅用于路由分发的 action 字段） */
+export declare function vueDevtoolsToolList(): CustomTool[];
 /** 官方声明了条件、且属于可开启范围的工具（由官方元数据派生，无手写） */
 export declare function isOfficialExtraTool(short: string): boolean;
 /** 由官方 conditions 推导所需 flag（experimentalX → --experimental-x，与官方 CLI 一致） */

package/es/core/mcp-tools.mjs

@@ -1,8 +1,15 @@
+import { VUE_DEVTOOLS_ACTIONS } from "@aipanel/core";
 import { OFFICIAL_TOOL_META } from "./official-meta.mjs";
 const MCP_PREFIX = "chrome-devtools_";
 function displayToolName(short) {
   return MCP_PREFIX + short;
 }
+const VUE_DEVTOOLS_PREFIX = "vue-devtools_";
+const LOGS_DEVTOOLS_PREFIX = "logs-devtools_";
+const VITE_LOGS_TOOL_NAME = `${LOGS_DEVTOOLS_PREFIX}vite_logs`;
+function serviceLogToolName(name) {
+  return `${LOGS_DEVTOOLS_PREFIX}${name}_logs`;
+}
 const OFFICIAL_GLOBAL_POLICY = [
   "evaluate_script",
   "list_console_messages",
@@ -33,8 +40,153 @@ const CUSTOM_TOOLS = [
     name: displayToolName("current_page"),
     description: "Get the page the user is currently browsing (URL, title, and page ID). Resolves the project page with injected context; for allowOrigins pages use list_pages and pass its pageId to page tools instead.",
     inputSchema: { type: "object", properties: {} }
+  },
+  {
+    name: VITE_LOGS_TOOL_NAME,
+    description: `\u83B7\u53D6 Vite \u5F00\u53D1\u670D\u52A1\u5668\u7684\u8FD0\u884C\u65E5\u5FD7\u3002
+
+**\u4F55\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177**\uFF1A
+- \u7528\u6237\u62A5\u544A"\u9875\u9762\u6CA1\u66F4\u65B0"\u3001"\u70ED\u66F4\u65B0\u4E0D\u5DE5\u4F5C"\u3001"HMR \u5931\u6548"\u65F6
+- \u6784\u5EFA\u62A5\u9519\u6216\u7F16\u8BD1\u5931\u8D25\uFF0C\u9700\u8981\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F
+- \u9875\u9762\u767D\u5C4F\u3001\u6837\u5F0F\u4E22\u5931\u3001\u6A21\u5757\u52A0\u8F7D\u5931\u8D25\u7B49\u5F00\u53D1\u95EE\u9898
+- \u7528\u6237\u63D0\u5230"\u5F00\u53D1\u670D\u52A1\u5668\u6709\u95EE\u9898"\u3001"vite \u62A5\u9519"
+- \u9700\u8981\u786E\u8BA4\u6700\u8FD1\u7684\u6587\u4EF6\u53D8\u66F4\u662F\u5426\u88AB Vite \u6B63\u786E\u5904\u7406
+
+**\u65E5\u5FD7\u5185\u5BB9**\uFF1A
+- Vite HMR \u70ED\u66F4\u65B0\u65E5\u5FD7\uFF08\u54EA\u4E9B\u6587\u4EF6\u88AB\u66F4\u65B0\u3001\u66F4\u65B0\u72B6\u6001\uFF09
+- \u6784\u5EFA\u7F16\u8BD1\u65E5\u5FD7\uFF08\u9519\u8BEF\u3001\u8B66\u544A\u3001\u6210\u529F\u4FE1\u606F\uFF09
+- OpenCode Web \u8FDB\u7A0B\u8F93\u51FA
+- \u63D2\u4EF6\u8FD0\u884C\u65E5\u5FD7
+
+\u65E5\u5FD7\u4FDD\u5B58\u5728\u5185\u5B58\u7F13\u51B2\u533A\uFF08\u6700\u8FD1 500 \u6761\uFF09\u3002`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        level: {
+          type: "string",
+          description: "\u65E5\u5FD7\u7EA7\u522B\u8FC7\u6EE4\uFF1Aerror(\u9519\u8BEF)\u3001warn(\u8B66\u544A)\u3001info(\u4FE1\u606F)\u3001debug(\u8C03\u8BD5)\u3001log(\u666E\u901A)\u3002\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF0C\u5982 'error,warn'"
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 200,
+          default: 50,
+          description: "\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4 50\uFF0C\u6700\u5927 200"
+        },
+        source: {
+          type: "string",
+          description: "\u6765\u6E90\u8FC7\u6EE4\uFF1Aconsole(\u63A7\u5236\u53F0)\u3001provider-stdout(\u670D\u52A1\u8F93\u51FA)\u3001provider-stderr(\u670D\u52A1\u9519\u8BEF)"
+        }
+      }
+    }
+  }
+];
+const VUE_DEVTOOLS_TOOLS = [
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_apps`,
+    action: VUE_DEVTOOLS_ACTIONS.GET_APPS,
+    description: `\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u6240\u6709 Vue \u5E94\u7528\u5B9E\u4F8B\u5217\u8868\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u6392\u67E5\u5FAE\u524D\u7AEF/\u591A\u5B9E\u4F8B\u573A\u666F\u4E0B\u64CD\u4F5C\u7684\u662F\u54EA\u4E2A\u5E94\u7528
+- \u5207\u6362\u6D3B\u8DC3\u5E94\u7528\u524D\u67E5\u770B\u6709\u54EA\u4E9B\u53EF\u7528`,
+    inputSchema: withPageIdSchema({ type: "object", properties: {} })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}set_active_app`,
+    action: VUE_DEVTOOLS_ACTIONS.TOGGLE_APP,
+    description: `\u5207\u6362\u6307\u5B9A\u9875\u9762\u7684\u6D3B\u8DC3 Vue \u5E94\u7528\u5B9E\u4F8B\u3002\u540E\u7EED\u6240\u6709 vue-devtools_* \u5DE5\u5177\u90FD\u64CD\u4F5C\u8FD9\u4E2A\u5E94\u7528\u3002`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: {
+        appId: { type: "string", description: "\u5E94\u7528 ID\uFF08\u4ECE vue-devtools_get_apps \u83B7\u53D6\uFF09" }
+      },
+      required: ["appId"]
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_component_tree`,
+    action: VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_TREE,
+    description: `\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u5F53\u524D\u6D3B\u8DC3 Vue \u5E94\u7528\u7684\u7EC4\u4EF6\u6811\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u4E86\u89E3\u9875\u9762\u7EC4\u4EF6\u5C42\u7EA7\u7ED3\u6784
+- \u627E\u5230\u76EE\u6807\u7EC4\u4EF6\u7684 nodeId\uFF08\u540E\u7EED\u67E5\u72B6\u6001\u7528\uFF09
+- \u6392\u67E5\u7EC4\u4EF6\u672A\u6E32\u67D3\u95EE\u9898
+- \u53EA\u5173\u5FC3\u67D0\u7C7B\u7EC4\u4EF6\u65F6\u7528 filter \u7F29\u5C0F\u8303\u56F4
+
+**\u8FD4\u56DE**\uFF1A\u7EC4\u4EF6\u6811 [{ id, name, children, file, ... }]`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: {
+        filter: { type: "string", description: "\u6309\u7EC4\u4EF6\u540D\u8FC7\u6EE4\uFF08\u5927\u5C0F\u5199\u4E0D\u654F\u611F\u7684\u5B50\u4E32\u5339\u914D\uFF09\uFF0C\u53EF\u9009" }
+      }
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_component_state`,
+    action: VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_STATE,
+    description: `\u83B7\u53D6\u6307\u5B9A\u7EC4\u4EF6\u7684\u5B8C\u6574\u8FD0\u884C\u65F6\u72B6\u6001\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u6392\u67E5 props \u4F20\u503C\u662F\u5426\u6B63\u786E
+- \u67E5\u770B ref/reactive \u54CD\u5E94\u5F0F\u6570\u636E\u7684\u5F53\u524D\u503C
+- \u68C0\u67E5 computed \u8BA1\u7B97\u7ED3\u679C
+- \u67E5\u770B attrs / events / inject / provide / template refs`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: {
+        nodeId: {
+          type: "string",
+          description: "\u7EC4\u4EF6\u8282\u70B9 ID\uFF08\u4ECE vue-devtools_get_component_tree \u83B7\u53D6\uFF09"
+        }
+      },
+      required: ["nodeId"]
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_component_render_code`,
+    action: VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_RENDER_CODE,
+    description: `\u83B7\u53D6\u7EC4\u4EF6\u7684\u6E32\u67D3\u51FD\u6570\u6E90\u7801\u3002`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: { nodeId: { type: "string", description: "\u7EC4\u4EF6\u8282\u70B9 ID" } },
+      required: ["nodeId"]
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_current_route`,
+    action: VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO,
+    description: `\u83B7\u53D6 Vue Router \u7684\u5F53\u524D\u8DEF\u7531\u4FE1\u606F\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u6392\u67E5\u8DEF\u7531\u8DF3\u8F6C\u95EE\u9898
+- \u67E5\u770B\u5F53\u524D\u8DEF\u7531 path/params/query/hash
+- \u786E\u8BA4\u8DEF\u7531\u5B88\u536B\u548C matched \u8BB0\u5F55`,
+    inputSchema: withPageIdSchema({ type: "object", properties: {} })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_routes`,
+    action: VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO,
+    description: `\u83B7\u53D6 Vue Router \u7684\u5B8C\u6574\u8DEF\u7531\u8868\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u67E5\u770B\u6240\u6709\u5DF2\u6CE8\u518C\u8DEF\u7531
+- \u786E\u8BA4\u8DEF\u7531\u914D\u7F6E\u662F\u5426\u6B63\u786E
+- \u67E5\u770B\u8DEF\u7531\u5D4C\u5957\u5173\u7CFB`,
+    inputSchema: withPageIdSchema({ type: "object", properties: {} })
   }
 ];
+function findVueDevtoolsTool(name) {
+  return VUE_DEVTOOLS_TOOLS.find((t) => t.name === name);
+}
+function vueDevtoolsToolList() {
+  return VUE_DEVTOOLS_TOOLS.map(({ name, description, inputSchema }) => ({
+    name,
+    description,
+    inputSchema
+  }));
+}
 const UNSAFE_CATEGORIES = /* @__PURE__ */ new Set(["EXTENSIONS", "PWA", "THIRD_PARTY", "WEBMCP"]);
 function metaByName(short) {
   return OFFICIAL_TOOL_META.find((m) => m.name === short);
@@ -106,18 +258,25 @@ function isAllowedToolName(name) {
 }
 export {
   CUSTOM_TOOLS,
+  LOGS_DEVTOOLS_PREFIX,
   MCP_PREFIX,
   OFFICIAL_GLOBAL_POLICY,
   OFFICIAL_NO_PAGE_TOOLS,
   PAGE_ID_PROP,
   PROJECT_DESCRIPTION_NOTES,
+  VITE_LOGS_TOOL_NAME,
+  VUE_DEVTOOLS_PREFIX,
+  VUE_DEVTOOLS_TOOLS,
   configureToolScope,
   currentOfficialShorts,
   displayToolName,
   extraToolFlag,
+  findVueDevtoolsTool,
   isAllowedToolName,
   isOfficialExtraTool,
   officialDefaultShorts,
   officialExtraCandidates,
+  serviceLogToolName,
+  vueDevtoolsToolList,
   withPageIdSchema
 };

package/es/endpoints/index.d.ts

@@ -6,4 +6,6 @@ import type { McpProxy } from "../core/mcp-proxy";
 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[], chromeProject?: ChromeProjectOptions): void;
+export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions, 
+/** 是否暴露 vue-devtools_* 工具（Vue 项目才有页面桥；未识别框架按保守策略视为 Vue） */
+exposeVueDevtools?: boolean): 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, chromeProject) {
+function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject, exposeVueDevtools = true) {
   setupWidgetEndpoints(server, ctx);
   setupContextEndpoint(server, ctx);
   setupStartEndpoint(server, ctx);
@@ -20,7 +20,14 @@ function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject) {
   setupWarmupEndpoint(server, ctx);
   setupLogsEndpoint(server);
   if (mcp) {
-    setupMcpEndpoint(server, mcp, () => ctx.getPageContext(), logFiles ?? [], chromeProject);
+    setupMcpEndpoint(
+      server,
+      mcp,
+      () => ctx.getPageContext(),
+      logFiles ?? [],
+      chromeProject,
+      exposeVueDevtools
+    );
     setupVueDevtoolsEndpoint(server, mcp);
   }
 }

package/es/endpoints/mcp.d.ts

@@ -3,4 +3,6 @@ import type { ChromeProjectOptions, LogFileConfig, PageContext } from "@aipanel/
 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[], chromeProject?: ChromeProjectOptions): void;
+export declare function setupMcpEndpoint(server: ViteDevServer, mcp: McpProxy, getPageContext: () => PageContext, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions, 
+/** Vue 项目才注入 vue-devtools 桥；非 Vue 项目既不上架也不路由这些工具，避免模型调用必失败的工具 */
+exposeVueDevtools?: boolean): void;

package/es/endpoints/mcp.mjs

@@ -1,4 +1,4 @@
-import { MCP_API_PATH, VUE_DEVTOOLS_ACTIONS } from "@aipanel/core";
+import { MCP_API_PATH } from "@aipanel/core";
 import {
   createLogger,
   getProcessLogBuffer,
@@ -12,12 +12,20 @@ import {
   validatePageId
 } from "../core/mcp-chrome.mjs";
 import { resolveProjectScope } from "../core/chrome-project.mjs";
-import { CUSTOM_TOOLS, isAllowedToolName } from "../core/mcp-tools.mjs";
+import {
+  CUSTOM_TOOLS,
+  findVueDevtoolsTool,
+  isAllowedToolName,
+  serviceLogToolName,
+  VITE_LOGS_TOOL_NAME,
+  VUE_DEVTOOLS_PREFIX,
+  vueDevtoolsToolList
+} from "../core/mcp-tools.mjs";
 import { getOfficialProjectTools } from "../core/official-tools.mjs";
 import { executeAction } from "./vue-devtools.mjs";
 import { findGitRoot } from "@aipanel/core/node";
 const log = createLogger("McpEndpoint");
-function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProject) {
+function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProject, exposeVueDevtools = true) {
   const projectRoot = findGitRoot(process.cwd());
   server.middlewares.use(async (req, res, next) => {
     if (!req.url?.startsWith(MCP_API_PATH)) return next();
@@ -50,7 +58,8 @@ function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProj
         scope.includeExtensions,
         getPageContext,
         logFiles,
-        projectRoot
+        projectRoot,
+        exposeVueDevtools
       );
       return;
     }
@@ -68,7 +77,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, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot) {
+async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot, exposeVueDevtools) {
   try {
     const body = await readBody(req);
     if (!body) {
@@ -80,7 +89,7 @@ async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, incl
     log.debug("MCP request", { method, body: body.substring(0, 150) });
     switch (method) {
       case "tools/list":
-        return await handleToolsList(res, id, mcp, logFiles);
+        return await handleToolsList(res, id, mcp, logFiles, exposeVueDevtools);
       case "tools/call":
         return await handleToolsCall(
           res,
@@ -92,7 +101,8 @@ async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, incl
           includeExtensions,
           getPageContext,
           logFiles,
-          projectRoot
+          projectRoot,
+          exposeVueDevtools
         );
       default:
         return await handleForward(res, body, mcp);
@@ -105,7 +115,7 @@ async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, incl
     });
   }
 }
-async function handleToolsList(res, id, mcp, logFiles) {
+async function handleToolsList(res, id, mcp, logFiles, exposeVueDevtools) {
   let official = [];
   try {
     official = await getOfficialProjectTools(mcp);
@@ -114,20 +124,28 @@ async function handleToolsList(res, id, mcp, logFiles) {
       error: e instanceof Error ? e.message : String(e)
     });
   }
-  const tools = [...official, ...CUSTOM_TOOLS, ...buildServiceLogTools(logFiles)];
+  const tools = [
+    ...official,
+    ...CUSTOM_TOOLS,
+    ...exposeVueDevtools ? vueDevtoolsToolList() : [],
+    ...buildServiceLogTools(logFiles)
+  ];
   sendMcpJson(res, 200, { jsonrpc: "2.0", id, result: { tools } }, mcp.sessionId);
 }
-function handleToolsCall(res, id, body, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot) {
+function handleToolsCall(res, id, body, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot, exposeVueDevtools) {
   const params = tryParseParams(body);
   const toolName = params?.name;
   const args = params?.arguments ?? {};
   if (toolName === "chrome-devtools_current_page") {
     return handleGetPageContext(res, id, mcp, operationsOrigins, includeExtensions, getPageContext);
   }
-  if (toolName?.startsWith("vue-devtools_")) {
+  if (toolName?.startsWith(VUE_DEVTOOLS_PREFIX)) {
+    if (!exposeVueDevtools) {
+      return sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
+    }
     return handleVueDevtoolsTool(res, id, mcp, projectOrigins, toolName, args);
   }
-  if (toolName === "logs-devtools_vite_logs") {
+  if (toolName === VITE_LOGS_TOOL_NAME) {
     return handleViteLogsTool(res, id, args, mcp.sessionId);
   }
   if (toolName && isServiceLogTool(toolName, logFiles)) {
@@ -388,23 +406,14 @@ async function handleDevTool(res, id, mcp, mapped, args, operationsOrigins, incl
     sendMcpError(res, id, -32603, `MCP \u8C03\u7528\u5931\u8D25: ${e.message}`, mcp.sessionId);
   }
 }
-const VUE_DEVTOOLS_TOOL_ACTIONS = {
-  "vue-devtools_get_apps": VUE_DEVTOOLS_ACTIONS.GET_APPS,
-  "vue-devtools_set_active_app": VUE_DEVTOOLS_ACTIONS.TOGGLE_APP,
-  "vue-devtools_get_component_tree": VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_TREE,
-  "vue-devtools_get_component_state": VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_STATE,
-  "vue-devtools_get_component_render_code": VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_RENDER_CODE,
-  "vue-devtools_get_current_route": VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO,
-  "vue-devtools_get_routes": VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO
-};
 async function handleVueDevtoolsTool(res, id, mcp, projectOrigins, toolName, args) {
   try {
-    const action = VUE_DEVTOOLS_TOOL_ACTIONS[toolName];
-    if (!action) {
+    const tool = findVueDevtoolsTool(toolName);
+    if (!tool) {
       sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
       return;
     }
-    const result = await executeAction(action, args, mcp, projectOrigins);
+    const result = await executeAction(tool.action, args, mcp, projectOrigins);
     switch (toolName) {
       case "vue-devtools_set_active_app":
         sendMcpResult(res, id, `\u5DF2\u5207\u6362\u5230\u5E94\u7528 ${args["appId"]}`, mcp.sessionId);
@@ -483,7 +492,7 @@ function parseProcessLevelFilter(level) {
 }
 function buildServiceLogTools(logFiles) {
   return logFiles.map((cfg) => ({
-    name: `logs-devtools_${cfg.name}_logs`,
+    name: serviceLogToolName(cfg.name),
     description: `\u83B7\u53D6 ${cfg.name} \u7684\u65E5\u5FD7\u3002
 
 **\u4F55\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177**\uFF1A
@@ -511,11 +520,11 @@ ${cfg.description}
   }));
 }
 function isServiceLogTool(toolName, logFiles) {
-  return logFiles.some((cfg) => `logs-devtools_${cfg.name}_logs` === toolName);
+  return logFiles.some((cfg) => serviceLogToolName(cfg.name) === toolName);
 }
 async function handleServiceLogsTool(res, id, toolName, args, logFiles, projectRoot, sessionId) {
   try {
-    const cfg = logFiles.find((c) => `logs-devtools_${c.name}_logs` === toolName);
+    const cfg = logFiles.find((c) => serviceLogToolName(c.name) === toolName);
     if (!cfg) {
       sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, sessionId);
       return;

package/es/index.mjs

@@ -210,7 +210,8 @@ function createAIPanelPlugin(options = {}) {
         },
         mcpProxy,
         config.logFiles,
-        chromeProjectOptions
+        chromeProjectOptions,
+        isVueProject
       );
       if (!config.mcpOnly) {
         try {

package/lib/core/mcp-tools.cjs

@@ -18,27 +18,41 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var mcp_tools_exports = {};
 __export(mcp_tools_exports, {
   CUSTOM_TOOLS: () => CUSTOM_TOOLS,
+  LOGS_DEVTOOLS_PREFIX: () => LOGS_DEVTOOLS_PREFIX,
   MCP_PREFIX: () => MCP_PREFIX,
   OFFICIAL_GLOBAL_POLICY: () => OFFICIAL_GLOBAL_POLICY,
   OFFICIAL_NO_PAGE_TOOLS: () => OFFICIAL_NO_PAGE_TOOLS,
   PAGE_ID_PROP: () => PAGE_ID_PROP,
   PROJECT_DESCRIPTION_NOTES: () => PROJECT_DESCRIPTION_NOTES,
+  VITE_LOGS_TOOL_NAME: () => VITE_LOGS_TOOL_NAME,
+  VUE_DEVTOOLS_PREFIX: () => VUE_DEVTOOLS_PREFIX,
+  VUE_DEVTOOLS_TOOLS: () => VUE_DEVTOOLS_TOOLS,
   configureToolScope: () => configureToolScope,
   currentOfficialShorts: () => currentOfficialShorts,
   displayToolName: () => displayToolName,
   extraToolFlag: () => extraToolFlag,
+  findVueDevtoolsTool: () => findVueDevtoolsTool,
   isAllowedToolName: () => isAllowedToolName,
   isOfficialExtraTool: () => isOfficialExtraTool,
   officialDefaultShorts: () => officialDefaultShorts,
   officialExtraCandidates: () => officialExtraCandidates,
+  serviceLogToolName: () => serviceLogToolName,
+  vueDevtoolsToolList: () => vueDevtoolsToolList,
   withPageIdSchema: () => withPageIdSchema
 });
 module.exports = __toCommonJS(mcp_tools_exports);
+var import_core = require("@aipanel/core");
 var import_official_meta = require("./official-meta.cjs");
 const MCP_PREFIX = "chrome-devtools_";
 function displayToolName(short) {
   return MCP_PREFIX + short;
 }
+const VUE_DEVTOOLS_PREFIX = "vue-devtools_";
+const LOGS_DEVTOOLS_PREFIX = "logs-devtools_";
+const VITE_LOGS_TOOL_NAME = `${LOGS_DEVTOOLS_PREFIX}vite_logs`;
+function serviceLogToolName(name) {
+  return `${LOGS_DEVTOOLS_PREFIX}${name}_logs`;
+}
 const OFFICIAL_GLOBAL_POLICY = [
   "evaluate_script",
   "list_console_messages",
@@ -69,8 +83,153 @@ const CUSTOM_TOOLS = [
     name: displayToolName("current_page"),
     description: "Get the page the user is currently browsing (URL, title, and page ID). Resolves the project page with injected context; for allowOrigins pages use list_pages and pass its pageId to page tools instead.",
     inputSchema: { type: "object", properties: {} }
+  },
+  {
+    name: VITE_LOGS_TOOL_NAME,
+    description: `\u83B7\u53D6 Vite \u5F00\u53D1\u670D\u52A1\u5668\u7684\u8FD0\u884C\u65E5\u5FD7\u3002
+
+**\u4F55\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177**\uFF1A
+- \u7528\u6237\u62A5\u544A"\u9875\u9762\u6CA1\u66F4\u65B0"\u3001"\u70ED\u66F4\u65B0\u4E0D\u5DE5\u4F5C"\u3001"HMR \u5931\u6548"\u65F6
+- \u6784\u5EFA\u62A5\u9519\u6216\u7F16\u8BD1\u5931\u8D25\uFF0C\u9700\u8981\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F
+- \u9875\u9762\u767D\u5C4F\u3001\u6837\u5F0F\u4E22\u5931\u3001\u6A21\u5757\u52A0\u8F7D\u5931\u8D25\u7B49\u5F00\u53D1\u95EE\u9898
+- \u7528\u6237\u63D0\u5230"\u5F00\u53D1\u670D\u52A1\u5668\u6709\u95EE\u9898"\u3001"vite \u62A5\u9519"
+- \u9700\u8981\u786E\u8BA4\u6700\u8FD1\u7684\u6587\u4EF6\u53D8\u66F4\u662F\u5426\u88AB Vite \u6B63\u786E\u5904\u7406
+
+**\u65E5\u5FD7\u5185\u5BB9**\uFF1A
+- Vite HMR \u70ED\u66F4\u65B0\u65E5\u5FD7\uFF08\u54EA\u4E9B\u6587\u4EF6\u88AB\u66F4\u65B0\u3001\u66F4\u65B0\u72B6\u6001\uFF09
+- \u6784\u5EFA\u7F16\u8BD1\u65E5\u5FD7\uFF08\u9519\u8BEF\u3001\u8B66\u544A\u3001\u6210\u529F\u4FE1\u606F\uFF09
+- OpenCode Web \u8FDB\u7A0B\u8F93\u51FA
+- \u63D2\u4EF6\u8FD0\u884C\u65E5\u5FD7
+
+\u65E5\u5FD7\u4FDD\u5B58\u5728\u5185\u5B58\u7F13\u51B2\u533A\uFF08\u6700\u8FD1 500 \u6761\uFF09\u3002`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        level: {
+          type: "string",
+          description: "\u65E5\u5FD7\u7EA7\u522B\u8FC7\u6EE4\uFF1Aerror(\u9519\u8BEF)\u3001warn(\u8B66\u544A)\u3001info(\u4FE1\u606F)\u3001debug(\u8C03\u8BD5)\u3001log(\u666E\u901A)\u3002\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF0C\u5982 'error,warn'"
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 200,
+          default: 50,
+          description: "\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4 50\uFF0C\u6700\u5927 200"
+        },
+        source: {
+          type: "string",
+          description: "\u6765\u6E90\u8FC7\u6EE4\uFF1Aconsole(\u63A7\u5236\u53F0)\u3001provider-stdout(\u670D\u52A1\u8F93\u51FA)\u3001provider-stderr(\u670D\u52A1\u9519\u8BEF)"
+        }
+      }
+    }
+  }
+];
+const VUE_DEVTOOLS_TOOLS = [
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_apps`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.GET_APPS,
+    description: `\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u6240\u6709 Vue \u5E94\u7528\u5B9E\u4F8B\u5217\u8868\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u6392\u67E5\u5FAE\u524D\u7AEF/\u591A\u5B9E\u4F8B\u573A\u666F\u4E0B\u64CD\u4F5C\u7684\u662F\u54EA\u4E2A\u5E94\u7528
+- \u5207\u6362\u6D3B\u8DC3\u5E94\u7528\u524D\u67E5\u770B\u6709\u54EA\u4E9B\u53EF\u7528`,
+    inputSchema: withPageIdSchema({ type: "object", properties: {} })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}set_active_app`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.TOGGLE_APP,
+    description: `\u5207\u6362\u6307\u5B9A\u9875\u9762\u7684\u6D3B\u8DC3 Vue \u5E94\u7528\u5B9E\u4F8B\u3002\u540E\u7EED\u6240\u6709 vue-devtools_* \u5DE5\u5177\u90FD\u64CD\u4F5C\u8FD9\u4E2A\u5E94\u7528\u3002`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: {
+        appId: { type: "string", description: "\u5E94\u7528 ID\uFF08\u4ECE vue-devtools_get_apps \u83B7\u53D6\uFF09" }
+      },
+      required: ["appId"]
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_component_tree`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_TREE,
+    description: `\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u5F53\u524D\u6D3B\u8DC3 Vue \u5E94\u7528\u7684\u7EC4\u4EF6\u6811\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u4E86\u89E3\u9875\u9762\u7EC4\u4EF6\u5C42\u7EA7\u7ED3\u6784
+- \u627E\u5230\u76EE\u6807\u7EC4\u4EF6\u7684 nodeId\uFF08\u540E\u7EED\u67E5\u72B6\u6001\u7528\uFF09
+- \u6392\u67E5\u7EC4\u4EF6\u672A\u6E32\u67D3\u95EE\u9898
+- \u53EA\u5173\u5FC3\u67D0\u7C7B\u7EC4\u4EF6\u65F6\u7528 filter \u7F29\u5C0F\u8303\u56F4
+
+**\u8FD4\u56DE**\uFF1A\u7EC4\u4EF6\u6811 [{ id, name, children, file, ... }]`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: {
+        filter: { type: "string", description: "\u6309\u7EC4\u4EF6\u540D\u8FC7\u6EE4\uFF08\u5927\u5C0F\u5199\u4E0D\u654F\u611F\u7684\u5B50\u4E32\u5339\u914D\uFF09\uFF0C\u53EF\u9009" }
+      }
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_component_state`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_STATE,
+    description: `\u83B7\u53D6\u6307\u5B9A\u7EC4\u4EF6\u7684\u5B8C\u6574\u8FD0\u884C\u65F6\u72B6\u6001\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u6392\u67E5 props \u4F20\u503C\u662F\u5426\u6B63\u786E
+- \u67E5\u770B ref/reactive \u54CD\u5E94\u5F0F\u6570\u636E\u7684\u5F53\u524D\u503C
+- \u68C0\u67E5 computed \u8BA1\u7B97\u7ED3\u679C
+- \u67E5\u770B attrs / events / inject / provide / template refs`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: {
+        nodeId: {
+          type: "string",
+          description: "\u7EC4\u4EF6\u8282\u70B9 ID\uFF08\u4ECE vue-devtools_get_component_tree \u83B7\u53D6\uFF09"
+        }
+      },
+      required: ["nodeId"]
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_component_render_code`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_RENDER_CODE,
+    description: `\u83B7\u53D6\u7EC4\u4EF6\u7684\u6E32\u67D3\u51FD\u6570\u6E90\u7801\u3002`,
+    inputSchema: withPageIdSchema({
+      type: "object",
+      properties: { nodeId: { type: "string", description: "\u7EC4\u4EF6\u8282\u70B9 ID" } },
+      required: ["nodeId"]
+    })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_current_route`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO,
+    description: `\u83B7\u53D6 Vue Router \u7684\u5F53\u524D\u8DEF\u7531\u4FE1\u606F\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u6392\u67E5\u8DEF\u7531\u8DF3\u8F6C\u95EE\u9898
+- \u67E5\u770B\u5F53\u524D\u8DEF\u7531 path/params/query/hash
+- \u786E\u8BA4\u8DEF\u7531\u5B88\u536B\u548C matched \u8BB0\u5F55`,
+    inputSchema: withPageIdSchema({ type: "object", properties: {} })
+  },
+  {
+    name: `${VUE_DEVTOOLS_PREFIX}get_routes`,
+    action: import_core.VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO,
+    description: `\u83B7\u53D6 Vue Router \u7684\u5B8C\u6574\u8DEF\u7531\u8868\u3002
+
+**\u4F55\u65F6\u4F7F\u7528**\uFF1A
+- \u67E5\u770B\u6240\u6709\u5DF2\u6CE8\u518C\u8DEF\u7531
+- \u786E\u8BA4\u8DEF\u7531\u914D\u7F6E\u662F\u5426\u6B63\u786E
+- \u67E5\u770B\u8DEF\u7531\u5D4C\u5957\u5173\u7CFB`,
+    inputSchema: withPageIdSchema({ type: "object", properties: {} })
   }
 ];
+function findVueDevtoolsTool(name) {
+  return VUE_DEVTOOLS_TOOLS.find((t) => t.name === name);
+}
+function vueDevtoolsToolList() {
+  return VUE_DEVTOOLS_TOOLS.map(({ name, description, inputSchema }) => ({
+    name,
+    description,
+    inputSchema
+  }));
+}
 const UNSAFE_CATEGORIES = /* @__PURE__ */ new Set(["EXTENSIONS", "PWA", "THIRD_PARTY", "WEBMCP"]);
 function metaByName(short) {
   return import_official_meta.OFFICIAL_TOOL_META.find((m) => m.name === short);
@@ -143,18 +302,25 @@ function isAllowedToolName(name) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CUSTOM_TOOLS,
+  LOGS_DEVTOOLS_PREFIX,
   MCP_PREFIX,
   OFFICIAL_GLOBAL_POLICY,
   OFFICIAL_NO_PAGE_TOOLS,
   PAGE_ID_PROP,
   PROJECT_DESCRIPTION_NOTES,
+  VITE_LOGS_TOOL_NAME,
+  VUE_DEVTOOLS_PREFIX,
+  VUE_DEVTOOLS_TOOLS,
   configureToolScope,
   currentOfficialShorts,
   displayToolName,
   extraToolFlag,
+  findVueDevtoolsTool,
   isAllowedToolName,
   isOfficialExtraTool,
   officialDefaultShorts,
   officialExtraCandidates,
+  serviceLogToolName,
+  vueDevtoolsToolList,
   withPageIdSchema
 });

package/lib/core/mcp-tools.d.ts

@@ -5,9 +5,17 @@
  * （schema/描述运行时同步自官方 tools/list，见 official-tools.ts）+ 本项目自定义工具。
  * 工具层限制（白名单、必填 pageId、仅项目页）由本文件 + endpoints/mcp.ts 的 tools/call 共同执行。
  */
+import { type VueDevtoolsAction } from "@aipanel/core";
 /** 模型可见名前缀：官方短名 → chrome-devtools_<name> */
 export declare const MCP_PREFIX = "chrome-devtools_";
 export declare function displayToolName(short: string): string;
+/** 本地桥接工具族前缀（tools/list 暴露面与 tools/call 路由共用） */
+export declare const VUE_DEVTOOLS_PREFIX = "vue-devtools_";
+export declare const LOGS_DEVTOOLS_PREFIX = "logs-devtools_";
+/** Vite 进程日志工具名（工具定义与调用路由共用） */
+export declare const VITE_LOGS_TOOL_NAME = "logs-devtools_vite_logs";
+/** 服务日志文件工具名（按 LogFileConfig.name 生成，暴露与路由共用） */
+export declare function serviceLogToolName(name: string): string;
 export interface CustomTool {
     name: string;
     description: string;
@@ -44,6 +52,20 @@ export declare function withPageIdSchema(schema: CustomTool["inputSchema"]): Cus
 export declare const PROJECT_DESCRIPTION_NOTES: Record<string, string>;
 /** 自定义工具（官方无对应，工具层本地实现） */
 export declare const CUSTOM_TOOLS: CustomTool[];
+/**
+ * 页面桥接工具：描述与输入 schema（模型可见）+ 后端 action（调用分发）单一来源。
+ * tools/list 与 tools/call 都取自本定义，避免"清单"与"路由"两份来源各自漂移。
+ * 只在注入 Vue DevTools 桥的项目（Vue 项目）暴露。
+ */
+export interface VueDevtoolsTool extends CustomTool {
+    /** 页面桥后端 action（endpoints/vue-devtools.ts executeAction） */
+    action: VueDevtoolsAction;
+}
+export declare const VUE_DEVTOOLS_TOOLS: readonly VueDevtoolsTool[];
+/** vue-devtools_* 工具名 → 定义（未知名称返回 undefined） */
+export declare function findVueDevtoolsTool(name: string): VueDevtoolsTool | undefined;
+/** vue-devtools_* 的 tools/list 暴露面（剥掉仅用于路由分发的 action 字段） */
+export declare function vueDevtoolsToolList(): CustomTool[];
 /** 官方声明了条件、且属于可开启范围的工具（由官方元数据派生，无手写） */
 export declare function isOfficialExtraTool(short: string): boolean;
 /** 由官方 conditions 推导所需 flag（experimentalX → --experimental-x，与官方 CLI 一致） */

package/lib/endpoints/index.cjs

@@ -36,7 +36,7 @@ var import_mcp = require("./mcp.cjs");
 var import_vue_devtools = require("./vue-devtools.cjs");
 var import_core = require("@aipanel/core");
 __reExport(endpoints_exports, require("./types.cjs"), module.exports);
-function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject) {
+function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject, exposeVueDevtools = true) {
   (0, import_widget.setupWidgetEndpoints)(server, ctx);
   (0, import_context.setupContextEndpoint)(server, ctx);
   (0, import_start.setupStartEndpoint)(server, ctx);
@@ -46,7 +46,14 @@ function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject) {
   (0, import_warmup.setupWarmupEndpoint)(server, ctx);
   (0, import_logs.setupLogsEndpoint)(server);
   if (mcp) {
-    (0, import_mcp.setupMcpEndpoint)(server, mcp, () => ctx.getPageContext(), logFiles ?? [], chromeProject);
+    (0, import_mcp.setupMcpEndpoint)(
+      server,
+      mcp,
+      () => ctx.getPageContext(),
+      logFiles ?? [],
+      chromeProject,
+      exposeVueDevtools
+    );
     (0, import_vue_devtools.setupVueDevtoolsEndpoint)(server, mcp);
   }
 }

package/lib/endpoints/index.d.ts

@@ -6,4 +6,6 @@ import type { McpProxy } from "../core/mcp-proxy";
 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[], chromeProject?: ChromeProjectOptions): void;
+export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions, 
+/** 是否暴露 vue-devtools_* 工具（Vue 项目才有页面桥；未识别框架按保守策略视为 Vue） */
+exposeVueDevtools?: boolean): void;

package/lib/endpoints/mcp.cjs

@@ -30,7 +30,7 @@ var import_official_tools = require("../core/official-tools.cjs");
 var import_vue_devtools = require("./vue-devtools.cjs");
 var import_node2 = require("@aipanel/core/node");
 const log = (0, import_node.createLogger)("McpEndpoint");
-function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProject) {
+function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProject, exposeVueDevtools = true) {
   const projectRoot = (0, import_node2.findGitRoot)(process.cwd());
   server.middlewares.use(async (req, res, next) => {
     if (!req.url?.startsWith(import_core.MCP_API_PATH)) return next();
@@ -63,7 +63,8 @@ function setupMcpEndpoint(server, mcp, getPageContext, logFiles = [], chromeProj
         scope.includeExtensions,
         getPageContext,
         logFiles,
-        projectRoot
+        projectRoot,
+        exposeVueDevtools
       );
       return;
     }
@@ -81,7 +82,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, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot) {
+async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot, exposeVueDevtools) {
   try {
     const body = await readBody(req);
     if (!body) {
@@ -93,7 +94,7 @@ async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, incl
     log.debug("MCP request", { method, body: body.substring(0, 150) });
     switch (method) {
       case "tools/list":
-        return await handleToolsList(res, id, mcp, logFiles);
+        return await handleToolsList(res, id, mcp, logFiles, exposeVueDevtools);
       case "tools/call":
         return await handleToolsCall(
           res,
@@ -105,7 +106,8 @@ async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, incl
           includeExtensions,
           getPageContext,
           logFiles,
-          projectRoot
+          projectRoot,
+          exposeVueDevtools
         );
       default:
         return await handleForward(res, body, mcp);
@@ -118,7 +120,7 @@ async function handlePost(req, res, mcp, projectOrigins, operationsOrigins, incl
     });
   }
 }
-async function handleToolsList(res, id, mcp, logFiles) {
+async function handleToolsList(res, id, mcp, logFiles, exposeVueDevtools) {
   let official = [];
   try {
     official = await (0, import_official_tools.getOfficialProjectTools)(mcp);
@@ -127,20 +129,28 @@ async function handleToolsList(res, id, mcp, logFiles) {
       error: e instanceof Error ? e.message : String(e)
     });
   }
-  const tools = [...official, ...import_mcp_tools.CUSTOM_TOOLS, ...buildServiceLogTools(logFiles)];
+  const tools = [
+    ...official,
+    ...import_mcp_tools.CUSTOM_TOOLS,
+    ...exposeVueDevtools ? (0, import_mcp_tools.vueDevtoolsToolList)() : [],
+    ...buildServiceLogTools(logFiles)
+  ];
   sendMcpJson(res, 200, { jsonrpc: "2.0", id, result: { tools } }, mcp.sessionId);
 }
-function handleToolsCall(res, id, body, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot) {
+function handleToolsCall(res, id, body, mcp, projectOrigins, operationsOrigins, includeExtensions, getPageContext, logFiles, projectRoot, exposeVueDevtools) {
   const params = tryParseParams(body);
   const toolName = params?.name;
   const args = params?.arguments ?? {};
   if (toolName === "chrome-devtools_current_page") {
     return handleGetPageContext(res, id, mcp, operationsOrigins, includeExtensions, getPageContext);
   }
-  if (toolName?.startsWith("vue-devtools_")) {
+  if (toolName?.startsWith(import_mcp_tools.VUE_DEVTOOLS_PREFIX)) {
+    if (!exposeVueDevtools) {
+      return sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
+    }
     return handleVueDevtoolsTool(res, id, mcp, projectOrigins, toolName, args);
   }
-  if (toolName === "logs-devtools_vite_logs") {
+  if (toolName === import_mcp_tools.VITE_LOGS_TOOL_NAME) {
     return handleViteLogsTool(res, id, args, mcp.sessionId);
   }
   if (toolName && isServiceLogTool(toolName, logFiles)) {
@@ -401,23 +411,14 @@ async function handleDevTool(res, id, mcp, mapped, args, operationsOrigins, incl
     sendMcpError(res, id, -32603, `MCP \u8C03\u7528\u5931\u8D25: ${e.message}`, mcp.sessionId);
   }
 }
-const VUE_DEVTOOLS_TOOL_ACTIONS = {
-  "vue-devtools_get_apps": import_core.VUE_DEVTOOLS_ACTIONS.GET_APPS,
-  "vue-devtools_set_active_app": import_core.VUE_DEVTOOLS_ACTIONS.TOGGLE_APP,
-  "vue-devtools_get_component_tree": import_core.VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_TREE,
-  "vue-devtools_get_component_state": import_core.VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_STATE,
-  "vue-devtools_get_component_render_code": import_core.VUE_DEVTOOLS_ACTIONS.GET_COMPONENT_RENDER_CODE,
-  "vue-devtools_get_current_route": import_core.VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO,
-  "vue-devtools_get_routes": import_core.VUE_DEVTOOLS_ACTIONS.GET_ROUTER_INFO
-};
 async function handleVueDevtoolsTool(res, id, mcp, projectOrigins, toolName, args) {
   try {
-    const action = VUE_DEVTOOLS_TOOL_ACTIONS[toolName];
-    if (!action) {
+    const tool = (0, import_mcp_tools.findVueDevtoolsTool)(toolName);
+    if (!tool) {
       sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
       return;
     }
-    const result = await (0, import_vue_devtools.executeAction)(action, args, mcp, projectOrigins);
+    const result = await (0, import_vue_devtools.executeAction)(tool.action, args, mcp, projectOrigins);
     switch (toolName) {
       case "vue-devtools_set_active_app":
         sendMcpResult(res, id, `\u5DF2\u5207\u6362\u5230\u5E94\u7528 ${args["appId"]}`, mcp.sessionId);
@@ -496,7 +497,7 @@ function parseProcessLevelFilter(level) {
 }
 function buildServiceLogTools(logFiles) {
   return logFiles.map((cfg) => ({
-    name: `logs-devtools_${cfg.name}_logs`,
+    name: (0, import_mcp_tools.serviceLogToolName)(cfg.name),
     description: `\u83B7\u53D6 ${cfg.name} \u7684\u65E5\u5FD7\u3002
 
 **\u4F55\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177**\uFF1A
@@ -524,11 +525,11 @@ ${cfg.description}
   }));
 }
 function isServiceLogTool(toolName, logFiles) {
-  return logFiles.some((cfg) => `logs-devtools_${cfg.name}_logs` === toolName);
+  return logFiles.some((cfg) => (0, import_mcp_tools.serviceLogToolName)(cfg.name) === toolName);
 }
 async function handleServiceLogsTool(res, id, toolName, args, logFiles, projectRoot, sessionId) {
   try {
-    const cfg = logFiles.find((c) => `logs-devtools_${c.name}_logs` === toolName);
+    const cfg = logFiles.find((c) => (0, import_mcp_tools.serviceLogToolName)(c.name) === toolName);
     if (!cfg) {
       sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, sessionId);
       return;

package/lib/endpoints/mcp.d.ts

@@ -3,4 +3,6 @@ import type { ChromeProjectOptions, LogFileConfig, PageContext } from "@aipanel/
 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[], chromeProject?: ChromeProjectOptions): void;
+export declare function setupMcpEndpoint(server: ViteDevServer, mcp: McpProxy, getPageContext: () => PageContext, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions, 
+/** Vue 项目才注入 vue-devtools 桥；非 Vue 项目既不上架也不路由这些工具，避免模型调用必失败的工具 */
+exposeVueDevtools?: boolean): void;

package/lib/index.cjs

@@ -230,7 +230,8 @@ function createAIPanelPlugin(options = {}) {
         },
         mcpProxy,
         config.logFiles,
-        chromeProjectOptions
+        chromeProjectOptions,
+        isVueProject
       );
       if (!config.mcpOnly) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-aipanel",
-  "version": "1.2.23",
+  "version": "1.2.24",
   "description": "Embed OpenCode Web UI in your Vite dev server for real-time code modification and preview",
   "type": "module",
   "main": "lib/index.cjs",
@@ -35,8 +35,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@aipanel/core": "1.2.23",
-    "@aipanel/provider-opencode": "1.2.23",
+    "@aipanel/core": "1.2.24",
+    "@aipanel/provider-opencode": "1.2.24",
     "@code-inspector/core": "^2.0.9",
     "@vue/devtools-kit": "^8.0.0",
     "@vue/language-server": "^3.3.7",
@@ -47,7 +47,7 @@
     "unplugin-vue-inspector": "^3.0.0"
   },
   "peerDependencies": {
-    "@aipanel/provider-deepseek": "1.2.23",
+    "@aipanel/provider-deepseek": "1.2.24",
     "vite": ">=5.0.0"
   },
   "peerDependenciesMeta": {
@@ -56,7 +56,7 @@
     }
   },
   "devDependencies": {
-    "@aipanel/client": "1.2.23",
+    "@aipanel/client": "1.2.24",
     "@types/picomatch": "^4.0.0",
     "sharp": "^0.34.5"
   },