@mearl/client 2.1.0 → 2.2.1

package/dist/commands.js

@@ -5,7 +5,7 @@ export const COMMANDS = [
         description: '获取最近的网络请求（mtop 或普通 xhr/fetch）',
         params: [
             { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
-            { name: 'count', type: 'number', description: '返回条数，默认 20' },
+            { name: 'count', type: 'number', description: '返回条数，默认 10' },
             {
                 name: 'source',
                 type: '"mtop" | "requests"',
@@ -61,7 +61,11 @@ export const COMMANDS = [
         description: '获取 API 接口 schema（出入参定义）',
         params: [
             { name: 'api', type: 'string', required: true, description: 'API 名称' },
-            { name: 'type', type: '"schema" | "hsf" | "all"', description: '返回类型，默认 all' },
+            {
+                name: 'fields',
+                type: '("schema" | "hsf")[]',
+                description: '指定返回内容；不填时返回全部可用内容',
+            },
         ],
         examples: [`get_api_schema --payload '{"api":"mtop.trade.order.detail"}'`],
     },
@@ -121,18 +125,30 @@ export const COMMANDS = [
     // ── 网络代理 ──────────────────────────────────────────────────────────────
     {
         name: 'send_request',
-        description: '发送 HTTP 请求，自动携带浏览器 Cookie',
+        description: '发送 HTTP 请求，自动携带浏览器 Cookie，支持 multipart 文件上传',
         params: [
             { name: 'url', type: 'string', required: true, description: '完整目标 URL' },
             { name: 'method', type: 'string', description: 'HTTP 方法，默认 GET' },
             { name: 'headers', type: 'object', description: '自定义请求头' },
             { name: 'params', type: 'object', description: 'URL 查询参数' },
             { name: 'body', type: 'any', description: '请求体（传对象时自动 JSON 序列化）' },
+            {
+                name: 'formData',
+                type: 'object',
+                description: 'multipart 文本字段（值支持 string/number/boolean）',
+            },
+            {
+                name: 'files',
+                type: 'SendRequestFile[]',
+                description: 'multipart 文件，最多 20 个、总计不超过 40 MiB；Base64 文件总计不超过 7 MiB。每项传 fieldName 和绝对 filePath，或传 base64 + filename',
+            },
             { name: 'withCookies', type: 'boolean', description: '是否附加浏览器 Cookie，默认 true' },
-            { name: 'cookieDomain', type: 'string', description: '指定 Cookie 域名，不填时从 url 提取' },
             { name: 'timeout', type: 'number', description: '超时毫秒数，默认 30000' },
         ],
-        examples: [`send_request --payload '{"url":"https://api.example.com/data","method":"GET"}'`],
+        examples: [
+            `send_request --payload '{"url":"https://api.example.com/data","method":"GET"}'`,
+            `send_request --payload '{"url":"https://api.example.com/upload","method":"POST","formData":{"folder":"assets"},"files":[{"fieldName":"file","filePath":"/absolute/path/image.png"}]}'`,
+        ],
     },
     {
         name: 'send_mtop_request',
@@ -184,7 +200,7 @@ export const COMMANDS = [
     },
     {
         name: 'browser_release',
-        description: '释放 Agent 对当前浏览器的调试控制，保留浏览器和全部标签页',
+        description: '按用户明确要求释放调试控制和会话级临时效果（含设备/时区模拟），保留浏览器和全部标签页；不用于普通任务收尾',
         examples: ['browser_release', 'browser_release --browser chrome-a'],
     },
     {
@@ -255,6 +271,11 @@ export const COMMANDS = [
         params: [
             { name: 'url', type: 'string', required: true, description: '要打开的 URL' },
             { name: 'active', type: 'boolean', description: '是否激活新 Tab，默认 false' },
+            {
+                name: 'openerTabId',
+                type: 'number',
+                description: '来源 Tab ID；用于把目标 Tab 关联到来源侧边栏对话',
+            },
             {
                 name: 'closeExisting',
                 type: 'boolean',
@@ -307,7 +328,7 @@ export const COMMANDS = [
     // ── 页面操作 ──────────────────────────────────────────────────────────────
     {
         name: 'page_click',
-        description: '点击页面元素，支持 selector / text / point 三种定位方式；auto 在可见页按设备模拟状态使用可信 mouse/touch，隐藏页使用 DOM fallback',
+        description: '点击页面元素，支持 selector / text / point 三种定位方式；auto 在可见页按设备模拟状态使用可信 mouse/touch，隐藏页使用 DOM fallback；点击直接打开新标签页时 observation.openedTabs 返回目标信息',
         params: [
             {
                 name: 'selector',
@@ -658,7 +679,7 @@ export const COMMANDS = [
     // ── 移动端模拟 ────────────────────────────────────────────────────────────
     {
         name: 'set_device_emulation',
-        description: '把目标 tab 切换为移动端模拟（视口/UA/触摸），等价 DevTools 设备工具栏，作用域 per-tab',
+        description: '把目标 tab 切换为移动端模拟（视口/UA/触摸），等价 DevTools 设备工具栏，作用域 per-tab；需保持调试控制才持续生效',
         params: [
             { name: 'enabled', type: 'boolean', required: true, description: 'true=启用，false=清除' },
             {
@@ -799,4 +820,4 @@ export const COMMANDS = [
         ],
     },
 ];
-export const COMMAND_MAP = new Map(COMMANDS.map(c => [c.name, c]));
+export const COMMAND_MAP = new Map(COMMANDS.map(command => [command.name, command]));