@mearl/client 3.0.0-beta.1 → 3.0.0-beta.3

package/README.md

@@ -9,9 +9,9 @@
 ## 安装
 
 ```bash
-npm install @mearl/client
+npm --@mearl:registry=https://registry.npmjs.org install @mearl/client
 # 或
-pnpm add @mearl/client
+pnpm --@mearl:registry=https://registry.npmjs.org add @mearl/client
 ```
 
 ## SDK 使用
@@ -60,7 +60,7 @@ mearl check
 mearl check --local --json
 
 # 更新本地环境
-npx @mearl/setup update --local
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup update --local
 
 # 查看某个 action 的帮助
 mearl <action> --help
@@ -105,7 +105,7 @@ Provider 浏览器与扩展、CDP 浏览器一起出现在 `browser_list` 中，
 全局 `browserId` 参与路由。Provider 的安装、更新和卸载由 `@mearl/setup` 管理：
 
 ```bash
-npx @mearl/setup provider install @example/mearl-provider-device
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup provider install @example/mearl-provider-device
 
 # 查看 Provider 当前版本的能力、参数与使用流程
 mearl example-device --help
@@ -118,8 +118,8 @@ mearl browser_list
 mearl tab_list --browser '<browserId>'
 mearl page_snapshot --payload '{"tabId":12345}' --browser '<browserId>'
 
-npx @mearl/setup provider update brow
-npx @mearl/setup provider uninstall brow
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup provider update brow
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup provider uninstall brow
 ```
 
 `browser_launch` 创建 `pairing` 实例时会直接返回 `pairing.url` 和可选的配对码；Agent 应把 URL 直接渲染为
@@ -165,7 +165,7 @@ Mearl 默认聚合当前机器和已配置 cloud-server 下的浏览器，并通
 client、native-host、cloud-connector 和扩展的最新发布版本。发布版本查询最长等待约 1.5 秒，
 无法访问发布源时会提示无法确认更新，不影响浏览器可用性检查。`--json` 输出机器可读的检查结果，
 与 `--updates` 同用时包含更新状态。发现更新时会提示适用的命令：client/native-host 使用
-`npx @mearl/setup update`，setup 管理的扩展使用 `npx @mearl/setup extension`。
+`npx --@mearl:registry=https://registry.npmjs.org @mearl/setup update`，setup 管理的扩展使用 `npx --@mearl:registry=https://registry.npmjs.org @mearl/setup extension`。
 
 全局安装的 `mearl` CLI 默认在每天首次使用后启动独立后台进程，查询最新发布版本，并比较
 client、native-host、cloud-server 和 MCP server 的已安装版本。发现更新时调用
