ghost-bridge 0.8.0 → 0.9.1

package/dist/server.js

@@ -27102,8 +27102,8 @@ var Protocol = class {
    *
    * The Protocol object assumes ownership of the Transport, replacing any callbacks that have already been set, and expects that it is the only user of the Transport instance going forward.
    */
-  async connect(transport2) {
-    this._transport = transport2;
+  async connect(transport) {
+    this._transport = transport;
     const _onclose = this.transport?.onclose;
     this._transport.onclose = () => {
       _onclose?.();
@@ -28523,6 +28523,7 @@ import net from "net";
 import fs2 from "fs";
 import os from "os";
 import path2 from "path";
+import { spawn } from "child_process";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // lib/version.js
@@ -28540,15 +28541,18 @@ var BASE_PORT = Number(process.env.GHOST_BRIDGE_PORT || 33333);
 var DEFAULT_WS_TOKEN = "ghost-bridge-local";
 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 PORT_INFO_FILE = process.env.GHOST_BRIDGE_PORT_INFO || 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 IS_DAEMON = process.env.GHOST_BRIDGE_DAEMON === "1";
 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}`);
 }
@@ -28561,7 +28565,8 @@ function buildIdentityPayload() {
     port: actualPort,
     version: GHOST_BRIDGE_VERSION,
     serverPath: SERVER_ENTRY_PATH,
-    startedAt: SERVER_STARTED_AT
+    startedAt: SERVER_STARTED_AT,
+    capabilities: ["heartbeat"]
   };
 }
 function getServiceMismatch(probe) {
@@ -28695,17 +28700,24 @@ function isPortAvailable(port) {
     server2.listen(port);
   });
 }
-async function startWebSocketServer() {
-  const available = await isPortAvailable(BASE_PORT);
-  if (!available) {
-    throw new Error(`\u56FA\u5B9A\u7AEF\u53E3 ${BASE_PORT} \u4E0D\u53EF\u7528\uFF0C\u8BF7\u91CA\u653E\u8BE5\u7AEF\u53E3\u6216\u901A\u8FC7 GHOST_BRIDGE_PORT \u6307\u5B9A\u5176\u4ED6\u7AEF\u53E3`);
-  }
-  actualPort = BASE_PORT;
-  const wss2 = new import_websocket_server.default({ port: BASE_PORT });
-  log(`\u{1F680} WebSocket \u670D\u52A1\u5DF2\u542F\u52A8\uFF0C\u7AEF\u53E3 ${BASE_PORT}${WS_TOKEN ? "\uFF08\u542F\u7528 token \u6821\u9A8C\uFF09" : ""}`);
-  return wss2;
+function startWebSocketServer(port) {
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const wss2 = new import_websocket_server.default({ port }, () => {
+      if (settled) return;
+      settled = true;
+      wss2.removeListener("error", onError);
+      resolve(wss2);
+    });
+    const onError = (err) => {
+      if (settled) return;
+      settled = true;
+      reject(err);
+    };
+    wss2.on("error", onError);
+  });
 }
-async function initWebSocketService() {
+async function acquirePortForDaemon() {
   const existing = getExistingService();
   if (existing) {
     log(`\u68C0\u6D4B\u5230\u73B0\u6709\u670D\u52A1 (PID: ${existing.pid}, \u7AEF\u53E3: ${existing.port})\uFF0C\u9A8C\u8BC1\u4E2D...`);
@@ -28715,17 +28727,15 @@ async function initWebSocketService() {
         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;
+          log(`\u2705 \u5DF2\u6709\u5E38\u9A7B\u670D\u52A1\u5728\u8FD0\u884C\uFF0C\u65E0\u9700\u91CD\u590D\u542F\u52A8`);
+          return { alreadyRunning: true };
         }
         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");
+        await stopExistingService(Number(probe.pid) || existing.pid, existing.port, "token \u4E0D\u4E00\u81F4");
       }
     } else {
-      log(`\u274C \u73B0\u6709\u670D\u52A1\u9A8C\u8BC1\u5931\u8D25\uFF0C\u542F\u52A8\u65B0\u670D\u52A1...`);
+      log(`\u274C \u73B0\u6709\u670D\u52A1\u9A8C\u8BC1\u5931\u8D25\uFF0C\u51C6\u5907\u63A5\u7BA1...`);
       try {
         fs2.unlinkSync(PORT_INFO_FILE);
       } catch {
@@ -28739,9 +28749,8 @@ async function initWebSocketService() {
         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;
+          log(`\u2705 \u56FA\u5B9A\u7AEF\u53E3\u4E0A\u5DF2\u6709\u5E38\u9A7B\u670D\u52A1\u5728\u8FD0\u884C\uFF0C\u65E0\u9700\u91CD\u590D\u542F\u52A8`);
+          return { alreadyRunning: true };
         }
         await stopExistingService(Number(probe.pid), BASE_PORT, mismatch);
       } else {
@@ -28752,8 +28761,34 @@ async function initWebSocketService() {
       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`);
     }
   }
