@opentiny/webmcp-cli 0.0.1-alpha.5 → 0.0.2

package/README.md

@@ -32,7 +32,9 @@ npm install -g .
 
 ### 1. `state` 命令
 
-获取浏览器当前活跃页签（或指定页签）的详细状态，包括当前页面的标题、URL、页面中包含的可操作 DOM 树，以及当前页面所有可调用的 MCP 工具列表（包含自动注入的 `page-agent-tool`）。
+获取浏览器当前活跃页签（或指定页签）的**导航元数据**，包括当前页面的标题、URL、浏览器所有已打开的页签列表，以及当前页面已注入的 MCP 工具列表（`webmcpTools`）。
+
+> **注意**：`state` 不再返回页面 DOM 内容（`content`）。若需要读取页面可交互元素，请在 `state` 之后显式调用 `page-agent-tool` 的 `browserState` action。
 
 **用法：**
 ```bash
@@ -43,7 +45,6 @@ webmcp-cli state -t <tabid>
 **返回格式（JSON）：**
 ```json
 {
-  "content": "浏览器状态：包含 [index]<type>text</type> 格式的页面树...",
   "url": "https://example.com",
   "title": "Example Domain",
   "webmcpTools": [
@@ -55,7 +56,7 @@ webmcp-cli state -t <tabid>
   ],
   "tabs": [
     {
-      "tabid": 1234,
+      "tabid": "2EA73ED323E46E5E108D4E46DA4E4AA7",
       "title": "Example Domain",
       "url": "https://example.com"
     }
@@ -83,17 +84,29 @@ webmcp-cli run change-color '{"color": "#ff0000"}'
 **示例二：使用内置的 `page-agent-tool` 操控浏览器**
 CLI 自动注入的 `page-agent-tool` 支持丰富的动作（action）：`browserState`, `click`, `fill`, `select`, `scroll`, `executeJavascript`。
 
-获取状态（执行前必须调用一次）：
+此外，该工具接收配置参数 **`responseMode`**，用于控制返回的页面状态形式：
+- **`diff`**（默认）：仅返回自上一次状态以来的增量 DOM 差异。
+- **`full`**：返回当前视口中完整的语义化 ARIA YAML 树。
+- **`both`**：同时返回全量树和增量差异。
+
+在执行 `click`, `fill`, `select`, `scroll` 等操作后，工具默认会自动以指定的 `responseMode`（默认 `diff`）返回最新的页面状态，使你可以立即检测操作效果，无须再次手动调用 `browserState`。
+
+获取状态（全量模式）：
+```bash
+webmcp-cli run page-agent-tool '{"action": "browserState", "responseMode": "full"}'
+```
+
+获取状态（仅增量差异模式，默认）：
 ```bash
-webmcp-cli run page-agent-tool '{"action": "browserState"}'
+webmcp-cli run page-agent-tool '{"action": "browserState", "responseMode": "diff"}'
 ```
 
-点击索引为 35 的元素：
+点击索引为 35 的元素（动作执行完自动返回增量）：
 ```bash
 webmcp-cli run page-agent-tool '{"action": "click", "index": 35}'
 ```
 
-向索引为 40 的输入框填入文本：
+向索引为 40 的输入框填入文本（动作执行完自动返回增量）：
 ```bash
 webmcp-cli run page-agent-tool '{"action": "fill", "index": 40, "text": "OpenTiny"}'
 ```