@mearl/setup 2.9.0 → 2.9.1

package/README.md

@@ -3,9 +3,9 @@
 Mearl 环境的一次性安装、更新、卸载与配置工具。无需先全局安装 setup：
 
 ```bash
-npx @mearl/setup [install] [--local] [--cloud|--qoder-cloud] [--mcp] [--yes]
-npx @mearl/setup <update|uninstall> [--local] [--cloud|--qoder-cloud] [--mcp] [--yes]
-npx @mearl/setup extension [--force] [--yes]
+npx @mearl/setup [install] [--local] [--cloud|--qoder-cloud] [--mcp]
+npx @mearl/setup <update|uninstall> [--local] [--cloud|--qoder-cloud] [--mcp]
+npx @mearl/setup extension [--full] [--force]
 ```
 
 配置 AgentBay API Key 时只需执行一次下面的命令，然后在隐藏输入提示中粘贴 Key。
@@ -51,6 +51,10 @@ npx @mearl/setup agentbay
   加载；后续更新由 `mearl check --local --json` 确认当前扩展仍来自 setup 管理目录后，直接替换
   文件并通过 Native Host 触发扩展 reload。固定目录和 manifest 中的 `key` 保证扩展 ID
   与浏览器存储保持稳定。
+- `extension --full` 会先安装或更新扩展，再复用 local profile 安装
+  `@mearl/client`、安装并初始化 `@mearl/native-host`，最后安装全局 Mearl Skill。
+  两部分都会尽量执行；任一步失败时命令返回非零退出码，已安装的部分会保留。它不安装
+  cloud 或 MCP 环境。
 - 下载前会通过 CDP 检查同 ID 插件的来源。未安装，或来源为固定目录中的 `UNPACKED`
   插件时可继续；Chrome 商店、企业策略或其他本地目录安装的版本默认保持不变。只有显式
   传入 `--force` 才会接管并替换这些版本。
@@ -61,6 +65,12 @@ npx @mearl/setup agentbay
 npx @mearl/setup extension
 ```
 
+首次使用时可一次安装完整的本地浏览器环境：
+
+```bash
+npx @mearl/setup extension --full
+```
+
 首次安装、旧版 setup 扩展首次迁移，或 Native Host reload 不可用时才需要 CDP。如果
 Chrome 尚未开放 CDP，交互命令会提示打开
 `chrome://inspect/#remote-debugging`、启用远程调试并允许连接，然后等待安装完成。无 TTY
@@ -127,6 +137,9 @@ npx @mearl/setup update
 # 独立安装或更新到最新浏览器扩展
 npx @mearl/setup extension
 
+# 安装完整本地环境（client、Native Host、Skill 和扩展）
+npx @mearl/setup extension --full
+
 # 只卸载本地环境
 npx @mearl/setup uninstall --local
 

package/dist/cli.d.ts

