@mearl/client 2.0.2 → 2.2.0

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"',
@@ -23,6 +23,7 @@ export const COMMANDS = [
         name: 'get_logs',
         description: '获取浏览器控制台日志',
         params: [
+            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
             { name: 'limit', type: 'number', description: '返回条数，默认 20' },
             { name: 'level', type: 'string', description: '按日志级别过滤：log/info/warn/error' },
             { name: 'filter', type: 'string', description: '按内容过滤，支持正则' },
@@ -60,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"}'`],
     },
@@ -69,6 +74,7 @@ export const COMMANDS = [
         name: 'set_mock',
         description: '设置 API mock 数据',
         params: [
+            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
             { name: 'apiName', type: 'string', required: true, description: 'API 名称或正则表达式' },
             { name: 'mockData', type: 'object', description: '完整 mock 响应数据（与 fields 二选一）' },
             {
@@ -100,6 +106,10 @@ export const COMMANDS = [
     {
         name: 'get_mocks',
         description: '查看当前生效的 mock 列表',
+        params: [
+            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
+            { name: 'apiName', type: 'string', description: '按 API 名称或正则表达式过滤' },
+        ],
         examples: ['get_mocks'],
     },
     {
@@ -147,6 +157,11 @@ export const COMMANDS = [
         name: 'tdbank_account',
         description: 'TDBank 账号操作：获取当前账号、账号列表、切换账号、快速借用并切换账号',
         params: [
+            {
+                name: 'tabId',
+                type: 'number',
+                description: 'CDP 模式下可指定用于读取 Cookie 的标签页 ID',
+            },
             {
                 name: 'operation',
                 type: '"current" | "list" | "switch" | "borrow"',
@@ -171,6 +186,11 @@ export const COMMANDS = [
         description: '列出所有浏览器及其连接状态、类型和托管实例信息',
         examples: ['browser_list'],
     },
+    {
+        name: 'browser_release',
+        description: '按用户明确要求释放调试控制和会话级临时效果（含设备/时区模拟），保留浏览器和全部标签页；不用于普通任务收尾',
+        examples: ['browser_release', 'browser_release --browser chrome-a'],
+    },
     {
         name: 'browser_launch',
         description: '启动独立 Chrome，可在新实例中通过 TDBank 登录指定账号',
@@ -630,17 +650,19 @@ export const COMMANDS = [
     {
         name: 'record_start',
         description: '开始录制用户操作',
+        params: [{ name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' }],
         examples: ['record_start'],
     },
     {
         name: 'record_stop',
         description: '停止录制并返回完整结果（操作 + 关联请求）；未在录制时不报错，返回 wasRecording: false',
+        params: [{ name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' }],
         examples: ['record_stop'],
     },
     // ── 移动端模拟 ────────────────────────────────────────────────────────────
     {
         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=清除' },
             {
@@ -685,6 +707,59 @@ export const COMMANDS = [
             `set_timezone --payload '{"tabId":12345,"timezone":""}'`,
         ],
     },
+    {
+        name: 'get_cookie',
+        description: '读取当前标签页的一个指定非分区 Cookie；拒绝返回 HttpOnly Cookie',
+        params: [
+            { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
+            {
+                name: 'name',
+                type: 'string',
+                required: true,
+                description: '要读取的 Cookie 名称；不支持列举全部 Cookie',
+            },
+            {
+                name: 'domain',
+                type: 'string',
+                description: '可选精确域过滤，只允许当前 host 或其父域',
+            },
+            { name: 'path', type: 'string', description: '可选精确 path 过滤' },
+        ],
+        examples: [
+            `get_cookie --payload '{"tabId":12345,"name":"feature_flag"}'`,
+            `get_cookie --payload '{"tabId":12345,"name":"edith_switch_br.rx-vehicle-search_home","domain":"taobao.com"}'`,
+        ],
+    },
+    {
+        name: 'set_cookie',
+        description: '设置当前标签页域下的一个指定非分区 session Cookie，可选刷新页面',
+        params: [
+            { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
+            {
+                name: 'name',
+                type: 'string',
+                required: true,
+                description: 'Cookie 名称',
+            },
+            {
+                name: 'value',
+                type: 'string',
+                required: true,
+                description: 'Cookie 值，可传空字符串；空字符串不会删除 Cookie',
+            },
+            {
+                name: 'domain',
+                type: 'string',
+                description: 'Cookie 域，默认当前 host；只允许当前 host 或其父域',
+            },
+            { name: 'path', type: 'string', description: 'Cookie path，默认 /' },
+            { name: 'reload', type: 'boolean', description: '设置后是否刷新页面，默认 false' },
+        ],
+        examples: [
+            `set_cookie --payload '{"tabId":12345,"name":"feature_flag","value":"enabled"}'`,
+            `set_cookie --payload '{"tabId":12345,"name":"edith_switch_br.rx-vehicle-search_home","value":"3.6.63","domain":"taobao.com","reload":true}'`,
+        ],
+    },
     // ── 其他 ──────────────────────────────────────────────────────────────────
     {
         name: 'page_frames',
@@ -728,4 +803,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]));