@attson/atwebpilot-mcp 0.0.51 → 0.0.53

package/dist/index.js

@@ -640,6 +640,10 @@ function capabilityForTool(tool, opts) {
     case "extractText":
     case "extractFormState":
     case "getValue":
+    case "createPageIndex":
+    case "searchPageIndex":
+    case "readPageBlock":
+    case "extractPageFields":
       return "read:dom";
     case "extractImages":
       return "read:image";
@@ -673,6 +677,7 @@ function capabilityForTool(tool, opts) {
     case "searchHistory":
       return "read:dom";
     case "downloadImage":
+    case "downloadSpreadsheet":
       return "submit:form";
     // writes to user's disk — treat as side-effect
     case "takeSnapshot":
@@ -1140,7 +1145,7 @@ var TOOL_DEFS = [
   },
   {
     name: "extractText",
-    description: "[FAST] \u63D0\u53D6\u9009\u62E9\u5668\u547D\u4E2D\u5143\u7D20\u7684\u6587\u672C\u3002single=true \u8FD4\u56DE\u5B57\u7B26\u4E32\uFF0C\u5426\u5219\u8FD4\u56DE\u6570\u7EC4\u3002\n\n\u793A\u4F8B\uFF1A\n- \u63D0\u53D6\u6807\u9898\uFF1A{ selector: 'h1', single: true }\n- \u63D0\u53D6\u6240\u6709\u6BB5\u843D\uFF1A{ selector: 'article p' }",
+    description: "[FAST\xB7TARGETED] \u63D0\u53D6\u9009\u62E9\u5668\u547D\u4E2D\u5143\u7D20\u7684\u6587\u672C\u3002single=true \u8FD4\u56DE\u5B57\u7B26\u4E32\uFF0C\u5426\u5219\u8FD4\u56DE\u6570\u7EC4\u3002\n\u53EA\u7528\u4E8E\u660E\u786E\u7684\u5C0F\u8303\u56F4 selector\uFF1B\u666E\u901A\u7F51\u9875\u7406\u89E3/\u5B57\u6BB5\u63D0\u53D6\u4E0D\u8981\u7528 extractText({selector:'body'})\uFF0C\u5148\u7528 createPageIndex + extractPageFields/searchPageIndex\u3002\n\n\u793A\u4F8B\uFF1A\n- \u63D0\u53D6\u6807\u9898\uFF1A{ selector: 'h1', single: true }\n- \u63D0\u53D6\u6240\u6709\u6BB5\u843D\uFF1A{ selector: 'article p' }",
     input_schema: {
       type: "object",
       properties: {
@@ -1152,6 +1157,66 @@ var TOOL_DEFS = [
       required: ["selector"]
     }
   },
+  // ─── Page Context Index · bounded read / extraction ─────────
+  {
+    name: "createPageIndex",
+    description: "[PAGE-INDEX][FIRST\xB7READ] \u5728\u5185\u5BB9\u811A\u672C\u672C\u5730\u6784\u5EFA/\u5237\u65B0\u9875\u9762\u7D22\u5F15\uFF0C\u8FD4\u56DE\u5C0F\u578B\u9875\u9762\u5730\u56FE\u3001blockId\u3001kinds\u3001truncation \u5143\u6570\u636E\u3002\n\u7528\u4E8E\u666E\u901A\u7F51\u9875\u7406\u89E3\u3001\u5546\u54C1/\u6587\u7AE0/\u8868\u683C\u5B57\u6BB5\u63D0\u53D6\u3001\u91C7\u96C6\u524D\u5B9A\u4F4D\u3002\u4E0D\u8981\u5148\u8BFB\u53D6 body\uFF1B\u5148\u5EFA\u7D22\u5F15\uFF0C\u518D\u7528 extractPageFields/searchPageIndex\u3002",
+    input_schema: {
+      type: "object",
+      properties: {
+        maxBlocks: { type: "integer", default: 600, description: "\u6700\u591A\u7D22\u5F15\u591A\u5C11\u4E2A\u9875\u9762\u5757\uFF1B\u8D85\u51FA\u8FD4\u56DE index_budget truncation" },
+        refresh: { type: "boolean", default: false, description: "true=\u5FFD\u7565\u7F13\u5B58\u91CD\u65B0\u626B\u63CF\u5F53\u524D\u9875\u9762" },
+        summaryLimit: { type: "integer", default: 40, description: "\u8FD4\u56DE\u7ED9\u6A21\u578B\u7684\u9875\u9762\u5730\u56FE\u6761\u6570" },
+        tabId: TAB_ID_FIELD
+      }
+    }
+  },
+  {
+    name: "searchPageIndex",
+    description: "[PAGE-INDEX] \u5728\u672C\u5730\u9875\u9762\u7D22\u5F15\u4E2D\u641C\u7D22\u5173\u952E\u8BCD/\u5B57\u6BB5\uFF0C\u8FD4\u56DE\u5C0F\u8BC1\u636E\u7247\u6BB5\u3001blockId\u3001complete/availableChars\u3001truncation \u5143\u6570\u636E\u3002\n\u9002\u5408\u5B9A\u4F4D\u6392\u540D\u3001\u4EF7\u683C\u3001\u8BC4\u8BBA\u6570\u3001\u65E5\u671F\u7B49\u8BC1\u636E\uFF1B\u4E0D\u8981\u7528 extractText({selector:'body'}) \u6765\u641C\u7D22\u5927\u9875\u9762\u3002",
+    input_schema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "\u8981\u641C\u7D22\u7684\u5173\u952E\u8BCD/\u77ED\u8BED" },
+        fields: { type: "array", items: { type: "string" }, description: "\u4E5F\u53EF\u7ED9\u5B57\u6BB5\u540D\u6570\u7EC4\u8F85\u52A9\u5339\u914D" },
+        limit: { type: "integer", default: 20 },
+        maxBlocks: { type: "integer", default: 600 },
+        refresh: { type: "boolean", default: false },
+        tabId: TAB_ID_FIELD
+      }
+    }
+  },
+  {
+    name: "readPageBlock",
+    description: "[PAGE-INDEX] \u6309 blockId \u8BFB\u53D6\u5C40\u90E8\u5185\u5BB9\uFF1B\u957F\u5185\u5BB9\u6309 offset/maxChars \u5206\u9875\uFF0C\u8FD4\u56DE hasMore\u3001nextOffset\u3001recommendedNext \u548C truncation \u65E5\u5FD7\u3002\n\u53EA\u5728 searchPageIndex/extractPageFields \u8BC1\u636E\u4E0D\u8DB3\u6216\u9700\u8981\u6838\u5BF9\u90BB\u8FD1\u4E0A\u4E0B\u6587\u65F6\u4F7F\u7528\u3002",
+    input_schema: {
+      type: "object",
+      properties: {
+        blockId: { type: "string", description: "createPageIndex/searchPageIndex/extractPageFields \u8FD4\u56DE\u7684\u7A33\u5B9A blockId" },
+        indexId: { type: "string", description: "\u53EF\u9009\uFF1A\u7ED1\u5B9A\u5230\u4EA7\u751F\u8BE5 blockId \u7684\u7D22\u5F15\uFF0C\u907F\u514D refresh \u540E\u8BEF\u8BFB\u540C\u540D blockId" },
+        offset: { type: "integer", default: 0 },
+        maxChars: { type: "integer", default: 4e3 },
+        includeNeighbors: { type: "boolean", default: false },
+        tabId: TAB_ID_FIELD
+      },
+      required: ["blockId"]
+    }
+  },
+  {
+    name: "extractPageFields",
+    description: "[PAGE-INDEX][FIELD-FIRST] \u901A\u7528\u5B57\u6BB5\u5019\u9009\u63D0\u53D6\uFF1A\u8F93\u5165\u5B57\u6BB5\u540D\u6570\u7EC4\uFF0C\u8FD4\u56DE value candidates\u3001confidence\u3001evidence\u3001blockId\u3001truncation\u3002\n\u9002\u5408\u5546\u54C1\u4FE1\u606F\u3001\u6587\u7AE0\u5143\u4FE1\u606F\u3001\u8868\u683C\u8BE6\u60C5\u3001\u8868\u5355\u5B57\u6BB5\u7B49\u7ED3\u6784\u5316\u63D0\u53D6\uFF1B\u8BC1\u636E\u4E0D\u8DB3\u518D\u7528 readPageBlock \u5B9A\u5411\u8BFB\u53D6\u3002",
+    input_schema: {
+      type: "object",
+      properties: {
+        fields: { type: "array", items: { type: "string" }, description: "\u7528\u6237\u8981\u63D0\u53D6\u7684\u5B57\u6BB5\u540D\uFF0C\u4F8B\u5982 \u4EF7\u683C\u3001\u6392\u540D\u3001ASIN\u3001\u4F5C\u8005\u3001\u53D1\u5E03\u65E5\u671F" },
+        maxCandidatesPerField: { type: "integer", default: 4 },
+        maxBlocks: { type: "integer", default: 600 },
+        refresh: { type: "boolean", default: false },
+        tabId: TAB_ID_FIELD
+      },
+      required: ["fields"]
+    }
+  },
   {
     name: "extractImages",
     description: "[FAST] \u5728 root \u8303\u56F4\u5185\u63D0\u53D6\u6240\u6709 <img> \u7684 src/data-src/srcset\uFF1BincludeBg=true \u65F6\u4E5F\u63D0\u53D6\u80CC\u666F\u56FE\u3002\u8FD4\u56DE [{url, via}].\n\n\u793A\u4F8B\uFF1A\n- \u5168\u9875\u56FE\uFF1A{ }\uFF08\u9ED8\u8BA4 root=document\uFF09\n- \u5546\u54C1\u4E3B\u56FE\uFF1A{ root: '.product-gallery' }",
@@ -1426,11 +1491,14 @@ var TOOL_DEFS = [
   // ─── User-side helpers ───────────────────────────────────────
   {
     name: "screenshot",
-    description: "[VISION] \u622A\u5F53\u524D tab \u53EF\u89C1\u533A\u57DF\u4E3A PNG\uFF08\u81EA\u52A8\u4F5C\u4E3A image block \u6CE8\u5165\u4E0B\u8F6E\uFF09\u3002\u7528\u4E8E\u89C6\u89C9\u8C03\u8BD5 selector / \u770B\u56FE\u56DE\u7B54 / \u7559\u8BC1\u636E\u3002\u8FD4\u56DE {ok: true, byteLen}\u3002",
+    description: "[VISION] \u622A\u5F53\u524D tab \u53EF\u89C1\u533A\u57DF\u4E3A PNG\uFF08\u81EA\u52A8\u4F5C\u4E3A image block \u6CE8\u5165\u4E0B\u8F6E\uFF09\u3002\u7528\u4E8E\u89C6\u89C9\u8C03\u8BD5\u3001\u770B\u56FE\u56DE\u7B54\u3001\u6838\u5BF9 page-index \u8BC1\u636E\u3002\n\u5982\u679C\u5DF2\u6709 searchPageIndex/extractPageFields \u8FD4\u56DE\u7684 blockId/indexId\uFF0C\u4F18\u5148\u4F20 {blockId,indexId}\uFF1B\u5DE5\u5177\u4F1A\u6EDA\u52A8\u5E76\u9AD8\u4EAE\u8BE5\u5C40\u90E8\u533A\u57DF\u540E\u622A\u56FE\u3002\u4E5F\u53EF\u4F20 selector\u3002",
     input_schema: {
       type: "object",
       properties: {
-        selector: { type: "string", description: "\u53EF\u9009\uFF1ACSS selector\u3002\u57FA\u7840\u7248\u65E0\u89C6\uFF0C\u59CB\u7EC8\u622A viewport\u3002" },
+        selector: { type: "string", description: "\u53EF\u9009\uFF1ACSS selector\uFF1B\u622A\u56FE\u524D\u4F1A\u6EDA\u52A8\u5E76\u9AD8\u4EAE\u76EE\u6807" },
+        blockId: { type: "string", description: "\u53EF\u9009\uFF1Apage-index \u8FD4\u56DE\u7684 blockId\uFF0C\u7528\u4E8E\u5C40\u90E8\u89C6\u89C9\u8BC1\u636E" },
+        indexId: { type: "string", description: "\u53EF\u9009\uFF1A\u4EA7\u751F blockId \u7684 indexId\uFF0C\u907F\u514D refresh \u540E\u8BEF\u8BFB" },
+        highlightMs: { type: "integer", default: 1500, description: "\u622A\u56FE\u524D\u76EE\u6807\u9AD8\u4EAE\u6301\u7EED\u65F6\u95F4\uFF0C250-5000ms" },
         tabId: TAB_ID_FIELD
       }
     }
@@ -1502,6 +1570,50 @@ var TOOL_DEFS = [
       required: ["url"]
     }
   },
+  {
+    name: "downloadSpreadsheet",
+    description: "[ACT] \u751F\u6210\u5E76\u4E0B\u8F7D\u771F\u6B63\u7684 .xlsx Excel \u6587\u4EF6\uFF08Chrome Downloads\uFF09\u3002\u9002\u5408\u628A\u91C7\u96C6/\u62BD\u53D6\u7ED3\u679C\u5BFC\u51FA\u4E3A\u8868\u683C\u3002\u652F\u6301\u591A\u4E2A sheet\uFF1Brows \u53EF\u4EE5\u662F\u4E8C\u7EF4\u6570\u7EC4\uFF0C\u4E5F\u53EF\u4EE5\u662F\u5BF9\u8C61\u6570\u7EC4\u3002\u5BF9\u8C61\u6570\u7EC4\u53EF\u914D columns \u63A7\u5236\u5217\u987A\u5E8F\u548C\u8868\u5934\u3002\u8FD4\u56DE {downloadId, filename, sheets, rows, bytes}\u3002caution \u7EA7\u3002",
+    input_schema: {
+      type: "object",
+      properties: {
+        filename: { type: "string", description: "\u5EFA\u8BAE\u6587\u4EF6\u540D\uFF1B\u53EF\u4E0D\u5E26 .xlsx \u540E\u7F00" },
+        sheets: {
+          type: "array",
+          minItems: 1,
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "sheet \u540D\uFF0C\u6700\u957F 31 \u5B57\u7B26\uFF1B\u975E\u6CD5\u5B57\u7B26\u4F1A\u88AB\u66FF\u6362" },
+              columns: {
+                type: "array",
+                description: "\u5BF9\u8C61\u884C\u7684\u5217\u987A\u5E8F\u548C\u8868\u5934\uFF1B\u4E8C\u7EF4\u6570\u7EC4\u884C\u53EF\u7701\u7565",
+                items: {
+                  type: "object",
+                  properties: {
+                    key: { type: "string" },
+                    header: { type: "string" }
+                  },
+                  required: ["key"]
+                }
+              },
+              rows: {
+                type: "array",
+                description: '\u4E8C\u7EF4\u6570\u7EC4\uFF0C\u5982 [["\u6807\u9898","\u4EF7\u683C"],["A",12]]\uFF1B\u6216\u5BF9\u8C61\u6570\u7EC4\uFF0C\u5982 [{title:"A",price:12}]',
+                items: {
+                  oneOf: [
+                    { type: "array", items: {} },
+                    { type: "object" }
+                  ]
+                }
+              }
+            },
+            required: ["rows"]
+          }
+        }
+      },
+      required: ["sheets"]
+    }
+  },
   // ─── Tier 4 · UID-based interaction + visual + batch ────────
   {
     name: "takeSnapshot",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attson/atwebpilot-mcp",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "license": "Apache-2.0",
   "description": "MCP server for the atwebpilot browser extension — let Claude Code drive your browser.",
   "homepage": "https://github.com/attson/atwebpilot#readme",