vite-plugin-opencode-assistant 1.1.24 → 1.1.26

package/lib/endpoints/index.d.ts

@@ -1,6 +1,8 @@
 import type { ViteDevServer } from "vite";
 import type { EndpointContext } from "./types";
+import { MCP_API_PATH } from "./mcp";
+import type { McpProxy } from "../core/mcp-proxy";
 import { LOGS_API_PATH } from "@vite-plugin-opencode-assistant/shared";
 export * from "./types";
-export { LOGS_API_PATH };
-export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext): void;
+export { LOGS_API_PATH, MCP_API_PATH };
+export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy): void;

package/lib/endpoints/mcp-tools.cjs

@@ -0,0 +1,541 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mcp_tools_exports = {};
+__export(mcp_tools_exports, {
+  CUSTOM_TOOLS: () => CUSTOM_TOOLS,
+  TOOL_MAP: () => TOOL_MAP
+});
+module.exports = __toCommonJS(mcp_tools_exports);
+const PAGE_ID_PROP = {
+  pageId: { type: "number", description: "\u76EE\u6807\u9875\u9762 ID\uFF08\u4ECE devtools_list_pages \u83B7\u53D6\uFF09" }
+};
+function withPageId(properties, required = []) {
+  return {
+    properties: __spreadValues(__spreadValues({}, PAGE_ID_PROP), properties),
+    required: ["pageId", ...required]
+  };
+}
+const CUSTOM_TOOLS = [
+  // ===== 页面管理 =====
+  {
+    name: "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: "devtools_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: __spreadValues({
+      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: "devtools_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: __spreadValues({
+      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 devtools_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: "devtools_click",
+    description: "\u70B9\u51FB\u9875\u9762\u5143\u7D20",
+    inputSchema: __spreadValues({
+      type: "object"
+    }, withPageId(
+      {
+        uid: { type: "string", description: "\u5143\u7D20 uid\uFF08\u4ECE devtools_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: "devtools_hover",
+    description: "\u9F20\u6807\u60AC\u505C\u5728\u9875\u9762\u5143\u7D20\u4E0A",
+    inputSchema: __spreadValues({
+      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: "devtools_drag",
+    description: "\u62D6\u62FD\u9875\u9762\u5143\u7D20\u5230\u53E6\u4E00\u4E2A\u5143\u7D20\u4E0A",
+    inputSchema: __spreadValues({
+      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: "devtools_type",
+    description: "\u5728\u5DF2\u805A\u7126\u7684\u8F93\u5165\u6846\u4E2D\u4F7F\u7528\u952E\u76D8\u8F93\u5165\u6587\u672C",
+    inputSchema: __spreadValues({
+      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: "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: __spreadValues({
+      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: "devtools_fill",
+    description: "\u586B\u5199\u8F93\u5165\u6846\u503C\u6216\u9009\u62E9 select \u9009\u9879\uFF0C\u89E6\u53D1 input/change \u4E8B\u4EF6",
+    inputSchema: __spreadValues({
+      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: "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: __spreadValues({
+      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: "devtools_navigate",
+    description: "\u5BFC\u822A\u9875\u9762\uFF08url/reload/back/forward\uFF09",
+    inputSchema: __spreadValues({
+      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: "devtools_resize_page",
+    description: "\u8C03\u6574\u9875\u9762\u89C6\u53E3\u5927\u5C0F",
+    inputSchema: __spreadValues({
+      type: "object"
+    }, withPageId(
+      {
+        width: { type: "number", description: "\u89C6\u53E3\u5BBD\u5EA6" },
+        height: { type: "number", description: "\u89C6\u53E3\u9AD8\u5EA6" }
+      },
+      ["width", "height"]
+    ))
+  },
+  {
+    name: "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: __spreadValues({
+      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: "devtools_evaluate",
+    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: __spreadValues({
+      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: "devtools_network",
+    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u7F51\u7EDC\u8BF7\u6C42\u5217\u8868\uFF08\u652F\u6301\u5206\u9875\u548C\u8FC7\u6EE4\uFF09",
+    inputSchema: __spreadValues({
+      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: "devtools_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: __spreadValues({
+      type: "object"
+    }, withPageId({
+      reqid: {
+        type: "number",
+        description: "\u8BF7\u6C42 ID\uFF08\u4ECE devtools_network \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: "devtools_console",
+    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u63A7\u5236\u53F0\u6D88\u606F\uFF08\u652F\u6301\u5206\u9875\u548C\u8FC7\u6EE4\uFF09",
+    inputSchema: __spreadValues({
+      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: "devtools_console_message",
+    description: "\u83B7\u53D6\u67D0\u6761\u63A7\u5236\u53F0\u6D88\u606F\u7684\u8BE6\u7EC6\u4FE1\u606F",
+    inputSchema: __spreadValues({
+      type: "object"
+    }, withPageId(
+      {
+        msgid: { type: "number", description: "\u6D88\u606F ID\uFF08\u4ECE devtools_console \u83B7\u53D6\uFF09" }
+      },
+      ["msgid"]
+    ))
+  },
+  // ===== 其他 =====
+  {
+    name: "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: __spreadValues({
+      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: "devtools_handle_dialog",
+    description: "\u5904\u7406 JavaScript \u5BF9\u8BDD\u6846\uFF08alert/confirm/prompt\uFF09",
+    inputSchema: __spreadValues({
+      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: "devtools_upload_file",
+    description: "\u4E0A\u4F20\u6587\u4EF6\u5230\u6587\u4EF6\u8F93\u5165\u6846",
+    inputSchema: __spreadValues({
+      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: "devtools_performance_start",
+    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: __spreadValues({
+      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: "devtools_performance_stop",
+    description: "\u505C\u6B62\u6027\u80FD trace \u8BB0\u5F55\u5E76\u8FD4\u56DE\u7ED3\u679C",
+    inputSchema: __spreadValues({
+      type: "object"
+    }, withPageId({
+      filePath: { type: "string", description: "\u4FDD\u5B58\u539F\u59CB trace \u6570\u636E\u7684\u8DEF\u5F84\uFF0C\u5982 trace.json.gz" }
+    }))
+  },
+  {
+    name: "devtools_performance_insight",
+    description: "\u83B7\u53D6\u7279\u5B9A\u6027\u80FD\u6307\u6807\u7684\u8BE6\u7EC6\u5206\u6790",
+    inputSchema: __spreadValues({
+      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: "devtools_lighthouse",
+    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: __spreadValues({
+      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: "devtools_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: __spreadValues({
+      type: "object"
+    }, withPageId(
+      {
+        filePath: { type: "string", description: "\u4FDD\u5B58 .heapsnapshot \u6587\u4EF6\u7684\u8DEF\u5F84" }
+      },
+      ["filePath"]
+    ))
+  }
+];
+const TOOL_MAP = {
+  devtools_list_pages: "list_pages",
+  devtools_snapshot: "take_snapshot",
+  devtools_screenshot: "take_screenshot",
+  devtools_evaluate: "evaluate_script",
+  devtools_click: "click",
+  devtools_hover: "hover",
+  devtools_drag: "drag",
+  devtools_type: "type_text",
+  devtools_press_key: "press_key",
+  devtools_fill: "fill",
+  devtools_fill_form: "fill_form",
+  devtools_navigate: "navigate_page",
+  devtools_resize_page: "resize_page",
+  devtools_emulate: "emulate",
+  devtools_network: "list_network_requests",
+  devtools_network_request: "get_network_request",
+  devtools_console: "list_console_messages",
+  devtools_console_message: "get_console_message",
+  devtools_wait_for: "wait_for",
+  devtools_handle_dialog: "handle_dialog",
+  devtools_upload_file: "upload_file",
+  devtools_performance_start: "performance_start_trace",
+  devtools_performance_stop: "performance_stop_trace",
+  devtools_performance_insight: "performance_analyze_insight",
+  devtools_lighthouse: "lighthouse_audit",
+  devtools_heapsnapshot: "take_heapsnapshot"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CUSTOM_TOOLS,
+  TOOL_MAP
+});

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

@@ -0,0 +1,17 @@
+/**
+ * 自定义 DevTools 工具定义
+ * 所有工具（除 devtools_list_pages）必须传入 pageId 参数，
+ * 代理层校验 pageId 是否为项目页面后方可调用 chrome-devtools-mcp。
+ */
+export interface CustomTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare const CUSTOM_TOOLS: CustomTool[];
+/** 工具名映射（自定义 → chrome-devtools-mcp） */
+export declare const TOOL_MAP: Record<string, string>;