@@ -190,9 +190,9 @@ client、native-host、cloud-server 和 MCP server 的已安装版本。发现
 安装 skill 并自动注册命令，或直接注册已有入口：
 
 ```bash
-npx @mearl/setup plugin install https://github.com/F-loat/mearl --skill browser-tab-manager --yes
-npx @mearl/setup plugin /absolute/path/to/browser-tab-manager
-npx @mearl/setup plugin uninstall tabs
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup plugin install https://github.com/F-loat/mearl --skill browser-tab-manager --yes
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup plugin /absolute/path/to/browser-tab-manager
+npx --@mearl:registry=https://registry.npmjs.org @mearl/setup plugin uninstall tabs
 mearl tabs summary
 mearl tabs --payload '{"command":"summary","input":{}}'
 mearl tabs --help

package/dist/autoUpdate.js

@@ -223,6 +223,7 @@ export function setupUpdateCommand(version, packageRoot, profiles, updateClient)
         command: 'npx',
         args: [
             '--yes',
+            '--@mearl:registry=https://registry.npmjs.org',
             `@mearl/setup@${version}`,
             'update',
             '--yes',

package/dist/check.js

@@ -414,10 +414,10 @@ export async function runUnifiedCheck(options, dependencies = {}) {
                 details: [
                     ...available.map(update => `${update.component}: ${update.installed} → ${update.latest}`),
                     ...(packageUpdateAvailable
-                        ? ['Update on the affected machine: npx @mearl/setup update']
+                        ? ['Update on the affected machine: npx --@mearl:registry=https://registry.npmjs.org @mearl/setup update']
                         : []),
                     ...(extensionUpdateAvailable
-                        ? ['Update a setup-managed extension: npx @mearl/setup extension']
+                        ? ['Update a setup-managed extension: npx --@mearl:registry=https://registry.npmjs.org @mearl/setup extension']
                         : []),
                     ...(connectorUpdateAvailable
                         ? ['Update cloud-connector with its package manager on the connector machine.']

package/dist/cli.js

@@ -229,7 +229,7 @@ function printProviderHelp(commandName, provider, extensionHelp) {
             lines.push(`  ${mode}（必填：${requiredFields}）`);
         });
     }
-    lines.push('', '发现与检查：', `  ${commandName} browser_list`, `  ${commandName} check --browser <browserId>`, '', '管理：', `  npx @mearl/setup provider update ${provider.providerId}`, `  npx @mearl/setup provider uninstall ${provider.providerId}`);
+    lines.push('', '发现与检查：', `  ${commandName} browser_list`, `  ${commandName} check --browser <browserId>`, '', '管理：', `  npx --@mearl:registry=https://registry.npmjs.org @mearl/setup provider update ${provider.providerId}`, `  npx --@mearl:registry=https://registry.npmjs.org @mearl/setup provider uninstall ${provider.providerId}`);
     if (browserType.configuration) {
         lines.push('', 'Provider 配置（在 Mearl 浏览器管理器中填写）：');
         const configurationRequired = new Set(browserType.configuration.inputSchema.required ?? []);

package/dist/nativeHost.js

@@ -96,7 +96,7 @@ export function inspectNativeHostInstallation(options = {}) {
                 details: [
                     ...details,
                     `Registration: ${manifestPath}`,
-                    'Run `mearl-native-host init` with a working Node.js, then reopen the extension. If the runtime package is missing, run `npx @mearl/setup update --local`.',
+                    'Run `mearl-native-host init` with a working Node.js, then reopen the extension. If the runtime package is missing, run `npx --@mearl:registry=https://registry.npmjs.org @mearl/setup update --local`.',
                 ],
             });
         }

package/dist/plugins/officialPluginInstaller.js

@@ -60,7 +60,7 @@ function appendOutput(current, chunk) {
 function installWithSetup(name) {
     return new Promise((resolve, reject) => {
         const command = process.platform === 'win32' ? 'npx.cmd' : 'npx';
-        const child = spawn(command, ['-y', `@mearl/setup@${CLIENT_VERSION}`, 'plugin', 'ensure', name], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
+        const child = spawn(command, ['-y', '--@mearl:registry=https://registry.npmjs.org', `@mearl/setup@${CLIENT_VERSION}`, 'plugin', 'ensure', name], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
         let stdout = '';
         let stderr = '';
         let settled = false;

package/dist/plugins/sdk/plugin.js

@@ -72,7 +72,7 @@ function missingPluginEntryMessage(entry, pluginName) {
         `插件：${name}`,
         `入口：${entry}`,
         '',
-        `卸载命令：npx @mearl/setup plugin uninstall ${name}`,
+        `卸载命令：npx --@mearl:registry=https://registry.npmjs.org @mearl/setup plugin uninstall ${name}`,
     ].join('\n');
 }
 const registrationRefreshes = new Map();

package/dist/socket.js

@@ -686,7 +686,7 @@ function formatConnectError(error, socketPath) {
     if (error.code === 'ENOENT') {
         return [
             `未找到 Socket: ${socketPath}`,
-            'native host 自动拉起失败。先运行 mearl check --local；缺少命令时运行 npx @mearl/setup --local --yes。',
+            'native host 自动拉起失败。先运行 mearl check --local；缺少命令时运行 npx --@mearl:registry=https://registry.npmjs.org @mearl/setup --local --yes。',
             '自动拉起只使用默认 daemon 参数；自定义 CDP/Profile/浏览器参数需手工启动，参见 mearl-native-host --help。',
             '',
             '【方式一：浏览器插件模式】',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0-beta.3",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -65,11 +65,11 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/daemon-core": "3.0.0-beta.1",
-    "@mearl/cloud-types": "3.0.0-beta.1",
-    "@mearl/provider": "3.0.0-beta.1",
-    "@mearl/agent-runtime": "3.0.0-beta.1",
-    "@mearl/browser-core": "3.0.0-beta.1"
+    "@mearl/daemon-core": "3.0.0-beta.3",
+    "@mearl/cloud-types": "3.0.0-beta.3",
+    "@mearl/provider": "3.0.0-beta.3",
+    "@mearl/agent-runtime": "3.0.0-beta.3",
+    "@mearl/browser-core": "3.0.0-beta.3"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",