@mearl/client 2.16.1 → 2.16.3

package/README.md

@@ -171,7 +171,7 @@ const result = await invokePlugin(
 );
 ```
 
-MCP Server 通过固定工具 `mearl_plugin` 接受同样的 `plugin`、`command` 和 `input`，不会把插件子命令动态扩展成 MCP 工具。SDK 与 MCP 不接受任意入口路径；调用官方目录中尚未注册的插件时，会通过匹配当前 client 版本的 setup 自动安装并重试一次。未知名称仍返回 `PLUGIN_NOT_REGISTERED`。
+MCP Server 通过固定工具 `mearl_plugin` 接受同样的 `plugin`、`command` 和 `input`，不会把插件子命令动态扩展成 MCP 工具。SDK 与 MCP 不接受任意入口路径；调用尚未注册的 `buc` 或 `tdbank` 时，会通过匹配当前 client 版本的 setup 自动安装并重试一次。其他未注册名称返回 `PLUGIN_NOT_REGISTERED`。
 
 注册记录在 `~/.mearl/plugins/<name>.json`，保存入口路径和可选的简短描述；skill 业务代码原地更新直接生效，换路径或更新描述后重新注册。
 `plugin uninstall <name>` 会对 `~/.agents/skills` 中的全局 Skill 调用 `ali-skills remove --global --yes`，
@@ -201,7 +201,6 @@ MCP Server 通过固定工具 `mearl_plugin` 接受同样的 `plugin`、`command
 | 组合调用      | `run_actions`                                                                                                                        |
 | 页面感知      | `page_snapshot` `page_screenshot` `page_selected_element` `page_frames`                                                              |
 | 环境与 Cookie | `set_device_emulation` `set_app_profile` `set_timezone` `get_cookie` `set_cookie`                                                     |
-| 录制          | `record_start` `record_stop`                                                                                                         |
 | 浏览器        | `browser_list` `browser_release` `browser_launch` `browser_close`                                                                    |
 
 页面交互动作（`page_click` / `page_drag` / `page_type` / `page_hover` / `page_scroll` / `page_press` / `page_upload`）默认等待异步稳定并返回 `{ action, observation }`。参数、ref 或目标解析在派发前失败时返回 `action.stage: "precondition"`，省略无意义的 `observation` / `diagnostics`，CLI 退出码为 1。传 `observe: false` 可执行裸动作；需要同一动作期间的新增 error logs 和业务 requests 时传 `diagnostics: true`，埋点通过 `diagnostics.events` 按需开启。`page_eval` 默认裸执行，可按需开启观察或诊断。

package/dist/cli.js

@@ -46,7 +46,6 @@ const CATEGORIES = [
         title: '环境与 Cookie',
         names: ['set_device_emulation', 'set_app_profile', 'set_timezone', 'get_cookie', 'set_cookie'],
     },
-    { title: '录制', names: ['record_start', 'record_stop'] },
     {
         title: '浏览器',
         names: ['browser_list', 'browser_release', 'browser_launch', 'browser_close'],
@@ -59,7 +58,7 @@ const BUILTIN_COMMANDS = [
         examples: ['check'],
     },
 ];
