@mearl/client 2.16.4 → 2.17.0

package/dist/commands.d.ts

@@ -308,8 +308,8 @@ export declare const COMMANDS: readonly [{
         readonly description: "签名使用的 appKey，默认 12574478";
     }, {
         readonly name: "env";
-        readonly type: "\"online\" | \"pre\"";
-        readonly description: "请求环境，默认 online";
+        readonly type: "\"prod\" | \"pre\"";
+        readonly description: "请求环境，默认 prod";
     }, {
         readonly name: "timeout";
         readonly type: "number";
@@ -856,7 +856,7 @@ export declare const COMMANDS: readonly [{
     readonly examples: ["set_device_emulation --payload '{\"enabled\":true,\"preset\":\"iphone-17-pro\"}'", "set_device_emulation --payload '{\"enabled\":true,\"preset\":\"pixel-11\",\"orientation\":\"landscape\"}'", "set_device_emulation --payload '{\"enabled\":true,\"preset\":\"ipad-mini-a17-pro\",\"orientation\":\"landscape\",\"deviceShell\":true,\"splitScreen\":true}'", "set_device_emulation --payload '{\"enabled\":false}'"];
 }, {
     readonly name: "set_app_profile";
-    readonly description: "设置 App 客户端环境与 JSBridge；传 emulation 时由同一个命令联动设备模拟，省略时不改变设备状态";
+    readonly description: "设置 App 客户端环境与 JSBridge；可同时设置 MTop 页面接口环境，传 emulation 时联动设备模拟";
     readonly summary: "设置或清除目标标签页的 App 容器模拟";
     readonly params: [{
         readonly name: "enabled";
@@ -883,6 +883,10 @@ export declare const COMMANDS: readonly [{
         readonly name: "bridgeConfig";
         readonly type: "object";
         readonly description: "声明式覆盖桥方法，形如 {methods:{api:{behavior|response|noop,silent?}}}；不执行配置脚本";
+    }, {
+        readonly name: "mtopEnv";
+        readonly type: "\"default\" | \"prod\" | \"pre\"";
+        readonly description: "可选 MTop 页面接口环境；default 关闭环境改写，省略时保持当前设置。扩展模式全局生效，CDP 模式仅作用于目标 tab";
     }, {
         readonly name: "emulation";
         readonly type: "object";
@@ -897,7 +901,7 @@ export declare const COMMANDS: readonly [{
         readonly required: true;
         readonly description: "目标标签页 ID";
     }];
-    readonly examples: ["set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\"}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\",\"emulation\":{}}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"alipay\",\"emulation\":{\"preset\":\"pixel-11\",\"deviceShell\":true}}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\",\"emulation\":{\"preset\":\"ipad-mini-a17-pro\",\"orientation\":\"landscape\",\"deviceShell\":true,\"splitScreen\":true}}'", "set_app_profile --payload '{\"enabled\":false}'", "set_app_profile --payload '{\"enabled\":false,\"emulation\":{}}'"];
+    readonly examples: ["set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\"}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\",\"mtopEnv\":\"pre\"}'", "set_app_profile --payload '{\"enabled\":false,\"mtopEnv\":\"prod\"}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\",\"emulation\":{}}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"alipay\",\"emulation\":{\"preset\":\"pixel-11\",\"deviceShell\":true}}'", "set_app_profile --payload '{\"enabled\":true,\"profile\":\"fliggy\",\"emulation\":{\"preset\":\"ipad-mini-a17-pro\",\"orientation\":\"landscape\",\"deviceShell\":true,\"splitScreen\":true}}'", "set_app_profile --payload '{\"enabled\":false}'", "set_app_profile --payload '{\"enabled\":false,\"emulation\":{}}'"];
 }, {
     readonly name: "set_timezone";
     readonly description: "覆盖目标 tab 的时区，传空字符串恢复浏览器默认时区";

package/dist/commands.js

@@ -214,7 +214,7 @@ export const COMMANDS = [
             { name: 'version', type: 'string', description: 'API 版本，默认 1.0' },
             { name: 'method', type: 'string', description: 'HTTP 方法，默认 GET' },
             { name: 'appKey', type: 'string', description: '签名使用的 appKey，默认 12574478' },
-            { name: 'env', type: '"online" | "pre"', description: '请求环境，默认 online' },
+            { name: 'env', type: '"prod" | "pre"', description: '请求环境，默认 prod' },
             { name: 'timeout', type: 'number', description: '超时毫秒数，默认 10000' },
         ],
         examples: [
@@ -794,7 +794,7 @@ export const COMMANDS = [
     },
     {
         name: 'set_app_profile',
-        description: '设置 App 客户端环境与 JSBridge；传 emulation 时由同一个命令联动设备模拟，省略时不改变设备状态',
+        description: '设置 App 客户端环境与 JSBridge；可同时设置 MTop 页面接口环境，传 emulation 时联动设备模拟',
         summary: '设置或清除目标标签页的 App 容器模拟',
         params: [
             { name: 'enabled', type: 'boolean', required: true, description: 'true=启用，false=清除' },
@@ -815,6 +815,11 @@ export const COMMANDS = [
                 type: 'object',
                 description: '声明式覆盖桥方法，形如 {methods:{api:{behavior|response|noop,silent?}}}；不执行配置脚本',
             },
+            {
+                name: 'mtopEnv',
+                type: '"default" | "prod" | "pre"',
+                description: '可选 MTop 页面接口环境；default 关闭环境改写，省略时保持当前设置。扩展模式全局生效，CDP 模式仅作用于目标 tab',
+            },
             {
                 name: 'emulation',
                 type: 'object',
@@ -825,6 +830,8 @@ export const COMMANDS = [
         ],
         examples: [
             `set_app_profile --payload '{"enabled":true,"profile":"fliggy"}'`,
+            `set_app_profile --payload '{"enabled":true,"profile":"fliggy","mtopEnv":"pre"}'`,
+            `set_app_profile --payload '{"enabled":false,"mtopEnv":"prod"}'`,
             `set_app_profile --payload '{"enabled":true,"profile":"fliggy","emulation":{}}'`,
             `set_app_profile --payload '{"enabled":true,"profile":"alipay","emulation":{"preset":"pixel-11","deviceShell":true}}'`,
             `set_app_profile --payload '{"enabled":true,"profile":"fliggy","emulation":{"preset":"ipad-mini-a17-pro","orientation":"landscape","deviceShell":true,"splitScreen":true}}'`,

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

@@ -95,13 +95,15 @@ export interface SendRequestParams {
     responseType?: 'json' | 'text' | 'auto';
     timeout?: number;
 }
+export type MtopEnvironmentTarget = 'prod' | 'pre';
+export type MtopEnvironment = 'default' | MtopEnvironmentTarget;
 export interface SendMtopRequestParams {
     api: string;
     data?: unknown;
     version?: string;
     method?: string;
     appKey?: string;
-    env?: string;
+    env?: MtopEnvironmentTarget;
     timeout?: number;
     headers?: Record<string, string>;
     ttid?: string;
@@ -427,6 +429,11 @@ export interface SetAppProfileParams {
     deviceModel?: string;
     /** 按方法覆盖档案内置桥配置，仅支持受控行为、固定 JSON 回包和成功空实现 */
     bridgeConfig?: AppBridgeConfig;
+    /**
+     * 可选 MTop 接口环境。default 关闭环境改写；省略时保持当前设置。
+     * 扩展模式与插件设置页共享并全局生效；CDP 模式仅作用于目标 tab。
+     */
+    mtopEnv?: MtopEnvironment;
     /**
      * 可选设备联动参数。传入时显式字段覆盖档案推荐设备，空对象使用推荐设备且默认开启
      * deviceShell；省略时不设置或清除该 tab 的设备状态。

package/package.json

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