ghost-bridge 0.7.1 → 0.9.0

package/dist/server.js

@@ -28523,6 +28523,7 @@ import net from "net";
 import fs2 from "fs";
 import os from "os";
 import path2 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // lib/version.js
 import fs from "fs";
@@ -28541,15 +28542,43 @@ var WS_TOKEN = process.env.GHOST_BRIDGE_TOKEN || DEFAULT_WS_TOKEN;
 var RESPONSE_TIMEOUT = 8e3;
 var PORT_INFO_FILE = path2.join(os.tmpdir(), "ghost-bridge-port.json");
 var SERVER_STARTED_AT = (/* @__PURE__ */ new Date()).toISOString();
+var SERVER_ENTRY_PATH = fileURLToPath2(import.meta.url);
 var chromeConnection = null;
 var activeConnection = null;
 var actualPort = BASE_PORT;
 var isMainInstance = false;
 var pendingRequests = /* @__PURE__ */ new Map();
 var mcpClients = /* @__PURE__ */ new Set();
+var mcpClientSeq = 0;
+var LOCAL_CLIENT_ID = "local";
 function log(msg) {
   console.error(`[ghost-bridge] ${msg}`);
 }
+function buildIdentityPayload() {
+  return {
+    type: "identity",
+    service: "ghost-bridge",
+    token: WS_TOKEN,
+    pid: process.pid,
+    port: actualPort,
+    version: GHOST_BRIDGE_VERSION,
+    serverPath: SERVER_ENTRY_PATH,
+    startedAt: SERVER_STARTED_AT,
+    capabilities: ["heartbeat"]
+  };
+}
+function getServiceMismatch(probe) {
+  if (!probe || probe.service !== "ghost-bridge") return null;
+  if (!probe.version) return "\u65E7\u670D\u52A1\u7F3A\u5C11\u7248\u672C\u5143\u6570\u636E";
+  if (probe.version !== GHOST_BRIDGE_VERSION) {
+    return `\u7248\u672C\u4E0D\u4E00\u81F4\uFF08\u65E7: ${probe.version}, \u65B0: ${GHOST_BRIDGE_VERSION}\uFF09`;
+  }
+  if (!probe.serverPath) return "\u65E7\u670D\u52A1\u7F3A\u5C11\u8DEF\u5F84\u5143\u6570\u636E";
+  if (path2.resolve(probe.serverPath) !== path2.resolve(SERVER_ENTRY_PATH)) {
+    return `\u8DEF\u5F84\u4E0D\u4E00\u81F4\uFF08\u65E7: ${probe.serverPath}, \u65B0: ${SERVER_ENTRY_PATH}\uFF09`;
+  }
+  return null;
+}
 function isProcessRunning(pid) {
   try {
     process.kill(pid, 0);
@@ -28628,11 +28657,11 @@ async function waitForPortAvailable(port, timeoutMs = 5e3) {
   }
   return isPortAvailable(port);
 }
-async function stopExistingService(pid, port) {
+async function stopExistingService(pid, port, reason = "\u9700\u8981\u7531\u65B0\u5B9E\u4F8B\u63A5\u7BA1") {
   if (!pid || pid === process.pid) {
     return false;
   }
-  log(`\u68C0\u6D4B\u5230\u65E7\u5B9E\u4F8B token \u4E0D\u4E00\u81F4\uFF0C\u51C6\u5907\u505C\u6B62\u65E7\u5B9E\u4F8B (PID: ${pid})`);
+  log(`\u68C0\u6D4B\u5230\u65E7\u5B9E\u4F8B\u9700\u8981\u66FF\u6362\uFF1A${reason}\uFF0C\u51C6\u5907\u505C\u6B62\u65E7\u5B9E\u4F8B (PID: ${pid})`);
   try {
     process.kill(pid, "SIGTERM");
   } catch (e) {
@@ -28686,13 +28715,18 @@ async function initWebSocketService() {
     const probe = await probeExistingService(existing.port);
     if (probe?.service === "ghost-bridge") {
       if (probe.token === WS_TOKEN) {
-        actualPort = existing.port;
-        isMainInstance = false;
-        log(`\u2705 \u590D\u7528\u73B0\u6709\u670D\u52A1\uFF0C\u7AEF\u53E3 ${actualPort}`);
-        return null;
+        const mismatch = getServiceMismatch(probe);
+        if (!mismatch) {
+          actualPort = existing.port;
+          isMainInstance = false;
+          log(`\u2705 \u590D\u7528\u73B0\u6709\u670D\u52A1\uFF0C\u7AEF\u53E3 ${actualPort}`);
+          return null;
+        }
+        await stopExistingService(Number(probe.pid) || existing.pid, existing.port, mismatch);
+      } else {
+        const oldPid = Number(probe.pid) || existing.pid;
+        await stopExistingService(oldPid, existing.port, "token \u4E0D\u4E00\u81F4");
       }
-      const oldPid = Number(probe.pid) || existing.pid;
-      await stopExistingService(oldPid, existing.port);
     } else {
       log(`\u274C \u73B0\u6709\u670D\u52A1\u9A8C\u8BC1\u5931\u8D25\uFF0C\u542F\u52A8\u65B0\u670D\u52A1...`);
       try {
@@ -28705,12 +28739,17 @@ async function initWebSocketService() {
     const probe = await probeExistingService(BASE_PORT);
     if (probe?.service === "ghost-bridge") {
       if (probe.token === WS_TOKEN) {
-        actualPort = BASE_PORT;
-        isMainInstance = false;
-        log(`\u2705 \u590D\u7528\u56FA\u5B9A\u7AEF\u53E3\u4E0A\u7684\u73B0\u6709\u670D\u52A1\uFF0C\u7AEF\u53E3 ${actualPort}`);
-        return null;
+        const mismatch = getServiceMismatch(probe);
+        if (!mismatch) {
+          actualPort = BASE_PORT;
+          isMainInstance = false;
+          log(`\u2705 \u590D\u7528\u56FA\u5B9A\u7AEF\u53E3\u4E0A\u7684\u73B0\u6709\u670D\u52A1\uFF0C\u7AEF\u53E3 ${actualPort}`);
+          return null;
+        }
+        await stopExistingService(Number(probe.pid), BASE_PORT, mismatch);
+      } else {
+        await stopExistingService(Number(probe.pid), BASE_PORT, "token \u4E0D\u4E00\u81F4");
       }
-      await stopExistingService(Number(probe.pid), BASE_PORT);
     }
     if (!await isPortAvailable(BASE_PORT)) {
       throw new Error(`\u56FA\u5B9A\u7AEF\u53E3 ${BASE_PORT} \u5DF2\u88AB\u5176\u4ED6\u8FDB\u7A0B\u5360\u7528\uFF0C\u8BF7\u91CA\u653E\u8BE5\u7AEF\u53E3\u6216\u901A\u8FC7 GHOST_BRIDGE_PORT \u6307\u5B9A\u5176\u4ED6\u7AEF\u53E3`);
@@ -28724,6 +28763,8 @@ async function initWebSocketService() {
       port: actualPort,
       wsUrl: `ws://localhost:${actualPort}`,
       pid: process.pid,
+      version: GHOST_BRIDGE_VERSION,
+      serverPath: SERVER_ENTRY_PATH,
       startedAt: SERVER_STARTED_AT
     }, null, 2)
   );
@@ -28731,20 +28772,19 @@ async function initWebSocketService() {
   return wss2;
 }
 var wss = await initWebSocketService();
+var wsPingInterval = null;
+var WS_PING_INTERVAL_MS = 3e4;
 if (wss) {
   wss.on("connection", (ws, req) => {
+    ws.isAlive = true;
+    ws.on("pong", () => {
+      ws.isAlive = true;
+    });
     const url2 = new URL(req.url || "/", "http://localhost");
     const token = url2.searchParams.get("token") || "";
     const role = url2.searchParams.get("role") || "";
     if (role === "probe") {
-      ws.send(JSON.stringify({
-        type: "identity",
-        service: "ghost-bridge",
-        token: WS_TOKEN,
-        pid: process.pid,
-        port: actualPort,
-        startedAt: SERVER_STARTED_AT
-      }));
+      ws.send(JSON.stringify(buildIdentityPayload()));
       ws.close(1e3, "Probe complete");
       return;
     }
@@ -28755,9 +28795,11 @@ if (wss) {
     }
     log(`\u8FDE\u63A5\u9A8C\u8BC1\u901A\u8FC7 (token: ${token})`);
     if (role === "mcp-client") {
-      log("\u{1F4E1} MCP \u5BA2\u6237\u7AEF\u5DF2\u8FDE\u63A5");
+      const clientId = `c${++mcpClientSeq}`;
+      ws.ghostClientId = clientId;
+      log(`\u{1F4E1} MCP \u5BA2\u6237\u7AEF\u5DF2\u8FDE\u63A5 (${clientId})`);
       mcpClients.add(ws);
-      ws.send(JSON.stringify({ type: "identity", service: "ghost-bridge", token: WS_TOKEN }));
+      ws.send(JSON.stringify(buildIdentityPayload()));
       ws.on("message", (data) => {
         try {
           const msg = JSON.parse(data.toString());
@@ -28767,7 +28809,11 @@ if (wss) {
               result: {
                 chromeConnected: !!chromeConnection,
                 mcpClientsCount: mcpClients.size,
-                port: actualPort
+                port: actualPort,
+                version: GHOST_BRIDGE_VERSION,
+                serverPath: SERVER_ENTRY_PATH,
+                pid: process.pid,
+                startedAt: SERVER_STARTED_AT
               }
             }));
             return;
@@ -28779,15 +28825,26 @@ if (wss) {
             return;
           }
           if (msg.id) {
-            pendingRequests.set(msg.id, { source: ws });
+            const wireId = `${clientId}:${msg.id}`;
+            pendingRequests.set(wireId, { source: ws, originalId: msg.id });
+            chromeConnection.send(JSON.stringify({
+              id: wireId,
+              command: msg.command,
+              params: msg.params,
+              clientId,
+              ...WS_TOKEN ? { token: WS_TOKEN } : {}
+            }));
+          } else {
+            chromeConnection.send(data);
           }
-          chromeConnection.send(data);
         } catch {
         }
       });
       ws.on("close", () => {
-        log("\u{1F4E1} MCP \u5BA2\u6237\u7AEF\u5DF2\u65AD\u5F00");
+        log(`\u{1F4E1} MCP \u5BA2\u6237\u7AEF\u5DF2\u65AD\u5F00 (${ws.ghostClientId})`);
         mcpClients.delete(ws);
+        askChrome("_clientDisconnected", { clientId: ws.ghostClientId }, { timeoutMs: 3e3 }).catch(() => {
+        });
       });
     } else {
       if (chromeConnection && chromeConnection !== ws && chromeConnection.readyState === import_websocket.default.OPEN) {
@@ -28801,15 +28858,21 @@ if (wss) {
       log("\u{1F310} Chrome \u6269\u5C55\u5DF2\u8FDE\u63A5");
       chromeConnection = ws;
       activeConnection = ws;
-      ws.send(JSON.stringify({ type: "identity", service: "ghost-bridge", token: WS_TOKEN }));
+      ws.send(JSON.stringify(buildIdentityPayload()));
       ws.on("message", (data) => {
         try {
           const msg = JSON.parse(data.toString());
+          if (msg.type === "heartbeat") {
+            ws.send(JSON.stringify({ type: "heartbeat_ack", ts: msg.ts || Date.now() }));
+            return;
+          }
           if (msg.id && pendingRequests.has(msg.id)) {
             const pending = pendingRequests.get(msg.id);
-            if (pending.source && pending.source.readyState === import_websocket.default.OPEN) {
+            if (pending.source) {
               pendingRequests.delete(msg.id);
-              pending.source.send(data);
+              if (pending.source.readyState === import_websocket.default.OPEN) {
+                pending.source.send(JSON.stringify({ ...msg, id: pending.originalId }));
+              }
               return;
             }
           }
@@ -28817,14 +28880,38 @@ if (wss) {
         }
         handleIncoming(data);
       });
-      ws.on("close", () => {
-        log("\u{1F310} Chrome \u8FDE\u63A5\u5DF2\u5173\u95ED");
+      ws.on("close", (code, reason) => {
+        const reasonText = reason ? reason.toString() : "";
+        log(`\u{1F310} Chrome \u8FDE\u63A5\u5DF2\u5173\u95ED (code=${code}${reasonText ? ` reason="${reasonText}"` : ""})`);
+        if (chromeConnection !== ws) {
+          log("\u5FFD\u7565\u65E7 Chrome \u8FDE\u63A5\u7684\u5173\u95ED\u4E8B\u4EF6");
+          return;
+        }
         chromeConnection = null;
-        activeConnection = null;
+        if (activeConnection === ws) {
+          activeConnection = null;
+        }
         failAllPending("Chrome \u8FDE\u63A5\u65AD\u5F00");
       });
+      ws.on("error", (err) => {
+        log(`\u{1F310} Chrome \u8FDE\u63A5\u9519\u8BEF: ${err.message}`);
+      });
     }
   });
+  wsPingInterval = setInterval(() => {
+    for (const client of wss.clients) {
+      if (client.isAlive === false) {
+        log("\u{1F310} \u5FC3\u8DF3\u8D85\u65F6\uFF0C\u4E3B\u52A8\u65AD\u5F00\u6B7B\u8FDE\u63A5");
+        client.terminate();
+        continue;
+      }
+      client.isAlive = false;
+      try {
+        client.ping();
+      } catch {
+      }
+    }
+  }, WS_PING_INTERVAL_MS);
 } else {
   log(`\u{1F4E1} \u4F5C\u4E3A\u5BA2\u6237\u7AEF\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B (\u7AEF\u53E3 ${actualPort})...`);
   connectToMainInstance();
@@ -28935,7 +29022,7 @@ async function askMainInstance(command, params = {}) {
 async function askChrome(command, params = {}, options = {}) {
   if (!activeConnection) throw new Error("Chrome \u672A\u8FDE\u63A5\uFF0C\u8BF7\u786E\u8BA4\u6D4F\u89C8\u5668\u5F00\u542F\u4E14\u6269\u5C55\u5DF2\u542F\u7528");
   const id = crypto.randomUUID();
-  const payload = { id, command, params };
+  const payload = { id, command, params, clientId: LOCAL_CLIENT_ID };
   if (WS_TOKEN) payload.token = WS_TOKEN;
   const timeoutMs = options.timeoutMs || RESPONSE_TIMEOUT;
   return new Promise((resolve, reject) => {
@@ -28956,6 +29043,10 @@ async function askChrome(command, params = {}, options = {}) {
 function jsonText(data) {
   return typeof data === "string" ? data : JSON.stringify(data);
 }
+var TARGET_ARG = {
+  type: "string",
+  description: "\u547D\u540D\u6D4F\u89C8\u5668\u76EE\u6807\uFF0C\u5982 cases/app\u3002\u5148\u7528 bind_tab \u7ED1\u5B9A\uFF1B\u4E0D\u6307\u5B9A\u5219\u4F7F\u7528\u9ED8\u8BA4 focused/pinned \u76EE\u6807\u3002\u7ED1\u5B9A\u4E0E pin \u5747\u6309\u4F1A\u8BDD\u9694\u79BB"
+};
 function buildSnippet(source, line, column, { beautifyEnabled = true, contextLines = 20 } = {}) {
   const result = {};
   if (!source) {
@@ -29003,6 +29094,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           selector: {
             type: "string",
             description: "CSS \u9009\u62E9\u5668\uFF0C\u9650\u5B9A\u5206\u6790\u8303\u56F4\u3002\u4E0D\u6307\u5B9A\u5219\u5206\u6790\u6574\u4E2A\u9875\u9762"
@@ -29023,12 +29115,75 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       description: "\u83B7\u53D6 ghost-bridge \u670D\u52A1\u5668\u72B6\u6001\uFF0C\u5305\u62EC\u5F53\u524D WebSocket \u7AEF\u53E3\u3001\u8FDE\u63A5\u72B6\u6001\u7B49",
       inputSchema: { type: "object", properties: {} }
     },
+    {
+      name: "list_tabs",
+      description: "\u5217\u51FA\u5F53\u524D Chrome \u6807\u7B7E\u9875\uFF0C\u5E76\u8FD4\u56DE Ghost Bridge \u5F53\u524D\u76EE\u6807\u6A21\u5F0F\u4E0E\u76EE\u6807\u6807\u7B7E\u9875\u3002",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "bind_tab",
+      description: "\u6309 tabId\u3001URL \u7247\u6BB5\u6216\u6807\u9898\u7247\u6BB5\u628A Chrome \u6807\u7B7E\u9875\u7ED1\u5B9A\u4E3A\u547D\u540D target\uFF0C\u4F8B\u5982 cases \u6216 app\u3002target \u547D\u540D\u7A7A\u95F4\u6309 MCP \u4F1A\u8BDD\u9694\u79BB\uFF1A\u591A\u4E2A Agent / \u540C\u4E00 Agent \u7684\u591A\u4E2A\u4F1A\u8BDD\u5404\u81EA\u7ED1\u5B9A\u7684 target\uFF08\u542B\u540C\u540D\uFF09\u4E92\u4E0D\u5E72\u6270\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "target \u540D\u79F0\uFF0C\u5982 cases/app\u3002\u53EA\u80FD\u5305\u542B\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u548C\u8FDE\u5B57\u7B26" },
+          tabId: { type: "number", description: "Chrome \u6807\u7B7E\u9875 ID\uFF0C\u4F18\u5148\u4F7F\u7528" },
+          urlContains: { type: "string", description: "URL \u7247\u6BB5\u3002\u672A\u63D0\u4F9B tabId \u65F6\u6309\u5B83\u5339\u914D" },
+          titleContains: { type: "string", description: "\u6807\u9898\u7247\u6BB5\u3002\u53EF\u4E0E urlContains \u540C\u65F6\u4F7F\u7528" }
+        },
+        required: ["name"]
+      }
+    },
+    {
+      name: "unbind_tab",
+      description: "\u89E3\u7ED1\u4E00\u4E2A\u547D\u540D target\u3002\u82E5\u8BE5 tab \u6CA1\u6709\u5176\u4ED6 target \u5F15\u7528\uFF0C\u4F1A\u91CA\u653E\u5BF9\u5E94 debugger session\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "\u8981\u89E3\u7ED1\u7684 target \u540D\u79F0" }
+        },
+        required: ["name"]
+      }
+    },
+    {
+      name: "list_targets",
+      description: "\u67E5\u770B\u5F53\u524D\u5DF2\u7ED1\u5B9A\u7684\u547D\u540D targets\uFF0C\u4EE5\u53CA\u9ED8\u8BA4 focused/pinned \u76EE\u6807\u72B6\u6001\u3002",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "get_target_tab",
+      description: "\u67E5\u770B Ghost Bridge \u5F53\u524D\u64CD\u4F5C\u76EE\u6807\u3002\u76EE\u6807\u6A21\u5F0F\u4E3A focused \u65F6\u8DDF\u968F\u5F53\u524D\u805A\u7126\u6807\u7B7E\u9875\uFF1Bpinned \u65F6\u9501\u5B9A\u6307\u5B9A\u6807\u7B7E\u9875\u3002",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "pin_current_tab",
+      description: "\u9501\u5B9A\u5F53\u524D\u805A\u7126\u7684 Chrome \u6807\u7B7E\u9875\u3002\u9501\u5B9A\u540E\u7528\u6237\u5207\u6362\u5230\u5176\u4ED6\u9875\u9762\u4E5F\u4E0D\u4F1A\u6539\u53D8 Ghost Bridge \u7684\u64CD\u4F5C\u76EE\u6807\u3002",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "pin_tab",
+      description: "\u6309 tabId\u3001URL \u7247\u6BB5\u6216\u6807\u9898\u7247\u6BB5\u9501\u5B9A Chrome \u6807\u7B7E\u9875\u3002pin \u72B6\u6001\u6309 MCP \u4F1A\u8BDD\u9694\u79BB\uFF1A\u591A\u4E2A Agent / \u591A\u4E2A\u4F1A\u8BDD\u5404\u81EA pin \u7684\u9875\u9762\u4E92\u4E0D\u8986\u76D6\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          tabId: { type: "number", description: "Chrome \u6807\u7B7E\u9875 ID\uFF0C\u4F18\u5148\u4F7F\u7528" },
+          urlContains: { type: "string", description: "URL \u7247\u6BB5\u3002\u672A\u63D0\u4F9B tabId \u65F6\u6309\u5B83\u5339\u914D" },
+          titleContains: { type: "string", description: "\u6807\u9898\u7247\u6BB5\u3002\u53EF\u4E0E urlContains \u540C\u65F6\u4F7F\u7528" }
+        }
+      }
+    },
+    {
+      name: "unpin_tab",
+      description: "\u89E3\u9664\u9501\u5B9A\uFF0C\u6062\u590D\u8DDF\u968F\u5F53\u524D\u805A\u7126\u6807\u7B7E\u9875\u3002",
+      inputSchema: { type: "object", properties: {} }
+    },
     {
       name: "get_last_error",
-      description: "\u83B7\u53D6\u5F53\u524D\u6807\u7B7E\u6700\u8FD1\u7684\u63A7\u5236\u53F0\u3001\u5F02\u5E38\u548C\u7F51\u7EDC\u9519\u8BEF\u4E8B\u4EF6\u3002\u9ED8\u8BA4\u53EA\u8FD4\u56DE error\uFF1B\u5982\u9700\u67E5\u770B console.log / console.warn\uFF0C\u8BF7\u4F20 severity=info / warn / all\u3002",
+      description: "\u83B7\u53D6\u76EE\u6807\u6807\u7B7E\u9875\u6700\u8FD1\u7684\u63A7\u5236\u53F0\u3001\u5F02\u5E38\u548C\u7F51\u7EDC\u9519\u8BEF\u4E8B\u4EF6\u3002\u9ED8\u8BA4\u53EA\u8FD4\u56DE error\uFF1B\u5982\u9700\u67E5\u770B console.log / console.warn\uFF0C\u8BF7\u4F20 severity=info / warn / all\u3002",
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           severity: {
             type: "string",
             enum: ["error", "warn", "info", "all"],
@@ -29043,10 +29198,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "get_script_source",
-      description: "\u6293\u53D6\u76EE\u6807\u811A\u672C\u6E90\u7801\u7247\u6BB5\uFF0C\u652F\u6301\u6309 URL \u7247\u6BB5\u7B5B\u9009\u548C\u53EF\u9009 beautify\u3002",
+      description: "\u6293\u53D6\u76EE\u6807\u6807\u7B7E\u9875\u7684\u811A\u672C\u6E90\u7801\u7247\u6BB5\uFF0C\u652F\u6301\u6309 URL \u7247\u6BB5\u7B5B\u9009\u548C\u53EF\u9009 beautify\u3002",
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           scriptUrlContains: { type: "string" },
           line: { type: "number" },
           column: { type: "number" },
@@ -29061,16 +29217,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           durationMs: { type: "number", description: "\u9ED8\u8BA4 1500ms" }
         }
       }
     },
     {
       name: "find_by_string",
-      description: "\u5728\u5F53\u524D\u9875\u9762\u811A\u672C\u5185\u6309\u5B57\u7B26\u4E32\u641C\u7D22\uFF0C\u8FD4\u56DE\u5339\u914D\u4E0A\u4E0B\u6587\u3002",
+      description: "\u5728\u76EE\u6807\u6807\u7B7E\u9875\u811A\u672C\u5185\u6309\u5B57\u7B26\u4E32\u641C\u7D22\uFF0C\u8FD4\u56DE\u5339\u914D\u4E0A\u4E0B\u6587\u3002",
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           query: { type: "string" },
           scriptUrlContains: { type: "string" },
           maxMatches: { type: "number" }
@@ -29081,23 +29239,24 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     {
       name: "symbolic_hints",
       description: "\u6536\u96C6\u9875\u9762\u7684\u8D44\u6E90\u3001\u5168\u5C40\u7B26\u53F7\u4E0E UA/URL \u7EBF\u7D22\uFF0C\u5E2E\u52A9\u63A8\u65AD\u7248\u672C\u4E0E\u6A21\u5757\u5F52\u5C5E",
-      inputSchema: { type: "object", properties: {} }
+      inputSchema: { type: "object", properties: { target: TARGET_ARG } }
     },
     {
       name: "eval_script",
-      description: "\u5728\u5F53\u524D\u9875\u9762\u6267\u884C\u53EA\u8BFB JS \u8868\u8FBE\u5F0F\uFF08\u8C28\u614E\u4F7F\u7528\uFF09",
+      description: "\u5728\u76EE\u6807\u6807\u7B7E\u9875\u6267\u884C\u53EA\u8BFB JS \u8868\u8FBE\u5F0F\uFF08\u8C28\u614E\u4F7F\u7528\uFF09",
       inputSchema: {
         type: "object",
-        properties: { code: { type: "string" } },
+        properties: { target: TARGET_ARG, code: { type: "string" } },
         required: ["code"]
       }
     },
     {
       name: "list_network_requests",
-      description: "\u5217\u51FA\u6355\u83B7\u7684\u7F51\u7EDC\u8BF7\u6C42\uFF0C\u652F\u6301\u6309 URL\u3001\u65B9\u6CD5\u3001\u72B6\u6001\u548C\u7C7B\u578B\u8FC7\u6EE4\u3002\u9ED8\u8BA4\u6309\u6392\u969C\u4F18\u5148\u7EA7\u6392\u5E8F\uFF1Bdata URL \u548C\u8D85\u957F URL \u4F1A\u81EA\u52A8\u6458\u8981\u5316\u3002",
+      description: "\u5217\u51FA\u76EE\u6807\u6807\u7B7E\u9875\u6355\u83B7\u7684\u7F51\u7EDC\u8BF7\u6C42\uFF0C\u652F\u6301\u6309 URL\u3001\u65B9\u6CD5\u3001\u72B6\u6001\u548C\u7C7B\u578B\u8FC7\u6EE4\u3002\u9ED8\u8BA4\u6309\u6392\u969C\u4F18\u5148\u7EA7\u6392\u5E8F\uFF1Bdata URL \u548C\u8D85\u957F URL \u4F1A\u81EA\u52A8\u6458\u8981\u5316\u3002",
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           filter: { type: "string", description: "URL \u5173\u952E\u8BCD\u8FC7\u6EE4" },
           method: { type: "string", description: "\u8BF7\u6C42\u65B9\u6CD5\uFF1AGET/POST/PUT/DELETE \u7B49" },
           status: { type: "string", description: "\u72B6\u6001\uFF1Asuccess/error/failed/pending" },
@@ -29117,6 +29276,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           requestId: { type: "string", description: "\u8BF7\u6C42 ID\uFF08\u4ECE list_network_requests \u83B7\u53D6\uFF09" },
           includeBody: { type: "boolean", description: "\u662F\u5426\u5305\u542B\u54CD\u5E94\u4F53\uFF0C\u9ED8\u8BA4 false" }
         },
@@ -29126,7 +29286,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     {
       name: "clear_network_requests",
       description: "\u6E05\u7A7A\u5DF2\u6355\u83B7\u7684\u7F51\u7EDC\u8BF7\u6C42\u8BB0\u5F55",
-      inputSchema: { type: "object", properties: {} }
+      inputSchema: { type: "object", properties: { target: TARGET_ARG } }
     },
     {
       name: "perf_metrics",
@@ -29134,6 +29294,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           includeTimings: {
             type: "boolean",
             description: "\u662F\u5426\u5305\u542B Navigation Timing \u548C Web Vitals\uFF0C\u9ED8\u8BA4 true"
@@ -29147,10 +29308,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "capture_screenshot",
-      description: "\u622A\u53D6\u5F53\u524D\u9875\u9762\u622A\u56FE\uFF0C\u9002\u5408\u770B\u9875\u9762\u5B9E\u9645\u89C6\u89C9\u6548\u679C\u3001UI \u6837\u5F0F\u548C\u5E03\u5C40\u3002\u9ED8\u8BA4\u4F18\u5148\u4F7F\u7528 JPEG\uFF1B\u9700\u8981\u6587\u5B57\u3001\u7EC6\u7EBF\u6216\u900F\u660E\u80CC\u666F\u7EC6\u8282\u65F6\u6539\u7528 PNG\u3002",
+      description: "\u622A\u53D6\u76EE\u6807\u6807\u7B7E\u9875\u622A\u56FE\uFF0C\u9002\u5408\u770B\u9875\u9762\u5B9E\u9645\u89C6\u89C9\u6548\u679C\u3001UI \u6837\u5F0F\u548C\u5E03\u5C40\u3002\u9ED8\u8BA4\u4F18\u5148\u4F7F\u7528 JPEG\uFF1B\u9700\u8981\u6587\u5B57\u3001\u7EC6\u7EBF\u6216\u900F\u660E\u80CC\u666F\u7EC6\u8282\u65F6\u6539\u7528 PNG\u3002",
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           format: {
             type: "string",
             enum: ["png", "jpeg"],
@@ -29179,10 +29341,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "get_page_content",
-      description: "\u63D0\u53D6\u5F53\u524D\u9875\u9762\u7684\u6587\u672C\u3001HTML \u6216\u7ED3\u6784\u5316\u6570\u636E\u3002\u6BD4\u622A\u56FE\u66F4\u8F7B\u91CF\uFF0C\u9002\u5408\u5148\u770B\u6587\u5B57\u3001DOM \u7ED3\u6784\u548C\u9875\u9762\u5143\u6570\u636E\uFF1B\u4E0D\u53CD\u6620 CSS\uFF0C\u4E5F\u4E0D\u542B iframe \u5185\u5BB9\u3002",
+      description: "\u63D0\u53D6\u76EE\u6807\u6807\u7B7E\u9875\u7684\u6587\u672C\u3001HTML \u6216\u7ED3\u6784\u5316\u6570\u636E\u3002\u6BD4\u622A\u56FE\u66F4\u8F7B\u91CF\uFF0C\u9002\u5408\u5148\u770B\u6587\u5B57\u3001DOM \u7ED3\u6784\u548C\u9875\u9762\u5143\u6570\u636E\uFF1B\u4E0D\u53CD\u6620 CSS\uFF0C\u4E5F\u4E0D\u542B iframe \u5185\u5BB9\u3002",
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           mode: {
             type: "string",
             enum: ["text", "html", "structured"],
@@ -29209,6 +29372,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           selector: {
             type: "string",
             description: "CSS \u9009\u62E9\u5668\uFF0C\u9650\u5B9A\u626B\u63CF\u8303\u56F4\u3002\u4E0D\u6307\u5B9A\u5219\u626B\u63CF\u6574\u4E2A\u9875\u9762"
@@ -29230,6 +29394,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           ref: {
             type: "string",
             description: "\u76EE\u6807\u5143\u7D20\u7684 ref \u6807\u8BC6\uFF0C\u5982 'e1'\u3001'e5'\uFF08\u4ECE get_interactive_snapshot \u83B7\u53D6\uFF09"
@@ -29270,8 +29435,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const args = request.params.arguments || {};
   try {
     if (name === "inspect_page") {
-      const { selector, includeInteractive = true, maxElements = 30 } = args;
+      const { target, selector, includeInteractive = true, maxElements = 30 } = args;
       const snapshot = await askChrome("inspectPageSnapshot", {
+        target,
         selector,
         includeInteractive,
         maxElements
@@ -29305,13 +29471,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
     if (name === "get_server_info") {
-      let chromeOk, clientsCount;
+      let chromeOk, clientsCount, mainStatus;
       if (isMainInstance) {
         chromeOk = !!chromeConnection;
         clientsCount = mcpClients.size;
+        mainStatus = {
+          pid: process.pid,
+          version: GHOST_BRIDGE_VERSION,
+          serverPath: SERVER_ENTRY_PATH,
+          startedAt: SERVER_STARTED_AT
+        };
       } else {
         try {
-          const mainStatus = await askMainInstance("_getMainStatus");
+          mainStatus = await askMainInstance("_getMainStatus");
           chromeOk = mainStatus.chromeConnected;
           clientsCount = mainStatus.mcpClientsCount;
         } catch {
@@ -29330,6 +29502,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               wsPort: actualPort,
               wsUrl: `ws://localhost:${actualPort}`,
               pid: process.pid,
+              serverPath: SERVER_ENTRY_PATH,
+              mainPid: mainStatus?.pid,
+              mainVersion: mainStatus?.version,
+              mainServerPath: mainStatus?.serverPath,
+              mainStartedAt: mainStatus?.startedAt,
               chromeConnected: chromeOk,
               mcpClientsCount: clientsCount,
               portInfoFile: PORT_INFO_FILE,
@@ -29339,13 +29516,49 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ]
       };
     }
+    if (name === "list_tabs") {
+      const res = await askChrome("listTabs");
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "bind_tab") {
+      const { name: targetName, tabId, urlContains, titleContains } = args;
+      const res = await askChrome("bindTab", { name: targetName, tabId, urlContains, titleContains }, { timeoutMs: 1e4 });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "unbind_tab") {
+      const { name: targetName } = args;
+      const res = await askChrome("unbindTab", { name: targetName }, { timeoutMs: 1e4 });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "list_targets") {
+      const res = await askChrome("listTargets");
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "get_target_tab") {
+      const res = await askChrome("getTargetTab");
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "pin_current_tab") {
+      const res = await askChrome("pinCurrentTab", {}, { timeoutMs: 1e4 });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "pin_tab") {
+      const { tabId, urlContains, titleContains } = args;
+      const res = await askChrome("pinTab", { tabId, urlContains, titleContains }, { timeoutMs: 1e4 });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "unpin_tab") {
+      const res = await askChrome("unpinTab", {}, { timeoutMs: 1e4 });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
     if (name === "get_last_error") {
-      const { severity = "error", limit = 20 } = args;
-      const data = await askChrome("getLastError", { severity, limit });
+      const { target, severity = "error", limit = 20 } = args;
+      const data = await askChrome("getLastError", { target, severity, limit });
       return { content: [{ type: "text", text: jsonText(data) }] };
     }
     if (name === "get_script_source") {
       const {
+        target,
         scriptUrlContains,
         line,
         column,
@@ -29354,6 +29567,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       } = args;
       const res = await askChrome("getScriptSource", {
         scriptUrlContains,
+        target,
         line,
         column
       });
@@ -29380,45 +29594,46 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
     if (name === "coverage_snapshot") {
+      const { target } = args;
       const durationMs = args.durationMs || 1500;
-      const res = await askChrome("coverageSnapshot", { durationMs }, { timeoutMs: durationMs + 4e3 });
+      const res = await askChrome("coverageSnapshot", { target, durationMs }, { timeoutMs: durationMs + 4e3 });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "find_by_string") {
-      const { query, scriptUrlContains, maxMatches = 5 } = args;
-      const res = await askChrome("findByString", { query, scriptUrlContains, maxMatches });
+      const { target, query, scriptUrlContains, maxMatches = 5 } = args;
+      const res = await askChrome("findByString", { target, query, scriptUrlContains, maxMatches });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "symbolic_hints") {
-      const res = await askChrome("symbolicHints");
+      const res = await askChrome("symbolicHints", { target: args.target });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "eval_script") {
-      const res = await askChrome("eval", { code: args.code });
+      const res = await askChrome("eval", { target: args.target, code: args.code });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "list_network_requests") {
-      const { filter, method, status, resourceType, limit, priorityMode = "debug" } = args;
-      const res = await askChrome("listNetworkRequests", { filter, method, status, resourceType, limit, priorityMode });
+      const { target, filter, method, status, resourceType, limit, priorityMode = "debug" } = args;
+      const res = await askChrome("listNetworkRequests", { target, filter, method, status, resourceType, limit, priorityMode });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "get_network_detail") {
-      const { requestId, includeBody } = args;
-      const res = await askChrome("getNetworkDetail", { requestId, includeBody });
+      const { target, requestId, includeBody } = args;
+      const res = await askChrome("getNetworkDetail", { target, requestId, includeBody });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "clear_network_requests") {
-      const res = await askChrome("clearNetworkRequests");
+      const res = await askChrome("clearNetworkRequests", { target: args.target });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "perf_metrics") {
-      const { includeTimings, includeResources } = args;
-      const res = await askChrome("perfMetrics", { includeTimings, includeResources });
+      const { target, includeTimings, includeResources } = args;
+      const res = await askChrome("perfMetrics", { target, 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 });
+      const { target, format, quality, fullPage, clip } = args;
+      const res = await askChrome("captureScreenshot", { target, format, quality, fullPage, clip }, { timeoutMs: 15e3 });
       const contents = [];
       if (res.imageData) {
         contents.push({
@@ -29442,7 +29657,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return { content: contents };
     }
     if (name === "get_page_content") {
-      const { mode = "text", selector, maxLength = 5e4, includeMetadata = true } = args;
+      const { target, mode = "text", selector, maxLength = 5e4, includeMetadata = true } = args;
       const validModes = ["text", "html", "structured"];
       if (mode && !validModes.includes(mode)) {
         return {
@@ -29452,17 +29667,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }]
         };
       }
-      const res = await askChrome("getPageContent", { mode, selector, maxLength, includeMetadata });
+      const res = await askChrome("getPageContent", { target, mode, selector, maxLength, includeMetadata });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "get_interactive_snapshot") {
-      const { selector, includeText, maxElements } = args;
-      const res = await askChrome("getInteractiveSnapshot", { selector, includeText, maxElements });
+      const { target, selector, includeText, maxElements } = args;
+      const res = await askChrome("getInteractiveSnapshot", { target, selector, includeText, maxElements });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     if (name === "dispatch_action") {
-      const { ref, action, value, key, deltaX, deltaY, waitMs } = args;
-      const res = await askChrome("dispatchAction", { ref, action, value, key, deltaX, deltaY, waitMs }, { timeoutMs: 1e4 });
+      const { target, ref, action, value, key, deltaX, deltaY, waitMs } = args;
+      const res = await askChrome("dispatchAction", { target, ref, action, value, key, deltaX, deltaY, waitMs }, { timeoutMs: 1e4 });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
     return { content: [{ type: "text", text: `\u672A\u77E5\u5DE5\u5177\uFF1A${name}` }] };
@@ -29513,6 +29728,10 @@ function cleanup() {
     } catch (e) {
       log(`\u6E05\u7406\u7AEF\u53E3\u4FE1\u606F\u6587\u4EF6\u5931\u8D25: ${e.message}`);
     }
+    if (wsPingInterval) {
+      clearInterval(wsPingInterval);
+      wsPingInterval = null;
+    }
     if (wss) {
       wss.close(() => {
         log("\u{1F50C} WebSocket \u670D\u52A1\u5668\u5DF2\u5173\u95ED");