-  const wss2 = await startWebSocketServer();
+  let wss2;
+  try {
+    wss2 = await startWebSocketServer(BASE_PORT);
+  } catch (err) {
+    const probe = await probeExistingService(BASE_PORT);
+    if (probe?.service === "ghost-bridge" && probe.token === WS_TOKEN && !getServiceMismatch(probe)) {
+      actualPort = BASE_PORT;
+      log(`\u2705 \u53E6\u4E00\u4E2A\u5E38\u9A7B\u670D\u52A1\u5DF2\u62A2\u5148\u542F\u52A8\uFF0C\u672C\u8FDB\u7A0B\u9000\u51FA`);
+      return { alreadyRunning: true };
+    }
+    throw err;
+  }
+  log(`\u{1F680} WebSocket \u670D\u52A1\u5DF2\u542F\u52A8\uFF0C\u7AEF\u53E3 ${BASE_PORT}${WS_TOKEN ? "\uFF08\u542F\u7528 token \u6821\u9A8C\uFF09" : ""}`);
+  actualPort = BASE_PORT;
   isMainInstance = true;
+  return { wss: wss2 };
+}
+async function runDaemon() {
+  let acquired;
+  try {
+    acquired = await acquirePortForDaemon();
+  } catch (e) {
+    log(`\u274C daemon \u542F\u52A8\u5931\u8D25\uFF1A${e.message}`);
+    process.exit(1);
+  }
+  if (acquired.alreadyRunning) {
+    process.exit(0);
+  }
   fs2.writeFileSync(
     PORT_INFO_FILE,
     JSON.stringify({
@@ -28766,11 +28801,55 @@ async function initWebSocketService() {
     }, null, 2)
   );
   log(`\u{1F4DD} \u7AEF\u53E3\u4FE1\u606F\u5DF2\u5199\u5165: ${PORT_INFO_FILE}`);
-  return wss2;
+  return acquired.wss;
 }
-var wss = await initWebSocketService();
+async function ensureDaemonRunning() {
+  const existing = getExistingService();
+  if (existing) {
+    const probe = await probeExistingService(existing.port);
+    if (probe?.service === "ghost-bridge" && probe.token === WS_TOKEN && !getServiceMismatch(probe)) {
+      actualPort = Number(probe.port) || existing.port;
+      return true;
+    }
+  } else {
+    const probe = await probeExistingService(BASE_PORT);
+    if (probe?.service === "ghost-bridge" && probe.token === WS_TOKEN && !getServiceMismatch(probe)) {
+      actualPort = BASE_PORT;
+      return true;
+    }
+  }
+  return spawnDaemonAndWait();
+}
+async function spawnDaemonAndWait(timeoutMs = 15e3) {
+  log("\u{1F6E0} \u5E38\u9A7B\u670D\u52A1\u672A\u8FD0\u884C\uFF0C\u6B63\u5728\u542F\u52A8 daemon...");
+  const child = spawn(process.execPath, [SERVER_ENTRY_PATH], {
+    detached: true,
+    stdio: "ignore",
+    env: { ...process.env, GHOST_BRIDGE_DAEMON: "1" }
+  });
+  child.unref();
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const probe = await probeExistingService(BASE_PORT);
+    if (probe?.service === "ghost-bridge" && probe.token === WS_TOKEN && !getServiceMismatch(probe)) {
+      actualPort = Number(probe.port) || BASE_PORT;
+      log(`\u2705 daemon \u5DF2\u5C31\u7EEA (PID: ${probe.pid}, \u7AEF\u53E3: ${actualPort})`);
+      return true;
+    }
+    await sleep(250);
+  }
+  log(`\u274C daemon \u672A\u80FD\u5728 ${timeoutMs}ms \u5185\u5C31\u7EEA\uFF0C\u7A0D\u540E\u5C06\u91CD\u8BD5`);
+  return false;
+}
+var wss = IS_DAEMON ? await runDaemon() : null;
+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") || "";
@@ -28786,7 +28865,9 @@ 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(buildIdentityPayload()));
       ws.on("message", (data) => {
@@ -28814,15 +28895,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) {
@@ -28840,11 +28932,17 @@ if (wss) {
       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;
             }
           }
@@ -28852,31 +28950,55 @@ 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})...`);
+  const ready = await ensureDaemonRunning();
+  if (!ready) log("\u26A0\uFE0F \u5E38\u9A7B\u670D\u52A1\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u5C06\u4FDD\u6301\u540E\u53F0\u91CD\u8BD5\u5E76\u81EA\u52A8\u62C9\u8D77");
+  log(`\u{1F4E1} \u4F5C\u4E3A\u5BA2\u6237\u7AEF\u8FDE\u63A5\u5230\u5E38\u9A7B\u670D\u52A1 (\u7AEF\u53E3: ${actualPort})...`);
   connectToMainInstance();
 }
-var MAX_RECONNECT_ATTEMPTS = 10;
 var RECONNECT_INTERVAL = 3e3;
-var reconnectAttempts = 0;
-var wasEverConnected = false;
+var DAEMON_CHECK_EVERY = 5;
+var consecutiveFailures = 0;
 function connectToMainInstance() {
   const url2 = new URL(`ws://localhost:${actualPort}`);
   url2.searchParams.set("token", WS_TOKEN);
   url2.searchParams.set("role", "mcp-client");
   const ws = new import_websocket.default(url2.toString());
   ws.on("open", () => {
-    log(`\u2705 \u5DF2\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B (\u7AEF\u53E3 ${actualPort})`);
-    reconnectAttempts = 0;
-    wasEverConnected = true;
+    log(`\u2705 \u5DF2\u8FDE\u63A5\u5230\u5E38\u9A7B\u670D\u52A1 (\u7AEF\u53E3: ${actualPort})`);
+    consecutiveFailures = 0;
   });
   ws.on("message", (data) => {
     try {
@@ -28891,30 +29013,25 @@ function connectToMainInstance() {
     }
   });
   ws.on("close", () => {
-    log("\u26A0\uFE0F \u4E0E\u4E3B\u5B9E\u4F8B\u7684\u8FDE\u63A5\u5DF2\u65AD\u5F00");
+    log("\u26A0\uFE0F \u4E0E\u5E38\u9A7B\u670D\u52A1\u7684\u8FDE\u63A5\u5DF2\u65AD\u5F00");
     activeConnection = null;
-    failAllPending("\u4E0E\u4E3B\u5B9E\u4F8B\u7684\u8FDE\u63A5\u5DF2\u65AD\u5F00");
-    reconnectAttempts++;
-    if (reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
-      log(`\u274C \u91CD\u8FDE\u5931\u8D25\u6B21\u6570\u8FC7\u591A (${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS})\uFF0C\u5BA2\u6237\u7AEF\u8FDB\u7A0B\u9000\u51FA`);
-      process.exit(0);
-    }
-    setTimeout(() => {
-      if (!activeConnection) {
-        log(`\u{1F504} \u5C1D\u8BD5\u91CD\u65B0\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B... (${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS})`);
-        connectToMainInstance();
-      }
+    failAllPending("\u4E0E\u5E38\u9A7B\u670D\u52A1\u7684\u8FDE\u63A5\u5DF2\u65AD\u5F00");
+    consecutiveFailures++;
+    const attempt = consecutiveFailures;
+    const needDaemonCheck = attempt % DAEMON_CHECK_EVERY === 0;
+    setTimeout(async () => {
+      if (activeConnection) return;
+      if (needDaemonCheck) {
+        log(`\u{1F504} \u8FDE\u7EED ${attempt} \u6B21\u672A\u8FDE\u4E0A\u5E38\u9A7B\u670D\u52A1\uFF0C\u68C0\u67E5\u5E76\u5C1D\u8BD5\u62C9\u8D77...`);
+        await ensureDaemonRunning();
+      }
+      if (activeConnection) return;
+      log(`\u{1F504} \u5C1D\u8BD5\u91CD\u65B0\u8FDE\u63A5\u5230\u5E38\u9A7B\u670D\u52A1 (\u7B2C ${attempt} \u6B21)...`);
+      connectToMainInstance();
     }, RECONNECT_INTERVAL);
   });
   ws.on("error", (err) => {
-    log(`\u274C \u8FDE\u63A5\u4E3B\u5B9E\u4F8B\u5931\u8D25: ${err.message}`);
-    if (!wasEverConnected) {
-      reconnectAttempts++;
-      if (reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
-        log(`\u274C \u65E0\u6CD5\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B\uFF0C\u5BA2\u6237\u7AEF\u8FDB\u7A0B\u9000\u51FA`);
-        process.exit(0);
-      }
-    }
+    log(`\u274C \u8FDE\u63A5\u5E38\u9A7B\u670D\u52A1\u5931\u8D25: ${err.message}`);
   });
 }
 function failAllPending(message) {
@@ -28949,7 +29066,7 @@ function handleIncoming(data) {
   else resolve(result);
 }
 async function askMainInstance(command, params = {}) {
-  if (!activeConnection) throw new Error("\u672A\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B");
+  if (!activeConnection) throw new Error("\u672A\u8FDE\u63A5\u5230\u5E38\u9A7B\u670D\u52A1");
   const id = crypto.randomUUID();
   const payload = { id, command, params };
   return new Promise((resolve, reject) => {
@@ -28968,9 +29085,13 @@ 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");
+  if (!activeConnection) {
+    throw new Error(
+      IS_DAEMON ? "Chrome \u672A\u8FDE\u63A5\uFF0C\u8BF7\u786E\u8BA4\u6D4F\u89C8\u5668\u5F00\u542F\u4E14\u6269\u5C55\u5DF2\u542F\u7528" : "ghost-bridge \u5E38\u9A7B\u670D\u52A1\u672A\u8FDE\u63A5\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF08\u53EF\u7528 ghost-bridge status \u68C0\u67E5\uFF09"
+    );
+  }
   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) => {
@@ -28991,6 +29112,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) {
@@ -29038,6 +29163,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"
@@ -29063,6 +29189,36 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       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",
@@ -29075,7 +29231,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "pin_tab",
-      description: "\u6309 tabId\u3001URL \u7247\u6BB5\u6216\u6807\u9898\u7247\u6BB5\u9501\u5B9A Chrome \u6807\u7B7E\u9875\u3002",
+      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: {
@@ -29096,6 +29252,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           severity: {
             type: "string",
             enum: ["error", "warn", "info", "all"],
@@ -29114,6 +29271,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           scriptUrlContains: { type: "string" },
           line: { type: "number" },
           column: { type: "number" },
@@ -29128,6 +29286,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           durationMs: { type: "number", description: "\u9ED8\u8BA4 1500ms" }
         }
       }
@@ -29138,6 +29297,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           query: { type: "string" },
           scriptUrlContains: { type: "string" },
           maxMatches: { type: "number" }
@@ -29148,14 +29308,14 @@ 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\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"]
       }
     },
@@ -29165,6 +29325,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       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" },
@@ -29184,6 +29345,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" }
         },
@@ -29193,7 +29355,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",
@@ -29201,6 +29363,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"
@@ -29218,6 +29381,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           format: {
             type: "string",
             enum: ["png", "jpeg"],
@@ -29250,6 +29414,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           mode: {
             type: "string",
             enum: ["text", "html", "structured"],
@@ -29276,6 +29441,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"
@@ -29297,6 +29463,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"
@@ -29337,8 +29504,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
@@ -29399,7 +29567,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             text: jsonText({
               service: "ghost-bridge",
               version: GHOST_BRIDGE_VERSION,
-              role: isMainInstance ? "\u4E3B\u5B9E\u4F8B (WebSocket Server)" : "\u5BA2\u6237\u7AEF (\u8FDE\u63A5\u5230\u4E3B\u5B9E\u4F8B)",
+              role: isMainInstance ? "daemon (\u5E38\u9A7B WebSocket \u670D\u52A1)" : "\u4F1A\u8BDD\u5BA2\u6237\u7AEF (\u8FDE\u63A5\u5E38\u9A7B\u670D\u52A1)",
               wsPort: actualPort,
               wsUrl: `ws://localhost:${actualPort}`,
               pid: process.pid,
@@ -29421,6 +29589,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       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) }] };
@@ -29439,12 +29621,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       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,
@@ -29453,6 +29636,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       } = args;
       const res = await askChrome("getScriptSource", {
         scriptUrlContains,
+        target,
         line,
         column
       });
@@ -29479,45 +29663,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({
@@ -29541,7 +29726,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 {
@@ -29551,17 +29736,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}` }] };
@@ -29569,38 +29754,42 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     return { content: [{ type: "text", text: `Error: ${e.message}` }] };
   }
 });
-var transport = new StdioServerTransport();
-await server.connect(transport);
-var roleText = isMainInstance ? "\u4E3B\u5B9E\u4F8B" : "\u5BA2\u6237\u7AEF";
-log(`\u2705 MCP server \u5DF2\u542F\u52A8 | \u89D2\u8272: ${roleText} | \u7AEF\u53E3: ${actualPort} | PID: ${process.pid} | PPID: ${process.ppid}`);
-log(`\u{1F4C4} \u7AEF\u53E3\u4FE1\u606F\u6587\u4EF6: ${PORT_INFO_FILE}`);
-log(`\u{1F4A1} \u4F7F\u7528 get_server_info \u5DE5\u5177\u67E5\u770B\u8BE6\u7EC6\u72B6\u6001`);
-var PARENT_CHECK_INTERVAL = 5e3;
-var parentPid = process.ppid;
-process.stdin.on("end", () => {
-  log("\u26A0\uFE0F stdin \u5DF2\u5173\u95ED\uFF0C\u7236\u8FDB\u7A0B\u53EF\u80FD\u5DF2\u9000\u51FA\uFF0C\u6B63\u5728\u9000\u51FA...");
-  cleanup();
-  process.exit(0);
-});
-process.stdin.on("close", () => {
-  log("\u26A0\uFE0F stdin \u5DF2\u5173\u95ED\uFF0C\u6B63\u5728\u9000\u51FA...");
-  cleanup();
-  process.exit(0);
-});
-var parentCheckTimer = setInterval(() => {
-  try {
-    process.kill(parentPid, 0);
-  } catch (e) {
-    log(`\u26A0\uFE0F \u7236\u8FDB\u7A0B (PID: ${parentPid}) \u5DF2\u4E0D\u5B58\u5728\uFF0C\u6B63\u5728\u9000\u51FA...`);
-    clearInterval(parentCheckTimer);
+if (!IS_DAEMON) {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  log(`\u2705 MCP server \u5DF2\u542F\u52A8 | \u89D2\u8272: \u4F1A\u8BDD\u5BA2\u6237\u7AEF | \u5E38\u9A7B\u670D\u52A1\u7AEF\u53E3: ${actualPort} | PID: ${process.pid} | PPID: ${process.ppid}`);
+  log(`\u{1F4A1} \u4F7F\u7528 get_server_info \u5DE5\u5177\u67E5\u770B\u8BE6\u7EC6\u72B6\u6001`);
+  const PARENT_CHECK_INTERVAL = 5e3;
+  const parentPid = process.ppid;
+  process.stdin.on("end", () => {
+    log("\u26A0\uFE0F stdin \u5DF2\u5173\u95ED\uFF0C\u7236\u8FDB\u7A0B\u53EF\u80FD\u5DF2\u9000\u51FA\uFF0C\u6B63\u5728\u9000\u51FA...");
     cleanup();
     process.exit(0);
-  }
-}, PARENT_CHECK_INTERVAL);
-parentCheckTimer.unref();
+  });
+  process.stdin.on("close", () => {
+    log("\u26A0\uFE0F stdin \u5DF2\u5173\u95ED\uFF0C\u6B63\u5728\u9000\u51FA...");
+    cleanup();
+    process.exit(0);
+  });
+  const parentCheckTimer = setInterval(() => {
+    try {
+      process.kill(parentPid, 0);
+    } catch (e) {
+      log(`\u26A0\uFE0F \u7236\u8FDB\u7A0B (PID: ${parentPid}) \u5DF2\u4E0D\u5B58\u5728\uFF0C\u6B63\u5728\u9000\u51FA...`);
+      clearInterval(parentCheckTimer);
+      cleanup();
+      process.exit(0);
+    }
+  }, PARENT_CHECK_INTERVAL);
+  parentCheckTimer.unref();
+} else {
+  log(`\u2705 ghost-bridge daemon \u5DF2\u542F\u52A8 | \u7AEF\u53E3: ${actualPort} | PID: ${process.pid}`);
+  log(`\u{1F4C4} \u7AEF\u53E3\u4FE1\u606F\u6587\u4EF6: ${PORT_INFO_FILE}`);
+  log(`\u{1F4A1} \u505C\u6B62\u670D\u52A1: ghost-bridge stop`);
+}
 function cleanup() {
   log("\u{1F9F9} \u6B63\u5728\u6E05\u7406...");
-  if (isMainInstance) {
+  if (IS_DAEMON) {
     try {
       if (fs2.existsSync(PORT_INFO_FILE)) {
         const info = JSON.parse(fs2.readFileSync(PORT_INFO_FILE, "utf-8"));
@@ -29612,6 +29801,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");
@@ -29633,7 +29826,7 @@ process.on("SIGTERM", () => {
   process.exit(0);
 });
 process.on("exit", () => {
-  if (isMainInstance) {
+  if (IS_DAEMON) {
     try {
       if (fs2.existsSync(PORT_INFO_FILE)) {
         const info = JSON.parse(fs2.readFileSync(PORT_INFO_FILE, "utf-8"));