-const OFFICIAL_PLUGIN_COMMANDS = listOfficialPluginNames().map(name => ({
+const AUTO_INSTALL_PLUGIN_COMMANDS = listOfficialPluginNames().map(name => ({
     name,
     description: findOfficialPlugin(name).description,
     examples: [name],
@@ -67,7 +66,7 @@ const OFFICIAL_PLUGIN_COMMANDS = listOfficialPluginNames().map(name => ({
 const SUGGESTABLE_COMMANDS = [
     ...COMMANDS,
     ...BUILTIN_COMMANDS,
-    ...OFFICIAL_PLUGIN_COMMANDS,
+    ...AUTO_INSTALL_PLUGIN_COMMANDS,
 ];
 const ADVANCED_BUILTIN_COMMANDS = new Set(['connector_list']);
 const PLUGIN_HOST_OPTIONS = new Set([
@@ -155,14 +154,6 @@ function printUsage(commandName, version) {
             });
             lines.push('', '已注册插件：', ...entries);
         }
-        const installed = new Set(plugins);
-        const available = listOfficialPluginNames().filter(name => !installed.has(name));
-        if (available.length) {
-            lines.push('', '官方插件（首次调用自动安装）：', ...available.map(name => {
-                const description = findOfficialPlugin(name).description;
-                return `  ${name.padEnd(TOP_LEVEL_COMMAND_NAME_WIDTH)}${description}`;
-            }));
-        }
     }
     catch (error) {
         lines.push('', error instanceof Error ? error.message : String(error));

package/dist/commands.d.ts

@@ -790,25 +790,6 @@ export declare const COMMANDS: readonly [{
         readonly description: "目标标签页 ID";
     }];
     readonly examples: ["page_selected_element", "page_selected_element --output ./element.png"];
-}, {
-    readonly name: "record_start";
-    readonly description: "开始录制用户操作";
-    readonly params: [{
-        readonly name: "tabId";
-        readonly type: "number";
-        readonly description: "目标标签页 ID，从 tab_list 获取";
-    }];
-    readonly examples: ["record_start"];
-}, {
-    readonly name: "record_stop";
-    readonly description: "停止录制并返回完整结果（操作 + 关联请求）；未在录制时不报错，返回 wasRecording: false";
-    readonly summary: "停止录制并返回操作和关联请求";
-    readonly params: [{
-        readonly name: "tabId";
-        readonly type: "number";
-        readonly description: "目标标签页 ID，从 tab_list 获取";
-    }];
-    readonly examples: ["record_stop"];
 }, {
     readonly name: "set_device_emulation";
     readonly description: "把目标 tab 切换为移动端模拟（视口/DPR/UA/触摸/视觉比例），等价 DevTools 设备工具栏，作用域 per-tab；需保持调试控制才持续生效";

package/dist/commands.js

@@ -740,20 +740,6 @@ export const COMMANDS = [
         ],
         examples: ['page_selected_element', 'page_selected_element --output ./element.png'],
     },
-    // ── 录制 ──────────────────────────────────────────────────────────────────
-    {
-        name: 'record_start',
-        description: '开始录制用户操作',
-        params: [{ name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' }],
-        examples: ['record_start'],
-    },
-    {
-        name: 'record_stop',
-        description: '停止录制并返回完整结果（操作 + 关联请求）；未在录制时不报错，返回 wasRecording: false',
-        summary: '停止录制并返回操作和关联请求',
-        params: [{ name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' }],
-        examples: ['record_stop'],
-    },
     // ── 移动端模拟 ────────────────────────────────────────────────────────────
     {
         name: 'set_device_emulation',

package/dist/generated-browser-action-protocol.d.ts

@@ -610,9 +610,6 @@ export interface SetCookieResult {
     path: string;
     reloaded: boolean;
 }
-export interface RecordParams {
-    tabId?: number;
-}
 export interface RequestDomainPermissionParams {
     domain: string;
 }
@@ -779,14 +776,6 @@ export interface BrowserActionMap {
         request: SetCookieParams;
         response: SetCookieResult;
     };
-    record_start: {
-        request: RecordParams;
-        response: unknown;
-    };
-    record_stop: {
-        request: RecordParams;
-        response: unknown;
-    };
     request_domain_permission: {
         request: RequestDomainPermissionParams;
         response: unknown;
@@ -842,8 +831,6 @@ export declare const BROWSER_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly record_start: true;
-    readonly record_stop: true;
     readonly request_domain_permission: true;
     readonly run_actions: true;
 };
@@ -885,8 +872,6 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly record_start: true;
-    readonly record_stop: true;
     readonly request_domain_permission: true;
     readonly run_actions: true;
 };
@@ -925,8 +910,6 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly record_start: true;
-    readonly record_stop: true;
     readonly request_domain_permission: true;
     readonly run_actions: true;
 };

package/dist/generated-browser-action-protocol.js

@@ -97,8 +97,6 @@ export const BROWSER_ACTIONS = {
     set_timezone: true,
     get_cookie: true,
     set_cookie: true,
-    record_start: true,
-    record_stop: true,
     request_domain_permission: true,
     run_actions: true,
 };
@@ -140,8 +138,6 @@ export const BROWSER_COMMAND_ACTIONS = {
     set_timezone: true,
     get_cookie: true,
     set_cookie: true,
-    record_start: true,
-    record_stop: true,
     request_domain_permission: true,
     run_actions: true,
 };
@@ -180,8 +176,6 @@ export const EXTENSION_BROWSER_ACTIONS = {
     set_timezone: true,
     get_cookie: true,
     set_cookie: true,
-    record_start: true,
-    record_stop: true,
     request_domain_permission: true,
     run_actions: true,
 };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invok
 export type { UnifiedClientOptions, UnifiedInvokeOptions, UnifiedInvokeOptions as InvokeOptions, } from './unified.js';
 export type { PluginInvocation, PluginInvokeOptions } from './plugin.js';
 export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCapabilityAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
-export type { ActionStep, AppProfileName, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCapabilities, BrowserCapabilityAction, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserJsonValue, BrowserLaunchParams, BrowserProviderOperation, BrowserListResult, BrowserPairingInfo, BrowserReleaseFailure, BrowserReleaseResult, BrowserProviderDefinition, BrowserProviderIdentity, BrowserProviderInputSchema, BrowserProviderListResult, BrowserReference, BrowserDetails, BrowserSource, BrowserStatus, BrowserScreenshotKind, BrowserTransport, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, ManagedBrowserInfo, PageClickParams, PageDragEndpoint, PageDragParams, PageDragPoint, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RecordParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from './generated-browser-action-protocol.js';
+export type { ActionStep, AppProfileName, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCapabilities, BrowserCapabilityAction, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserJsonValue, BrowserLaunchParams, BrowserProviderOperation, BrowserListResult, BrowserPairingInfo, BrowserReleaseFailure, BrowserReleaseResult, BrowserProviderDefinition, BrowserProviderIdentity, BrowserProviderInputSchema, BrowserProviderListResult, BrowserReference, BrowserDetails, BrowserSource, BrowserStatus, BrowserScreenshotKind, BrowserTransport, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, ManagedBrowserInfo, PageClickParams, PageDragEndpoint, PageDragParams, PageDragPoint, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from './generated-browser-action-protocol.js';
 import { type UnifiedInvokeOptions } from './unified.js';
 import type * as Protocol from './generated-browser-action-protocol.js';
 export declare function tabCheckpoint(params?: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;

package/dist/officialPluginCatalog.d.ts

@@ -18,61 +18,6 @@ export declare const OFFICIAL_PLUGINS: {
         readonly setup: "alibaba";
         readonly skill: "tdbank-account";
     };
-    readonly agentforce: {
-        readonly description: "管理 AgentForce 数字员工";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "agentforce-manage", "--yes"];
-        readonly skill: "agentforce-manage";
-    };
-    readonly aliway: {
-        readonly description: "读取和管理 Aliway 内容";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "aliway-doc-fetch", "--yes"];
-        readonly skill: "aliway-doc-fetch";
-    };
-    readonly ata: {
-        readonly description: "读取和管理 ATA 内容";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "ata-doc-fetch", "--yes"];
-        readonly skill: "ata-doc-fetch";
-    };
-    readonly code: {
-        readonly description: "读取 code.alibaba-inc.com 代码";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "code-file-fetch", "--yes"];
-        readonly skill: "code-file-fetch";
-    };
-    readonly dingtalk: {
-        readonly description: "读取钉钉文档与表格";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "dingtalk-doc-fetch", "--yes"];
-        readonly skill: "dingtalk-doc-fetch";
-    };
-    readonly figma: {
-        readonly description: "提取 Figma 设计数据与素材";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "figma-design-fetch", "--yes"];
-        readonly skill: "figma-design-fetch";
-    };
-    readonly flyeye: {
-        readonly description: "查询 FlyEye 分布式链路日志";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "flyeye-trace-query", "--yes"];
-        readonly skill: "flyeye-trace-query";
-    };
-    readonly jarvis: {
-        readonly description: "查询和处理 Jarvis 机票退改";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "jarvis-order-operations", "--yes"];
-        readonly skill: "jarvis-order-operations";
-    };
-    readonly loginsight: {
-        readonly description: "分析 LogInsight 全链路日志";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "loginsight-analyze", "--yes"];
-        readonly skill: "loginsight-analyze";
-    };
-    readonly tps: {
-        readonly description: "上传 TPS 图片并获取 CDN 地址";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "tps-image-upload", "--yes"];
-        readonly skill: "tps-image-upload";
-    };
-    readonly yuque: {
-        readonly description: "读取和管理阿里语雀文档";
-        readonly installArgs: readonly ["trip/mearl", "--skill", "yuque-doc-fetch", "--yes"];
-        readonly skill: "yuque-doc-fetch";
-    };
 };
 export type OfficialPluginName = keyof typeof OFFICIAL_PLUGINS;
 export declare function findOfficialPlugin(name: string): OfficialPluginDefinition | undefined;

package/dist/officialPluginCatalog.js

@@ -12,61 +12,6 @@ export const OFFICIAL_PLUGINS = {
         setup: 'alibaba',
         skill: 'tdbank-account',
     },
-    agentforce: {
-        description: '管理 AgentForce 数字员工',
-        installArgs: ['trip/mearl', '--skill', 'agentforce-manage', '--yes'],
-        skill: 'agentforce-manage',
-    },
-    aliway: {
-        description: '读取和管理 Aliway 内容',
-        installArgs: ['trip/mearl', '--skill', 'aliway-doc-fetch', '--yes'],
-        skill: 'aliway-doc-fetch',
-    },
-    ata: {
-        description: '读取和管理 ATA 内容',
-        installArgs: ['trip/mearl', '--skill', 'ata-doc-fetch', '--yes'],
-        skill: 'ata-doc-fetch',
-    },
-    code: {
-        description: '读取 code.alibaba-inc.com 代码',
-        installArgs: ['trip/mearl', '--skill', 'code-file-fetch', '--yes'],
-        skill: 'code-file-fetch',
-    },
-    dingtalk: {
-        description: '读取钉钉文档与表格',
-        installArgs: ['trip/mearl', '--skill', 'dingtalk-doc-fetch', '--yes'],
-        skill: 'dingtalk-doc-fetch',
-    },
-    figma: {
-        description: '提取 Figma 设计数据与素材',
-        installArgs: ['trip/mearl', '--skill', 'figma-design-fetch', '--yes'],
-        skill: 'figma-design-fetch',
-    },
-    flyeye: {
-        description: '查询 FlyEye 分布式链路日志',
-        installArgs: ['trip/mearl', '--skill', 'flyeye-trace-query', '--yes'],
-        skill: 'flyeye-trace-query',
-    },
-    jarvis: {
-        description: '查询和处理 Jarvis 机票退改',
-        installArgs: ['trip/mearl', '--skill', 'jarvis-order-operations', '--yes'],
-        skill: 'jarvis-order-operations',
-    },
-    loginsight: {
-        description: '分析 LogInsight 全链路日志',
-        installArgs: ['trip/mearl', '--skill', 'loginsight-analyze', '--yes'],
-        skill: 'loginsight-analyze',
-    },
-    tps: {
-        description: '上传 TPS 图片并获取 CDN 地址',
-        installArgs: ['trip/mearl', '--skill', 'tps-image-upload', '--yes'],
-        skill: 'tps-image-upload',
-    },
-    yuque: {
-        description: '读取和管理阿里语雀文档',
-        installArgs: ['trip/mearl', '--skill', 'yuque-doc-fetch', '--yes'],
-        skill: 'yuque-doc-fetch',
-    },
 };
 export function findOfficialPlugin(name) {
     return Object.hasOwn(OFFICIAL_PLUGINS, name)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.16.1",
+  "version": "2.16.3",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -59,8 +59,8 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/cloud-types": "2.16.1",
-    "@mearl/provider": "2.16.1"
+    "@mearl/cloud-types": "2.16.3",
+    "@mearl/provider": "2.16.3"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",