ghost-bridge 1.0.2 → 1.1.0

package/README.md

@@ -94,7 +94,9 @@ Typical prompts:
 | `capture_screenshot` | Visual inspection and UI debugging |
 | `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 |
+| `dispatch_action` | Click, fill, press, scroll, hover, or select; supports selector-based and batched actions |
+| `eval_script` | Execute JavaScript, wait for returned promises, and cap arbitrary output |
+| `page_request` | Send an authenticated page-context request and wait for the response in one call |
 | `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 |
@@ -113,11 +115,36 @@ Typical prompts:
 
 Recommended flow:
 
-1. Start with `inspect_page`
+1. Start with `inspect_page`; its compact response includes a small set of actionable refs
 2. Use `capture_screenshot` for visual issues
    Default is optimized for transfer with JPEG; switch to `png` for pixel-level checks
 3. Use `get_page_content` for DOM or text extraction
-4. Use `get_interactive_snapshot` before `dispatch_action`
+4. Use `get_interactive_snapshot` only when the refs returned by `inspect_page` are insufficient
+5. Put consecutive fills/clicks into one `dispatch_action.actions` call and request `snapshotAfter` when the next page state is needed
+
+Round-trip-efficient examples:
+
+```json
+{
+  "target": "app",
+  "actions": [
+    { "selector": "input[name=email]", "action": "fill", "value": "user@example.com" },
+    { "selector": "input[name=password]", "action": "fill", "value": "secret" },
+    { "selector": "button[type=submit]", "action": "click", "waitMs": 1200 }
+  ],
+  "snapshotAfter": true
+}
+```
+
+For API calls that need the page's login state, prefer `page_request`. If custom asynchronous JavaScript is still needed, return the promise from `eval_script` instead of storing a result on `window` and polling it in another tool call:
+
+```javascript
+(async () => {
+  const response = await fetch('/api/items', { credentials: 'include' })
+  const data = await response.json()
+  return data.items.map(({ id, name }) => ({ id, name }))
+})()
+```
 
 Notes:
 

package/dist/server.js

@@ -28541,6 +28541,8 @@ 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 DEFAULT_EVAL_OUTPUT_LENGTH = 8e3;
+var MAX_EVAL_OUTPUT_LENGTH = 5e4;
 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);
