@attson/atwebpilot-mcp 0.0.71 → 0.0.72

package/README.md

@@ -49,8 +49,8 @@ listen 端口的能力，所以方向只能如此。这也是配对页存在的
 ## 工具面
 
 - 控制面 4 个：`list_tabs / open_session / close_session / get_quota`
-- 发现 1 个：`browser_discoverTools` —— 不带参数返回未发布工具目录（按 `export / network / storage / browser-data / inspect / legacy-dom / form` 分组）；带 `enable: [...]` 把它们加进本进程的 `tools/list`（发送 `tools/list_changed`），并直接返回完整 schema。
-- 执行面默认 **core 32 个** `browser_*`：浏览 / 采集 / 填表 / 导航 / 截图 闭环所需的工具。其余 19 个由 AI 按需 `discoverTools` 拉取，用户不用配置。
+- 发现 1 个：`browser_discoverTools` —— 不带参数返回未发布工具目录（按 `export / network / storage / browser-data / inspect / legacy-dom / form / tabs` 分组）；带 `enable: [...]` 把它们加进本进程的 `tools/list`（发送 `tools/list_changed`），并直接返回完整 schema。
+- 执行面默认 **core 31 个** `browser_*`：浏览 / 采集 / 填表 / 导航 / 截图 闭环所需的工具。其余 20 个由 AI 按需 `discoverTools` 拉取，用户不用配置。
 - 不暴露 `askUser`（MCP 会话没有人在侧边栏应答）和 `attachTab` / `detachTab`（目标 tab 已由 `open_session` 绑定）。
 
 MCP 层的描述是精简英文（≈2.5k tokens for core），侧边栏内置 LLM 仍用中文长描述；两者共享同一份 `TOOL_DEFS`，靠 `mcp` 字段区分。
@@ -65,7 +65,7 @@ hover / uploadFile / scroll / waitFor`）；`browser_storage` 也不会列出，
 
 | 值 | 效果 |
 |---|---|
-| `core`（默认） | 32 个核心工具 + `browser_discoverTools`，其余按需发现 |
+| `core`（默认） | 31 个核心工具 + `browser_discoverTools`，其余按需发现 |
 | `full` | 一开始就全部列出（51 个），适合不想让 AI 多一步发现的用户 |
 
 无法识别的值（包括已移除的 `parity`）按 `core` 处理，并往 stderr 打一条提示。
@@ -95,7 +95,7 @@ hover / uploadFile / scroll / waitFor`）；`browser_storage` 也不会列出，
 | `browser_drag` / `browser_drop` | `browser_drag` / `browser_drop` |
 | `browser_file_upload` | `browser_uploadFile` |
 | `browser_navigate` / `browser_navigate_back` | `browser_navigate`（`action` 取 `goto` / `back` / `forward` / `reload`） |
-| `browser_tabs` | `browser_listTabs` / `openTab` / `closeTab` / `switchToTab` |
+| `browser_tabs` | `browser_listTabs` / `openTab` / `closeTab`; `switchToTab` 需按需发现，仅用于用户明确要求前台切换 |
 | `browser_close` | `browser_closeTab` |
 | `browser_resize` | `browser_resize` |
 | `browser_take_screenshot` | `browser_screenshot`（含 `fullPage` / `format` / `scale`） |

package/dist/index.js

@@ -1425,7 +1425,9 @@ var TOOL_DEFS = [
   {
     name: "switchToTab",
     description: "[META] \u628A Chrome \u524D\u53F0\u5207\u5230\u76EE\u6807 tab\u3002tabId \u5FC5\u987B\u5DF2\u5728 attachedTabs \u6216\u5F53\u524D tab\u3002",
-    mcp: { description: "Bring the session's tab to the foreground." },
+    mcp: {
+      description: "Bring the session's tab and Chrome window to the foreground. Use only when the user explicitly asks to see that tab; all other browser tools already operate on the session-bound tab without this setup step."
+    },
     input_schema: {
       type: "object",
       properties: { tabId: { type: "integer" } },
@@ -1437,7 +1439,7 @@ var TOOL_DEFS = [
     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\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",
     mcp: {
-      description: "PNG/JPEG of the visible viewport, returned as an image block. selector or blockId scrolls to and highlights that region first; fullPage stitches the whole page.",
+      description: "PNG/JPEG returned as an image block. With opt-in CDP enabled, captures viewport/fullPage/selector in the background without activating or scrolling the tab; compatibility mode may temporarily activate the tab.",
       params: { blockId: "page-index blockId to frame", indexId: "indexId that produced blockId", scale: "0.1\u20131; smaller saves tokens" }
     },
     input_schema: {
@@ -1927,7 +1929,6 @@ var CORE_TOOLS = [
   "listTabs",
   "openTab",
   "closeTab",
-  "switchToTab",
   "resize",
   "scroll",
   // observation
@@ -2072,7 +2073,8 @@ var DISCOVERABLE_GROUPS = {
   "browser-data": ["browser_searchBookmarks", "browser_searchHistory"],
   inspect: ["browser_inspectElement", "browser_highlight", "browser_getValue", "browser_extractFormState"],
   "legacy-dom": ["browser_snapshotDOM", "browser_querySelector", "browser_querySelectorAll", "browser_extractImages", "browser_focus"],
-  form: ["browser_submitForm"]
+  form: ["browser_submitForm"],
+  tabs: ["browser_switchToTab"]
 };
 var GROUP_BY_NAME = new Map(
   Object.entries(DISCOVERABLE_GROUPS).flatMap(([g, names]) => names.map((n) => [n, g]))

package/package.json

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