@mearl/client 2.16.0 → 2.16.2

package/README.md

@@ -153,8 +153,11 @@ setup 会补齐缺失或低于自身版本的 client、native-host；安装参
 退出码为 0 表示插件已注册且入口可加载，stdout 返回同目录 `SKILL.md` 的版本，缺少版本元数据时返回 `unknown`。
 未注册、入口丢失或加载失败会以退出码 2 和对应的 `PLUGIN_*` 错误结束。普通业务调用无需预先检查，直接处理同样的错误即可。
 
-插件接受位置参数或包含 command/input 的 `--payload`，两种形式不能混用。JSON 保留业务字段类型；正文等文件输入
-按具体 skill 的字段约定处理。插件不使用上表中内置 action 的 `--payload-file` 入口。
+插件接受位置参数、字符串业务选项或包含 command/input 的 `--payload`。业务选项推荐写成
+`--name=value`，也接受 `--name value`，字段名与 handler 的 input 一致且不依赖位置顺序；同一字段不能同时
+使用位置参数和业务选项，`--payload` 不能与前两种形式混用。JSON 保留业务字段类型；正文等文件输入按具体
+skill 的字段约定处理。`browser`、`timeout`、`output` 等宿主选项保留原有含义；同名业务字段以及数字、
+布尔值、对象和数组通过 `--payload` 传入。插件不使用上表中内置 action 的 `--payload-file` 入口。
 
 注册后的插件也可从 SDK 调用；实例方法 `client.invokePlugin` 复用既有连接和默认浏览器：
 
@@ -168,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`，
@@ -180,8 +183,9 @@ MCP Server 通过固定工具 `mearl_plugin` 接受同样的 `plugin`、`command
 
 需要 BUC 身份的内部 HTTP 接口通过官方 `buc` 插件调用。CLI 使用 `mearl buc request`，业务插件使用
 `app.invoke('buc', { command: 'request', input })`；当前身份和人员资料分别使用 `whoami` 与 `profile`
-子命令。BUC 插件按请求创建一次性凭据，只允许访问 HTTPS `alibaba-inc.com` 域名，过滤认证字段与
-Cookie，并始终在运行 CLI、SDK 或 MCP Server 的机器上执行，不随浏览器或 connector 转发。
+子命令。BUC 插件按请求创建一次性凭据，只接受无 URL 凭据的 HTTPS 地址，过滤认证字段与 Cookie；
+调用方须按已验证的业务契约确认目标服务可信。请求始终在运行 CLI、SDK 或 MCP Server 的机器上执行，
+不随浏览器或 connector 转发。
 `buc request` 支持与 `send_request` 同结构的 `formData` 和 `files`；`files[].filePath` 从该插件执行
 宿主读取，而不是浏览器 native-host，无法引用宿主路径时使用 Base64 内容与 `filename`。
 