@@ -29150,6 +29152,32 @@ function compact(value) {
 function out(data) {
   return jsonText(compact(data));
 }
+function clampNumber(value, fallback, min, max) {
+  const number3 = Number(value);
+  if (!Number.isFinite(number3)) return fallback;
+  return Math.min(max, Math.max(min, Math.round(number3)));
+}
+function boundedOut(data, maxLength = DEFAULT_EVAL_OUTPUT_LENGTH) {
+  const text = out(data) ?? "undefined";
+  const limit = clampNumber(maxLength, DEFAULT_EVAL_OUTPUT_LENGTH, 200, MAX_EVAL_OUTPUT_LENGTH);
+  if (text.length <= limit) return text;
+  const markerBudget = 100;
+  const headLength = Math.max(100, Math.floor((limit - markerBudget) * 0.8));
+  const tailLength = Math.max(50, limit - markerBudget - headLength);
+  const omitted = Math.max(0, text.length - headLength - tailLength);
+  return out({
+    truncated: true,
+    originalLength: text.length,
+    content: `${text.slice(0, headLength)}
+... [\u5DF2\u7701\u7565 ${omitted} \u4E2A\u5B57\u7B26] ...
+${text.slice(-tailLength)}`,
+    hint: "\u9700\u8981\u66F4\u591A\u7ED3\u679C\u65F6\u8BF7\u6536\u7A84\u8FD4\u56DE\u5B57\u6BB5\uFF1B\u4E0D\u8981\u901A\u8FC7\u8FDE\u7EED\u8F6E\u8BE2\u5206\u7247\u83B7\u53D6\u5927\u5BF9\u8C61"
+  });
+}
+function truncateUrl(url2, maxLen = 200) {
+  if (typeof url2 !== "string" || url2.length <= maxLen) return url2;
+  return url2.slice(0, maxLen) + "\u2026";
+}
 function shrinkListTabs(res, { fullUrl } = {}) {
   if (!res || !Array.isArray(res.tabs)) return res;
   const trimTab = (t) => {
@@ -29230,7 +29258,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
   tools: [
     {
       name: "inspect_page",
-      description: "\u9875\u9762\u5206\u6790\u5165\u53E3\uFF1A\u8FD4\u56DE\u5143\u6570\u636E\u3001\u7ED3\u6784\u8BA1\u6570\u4E0E\u53EF\u4EA4\u4E92\u5143\u7D20\u6570\u91CF\uFF08\u7D27\u51D1\u6A21\u5F0F\uFF09\u3002\u9700\u8981\u5B8C\u6574 page/interactive \u6570\u636E\u4F20 detail:true\u3002",
+      description: "\u9875\u9762\u5206\u6790\u5165\u53E3\uFF1A\u4E00\u6B21\u8FD4\u56DE\u5143\u6570\u636E\u3001\u7ED3\u6784\u8BA1\u6570\u548C\u5C11\u91CF\u53EF\u76F4\u63A5\u64CD\u4F5C\u7684\u5143\u7D20 ref\uFF0C\u901A\u5E38\u65E0\u9700\u518D\u8C03\u7528 get_interactive_snapshot\u3002detail:true \u8FD4\u56DE\u5B8C\u6574\u7ED3\u6784\u3002",
       inputSchema: {
         type: "object",
         properties: {
@@ -29245,7 +29273,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
           },
           maxElements: {
             type: "number",
-            description: "detail \u6A21\u5F0F\u4E0B\u53EF\u4EA4\u4E92\u5143\u7D20\u4E0A\u9650\uFF0C\u9ED8\u8BA4 30"
+            description: "\u8FD4\u56DE\u53EF\u4EA4\u4E92\u5143\u7D20\u4E0A\u9650\uFF0C\u9ED8\u8BA4 20"
+          },
+          includeElements: {
+            type: "boolean",
+            description: "\u7D27\u51D1\u6A21\u5F0F\u662F\u5426\u9644\u5E26\u53EF\u64CD\u4F5C\u5143\u7D20\uFF0C\u9ED8\u8BA4 true"
           },
           detail: {
             type: "boolean",
@@ -29395,13 +29427,37 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "eval_script",
-      description: "\u5728\u76EE\u6807\u9875\u6267\u884C\u53EA\u8BFB JS \u8868\u8FBE\u5F0F\uFF08\u8C28\u614E\u4F7F\u7528\uFF09\u3002",
+      description: "\u5728\u76EE\u6807\u9875\u6267\u884C JS\u3002\u9AD8\u6210\u672C\u5DE5\u5177\uFF1A\u540C\u4E00\u76EE\u6807\u7684\u8BFB\u53D6/\u64CD\u4F5C\u5E94\u5408\u5E76\u8FDB\u4E00\u6B21 code\uFF1B\u5F02\u6B65\u4EE3\u7801\u76F4\u63A5\u8FD4\u56DE Promise\uFF0C\u672C\u5DE5\u5177\u9ED8\u8BA4\u7B49\u5F85\u5B8C\u6210\uFF0C\u7981\u6B62\u5199 window \u4E34\u65F6\u53D8\u91CF\u540E\u518D\u6B21\u8F6E\u8BE2\u3002\u7ED3\u679C\u9ED8\u8BA4\u6700\u591A 8000 \u5B57\u7B26\u3002",
       inputSchema: {
         type: "object",
-        properties: { target: TARGET_ARG, code: { type: "string" } },
+        properties: {
+          target: TARGET_ARG,
+          code: { type: "string", description: "JS \u8868\u8FBE\u5F0F\uFF1B\u5F02\u6B65\u793A\u4F8B\uFF1A(async()=>await fetch(...).then(r=>r.json()))()" },
+          awaitPromise: { type: "boolean", description: "\u7B49\u5F85 Promise \u5B8C\u6210\uFF0C\u9ED8\u8BA4 true" },
+          timeoutMs: { type: "number", description: "Promise \u7B49\u5F85\u4E0A\u9650\uFF0C\u9ED8\u8BA4 10000\uFF0C\u6700\u5927 30000" },
+          maxOutputLength: { type: "number", description: "\u5E8F\u5217\u5316\u7ED3\u679C\u5B57\u7B26\u4E0A\u9650\uFF0C\u9ED8\u8BA4 8000\uFF0C\u6700\u5927 50000" }
+        },
         required: ["code"]
       }
     },
+    {
+      name: "page_request",
+      description: "\u4F7F\u7528\u5F53\u524D\u9875\u9762\u767B\u5F55\u6001\u53D1\u8D77 fetch \u5E76\u7B49\u5F85\u54CD\u5E94\uFF0C\u4E00\u6B21\u8FD4\u56DE\u7ED3\u679C\uFF1B\u9875\u9762\u63A5\u53E3\u8C03\u7528\u4F18\u5148\u7528\u5B83\uFF0C\u907F\u514D eval_script \u53D1\u8D77\u8BF7\u6C42\u540E\u518D\u8F6E\u8BE2\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          target: TARGET_ARG,
+          url: { type: "string", description: "\u76F8\u5BF9\u6216\u7EDD\u5BF9 HTTP(S) URL" },
+          method: { type: "string", description: "\u9ED8\u8BA4 GET" },
+          headers: { type: "object", description: "\u8BF7\u6C42\u5934" },
+          body: { description: "\u5B57\u7B26\u4E32\u6216 JSON \u5BF9\u8C61\uFF1B\u5BF9\u8C61\u4F1A\u81EA\u52A8 JSON.stringify" },
+          responseType: { type: "string", enum: ["auto", "json", "text"], description: "\u9ED8\u8BA4 auto" },
+          timeoutMs: { type: "number", description: "\u9ED8\u8BA4 10000\uFF0C\u6700\u5927 30000" },
+          maxOutputLength: { type: "number", description: "\u54CD\u5E94\u5185\u5BB9\u5B57\u7B26\u4E0A\u9650\uFF0C\u9ED8\u8BA4 8000\uFF0C\u6700\u5927 50000" }
+        },
+        required: ["url"]
+      }
+    },
     {
       name: "list_network_requests",
       description: "\u5217\u51FA\u6355\u83B7\u7684\u7F51\u7EDC\u8BF7\u6C42\uFF0C\u652F\u6301 URL/\u65B9\u6CD5/\u72B6\u6001/\u7C7B\u578B\u8FC7\u6EE4\uFF1B\u8D85\u957F URL \u81EA\u52A8\u6458\u8981\u3002",
@@ -29481,7 +29537,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "get_page_content",
-      description: "\u63D0\u53D6\u9875\u9762\u6587\u672C/HTML/\u7ED3\u6784\u5316\u6570\u636E\uFF0C\u6BD4\u622A\u56FE\u8F7B\u91CF\u3002\u9ED8\u8BA4\u4E0A\u9650 8000 \u5B57\u7B26\uFF1B\u4E0D\u591F\u65F6\u8C03\u5927 maxLength \u6216\u7528 offset \u7FFB\u9875\u3001selector \u6536\u7A84\u3002\u4E0D\u53CD\u6620 CSS\uFF0C\u4E0D\u542B iframe\u3002",
+      description: "\u63D0\u53D6\u9875\u9762\u6587\u672C/HTML/\u7ED3\u6784\u5316\u6570\u636E\uFF0C\u6BD4\u622A\u56FE\u8F7B\u91CF\u3002text \u6A21\u5F0F\u9012\u5F52\u6536\u96C6\u540C\u6E90 iframe \u6587\u672C\uFF08\u9002\u5408\u6587\u6863\u7C7B\u9875\u9762\uFF09\u3002\u9ED8\u8BA4\u4E0A\u9650 8000 \u5B57\u7B26\uFF1B\u4E0D\u591F\u65F6\u8C03\u5927 maxLength \u6216\u7528 offset \u7FFB\u9875\u3001selector \u6536\u7A84\u3002\u4E0D\u53CD\u6620 CSS\u3002",
       inputSchema: {
         type: "object",
         properties: {
@@ -29534,7 +29590,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "dispatch_action",
-      description: "\u5BF9 get_interactive_snapshot \u8FD4\u56DE\u7684 ref \u6267\u884C\u64CD\u4F5C\uFF1Aclick/fill/press/scroll/select/hover/focus\u3002\u26A0\uFE0F \u5FC5\u987B\u5148\u5FEB\u7167\u62FF ref\uFF1B\u64CD\u4F5C\u540E\u5EFA\u8BAE\u590D\u67E5\u9875\u9762\u72B6\u6001\u3002",
+      description: "\u6267\u884C\u5355\u4E2A\u6216\u4E00\u6279\u4EA4\u4E92\u52A8\u4F5C\u3002\u53EF\u7528\u5FEB\u7167 ref \u6216 CSS selector \u5B9A\u4F4D\uFF1B\u4F18\u5148\u7528 actions \u6279\u91CF\u5B8C\u6210\u8FDE\u7EED\u586B\u5199/\u70B9\u51FB\uFF0CsnapshotAfter:true \u53EF\u5728\u540C\u4E00\u6B21\u8C03\u7528\u8FD4\u56DE\u64CD\u4F5C\u540E\u5143\u7D20\uFF0C\u51CF\u5C11\u6A21\u578B\u5F80\u8FD4\u3002",
       inputSchema: {
         type: "object",
         properties: {
@@ -29543,6 +29599,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             type: "string",
             description: "\u5143\u7D20 ref\uFF0C\u5982 'e1'\uFF08\u6765\u81EA get_interactive_snapshot\uFF09"
           },
+          selector: {
+            type: "string",
+            description: "CSS \u9009\u62E9\u5668\uFF1B\u5DF2\u77E5\u9009\u62E9\u5668\u65F6\u53EF\u66FF\u4EE3 ref\uFF0C\u7701\u53BB\u524D\u7F6E\u5FEB\u7167"
+          },
           action: {
             type: "string",
             enum: ["click", "fill", "press", "scroll", "select", "hover", "focus"]
@@ -29566,9 +29626,43 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
           waitMs: {
             type: "number",
             description: "\u64CD\u4F5C\u540E\u7B49\u5F85 ms\uFF0C\u9ED8\u8BA4 500\uFF0C\u6700\u5927 3000"
+          },
+          actions: {
+            type: "array",
+            maxItems: 20,
+            description: "\u987A\u5E8F\u6267\u884C\u7684\u52A8\u4F5C\uFF0C\u6700\u591A 20 \u4E2A\uFF1B\u6BCF\u9879\u652F\u6301 ref/selector\u3001action\u3001value/key\u3001deltaX/deltaY\u3001waitMs",
+            items: {
+              type: "object",
+              properties: {
+                ref: { type: "string" },
+                selector: { type: "string" },
+                action: { type: "string", enum: ["click", "fill", "press", "scroll", "select", "hover", "focus"] },
+                value: { type: "string" },
+                key: { type: "string" },
+                deltaX: { type: "number" },
+                deltaY: { type: "number" },
+                waitMs: { type: "number" }
+              },
+              required: ["action"]
+            }
+          },
+          stopOnError: {
+            type: "boolean",
+            description: "\u6279\u91CF\u52A8\u4F5C\u5931\u8D25\u65F6\u7ACB\u5373\u505C\u6B62\uFF0C\u9ED8\u8BA4 true"
+          },
+          snapshotAfter: {
+            type: "boolean",
+            description: "\u5728\u6700\u540E\u4E00\u4E2A\u52A8\u4F5C\u540E\u8FD4\u56DE\u65B0\u7684\u4EA4\u4E92\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false"
+          },
+          snapshotSelector: {
+            type: "string",
+            description: "\u9650\u5236\u64CD\u4F5C\u540E\u5FEB\u7167\u8303\u56F4"
+          },
+          snapshotMaxElements: {
+            type: "number",
+            description: "\u64CD\u4F5C\u540E\u5FEB\u7167\u5143\u7D20\u4E0A\u9650\uFF0C\u9ED8\u8BA4 20"
           }
-        },
-        required: ["ref", "action"]
+        }
       }
     }
   ]
@@ -29578,7 +29672,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const args = request.params.arguments || {};
   try {
     if (name === "inspect_page") {
-      const { target, selector, includeInteractive = true, maxElements = 30, detail = false } = args;
+      const { target, selector, includeInteractive = true, maxElements = 20, includeElements = true, detail = false } = args;
       const snapshot = await askChrome("inspectPageSnapshot", {
         target,
         selector,
@@ -29593,13 +29687,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const interactiveCount = Array.isArray(interactive?.elements) ? interactive.elements.length : Array.isArray(interactive) ? interactive.length : void 0;
       const summary = {
         title: page?.metadata?.title,
-        url: page?.metadata?.url,
+        url: truncateUrl(page?.metadata?.url),
         description: page?.metadata?.description,
         links,
         buttons,
         forms,
         interactiveCount
       };
+      const elements = includeElements && Array.isArray(interactive?.elements) ? interactive.elements : void 0;
       return {
         content: [
           {
@@ -29612,7 +29707,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 nextStepHint: "\u89C6\u89C9\u7528 capture_screenshot\uFF1B\u70B9\u51FB/\u8F93\u5165\u7528 get_interactive_snapshot + dispatch_action\uFF1B\u8BF7\u6C42/\u6027\u80FD\u7528 list_network_requests / perf_metrics\u3002"
               } : {
                 summary,
-                nextStepHint: "\u4F20 detail:true \u67E5\u770B\u5B8C\u6574 page/interactive\uFF1B\u89C6\u89C9\u7528 capture_screenshot\uFF1B\u4EA4\u4E92\u5148 get_interactive_snapshot \u518D dispatch_action\u3002"
+                interactive: elements ? { viewport: interactive?.viewport, elements } : void 0,
+                nextStepHint: "\u53EF\u76F4\u63A5\u7528 interactive.elements \u7684 ref \u8C03 dispatch_action\uFF1B\u8FDE\u7EED\u52A8\u4F5C\u653E\u8FDB actions\uFF0C\u64CD\u4F5C\u540E\u9700\u7EE7\u7EED\u5B9A\u4F4D\u65F6\u4F20 snapshotAfter:true\u3002"
               }
             )
           }
@@ -29758,8 +29854,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return { content: [{ type: "text", text: out(res) }] };
     }
     if (name === "eval_script") {
-      const res = await askChrome("eval", { target: args.target, code: args.code });
-      return { content: [{ type: "text", text: out(res) }] };
+      const timeoutMs = clampNumber(args.timeoutMs, 1e4, 100, 3e4);
+      const res = await askChrome("eval", {
+        target: args.target,
+        code: args.code,
+        awaitPromise: args.awaitPromise !== false,
+        timeoutMs
+      }, { timeoutMs: timeoutMs + 3e3 });
+      return { content: [{ type: "text", text: boundedOut(res, args.maxOutputLength) }] };
+    }
+    if (name === "page_request") {
+      const timeoutMs = clampNumber(args.timeoutMs, 1e4, 100, 3e4);
+      const maxOutputLength = clampNumber(args.maxOutputLength, DEFAULT_EVAL_OUTPUT_LENGTH, 200, MAX_EVAL_OUTPUT_LENGTH);
+      const res = await askChrome("pageRequest", {
+        target: args.target,
+        url: args.url,
+        method: args.method,
+        headers: args.headers,
+        body: args.body,
+        responseType: args.responseType,
+        timeoutMs,
+        maxOutputLength
+      }, { timeoutMs: timeoutMs + 3e3 });
+      return { content: [{ type: "text", text: boundedOut(res, maxOutputLength) }] };
     }
     if (name === "list_network_requests") {
       const { target, filter, method, status, resourceType, limit, priorityMode = "debug" } = args;
@@ -29818,7 +29935,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
       if (offset > 0 && mode === "text") {
         const selectorExpr = selector ? `(document.querySelector(${JSON.stringify(selector)}) || document.body)` : "document.body";
-        const code = `(function(){try{var text=(${selectorExpr}).innerText||"";var start=${offset};var end=${offset + maxLength};return {content:text.slice(start,end),offset:start,totalLength:text.length,hasMore:text.length>end};}catch(e){return {error:e.message}}})()`;
+        const code = `(function(){try{function ct(el){var t=el.innerText||el.textContent||"";try{var fs=el.querySelectorAll("iframe");for(var i=0;i<fs.length;i++){try{var d=fs[i].contentDocument;if(d&&d.body)t+="\\n\\n"+ct(d.body);}catch(e){}}}catch(e){}return t;}var text=ct(${selectorExpr});var start=${offset};var end=${offset + maxLength};return {content:text.slice(start,end),offset:start,totalLength:text.length,hasMore:text.length>end};}catch(e){return {error:e.message}}})()`;
         const res2 = await askChrome("eval", { target, code });
         return { content: [{ type: "text", text: out(res2) }] };
       }
@@ -29832,6 +29949,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return { content: [{ type: "text", text: out(res2) }] };
       }
       const res = await askChrome("getPageContent", { target, mode, selector, maxLength, includeMetadata });
+      if (typeof res?.metadata?.url === "string" && res.metadata.url.length > 200) {
+        res.metadata.url = truncateUrl(res.metadata.url);
+        res.metadata.urlTruncated = true;
+      }
       return { content: [{ type: "text", text: out(res) }] };
     }
     if (name === "get_interactive_snapshot") {
@@ -29840,8 +29961,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return { content: [{ type: "text", text: out(res) }] };
     }
     if (name === "dispatch_action") {
-      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 });
+      const steps = Array.isArray(args.actions) ? args.actions : [args];
+      if (!steps.length || steps.length > 20) throw new Error("actions \u6570\u91CF\u5FC5\u987B\u5728 1-20 \u4E4B\u95F4");
+      const totalWaitMs = steps.reduce((sum, step) => sum + clampNumber(step.waitMs, 500, 0, 3e3), 0);
+      const timeoutMs = Math.min(45e3, 1e4 + totalWaitMs);
+      const res = await askChrome("dispatchAction", args, { timeoutMs });
       return { content: [{ type: "text", text: out(res) }] };
     }
     return { content: [{ type: "text", text: `\u672A\u77E5\u5DE5\u5177\uFF1A${name}` }] };

package/extension/background.js

@@ -989,10 +989,90 @@ async function handleSymbolicHints(params = {}) {
 
 async function handleEval(params = {}) {
   const target = await ensureAttached(params)
-  const { result } = await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
-    expression: params.code,
-    returnByValue: true,
-  })
+  const timeoutMs = Math.min(30000, Math.max(100, Number(params.timeoutMs) || 10000))
+  const { result, exceptionDetails } = await withTimeout(
+    chrome.debugger.sendCommand(target, "Runtime.evaluate", {
+      expression: params.code,
+      returnByValue: true,
+      awaitPromise: params.awaitPromise !== false,
+    }),
+    timeoutMs,
+    "eval_script"
+  )
+  if (exceptionDetails) {
+    throw new Error(exceptionDetails.exception?.description || exceptionDetails.text || "脚本执行失败")
+  }
+  return result?.value
+}
+
+async function handlePageRequest(params = {}) {
+  const target = await ensureAttached(params)
+  if (!params.url || typeof params.url !== 'string') throw new Error("page_request 需要提供 url")
+  const timeoutMs = Math.min(30000, Math.max(100, Number(params.timeoutMs) || 10000))
+  const maxOutputLength = Math.min(50000, Math.max(200, Number(params.maxOutputLength) || 8000))
+  const method = String(params.method || 'GET').toUpperCase()
+  const responseType = ['auto', 'json', 'text'].includes(params.responseType) ? params.responseType : 'auto'
+  const headers = params.headers && typeof params.headers === 'object' ? { ...params.headers } : {}
+  let body = params.body
+  if (body !== undefined && body !== null && typeof body !== 'string') {
+    body = JSON.stringify(body)
+    if (!Object.keys(headers).some((name) => name.toLowerCase() === 'content-type')) {
+      headers['Content-Type'] = 'application/json'
+    }
+  }
+
+  const expression = `(async function() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), ${timeoutMs});
+    try {
+      const url = new URL(${JSON.stringify(params.url)}, window.location.href);
+      if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error('仅支持 HTTP(S) URL');
+      }
+      const response = await fetch(url.href, {
+        method: ${JSON.stringify(method)},
+        headers: ${JSON.stringify(headers)},
+        body: ${body === undefined || body === null ? 'undefined' : JSON.stringify(String(body))},
+        credentials: 'include',
+        signal: controller.signal,
+      });
+      const text = await response.text();
+      const contentType = response.headers.get('content-type') || '';
+      const truncated = text.length > ${maxOutputLength};
+      const content = truncated ? text.slice(0, ${maxOutputLength}) : text;
+      let data = content;
+      if (!truncated && (${JSON.stringify(responseType)} === 'json' || (${JSON.stringify(responseType)} === 'auto' && contentType.includes('json')))) {
+        try { data = JSON.parse(content); } catch (e) {
+          if (${JSON.stringify(responseType)} === 'json') throw new Error('响应不是有效 JSON: ' + e.message);
+        }
+      }
+      return {
+        ok: response.ok,
+        status: response.status,
+        statusText: response.statusText,
+        url: response.url,
+        contentType,
+        originalLength: text.length,
+        truncated,
+        data,
+      };
+    } finally {
+      clearTimeout(timer);
+    }
+  })()`
+
+  const { result, exceptionDetails } = await withTimeout(
+    chrome.debugger.sendCommand(target, "Runtime.evaluate", {
+      expression,
+      returnByValue: true,
+      awaitPromise: true,
+    }),
+    timeoutMs + 500,
+    "page_request"
+  )
+  if (exceptionDetails) {
+    throw new Error(exceptionDetails.exception?.description || exceptionDetails.text || "页面请求失败")
+  }
   return result?.value
 }
 
@@ -1351,6 +1431,15 @@ async function handleGetPageContent(params = {}) {
 async function handleGetInteractiveSnapshot(params = {}) {
   const { target, session } = await ensureAttachedSession(params)
   const { selector, includeText = true, maxElements = 100 } = params
+  const value = await evaluateInteractiveSnapshot(target, { selector, includeText, maxElements })
+  if (value) {
+    value.target = describeCommandTarget(params, session)
+    value.tabId = session.tabId
+  }
+  return value
+}
+
+async function evaluateInteractiveSnapshot(target, { selector, includeText = true, maxElements = 100 } = {}) {
   const expression = GhostBridgeDom.buildInteractiveSnapshotExpression({ selector, includeText, maxElements })
 
   const { result } = await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
@@ -1359,12 +1448,7 @@ async function handleGetInteractiveSnapshot(params = {}) {
   })
 
   if (result?.value?.error) throw new Error(result.value.error)
-  const value = result?.value
-  if (value) {
-    value.target = describeCommandTarget(params, session)
-    value.tabId = session.tabId
-  }
-  return value
+  return result?.value
 }
 
 // ========== DOM 交互：动作分发器 ==========
@@ -1375,16 +1459,59 @@ async function handleDispatchAction(params = {}) {
     throw new Error("已绑定命名 target 时，dispatch_action 必须提供 target，避免跨页面误用 ref")
   }
   const target = await ensureAttached(params)
-  const { ref, action, value, key, deltaX, deltaY, waitMs = 500 } = params
+  const isBatch = Array.isArray(params.actions)
+  const actions = isBatch ? params.actions : [params]
+  if (!actions.length || actions.length > 20) throw new Error("actions 数量必须在 1-20 之间")
+
+  const results = []
+  for (let index = 0; index < actions.length; index++) {
+    try {
+      results.push(await executeDispatchAction(target, actions[index]))
+    } catch (e) {
+      if (!isBatch) throw e
+      results.push({ index, success: false, error: e.message })
+      if (params.stopOnError !== false) break
+    }
+  }
+
+  const pageAfter = await readPageState(target)
+  const response = isBatch
+    ? {
+        success: results.length === actions.length && results.every((item) => item.success),
+        completed: results.filter((item) => item.success).length,
+        total: actions.length,
+        results,
+        pageAfter,
+      }
+    : { ...results[0], pageAfter }
+
+  if (params.snapshotAfter) {
+    response.snapshotAfter = await evaluateInteractiveSnapshot(target, {
+      selector: params.snapshotSelector,
+      includeText: true,
+      maxElements: Math.min(100, Math.max(1, Number(params.snapshotMaxElements) || 20)),
+    })
+  }
+
+  return response
+}
+
+async function executeDispatchAction(target, step = {}) {
+  const { ref, selector, action, value, key, deltaX, deltaY, waitMs = 500 } = step
 
-  if (!ref) throw new Error("需要提供 ref（元素标识，如 'e1'）")
+  if (!ref && !selector) throw new Error("需要提供 ref 或 selector")
+  if (ref && !/^e\d+$/.test(String(ref))) throw new Error(`无效的 ref: ${ref}`)
   if (!action) throw new Error("需要提供 action（动作类型：click/fill/press/scroll/select/hover/focus）")
 
+  const locator = ref ? `[data-ghost-ref="${ref}"]` : String(selector)
+  const locatorExpression = JSON.stringify(locator)
+  const locatorLabel = ref || selector
+
   // Step 1: 实时获取目标元素的最新坐标和状态
   const locateExpression = `(function() {
     try {
-      const el = document.querySelector('[data-ghost-ref="${ref}"]');
-      if (!el) return { error: '元素未找到，ref 可能已失效，请重新获取快照' };
+      const el = document.querySelector(${locatorExpression});
+      if (!el) return { error: '元素未找到：' + ${JSON.stringify(locatorLabel)} };
       // 关键修复：确保元素在视口内，否则超出屏幕的坐标无法被 CDP 模拟点击
       el.scrollIntoView({ block: 'center', inline: 'center' });
       const rect = el.getBoundingClientRect();
@@ -1408,12 +1535,12 @@ async function handleDispatchAction(params = {}) {
 
   const loc = locResult?.value
   if (!loc || loc.error) throw new Error(loc?.error || "无法定位元素")
-  if (loc.disabled) throw new Error(`元素 ${ref} 已被禁用 (disabled)`)
+  if (loc.disabled) throw new Error(`元素 ${locatorLabel} 已被禁用 (disabled)`)
 
   const cx = loc.cx
   const cy = loc.cy
 
-  let actionResult = { ref, action, success: true }
+  let actionResult = { ...(ref ? { ref } : { selector }), action, success: true }
 
   // Step 2: 根据动作类型执行 CDP 命令
   if (action === "click") {
@@ -1424,7 +1551,7 @@ async function handleDispatchAction(params = {}) {
     await chrome.debugger.sendCommand(target, "Input.dispatchMouseEvent", {
       type: "mouseReleased", x: cx, y: cy, button: "left", clickCount: 1,
     })
-    actionResult.detail = `已点击 ${ref} (${loc.tag}) 坐标 (${cx}, ${cy})`
+    actionResult.detail = `已点击 ${locatorLabel} (${loc.tag}) 坐标 (${cx}, ${cy})`
 
   } else if (action === "fill") {
     if (value === undefined || value === null) throw new Error("fill 动作需要提供 value 参数")
@@ -1438,7 +1565,7 @@ async function handleDispatchAction(params = {}) {
     // 全选并清空已有内容
     await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
       expression: `(function() {
-        const el = document.querySelector('[data-ghost-ref="${ref}"]');
+        const el = document.querySelector(${locatorExpression});
         if (el) { el.focus(); el.select && el.select(); }
       })()`,
     })
@@ -1449,14 +1576,14 @@ async function handleDispatchAction(params = {}) {
     // 强制触发 input/change 事件（兼容 React/Vue）
     await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
       expression: `(function() {
-        const el = document.querySelector('[data-ghost-ref="${ref}"]');
+        const el = document.querySelector(${locatorExpression});
         if (el) {
           el.dispatchEvent(new Event('input', { bubbles: true }));
           el.dispatchEvent(new Event('change', { bubbles: true }));
         }
       })()`,
     })
-    actionResult.detail = `已在 ${ref} (${loc.tag}) 中填入 "${String(value).slice(0, 50)}"`
+    actionResult.detail = `已在 ${locatorLabel} (${loc.tag}) 中填入 "${String(value).slice(0, 50)}"`
 
   } else if (action === "press") {
     // 模拟键盘按键
@@ -1464,7 +1591,7 @@ async function handleDispatchAction(params = {}) {
     // 先确保元素聚焦
     await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
       expression: `(function() {
-        const el = document.querySelector('[data-ghost-ref="${ref}"]');
+        const el = document.querySelector(${locatorExpression});
         if (el) el.focus();
       })()`,
     })
@@ -1474,7 +1601,7 @@ async function handleDispatchAction(params = {}) {
     await chrome.debugger.sendCommand(target, "Input.dispatchKeyEvent", {
       type: "keyUp", key: keyName,
     })
-    actionResult.detail = `已在 ${ref} 上按下 ${keyName}`
+    actionResult.detail = `已在 ${locatorLabel} 上按下 ${keyName}`
 
   } else if (action === "scroll") {
     const dx = deltaX || 0
@@ -1482,36 +1609,36 @@ async function handleDispatchAction(params = {}) {
     await chrome.debugger.sendCommand(target, "Input.dispatchMouseEvent", {
       type: "mouseWheel", x: cx, y: cy, deltaX: dx, deltaY: dy,
     })
-    actionResult.detail = `已在 ${ref} 位置滚动 (${dx}, ${dy})`
+    actionResult.detail = `已在 ${locatorLabel} 位置滚动 (${dx}, ${dy})`
 
   } else if (action === "select") {
     // 下拉框选择
     if (value === undefined) throw new Error("select 动作需要提供 value 参数")
     await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
       expression: `(function() {
-        const el = document.querySelector('[data-ghost-ref="${ref}"]');
+        const el = document.querySelector(${locatorExpression});
         if (el && el.tagName === 'SELECT') {
           el.value = ${JSON.stringify(String(value))};
           el.dispatchEvent(new Event('change', { bubbles: true }));
         }
       })()`,
     })
-    actionResult.detail = `已在 ${ref} 选择值 "${value}"`
+    actionResult.detail = `已在 ${locatorLabel} 选择值 "${value}"`
 
   } else if (action === "hover") {
     await chrome.debugger.sendCommand(target, "Input.dispatchMouseEvent", {
       type: "mouseMoved", x: cx, y: cy,
     })
-    actionResult.detail = `已将鼠标悬停到 ${ref} (${cx}, ${cy})`
+    actionResult.detail = `已将鼠标悬停到 ${locatorLabel} (${cx}, ${cy})`
 
   } else if (action === "focus") {
     await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
       expression: `(function() {
-        const el = document.querySelector('[data-ghost-ref="${ref}"]');
+        const el = document.querySelector(${locatorExpression});
         if (el) el.focus();
       })()`,
     })
-    actionResult.detail = `已聚焦到 ${ref}`
+    actionResult.detail = `已聚焦到 ${locatorLabel}`
 
   } else {
     throw new Error(`不支持的动作类型: ${action}，可选: click/fill/press/scroll/select/hover/focus`)
@@ -1522,7 +1649,10 @@ async function handleDispatchAction(params = {}) {
     await sleep(Math.min(waitMs, 3000))
   }
 
-  // Step 4: 获取操作后状态摘要
+  return actionResult
+}
+
+async function readPageState(target) {
   const { result: afterResult } = await chrome.debugger.sendCommand(target, "Runtime.evaluate", {
     expression: `(function() {
       return {
@@ -1533,11 +1663,7 @@ async function handleDispatchAction(params = {}) {
     })()`,
     returnByValue: true,
   })
-  if (afterResult?.value) {
-    actionResult.pageAfter = afterResult.value
-  }
-
-  return actionResult
+  return afterResult?.value
 }
 
 // 处理来自服务器的命令
@@ -1578,6 +1704,7 @@ async function handleCommand(message) {
     else if (command === "findByString") result = await handleFindByString(params)
     else if (command === "symbolicHints") result = await handleSymbolicHints(params)
     else if (command === "eval") result = await handleEval(params)
+    else if (command === "pageRequest") result = await handlePageRequest(params)
     else if (command === "listNetworkRequests") result = await handleListNetworkRequests(params)
     else if (command === "getNetworkDetail") result = await handleGetNetworkDetail(params)
     else if (command === "clearNetworkRequests") result = await handleClearNetworkRequests(params)
@@ -1825,6 +1952,24 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
   return false
 })
 
+// ========== 定时兜底重连 ==========
+// offscreen 的重连循环在 daemon 重启/长时间找不到服务后偶发停摆（现象：手动点 Connect 才恢复）。
+// 每分钟检查一次连接状态，未连接则重新触发完整连接流程，保证无人值守时也能自动恢复
+chrome.alarms.create('ghost-bridge-keepalive', { delayInMinutes: 1, periodInMinutes: 1 })
+chrome.alarms.onAlarm.addListener(async (alarm) => {
+  if (alarm.name !== 'ghost-bridge-keepalive') return
+  if (!state.enabled) return
+  try {
+    const status = await chrome.runtime.sendMessage({ type: 'getOffscreenStatus' }).catch(() => null)
+    if (!status || !status.connected) {
+      log('定时兜底：连接未建立，重新触发连接流程')
+      await startBridgeConnection()
+    }
+  } catch (e) {
+    log(`定时兜底重连失败：${e.message}`)
+  }
+})
+
 // ========== 唤醒探活钩子 ==========
 // 系统锁屏/睡眠唤醒后，WebSocket 可能处于半开状态（onclose 不触发、徽章仍显示已连接），
 // 通知 offscreen 立即发一次心跳：无响应则关闭死链并马上重连，不等 15 秒周期心跳超时

package/extension/bg-dom.js

@@ -299,9 +299,26 @@
         }
 
         if (mode === 'text') {
-          let text = targetElement.innerText || targetElement.textContent || '';
+          // 递归收集同源 iframe 内的文本：跨域 iframe 访问 contentDocument 会抛错，跳过即可。
+          // 大量文档类页面（钉钉文档、italent 等）正文都在 iframe 里，不递归会拿到空文本，
+            // 迫使模型退化为整页截图读文档——那是长会话里最昂贵的 token 开销
+          function collectText(el) {
+            let text = el.innerText || el.textContent || '';
+            try {
+              var frames = el.querySelectorAll('iframe');
+              for (var i = 0; i < frames.length; i++) {
+                try {
+                  var doc = frames[i].contentDocument;
+                  if (doc && doc.body) text += '\\n\\n' + collectText(doc.body);
+                } catch (e) {}
+              }
+            } catch (e) {}
+            return text;
+          }
+          let text = collectText(targetElement);
           text = text.replace(/\\n{3,}/g, '\\n\\n').trim();
           result.contentLength = text.length;
+          result.includesIframes = true;
           const truncated = smartTruncateText(text, maxLength);
           result.content = truncated.content;
           result.truncated = truncated.truncated;

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Ghost Bridge",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Zero-restart Chrome debugger bridge for Claude MCP, optimized for no-sourcemap production debugging.",
   "permissions": [
     "debugger",
@@ -10,7 +10,8 @@
     "storage",
     "tabs",
     "offscreen",
-    "idle"
+    "idle",
+    "alarms"
   ],
   "host_permissions": [
     "ws://localhost/*",
@@ -33,4 +34,4 @@
   "background": {
     "service_worker": "background.js"
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghost-bridge",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "private": false,
   "type": "module",
   "description": "Ghost Bridge: Zero-restart Chrome debugger bridge for Claude MCP. Includes CLI for easy setup.",