ghost-bridge 0.2.5 → 0.3.0

package/dist/server.js

@@ -28896,7 +28896,7 @@ function buildSnippet(source, line, column, { beautifyEnabled = true, contextLin
   return result;
 }
 var server = new Server(
-  { name: "ghost-bridge", version: "0.1.0" },
+  { name: "ghost-bridge", version: "0.3.0" },
   { capabilities: { tools: {} } }
 );
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -28993,6 +28993,23 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       description: "\u6E05\u7A7A\u5DF2\u6355\u83B7\u7684\u7F51\u7EDC\u8BF7\u6C42\u8BB0\u5F55",
       inputSchema: { type: "object", properties: {} }
     },
+    {
+      name: "perf_metrics",
+      description: "\u83B7\u53D6\u9875\u9762\u6027\u80FD\u6307\u6807\uFF1A\u5305\u542B\u5F15\u64CE\u7EA7\u6307\u6807\uFF08JS\u5806\u5185\u5B58\u3001DOM\u8282\u70B9\u6570\u3001Layout\u6B21\u6570\u3001\u811A\u672C\u6267\u884C\u65F6\u95F4\uFF09\u3001Web Vitals\uFF08FCP\u3001TTFB\u3001DOMContentLoaded\u3001Long Tasks\uFF09\u548C\u8D44\u6E90\u52A0\u8F7D\u6458\u8981\u3002\u7528\u4E8E\u8BCA\u65AD\u9875\u9762\u5361\u987F\u3001\u5185\u5B58\u5360\u7528\u8FC7\u9AD8\u3001\u52A0\u8F7D\u7F13\u6162\u7B49\u6027\u80FD\u95EE\u9898\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          includeTimings: {
+            type: "boolean",
+            description: "\u662F\u5426\u5305\u542B Navigation Timing \u548C Web Vitals\uFF0C\u9ED8\u8BA4 true"
+          },
+          includeResources: {
+            type: "boolean",
+            description: "\u662F\u5426\u5305\u542B\u8D44\u6E90\u52A0\u8F7D\u6458\u8981\uFF08\u6309\u7C7B\u578B\u7EDF\u8BA1\u3001\u6700\u6162\u8D44\u6E90\uFF09\uFF0C\u9ED8\u8BA4 true"
+          }
+        }
+      }
+    },
     {
       name: "capture_screenshot",
       description: "\u3010\u63A8\u8350\u7528\u4E8E\u89C6\u89C9\u5206\u6790\u3011\u622A\u53D6\u5F53\u524D\u9875\u9762\u7684\u622A\u56FE\uFF0C\u8FD4\u56DE base64 \u56FE\u7247\u3002\u9002\u7528\u4E8E\uFF1A1) \u67E5\u770B\u9875\u9762\u5B9E\u9645\u89C6\u89C9\u6548\u679C 2) \u6392\u67E5 UI/\u6837\u5F0F/\u5E03\u5C40/\u989C\u8272\u95EE\u9898 3) \u9A8C\u8BC1\u9875\u9762\u6E32\u67D3 4) \u5206\u6790\u5143\u7D20\u4F4D\u7F6E\u548C\u95F4\u8DDD 5) \u67E5\u770B\u56FE\u7247/\u56FE\u6807\u7B49\u89C6\u89C9\u5185\u5BB9\u3002\u5F53\u9700\u8981\u770B\u5230\u9875\u9762\u300C\u957F\u4EC0\u4E48\u6837\u300D\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177\u3002\u5982\u4EC5\u9700\u6587\u672C/\u94FE\u63A5\u7B49\u4FE1\u606F\uFF0C\u5EFA\u8BAE\u4F7F\u7528\u66F4\u5FEB\u7684 get_page_content\u3002",
@@ -29078,7 +29095,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             type: "text",
             text: jsonText({
               service: "ghost-bridge",
-              version: "0.1.0",
+              version: "0.3.0",
               role: isMainInstance ? "\u4E3B\u5B9E\u4F8B (WebSocket Server)" : "\u5BA2\u6237\u7AEF (\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B)",
               wsPort: actualPort,
               wsUrl: `ws://localhost:${actualPort}`,
@@ -29163,6 +29180,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const res = await askChrome("clearNetworkRequests");
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
+    if (name === "perf_metrics") {
+      const { includeTimings, includeResources } = args;
+      const res = await askChrome("perfMetrics", { includeTimings, includeResources });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
     if (name === "capture_screenshot") {
       const { format, quality, fullPage, clip } = args;
       const res = await askChrome("captureScreenshot", { format, quality, fullPage, clip }, { timeoutMs: 15e3 });

package/extension/background.js

@@ -590,6 +590,157 @@ async function handleClearNetworkRequests() {
   return { cleared: count }
 }
 
+async function handlePerfMetrics(params = {}) {
+  const target = await ensureAttached()
+  const { includeResources = true, includeTimings = true } = params
+
+  // 1. CDP Performance.getMetrics — 底层引擎指标
+  await chrome.debugger.sendCommand(target, "Performance.enable")
+  const { metrics } = await chrome.debugger.sendCommand(target, "Performance.getMetrics")
+  await chrome.debugger.sendCommand(target, "Performance.disable")
+
+  // 整理为可读的分组
+  const metricsMap = {}
+  for (const m of metrics) {
+    metricsMap[m.name] = m.value
+  }
+
+  const engineMetrics = {
+    memory: {
+      jsHeapUsedSize: formatBytes(metricsMap.JSHeapUsedSize),
+      jsHeapTotalSize: formatBytes(metricsMap.JSHeapTotalSize),
+      usagePercent: metricsMap.JSHeapTotalSize
+        ? Math.round((metricsMap.JSHeapUsedSize / metricsMap.JSHeapTotalSize) * 100) + "%"
+        : "N/A",
+    },
+    dom: {
+      nodes: metricsMap.Nodes,
+      documents: metricsMap.Documents,
+      frames: metricsMap.Frames,
+      jsEventListeners: metricsMap.JSEventListeners,
+    },
+    layout: {
+      layoutCount: metricsMap.LayoutCount,
+      recalcStyleCount: metricsMap.RecalcStyleCount,
+      layoutDuration: roundMs(metricsMap.LayoutDuration),
+      recalcStyleDuration: roundMs(metricsMap.RecalcStyleDuration),
+    },
+    tasks: {
+      scriptDuration: roundMs(metricsMap.ScriptDuration),
+      taskDuration: roundMs(metricsMap.TaskDuration),
+      taskOtherDuration: roundMs(metricsMap.TaskOtherDuration),
+    },
+  }
+
+  const result = { engineMetrics }
+
+  // 2. Web Vitals + Navigation Timing（通过 Runtime.evaluate）
+  if (includeTimings) {
+    const expression = `(function() {
+      try {
+        const result = {};
+        // Navigation Timing
+        const nav = performance.getEntriesByType('navigation')[0];
+        if (nav) {
+          result.navigation = {
+            type: nav.type,
+            redirectTime: Math.round(nav.redirectEnd - nav.redirectStart),
+            dnsTime: Math.round(nav.domainLookupEnd - nav.domainLookupStart),
+            connectTime: Math.round(nav.connectEnd - nav.connectStart),
+            ttfb: Math.round(nav.responseStart - nav.requestStart),
+            responseTime: Math.round(nav.responseEnd - nav.responseStart),
+            domInteractive: Math.round(nav.domInteractive),
+            domContentLoaded: Math.round(nav.domContentLoadedEventEnd),
+            loadComplete: Math.round(nav.loadEventEnd),
+            totalDuration: Math.round(nav.duration),
+          };
+        }
+        // Paint Timing (FP, FCP)
+        const paints = performance.getEntriesByType('paint');
+        result.paint = {};
+        for (const p of paints) {
+          if (p.name === 'first-paint') result.paint.firstPaint = Math.round(p.startTime);
+          if (p.name === 'first-contentful-paint') result.paint.firstContentfulPaint = Math.round(p.startTime);
+        }
+        // Long Tasks（如果有 PerformanceObserver 记录）
+        try {
+          const longTasks = performance.getEntriesByType('longtask');
+          if (longTasks && longTasks.length > 0) {
+            result.longTasks = {
+              count: longTasks.length,
+              totalDuration: Math.round(longTasks.reduce((s, t) => s + t.duration, 0)),
+              longest: Math.round(Math.max(...longTasks.map(t => t.duration))),
+            };
+          }
+        } catch(e) {}
+        // 基本信息
+        result.timing = {
+          now: Math.round(performance.now()),
+          timeOrigin: Math.round(performance.timeOrigin),
+        };
+        return result;
+      } catch (e) { return { error: e.message }; }
+    })()`
+    const { result: evalResult } = await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
+      expression,
+      returnByValue: true,
+    })
+    if (evalResult?.value) {
+      result.webVitals = evalResult.value
+    }
+  }
+
+  // 3. 资源加载摘要
+  if (includeResources) {
+    const resExpression = `(function() {
+      try {
+        const entries = performance.getEntriesByType('resource');
+        const byType = {};
+        let totalSize = 0, totalDuration = 0, slowest = null;
+        for (const e of entries) {
+          const type = e.initiatorType || 'other';
+          if (!byType[type]) byType[type] = { count: 0, totalSize: 0, totalDuration: 0 };
+          byType[type].count++;
+          byType[type].totalSize += e.transferSize || 0;
+          byType[type].totalDuration += e.duration || 0;
+          totalSize += e.transferSize || 0;
+          totalDuration += e.duration || 0;
+          if (!slowest || e.duration > slowest.duration) {
+            slowest = { name: e.name.split('/').pop().split('?')[0] || e.name.slice(0, 60), duration: Math.round(e.duration), size: e.transferSize || 0, type };
+          }
+        }
+        // 格式化 byType
+        const summary = {};
+        for (const [type, data] of Object.entries(byType)) {
+          summary[type] = { count: data.count, totalSize: data.totalSize, avgDuration: Math.round(data.totalDuration / data.count) };
+        }
+        return { totalResources: entries.length, totalTransferSize: totalSize, summary, slowest };
+      } catch (e) { return { error: e.message }; }
+    })()`
+    const { result: resResult } = await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
+      expression: resExpression,
+      returnByValue: true,
+    })
+    if (resResult?.value) {
+      result.resources = resResult.value
+    }
+  }
+
+  return result
+}
+
+function formatBytes(bytes) {
+  if (bytes == null) return "N/A"
+  if (bytes < 1024) return bytes + " B"
+  if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + " KB"
+  return (bytes / (1024 * 1024)).toFixed(1) + " MB"
+}
+
+function roundMs(seconds) {
+  if (seconds == null) return "N/A"
+  return Math.round(seconds * 1000) + "ms"
+}
+
 async function handleCaptureScreenshot(params = {}) {
   const target = await ensureAttached()
   const { format = 'png', quality, fullPage = false, clip } = params
@@ -784,6 +935,7 @@ async function handleCommand(message) {
     else if (command === "listNetworkRequests") result = await handleListNetworkRequests(params)
     else if (command === "getNetworkDetail") result = await handleGetNetworkDetail(params)
     else if (command === "clearNetworkRequests") result = await handleClearNetworkRequests()
+    else if (command === "perfMetrics") result = await handlePerfMetrics(params)
     else if (command === "captureScreenshot") result = await handleCaptureScreenshot(params)
     else if (command === "getPageContent") result = await handleGetPageContent(params)
     else throw new Error(`未知指令 ${command}`)

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Ghost Bridge",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zero-restart Chrome debugger bridge for Claude MCP, optimized for no-sourcemap production debugging.",
   "permissions": [
     "debugger",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghost-bridge",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "description": "Ghost Bridge: Zero-restart Chrome debugger bridge for Claude MCP. Includes CLI for easy setup.",
@@ -26,4 +26,4 @@
     "js-beautify": "^1.14.11",
     "ws": "^8.14.2"
   }
-}
+}