vite-plugin-aipanel 1.2.0-beta.0

package/es/core/mcp-tools.mjs

@@ -0,0 +1,671 @@
+const PAGE_ID_PROP = {
+  pageId: { type: "number", description: "\u76EE\u6807\u9875\u9762 ID" }
+};
+function withPageId(properties, required = []) {
+  return {
+    properties: { ...PAGE_ID_PROP, ...properties },
+    required: ["pageId", ...required]
+  };
+}
+const CUSTOM_TOOLS = [
+  // ===== 页面管理 =====
+  {
+    name: "chrome-devtools_list_pages",
+    description: "\u83B7\u53D6\u5F53\u524D\u9879\u76EE\u6240\u6709\u6253\u5F00\u7684\u9875\u9762\u5217\u8868\uFF0C\u542B active\uFF08\u7528\u6237\u6B63\u5728\u6D4F\u89C8\uFF09\u548C selected\uFF08Chrome DevTools \u5F53\u524D\u64CD\u4F5C\u76EE\u6807\uFF09\u6807\u8BB0",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "chrome-devtools_current_page",
+    description: "\u83B7\u53D6\u7528\u6237\u5F53\u524D\u6B63\u5728\u6D4F\u89C8\u5668\u6D4F\u89C8\u7684\u9875\u9762\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF0C\u5305\u542B\u9875\u9762 URL\u3001\u6807\u9898\u3001\u9875\u9762 ID",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "chrome-devtools_new_page",
+    description: "\u6253\u5F00\u4E00\u4E2A\u65B0\u6807\u7B7E\u9875\u5E76\u52A0\u8F7D URL\uFF08\u4EC5\u5141\u8BB8\u6253\u5F00\u5F53\u524D\u9879\u76EE\u7684\u9875\u9762\uFF09\u3002\u82E5\u5F53\u524D\u9879\u76EE\u5DF2\u6709\u6253\u5F00\u7684\u9875\u9762\uFF0C\u5219\u4E0D\u4F1A\u91CD\u590D\u6253\u5F00\uFF0C\u800C\u662F\u8FD4\u56DE\u5DF2\u6709\u9875\u9762\u4FE1\u606F",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "\u8981\u6253\u5F00\u7684\u9875\u9762 URL\uFF08\u5FC5\u987B\u662F\u5F53\u524D\u9879\u76EE\u7684\u9875\u9762\uFF09"
+        },
+        timeout: {
+          type: "integer",
+          description: "\u6700\u5927\u7B49\u5F85\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C0 \u4F7F\u7528\u9ED8\u8BA4\u8D85\u65F6"
+        }
+      },
+      required: ["url"]
+    }
+  },
+  // ===== 截图与快照 =====
+  {
+    name: "chrome-devtools_take_snapshot",
+    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u53EF\u8BBF\u95EE\u6027\u6811\u5FEB\u7167\uFF0C\u8FD4\u56DE\u5143\u7D20 uid\u3001\u89D2\u8272\u3001\u6587\u672C\u7B49",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        verbose: { type: "boolean", description: "\u662F\u5426\u83B7\u53D6\u5B8C\u6574 a11y \u6811\u4FE1\u606F\uFF0C\u9ED8\u8BA4 false" },
+        filePath: { type: "string", description: "\u4FDD\u5B58\u5FEB\u7167\u7684\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u5185\u8054\u8FD4\u56DE" }
+      })
+    }
+  },
+  {
+    name: "chrome-devtools_take_screenshot",
+    description: "\u622A\u53D6\u6307\u5B9A\u9875\u9762\u6216\u5143\u7D20\u5C4F\u5E55\u622A\u56FE\uFF0C\u8FD4\u56DE base64 \u6216\u4FDD\u5B58\u5230\u6587\u4EF6",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        format: {
+          type: "string",
+          enum: ["png", "jpeg", "webp"],
+          description: "\u56FE\u7247\u683C\u5F0F\uFF0C\u9ED8\u8BA4 png"
+        },
+        quality: {
+          type: "number",
+          minimum: 0,
+          maximum: 100,
+          description: "JPEG/WebP \u538B\u7F29\u8D28\u91CF 0-100"
+        },
+        uid: {
+          type: "string",
+          description: "\u5143\u7D20 uid\uFF08\u4ECE chrome-devtools_take_snapshot \u83B7\u53D6\uFF09\uFF0C\u7701\u7565\u622A\u53D6\u6574\u9875"
+        },
+        fullPage: { type: "boolean", description: "\u662F\u5426\u622A\u53D6\u5B8C\u6574\u9875\u9762\uFF08\u4E0E uid \u4E92\u65A5\uFF09" },
+        filePath: { type: "string", description: "\u4FDD\u5B58\u622A\u56FE\u7684\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7701\u7565\u8FD4\u56DE base64" }
+      })
+    }
+  },
+  // ===== 交互操作 =====
+  {
+    name: "chrome-devtools_click",
+    description: "\u70B9\u51FB\u9875\u9762\u5143\u7D20",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          uid: { type: "string", description: "\u5143\u7D20 uid\uFF08\u4ECE chrome-devtools_take_snapshot \u83B7\u53D6\uFF09" },
+          dblClick: { type: "boolean", description: "\u662F\u5426\u53CC\u51FB\uFF0C\u9ED8\u8BA4 false" },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["uid"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_hover",
+    description: "\u9F20\u6807\u60AC\u505C\u5728\u9875\u9762\u5143\u7D20\u4E0A",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          uid: { type: "string", description: "\u5143\u7D20 uid" },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["uid"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_drag",
+    description: "\u62D6\u62FD\u9875\u9762\u5143\u7D20\u5230\u53E6\u4E00\u4E2A\u5143\u7D20\u4E0A",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          from_uid: { type: "string", description: "\u88AB\u62D6\u62FD\u5143\u7D20\u7684 uid" },
+          to_uid: { type: "string", description: "\u76EE\u6807\u653E\u7F6E\u5143\u7D20\u7684 uid" },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["from_uid", "to_uid"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_type_text",
+    description: "\u5728\u5DF2\u805A\u7126\u7684\u8F93\u5165\u6846\u4E2D\u4F7F\u7528\u952E\u76D8\u8F93\u5165\u6587\u672C",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          text: { type: "string", description: "\u8981\u8F93\u5165\u7684\u6587\u672C" },
+          submitKey: {
+            type: "string",
+            description: '\u8F93\u5165\u540E\u6309\u4E0B\u7684\u6309\u952E\uFF0C\u5982 "Enter"\u3001"Tab"\u3001"Escape"'
+          }
+        },
+        ["text"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_press_key",
+    description: "\u6309\u4E0B\u952E\u76D8\u6309\u952E\u6216\u7EC4\u5408\u952E\uFF08\u5FEB\u6377\u952E\u3001\u5BFC\u822A\u952E\u7B49\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          key: {
+            type: "string",
+            description: '\u6309\u952E\u6216\u7EC4\u5408\u952E\uFF0C\u5982 "Enter"\u3001"Control+A"\u3002\u4FEE\u9970\u952E: Control, Shift, Alt, Meta'
+          },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["key"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_fill",
+    description: "\u586B\u5199\u8F93\u5165\u6846\u503C\u6216\u9009\u62E9 select \u9009\u9879\uFF0C\u89E6\u53D1 input/change \u4E8B\u4EF6",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          uid: { type: "string", description: "\u8F93\u5165\u6846/select \u5143\u7D20 uid" },
+          value: {
+            type: "string",
+            description: '\u8981\u586B\u5165\u7684\u503C\u3002checkbox/toggle \u7528 "true"/"false"\uFF0Cradio \u7528 "true"'
+          },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["uid", "value"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_fill_form",
+    description: "\u6279\u91CF\u586B\u5199\u8868\u5355\u5B57\u6BB5\uFF0C\u6BD4\u591A\u6B21\u8C03\u7528 fill/click \u66F4\u5FEB\u66F4\u53EF\u9760",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          elements: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: { uid: { type: "string" }, value: { type: "string" } }
+            },
+            description: "\u8868\u5355\u5143\u7D20\u6570\u7EC4 [{ uid, value }]"
+          },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["elements"]
+      )
+    }
+  },
+  // ===== 页面导航 =====
+  {
+    name: "chrome-devtools_navigate_page",
+    description: "\u5BFC\u822A\u9875\u9762\uFF08url/reload/back/forward\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          type: {
+            type: "string",
+            enum: ["url", "back", "forward", "reload"],
+            description: "\u5BFC\u822A\u7C7B\u578B"
+          },
+          url: { type: "string", description: "\u76EE\u6807 URL\uFF08type=url \u65F6\u5FC5\u586B\uFF09" },
+          ignoreCache: { type: "boolean", description: "reload \u65F6\u662F\u5426\u5FFD\u7565\u7F13\u5B58" },
+          handleBeforeUnload: {
+            type: "string",
+            enum: ["accept", "dismiss"],
+            description: "beforeunload \u5BF9\u8BDD\u6846\u5904\u7406\u65B9\u5F0F"
+          },
+          initScript: {
+            type: "string",
+            description: "\u4E0B\u4E00\u6B21\u5BFC\u822A\u65F6\uFF0C\u5728\u6BCF\u4E2A\u65B0 document \u52A0\u8F7D\u524D\u6267\u884C\u7684 JS \u811A\u672C"
+          },
+          timeout: { type: "integer", description: "\u6700\u5927\u7B49\u5F85\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C0 \u4F7F\u7528\u9ED8\u8BA4\u8D85\u65F6" }
+        },
+        ["type"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_resize_page",
+    description: "\u8C03\u6574\u9875\u9762\u89C6\u53E3\u5927\u5C0F",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          width: { type: "number", description: "\u89C6\u53E3\u5BBD\u5EA6" },
+          height: { type: "number", description: "\u89C6\u53E3\u9AD8\u5EA6" }
+        },
+        ["width", "height"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_emulate",
+    description: "\u6A21\u62DF\u8BBE\u5907\u7279\u6027\uFF08\u7F51\u7EDC\u8282\u6D41\u3001CPU \u964D\u901F\u3001\u5730\u7406\u4F4D\u7F6E\u3001UA\u3001\u989C\u8272\u65B9\u6848\u3001\u89C6\u53E3\u7B49\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        networkConditions: {
+          type: "string",
+          enum: ["Offline", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G"],
+          description: "\u7F51\u7EDC\u8282\u6D41\u6A21\u5F0F"
+        },
+        cpuThrottlingRate: {
+          type: "number",
+          minimum: 1,
+          maximum: 20,
+          description: "CPU \u964D\u901F\u500D\u6570\uFF0C1 \u4E0D\u964D\u901F"
+        },
+        geolocation: { type: "string", description: "\u5730\u7406\u4F4D\u7F6E\uFF0C\u683C\u5F0F `<\u7EAC\u5EA6>,<\u7ECF\u5EA6>`" },
+        userAgent: { type: "string", description: "UA \u5B57\u7B26\u4E32\uFF0C\u7A7A\u5B57\u7B26\u4E32\u6E05\u9664" },
+        colorScheme: {
+          type: "string",
+          enum: ["dark", "light", "auto"],
+          description: '\u989C\u8272\u65B9\u6848\uFF0C"auto" \u6062\u590D\u9ED8\u8BA4'
+        },
+        viewport: {
+          type: "string",
+          description: "\u89C6\u53E3\u6A21\u62DF\uFF0C\u683C\u5F0F `<\u5BBD>x<\u9AD8>x<\u7F29\u653E\u6BD4>[,mobile][,touch][,landscape]`"
+        },
+        extraHttpHeaders: {
+          type: "string",
+          description: `\u989D\u5916 HTTP \u8BF7\u6C42\u5934 JSON\uFF0C\u5982 '{"X-Custom":"value"}'`
+        }
+      })
+    }
+  },
+  // ===== JS 执行 =====
+  {
+    name: "chrome-devtools_evaluate_script",
+    description: "\u5728\u6307\u5B9A\u9875\u9762\u6267\u884C JavaScript \u51FD\u6570\u5E76\u8FD4\u56DE\u7ED3\u679C\uFF08\u8FD4\u56DE\u503C\u9700\u53EF JSON \u5E8F\u5217\u5316\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          function: {
+            type: "string",
+            description: "JS \u51FD\u6570\u58F0\u660E\u3002\u65E0\u53C2\u6570: `() => document.title`\uFF0C\u6709\u53C2\u6570: `(el) => el.innerText`"
+          },
+          args: {
+            type: "array",
+            items: { type: "string" },
+            description: "\u4F20\u7ED9\u51FD\u6570\u7684\u53C2\u6570\u5217\u8868\uFF08\u5143\u7D20 uid\uFF09"
+          },
+          filePath: { type: "string", description: "\u4FDD\u5B58\u8F93\u51FA\u5230\u6587\u4EF6\uFF0C\u7701\u7565\u5219\u5185\u8054\u8FD4\u56DE" },
+          dialogAction: {
+            type: "string",
+            description: '\u5BF9\u8BDD\u6846\u5904\u7406: "accept"\u3001"dismiss" \u6216 prompt \u6587\u672C'
+          }
+        },
+        ["function"]
+      )
+    }
+  },
+  // ===== 网络监控 =====
+  {
+    name: "chrome-devtools_list_network_requests",
+    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u7F51\u7EDC\u8BF7\u6C42\u5217\u8868\uFF08\u652F\u6301\u5206\u9875\u548C\u8FC7\u6EE4\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        pageSize: { type: "integer", description: "\u6BCF\u9875\u6700\u5927\u8BF7\u6C42\u6570" },
+        pageIdx: { type: "integer", minimum: 0, description: "\u9875\u7801\uFF08\u4ECE 0 \u5F00\u59CB\uFF09" },
+        resourceTypes: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: [
+              "document",
+              "stylesheet",
+              "image",
+              "media",
+              "font",
+              "script",
+              "xhr",
+              "fetch",
+              "websocket",
+              "manifest",
+              "other"
+            ]
+          },
+          description: "\u6309\u8D44\u6E90\u7C7B\u578B\u8FC7\u6EE4"
+        },
+        includePreservedRequests: {
+          type: "boolean",
+          description: "\u662F\u5426\u8FD4\u56DE\u6700\u8FD1 3 \u6B21\u5BFC\u822A\u7684\u4FDD\u7559\u8BF7\u6C42"
+        }
+      })
+    }
+  },
+  {
+    name: "chrome-devtools_get_network_request",
+    description: "\u83B7\u53D6\u7F51\u7EDC\u8BF7\u6C42\u7684\u8BE6\u7EC6\u4FE1\u606F\uFF0C\u53EF\u4FDD\u5B58\u8BF7\u6C42/\u54CD\u5E94\u4F53\u5230\u6587\u4EF6",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        reqid: {
+          type: "number",
+          description: "\u8BF7\u6C42 ID\uFF08\u4ECE chrome-devtools_list_network_requests \u83B7\u53D6\uFF09\uFF0C\u7701\u7565\u8FD4\u56DE\u5F53\u524D\u9009\u4E2D\u8BF7\u6C42"
+        },
+        requestFilePath: {
+          type: "string",
+          description: "\u4FDD\u5B58\u8BF7\u6C42\u4F53\u5230 .network-request \u6587\u4EF6\u7684\u8DEF\u5F84"
+        },
+        responseFilePath: {
+          type: "string",
+          description: "\u4FDD\u5B58\u54CD\u5E94\u4F53\u5230 .network-response \u6587\u4EF6\u7684\u8DEF\u5F84"
+        }
+      })
+    }
+  },
+  // ===== 控制台 =====
+  {
+    name: "chrome-devtools_list_console_messages",
+    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u63A7\u5236\u53F0\u6D88\u606F\uFF08\u652F\u6301\u5206\u9875\u548C\u8FC7\u6EE4\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        pageSize: { type: "integer", description: "\u6BCF\u9875\u6700\u5927\u6D88\u606F\u6570" },
+        pageIdx: { type: "integer", minimum: 0, description: "\u9875\u7801\uFF08\u4ECE 0 \u5F00\u59CB\uFF09" },
+        types: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: ["log", "debug", "info", "error", "warn", "trace", "verbose", "issue"]
+          },
+          description: "\u6309\u6D88\u606F\u7C7B\u578B\u8FC7\u6EE4"
+        },
+        includePreservedMessages: {
+          type: "boolean",
+          description: "\u662F\u5426\u8FD4\u56DE\u6700\u8FD1 3 \u6B21\u5BFC\u822A\u7684\u4FDD\u7559\u6D88\u606F"
+        },
+        serviceWorkerId: { type: "string", description: "\u6309 service worker ID \u8FC7\u6EE4" }
+      })
+    }
+  },
+  {
+    name: "chrome-devtools_get_console_message",
+    description: "\u83B7\u53D6\u67D0\u6761\u63A7\u5236\u53F0\u6D88\u606F\u7684\u8BE6\u7EC6\u4FE1\u606F",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          msgid: {
+            type: "number",
+            description: "\u6D88\u606F ID\uFF08\u4ECE chrome-devtools_list_console_messages \u83B7\u53D6\uFF09"
+          }
+        },
+        ["msgid"]
+      )
+    }
+  },
+  // ===== 其他 =====
+  {
+    name: "chrome-devtools_wait_for",
+    description: "\u7B49\u5F85\u6307\u5B9A\u9875\u9762\u51FA\u73B0\u6307\u5B9A\u6587\u672C\uFF08\u4EFB\u4E00\u5339\u914D\u5373\u8FD4\u56DE\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          text: {
+            type: "array",
+            items: { type: "string" },
+            minItems: 1,
+            description: "\u7B49\u5F85\u51FA\u73B0\u7684\u6587\u672C\u5217\u8868"
+          },
+          timeout: { type: "integer", description: "\u6700\u5927\u7B49\u5F85\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C0 \u4F7F\u7528\u9ED8\u8BA4\u8D85\u65F6" }
+        },
+        ["text"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_handle_dialog",
+    description: "\u5904\u7406 JavaScript \u5BF9\u8BDD\u6846\uFF08alert/confirm/prompt\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          action: { type: "string", enum: ["accept", "dismiss"], description: "\u63A5\u53D7\u6216\u5173\u95ED\u5BF9\u8BDD\u6846" },
+          promptText: { type: "string", description: "prompt \u5BF9\u8BDD\u6846\u7684\u8F93\u5165\u6587\u672C" }
+        },
+        ["action"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_upload_file",
+    description: "\u4E0A\u4F20\u6587\u4EF6\u5230\u6587\u4EF6\u8F93\u5165\u6846",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          uid: { type: "string", description: "\u6587\u4EF6\u8F93\u5165\u6846\u5143\u7D20 uid" },
+          filePath: { type: "string", description: "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84" },
+          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
+        },
+        ["uid", "filePath"]
+      )
+    }
+  },
+  // ===== 性能分析 =====
+  {
+    name: "chrome-devtools_performance_start_trace",
+    description: "\u5728\u6307\u5B9A\u9875\u9762\u5F00\u59CB\u8BB0\u5F55\u6027\u80FD trace\uFF08\u7528\u4E8E\u53D1\u73B0 Core Web Vitals \u6027\u80FD\u95EE\u9898\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        reload: { type: "boolean", description: "\u5F00\u59CB\u540E\u662F\u5426\u81EA\u52A8\u5237\u65B0\u9875\u9762\uFF0C\u9ED8\u8BA4 true" },
+        autoStop: { type: "boolean", description: "\u662F\u5426\u81EA\u52A8\u505C\u6B62\u5F55\u5236\uFF0C\u9ED8\u8BA4 true" },
+        filePath: { type: "string", description: "\u4FDD\u5B58\u539F\u59CB trace \u6570\u636E\u7684\u8DEF\u5F84\uFF0C\u5982 trace.json.gz" }
+      })
+    }
+  },
+  {
+    name: "chrome-devtools_performance_stop_trace",
+    description: "\u505C\u6B62\u6027\u80FD trace \u8BB0\u5F55\u5E76\u8FD4\u56DE\u7ED3\u679C",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        filePath: { type: "string", description: "\u4FDD\u5B58\u539F\u59CB trace \u6570\u636E\u7684\u8DEF\u5F84\uFF0C\u5982 trace.json.gz" }
+      })
+    }
+  },
+  {
+    name: "chrome-devtools_performance_analyze_insight",
+    description: "\u83B7\u53D6\u7279\u5B9A\u6027\u80FD\u6307\u6807\u7684\u8BE6\u7EC6\u5206\u6790",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          insightSetId: { type: "string", description: "\u6307\u6807\u96C6 ID\uFF08\u4ECE trace \u7ED3\u679C\u83B7\u53D6\uFF09" },
+          insightName: {
+            type: "string",
+            description: '\u6307\u6807\u540D\u79F0\uFF0C\u5982 "DocumentLatency"\u3001"LCPBreakdown"'
+          }
+        },
+        ["insightSetId", "insightName"]
+      )
+    }
+  },
+  {
+    name: "chrome-devtools_lighthouse_audit",
+    description: "\u5BF9\u6307\u5B9A\u9875\u9762\u8FD0\u884C Lighthouse \u5BA1\u8BA1\uFF08\u53EF\u8BBF\u95EE\u6027/SEO/\u6700\u4F73\u5B9E\u8DF5\uFF0C\u4E0D\u542B\u6027\u80FD\uFF09",
+    inputSchema: {
+      type: "object",
+      ...withPageId({
+        mode: {
+          type: "string",
+          enum: ["navigation", "snapshot"],
+          description: "navigation \u5237\u65B0\u5BA1\u8BA1\uFF0Csnapshot \u5206\u6790\u5F53\u524D\u72B6\u6001"
+        },
+        device: {
+          type: "string",
+          enum: ["desktop", "mobile"],
+          description: "\u6A21\u62DF\u8BBE\u5907\u7C7B\u578B\uFF0C\u9ED8\u8BA4 desktop"
+        },
+        outputDirPath: { type: "string", description: "\u62A5\u544A\u8F93\u51FA\u76EE\u5F55\uFF0C\u7701\u7565\u4F7F\u7528\u4E34\u65F6\u6587\u4EF6" }
+      })
+    }
+  },
+  {
+    name: "chrome-devtools_take_heapsnapshot",
+    description: "\u6355\u83B7\u6307\u5B9A\u9875\u9762\u5806\u5185\u5B58\u5FEB\u7167\uFF0C\u7528\u4E8E\u5206\u6790 JS \u5BF9\u8C61\u5185\u5B58\u5206\u5E03\u548C\u8C03\u8BD5\u5185\u5B58\u6CC4\u6F0F",
+    inputSchema: {
+      type: "object",
+      ...withPageId(
+        {
+          filePath: { type: "string", description: "\u4FDD\u5B58 .heapsnapshot \u6587\u4EF6\u7684\u8DEF\u5F84" }
+        },
+        ["filePath"]
+      )
+    }
+  },
+  // ===== Vue DevTools =====
+  {
+    name: "vue-devtools_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: {
+      type: "object",
+      ...withPageId({})
+    }
+  },
+  {
+    name: "vue-devtools_set_active_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: {
+      type: "object",
+      ...withPageId(
+        {
+          appId: { type: "string", description: "\u5E94\u7528 ID\uFF08\u4ECE vue-devtools_get_apps \u83B7\u53D6\uFF09" }
+        },
+        ["appId"]
+      )
+    }
+  },
+  {
+    name: "vue-devtools_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: {
+      type: "object",
+      ...withPageId({
+        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_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: {
+      type: "object",
+      ...withPageId(
+        {
+          nodeId: {
+            type: "string",
+            description: "\u7EC4\u4EF6\u8282\u70B9 ID\uFF08\u4ECE vue-devtools_get_component_tree \u83B7\u53D6\uFF09"
+          }
+        },
+        ["nodeId"]
+      )
+    }
+  },
+  {
+    name: "vue-devtools_get_component_render_code",
+    description: `\u83B7\u53D6\u7EC4\u4EF6\u7684\u6E32\u67D3\u51FD\u6570\u6E90\u7801\u3002`,
+    inputSchema: {
+      type: "object",
+      ...withPageId({ nodeId: { type: "string", description: "\u7EC4\u4EF6\u8282\u70B9 ID" } }, ["nodeId"])
+    }
+  },
+  {
+    name: "vue-devtools_get_current_route",
+    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: {
+      type: "object",
+      ...withPageId({})
+    }
+  },
+  {
+    name: "vue-devtools_get_routes",
+    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: {
+      type: "object",
+      ...withPageId({})
+    }
+  },
+  // ===== Vite 进程日志 =====
+  {
+    name: "logs-devtools_vite_logs",
+    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)"
+        }
+      }
+    }
+  }
+];
+export {
+  CUSTOM_TOOLS
+};

package/es/core/provider-loader.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderInitContext, WebProvider } from "@aipanel/core";
+/**
+ * id → Provider npm 包名映射（登记制）
+ * "default" 是默认别名（未配置 provider 时的兜底），其他键为 Provider 真实 id。
+ * 这里只有包名字符串，无静态依赖；加载与初始化完全由 Provider 包自身完成。
+ */
+declare const PROVIDER_PACKAGES: {
+    readonly default: "@aipanel/provider-opencode";
+    readonly opencode: "@aipanel/provider-opencode";
+    readonly deepseek: "@aipanel/provider-deepseek";
+};
+/** 已登记的 Provider id 联合类型（与运行时映射保持单一事实来源） */
+export type ProviderId = keyof typeof PROVIDER_PACKAGES;
+/**
+ * 按 id 动态加载 Provider 包并初始化
+ * 约定：Provider 包必须导出 createProvider(ctx): WebProvider 工厂
+ */
+export declare function loadProvider(id: string, ctx: ProviderInitContext): Promise<WebProvider>;
+export {};