vite-plugin-aipanel 1.2.22 → 1.2.24

package/README.md

@@ -10,25 +10,14 @@
 - Chrome / Edge / Arc / Brave 等 Chromium 内核浏览器
 - 任选其一：OpenCode CLI（默认）或 DeepSeek Harness (dsh) CLI
 
-## 快速开始
-
-### 1. 安装 AI 引擎
-
-**默认引擎 OpenCode CLI：**
-
-```bash
-curl -fsSL https://opencode.ai/install | bash
-opencode --version # 验证
-```
-
-> 使用 DeepSeek Harness 请改装：`npm i -g @deepseek-ai/dsh` + `npm i -D @aipanel/provider-deepseek`，并配置 `provider: "deepseek"`（见下）。
-
-### 2. 安装并配置 Vite 插件
+## 安装
 
 ```bash
 npm install -D vite-plugin-aipanel
 ```
 
+## 快速开始
+
 ```ts
 // vite.config.ts
 import { defineConfig } from "vite";
@@ -39,90 +28,26 @@ export default defineConfig({
 });
 ```
 
-### 3. 启动开发服务器
-
-```bash
-npm run dev
-```
-
-插件自动完成：校验引擎 → 启动 AIPanel Web 服务（默认 5097）与代理（默认 6097，端口占用自动换）→ 复用/创建当前项目会话。
-
-### 4. 安装浏览器扩展
-
-1. [下载扩展包](https://github.com/code-farmer-i/vite-plugin-aipanel/raw/main/packages/extension/aipanel-assistant.zip)
-2. Chrome 打开 `chrome://extensions/`，开启右上角**「开发者模式」**
-3. 解压 `.zip` → **「加载已解压的扩展程序」** → 选择解压目录
-4. 打开 `localhost` 开发页面，点击工具栏 **AIPanel 图标**（或 `Ctrl/Cmd + K`）唤起侧边栏
-
-> Edge / Arc / Brave 入口分别是 `edge://extensions/` / `arc://extensions/` / `brave://extensions/`。
+启动 `npm run dev` 后，插件自动完成：校验引擎 → 启动 AIPanel Web 服务（默认 5097）与代理（默认 6097，端口占用自动换）→ 复用/创建当前项目会话。
 
 ## 切换 AI 引擎
 
 插件默认 `provider: "default"`（等价 `"opencode"`，适配已内置，仅需安装 opencode CLI）。
 
-| provider  | 引擎                   | 额外依赖                                   | 说明                        |
-| --------- | ---------------------- | ------------------------------------------ | --------------------------- |
-| `default` | OpenCode CLI           | 无（适配内置；需另装 opencode CLI）        | 默认值，同 `opencode`    |
-| `opencode` | OpenCode CLI         | 无（适配内置；需另装 opencode CLI）        | 显式指定 OpenCode           |
-| `deepseek` | DeepSeek Harness (dsh) | `@aipanel/provider-deepseek` + dsh CLI   | DeepSeek 官方 Web 对话界面  |
-
-```ts
-// 使用 DeepSeek Harness 引擎（先安装其依赖）
-aipanelAssistant({
-  provider: "deepseek",
-  providerOptions: {
-    // home: "~/.dsh",                // dsh 数据目录
-    // agentPreset: "standard",       // 新建会话的默认 Agent 预设
-    // permissionPreset: "read-only", // 默认权限预设
-    // busyEnter: "queue",            // 繁忙时 Enter 行为
-  },
-});
-```
-
-> **注意**：插件**不会自动探测**已安装的引擎，引擎由 `provider` 字段决定；切换前请确认对应 CLI 已安装。
+| provider    | 引擎                   | 额外依赖                                 |
+| ----------- | ---------------------- | ---------------------------------------- |
+| `default`   | OpenCode CLI           | 无（适配内置；需另装 opencode CLI）      |
+| `opencode`  | OpenCode CLI           | 无（适配内置；需另装 opencode CLI）      |
+| `deepseek`  | DeepSeek Harness (dsh) | `@aipanel/provider-deepseek` + dsh CLI   |
 
 ## 纯净 MCP 模式
 
-`mcpOnly: true` 时，插件只暴露 MCP 工具服务（Chrome DevTools 控制、Vue DevTools、日志读取等），不启动 AI 引擎、不注入对话界面，适合作为独立 MCP server 供外部 Agent 消费：
-
-```ts
-aipanelAssistant({ mcpOnly: true });
-```
-
-端点挂在 Vite dev server 上（需保持 `vite dev` 运行），外部 MCP 客户端按 Streamable HTTP 配置：
-
-```json
-{
-  "mcpServers": {
-    "aipanel": {
-      "type": "http",
-      "url": "http://localhost:5173/__aipanel_mcp__"
-    }
-  }
-}
-```
-
-> 端口随 Vite dev server 变化（默认 5173），以启动日志中的 `MCP endpoint` 为准；`Claude Code` / `Cursor` 等客户端配置详见在线文档。
-
-## 工作原理
-
-```
-┌────────────────┐      ┌────────────────┐      ┌─────────────┐
-│  Vite 插件       │      │  浏览器扩展      │      │ OpenCode/dsh │
-│  启动 Web 服务   │◀────▶│  侧边栏面板      │◀────▶│  AI 引擎     │
-│  代理跨域        │      │  页面上下文同步   │      │  会话管理    │
-└────────────────┘      └────────────────┘      └─────────────┘
-```
-
-- Vite 插件在项目启动时自动拉起 AIPanel Web 服务
-- 浏览器扩展检测到 `localhost` 页面后自动连接该服务
-- 实时同步页面 URL、标题等上下文给 AI
-- 多标签页自动切换对应项目的会话
+`mcpOnly: true` 时插件只暴露 MCP 工具服务（Chrome DevTools 控制、Vue DevTools、日志读取等），不启动 AI 引擎、不注入对话界面，适合作为独立 MCP server 供外部 Agent 消费。
 
 ## 文档
 
-完整使用指南请访问 [在线文档](https://code-farmer-i.github.io/vite-plugin-aipanel/)。
+完整使用指南（浏览器扩展安装、MCP 客户端配置等）请访问 [在线文档](https://code-farmer-i.github.io/vite-plugin-aipanel/)，仓库见 [code-farmer-i/vite-plugin-aipanel](https://github.com/code-farmer-i/vite-plugin-aipanel)。
 
 ## License
 
-MIT
+MIT

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 {