ghost-bridge 0.8.0 → 0.9.0

package/README.md

@@ -16,6 +16,7 @@ Most browser-capable AI tools start a separate browser. Ghost Bridge connects AI
 - Inspect page structure, text, screenshots, errors, and network traffic
 - Search and extract script sources, even in production bundles
 - Click, type, scroll, and submit forms on the current page
+- Bind multiple Chrome tabs as named targets and operate them independently
 - Share one Chrome transport across multiple MCP clients
 
 ## Quick Start
@@ -94,6 +95,9 @@ Typical prompts:
 | `get_page_content` | Text, HTML, and structured DOM extraction |
 | `get_interactive_snapshot` | Find clickable and editable elements |
 | `dispatch_action` | Click, fill, press, scroll, hover, select |
+| `bind_tab` | Bind a Chrome tab as a named target such as `cases` or `app` |
+| `unbind_tab` | Remove a named target binding |
+| `list_targets` | Show named targets and their per-tab session status |
 | `pin_current_tab` | Keep Ghost Bridge attached to the current tab while you browse elsewhere |
 | `pin_tab` | Pin a target tab by tab ID, URL fragment, or title fragment |
 | `unpin_tab` | Return to following the focused tab |
@@ -117,9 +121,19 @@ Recommended flow:
 
 Notes:
 
+- Use `bind_tab` when a workflow spans multiple pages. For example, bind a checklist page as `cases` and a business page as `app`, then call tools with `target: "cases"` or `target: "app"`.
+- All browser tools accept an optional `target` parameter. When named targets are bound, `dispatch_action` requires `target` so refs from one page are not accidentally used on another page.
 - Use `pin_current_tab` when you are debugging a page and need to switch to other tabs without changing the AI target. Use `unpin_tab` to restore the original follow-focused-tab behavior.
 - `list_network_requests` and `get_network_detail` automatically summarize `data:` URLs and very long URLs so inline images or oversized query strings do not overwhelm model context
 
+Multi-page example:
+
+```text
+Bind the current checklist tab as cases.
+Bind the tab whose title contains "Orders" as app.
+Read the next case from target cases, operate target app, then mark the case passed or failed back on target cases.
+```
+
 ## Configuration
 
 | Setting | Default | Notes |
@@ -135,7 +149,7 @@ flowchart LR
     A["AI Client<br/>Claude / Codex / Cursor"]
     B["Ghost Bridge MCP Server<br/>server.js"]
     C["Chrome Extension<br/>background.js"]
-    D["Browser Tab<br/>Target Context"]
+    D["Browser Tabs<br/>Target Sessions"]
 
     A <-->|"stdio"| B
     B <-->|"WebSocket"| C

package/dist/server.js

@@ -28549,6 +28549,8 @@ 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 +28563,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) {
@@ -28769,8 +28772,14 @@ 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") || "";
@@ -28786,7 +28795,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 +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) {
@@ -28840,11 +28862,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,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();
@@ -28970,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) => {
@@ -28991,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) {
@@ -29038,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"
@@ -29063,6 +29120,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 +29162,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 +29183,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           severity: {
             type: "string",
             enum: ["error", "warn", "info", "all"],
@@ -29114,6 +29202,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           scriptUrlContains: { type: "string" },
           line: { type: "number" },
           column: { type: "number" },
@@ -29128,6 +29217,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           durationMs: { type: "number", description: "\u9ED8\u8BA4 1500ms" }
         }
       }
@@ -29138,6 +29228,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           query: { type: "string" },
           scriptUrlContains: { type: "string" },
           maxMatches: { type: "number" }
@@ -29148,14 +29239,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 +29256,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 +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" }
         },
@@ -29193,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",
@@ -29201,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"
@@ -29218,6 +29312,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           format: {
             type: "string",
             enum: ["png", "jpeg"],
@@ -29250,6 +29345,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object",
         properties: {
+          target: TARGET_ARG,
           mode: {
             type: "string",
             enum: ["text", "html", "structured"],
@@ -29276,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"
@@ -29297,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"
@@ -29337,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
@@ -29421,6 +29520,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 +29552,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 +29567,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       } = args;
       const res = await askChrome("getScriptSource", {
         scriptUrlContains,
+        target,
         line,
         column
       });
@@ -29479,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({
@@ -29541,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 {
@@ -29551,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}` }] };
@@ -29612,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");