@@ -9,6 +9,7 @@ interface ParsedArgs {
     agentBayReadStdin: boolean;
     cloudMode?: 'websocket' | 'qoder';
     force?: boolean;
+    full?: boolean;
     help: boolean;
     operation?: MearlLifecycleOperation | 'agentbay' | 'extension';
     profiles?: MearlProfile[];

package/dist/cli.js

@@ -80,6 +80,7 @@ export function parseSetupArgs(argv) {
     const extension = new Command('extension')
         .exitOverride()
         .configureOutput({ writeErr: () => { }, writeOut: () => { } })
+        .option('--full')
         .option('--force')
         .option('-y, --yes')
         .option('--non-interactive')
@@ -88,6 +89,7 @@ export function parseSetupArgs(argv) {
         parsed = {
             ...baseParsedArgs(),
             ...(options.force ? { force: true } : {}),
+            ...(options.full ? { full: true } : {}),
             operation: 'extension',
             yes: options.yes === true || options.nonInteractive === true,
         };
@@ -142,14 +144,14 @@ function printHelp(toError = false) {
 Usage:
   npx @mearl/setup [install] [--local] [--cloud|--qoder-cloud] [--mcp] [--yes]
   npx @mearl/setup <update|uninstall> [--local] [--cloud|--qoder-cloud] [--mcp] [--yes]
-  npx @mearl/setup extension [--force] [--yes]
+  npx @mearl/setup extension [--full] [--force] [--yes]
   npx @mearl/setup agentbay [--stdin | --key-file <path>]
 
 Behavior:
   install      Default command; defaults to --local when no environment is specified
   update       Auto-detects installed environments from the current PATH
   uninstall    Auto-detects installed environments and asks for confirmation
-  extension    Download the latest browser extension and install or reload it through CDP
+  extension    Install or update the browser extension; --full also installs the local environment
   agentbay     Save or update AGENTBAY_KEY without changing other Mearl settings
 
 Options:
@@ -163,6 +165,7 @@ Options:
   --target-line <major.minor.x>
                Install the latest packages from one release line, such as 2.3.x
   --skip-skill Keep the independently managed Mearl Skill unchanged
+  --full       Also install @mearl/client, @mearl/native-host, and the Mearl Skill
   --force      Replace an existing store, managed, or other local Mearl extension
   --yes, -y    Run without prompts and accept detected defaults
   --non-interactive
@@ -179,6 +182,7 @@ Examples:
   npx @mearl/setup --local --cloud
   npx @mearl/setup update
   npx @mearl/setup extension
+  npx @mearl/setup extension --full
   npx @mearl/setup agentbay
   npx @mearl/setup --qoder-cloud --yes
   npx @mearl/setup update --local --target-line 2.3.x --skip-skill
@@ -236,6 +240,7 @@ export async function main(argv = process.argv.slice(2), interactiveTerminal = p
             console.error('Non-interactive input detected. Re-run with --yes or --non-interactive.');
             return 2;
         }
+        let extensionInstalled = false;
         try {
             const result = await (dependencies.installBrowserExtension ?? installMearlBrowserExtension)({
                 force: parsed.force,
@@ -248,20 +253,35 @@ export async function main(argv = process.argv.slice(2), interactiveTerminal = p
                     : `Browser extension v${result.version} installed or reloaded through CDP.`);
                 console.error(`Extension ID: ${result.extensionId}`);
                 console.error(`Extension directory: ${result.path}`);
-                return 0;
+                extensionInstalled = true;
+            }
+            else {
+                console.error(result.filesUpdated
+                    ? `Browser extension v${result.version} files were updated, but the extension was not reloaded.`
+                    : `Browser extension v${result.version} was not installed.`);
+                if (result.cdpError)
+                    console.error(`CDP installation pending: ${result.cdpError}`);
+                console.error('Open chrome://inspect/#remote-debugging, enable remote debugging, approve the connection, then rerun: npx @mearl/setup extension');
             }
-            console.error(result.filesUpdated
-                ? `Browser extension v${result.version} files were updated, but the extension was not reloaded.`
-                : `Browser extension v${result.version} was not installed.`);
-            if (result.cdpError)
-                console.error(`CDP installation pending: ${result.cdpError}`);
-            console.error('Open chrome://inspect/#remote-debugging, enable remote debugging, approve the connection, then rerun: npx @mearl/setup extension');
-            return 1;
         }
         catch (error) {
             console.error(error instanceof Error ? error.message : String(error));
-            return 1;
         }
+        if (!parsed.full)
+            return extensionInstalled ? 0 : 1;
+        let localInstalled = false;
+        try {
+            localInstalled = await (dependencies.runLifecycle ?? runMearlLifecycle)({
+                operation: 'install',
+                profiles: ['local'],
+                skipSkill: false,
+                yes: parsed.yes,
+            });
+        }
+        catch (error) {
+            console.error(error instanceof Error ? error.message : String(error));
+        }
+        return extensionInstalled && localInstalled ? 0 : 1;
     }
     if (!interactiveTerminal && !parsed.yes && parsed.operation !== 'update') {
         console.error('Non-interactive input detected. Re-run with --yes or --non-interactive.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/setup",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "description": "One-shot environment setup and configuration for Mearl",
   "type": "module",
   "main": "dist/index.js",
@@ -65,7 +65,7 @@
     "commander": "^15.0.0",
     "extract-zip": "^2.0.1",
     "ws": "^8.18.3",
-    "@mearl/client": "2.9.0"
+    "@mearl/client": "2.9.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",