@@ -197,7 +201,6 @@ Cookie，并始终在运行 CLI、SDK 或 MCP Server 的机器上执行，不随
 | 组合调用      | `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.d.ts

@@ -17,6 +17,7 @@ export interface ParsedArgs {
     timeoutSec: number;
     timeoutOption?: string;
     pluginArgs?: string[];
+    pluginInput?: Record<string, unknown>;
     help?: boolean;
     version?: boolean;
     verbose?: boolean;

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,9 +66,42 @@ 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([
+    '--browser',
+    '--cdp',
+    '--compact',
+    '--connector',
+    '--help',
+    '--json',
+    '--local',
+    '--output',
+    '--payload',
+    '--payload-file',
+    '--server',
+    '--timeout',
+    '--verbose',
+    '--version',
+]);
+function findPluginInputOptionNames(args) {
+    const names = new Set();
+    for (const argument of args) {
+        if (!argument.startsWith('--') || argument === '--')
+            continue;
+        const equals = argument.indexOf('=');
+        const option = equals === -1 ? argument : argument.slice(0, equals);
+        if (PLUGIN_HOST_OPTIONS.has(option))
+            continue;
+        const name = option.slice(2);
+        if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(name)) {
+            throw new Error(`无效的插件业务选项: ${option}`);
+        }
+        names.add(name);
+    }
+    return [...names];
+}
 function printUsage(commandName, version) {
     const lines = [
         `${commandName} v${version}`,
@@ -122,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));
@@ -355,6 +379,7 @@ function actionInvocationFailed(action, result) {
         : false;
 }
 export function parseClientArgs(args, plugin = false) {
+    const pluginInputOptionNames = plugin ? findPluginInputOptionNames(args) : [];
     const program = new Command()
         .name('mearl')
         .helpOption(false)
@@ -379,6 +404,8 @@ export function parseClientArgs(args, plugin = false) {
             .option('-h, --help')
             .option('-v, --version')
             .option('--verbose');
+    for (const name of pluginInputOptionNames)
+        program.option(`--${name} <value>`);
     try {
         program.parse(['node', 'mearl', ...args]);
     }
@@ -393,6 +420,12 @@ export function parseClientArgs(args, plugin = false) {
     if (plugin && options.payloadFile !== undefined) {
         throw new Error('插件使用 --payload 传入 command 和 input；正文文件可由业务字段引用');
     }
+    const pluginInput = Object.fromEntries(pluginInputOptionNames
+        .filter(name => Object.hasOwn(options, name))
+        .map(name => [name, options[name]]));
+    if (plugin && options.payload !== undefined && Object.keys(pluginInput).length > 0) {
+        throw new Error('插件业务选项不能与 --payload 同时使用');
+    }
     const json = options.json === true;
     if (json && action !== 'check')
         throw new Error('--json 仅适用于 check');
@@ -420,6 +453,7 @@ export function parseClientArgs(args, plugin = false) {
         ...(plugin
             ? {
                 pluginArgs: program.processedArgs[1],
+                ...(Object.keys(pluginInput).length > 0 ? { pluginInput } : {}),
                 help: options.help === true,
                 version: options.version === true,
                 verbose: options.verbose === true,
@@ -471,7 +505,7 @@ async function runPluginCli(args, commandName) {
             console.error(plugin.help(`${commandName} ${parsed.action}`, parsed.pluginArgs?.[0]));
             return 0;
         }
-        const result = await plugin.run(parsed.pluginArgs ?? [], parsed.hasPayload ? parsed.payload : undefined);
+        const result = await plugin.run(parsed.pluginArgs ?? [], parsed.hasPayload ? parsed.payload : undefined, parsed.pluginInput);
         if (result !== undefined) {
             if (parsed.outputPath)
                 writeOutput('', result, parsed.outputPath);

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/dist/plugin.d.ts

@@ -27,13 +27,13 @@ export declare function loadPlugin(entry: string, context: Pick<PluginApp, 'invo
     description: string | undefined;
     version: string | undefined;
     help(namespace: string, name?: string): string;
-    run(positionals: string[], payload?: unknown): Promise<unknown>;
+    run(positionals: string[], payload?: unknown, namedInput?: Record<string, unknown>): Promise<unknown>;
 }>;
 export declare function loadRegisteredPlugin(name: string, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<{
     name: string | undefined;
     description: string | undefined;
     version: string | undefined;
     help(namespace: string, name?: string): string;
-    run(positionals: string[], payload?: unknown): Promise<unknown>;
+    run(positionals: string[], payload?: unknown, namedInput?: Record<string, unknown>): Promise<unknown>;
 }>;
 export declare function invokeRegisteredPlugin(name: string, invocation: PluginInvocation, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<unknown>;

package/dist/plugin.js

@@ -145,21 +145,24 @@ export async function loadPlugin(entry, context, pluginName) {
                 '',
                 '常用选项: --browser --timeout --compact --output',
                 '连接或传输排障运行 mearl check --help。',
-                '插件选项: --verbose; -h, --help; -v, --version',
-                'JSON input 直接传给 handler；业务字段与校验规则见对应 skill。',
+                '插件选项: --name=value 传入字符串业务字段；--verbose; -h, --help; -v, --version',
+                '同名宿主选项及非字符串字段使用 --payload；业务字段与校验规则见对应 skill。',
             ].join('\n');
         },
-        async run(positionals, payload) {
+        async run(positionals, payload, namedInput = {}) {
             if (payload !== undefined && positionals.length > 0) {
                 throw new PluginError('PLUGIN_INVALID_INPUT', '位置参数调用与 --payload 调用不能混用');
             }
+            if (payload !== undefined && Object.keys(namedInput).length > 0) {
+                throw new PluginError('PLUGIN_INVALID_INPUT', '插件业务选项与 --payload 调用不能混用');
+            }
             if (payload !== undefined &&
                 (!isObject(payload) || typeof payload.command !== 'string' || !isObject(payload.input))) {
                 throw new PluginError('PLUGIN_INVALID_INPUT', '--payload 必须为 {"command":"...","input":{...}}');
             }
             const envelope = payload;
             const { command, handler } = find(envelope?.command ?? positionals[0] ?? '');
-            const input = envelope
+            const positionalInput = envelope
                 ? { ...envelope.input }
                 : Object.fromEntries(command.registeredArguments
                     .map((argument, index) => [
@@ -167,6 +170,12 @@ export async function loadPlugin(entry, context, pluginName) {
                     argument.variadic ? positionals.slice(index + 1) : positionals[index + 1],
                 ])
                     .filter(([, value]) => value !== undefined));
+            for (const name of Object.keys(namedInput)) {
+                if (Object.hasOwn(positionalInput, name)) {
+                    throw new PluginError('PLUGIN_INVALID_INPUT', `参数不能重复传入: ${name}`);
+                }
+            }
+            const input = { ...positionalInput, ...namedInput };
             if (!envelope &&
                 !command.registeredArguments.some(argument => argument.variadic) &&
                 positionals.length - 1 > command.registeredArguments.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.16.0",
+  "version": "2.16.2",
   "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.0",
-    "@mearl/provider": "2.16.0"
+    "@mearl/cloud-types": "2.16.2",
+    "@mearl/provider": "2.16.2"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",