@mearl/setup 3.0.0 → 3.0.1

package/README.en.md

@@ -9,17 +9,17 @@ One-time installation, updates, removal, and configuration for Mearl environment
 Run `node --version` before installation to verify Node.js >= 20.18.0.
 
 ```bash
-npx @mearl/setup@3 [install] [--local] [--cloud] [--cloud-mode <id>] [--mcp]
-npx @mearl/setup@3 update [--local] [--cloud] [--cloud-mode <id>] [--mcp]
-npx @mearl/setup@3 uninstall [--local] [--cloud] [--cloud-mode <id>] [--mcp] [--full]
-npx @mearl/setup@3 extension [--full] [--force]
-npx @mearl/setup@3 extension --extract
-npx @mearl/setup@3 plugin [name] <path>
-npx @mearl/setup@3 plugin install <skills add arguments...>
-npx @mearl/setup@3 plugin uninstall <name>
-npx @mearl/setup@3 provider <install|update|uninstall> <package|id>
-npx @mearl/setup@3 profile install <source> [--browser <id-or-name>]
-npx @mearl/setup@3 preset repair [--replace-skill <name> ...]
+npx @mearl/setup [install] [--local] [--cloud] [--cloud-mode <id>] [--mcp]
+npx @mearl/setup update [--local] [--cloud] [--cloud-mode <id>] [--mcp]
+npx @mearl/setup uninstall [--local] [--cloud] [--cloud-mode <id>] [--mcp] [--full]
+npx @mearl/setup extension [--full] [--force]
+npx @mearl/setup extension --extract
+npx @mearl/setup plugin [name] <path>
+npx @mearl/setup plugin install <skills add arguments...>
+npx @mearl/setup plugin uninstall <name>
+npx @mearl/setup provider <install|update|uninstall> <package|id>
+npx @mearl/setup profile install <source> [--browser <id-or-name>]
+npx @mearl/setup preset repair [--replace-skill <name> ...]
 ```
 
 Browser Providers install and evolve independently. After installation, run `mearl <providerId>` to inspect that version's capabilities,
@@ -30,7 +30,7 @@ Install optional cloud protocols through a preset before selecting `--cloud-mode
 ## Install App emulation
 
 ```bash
-npx @mearl/setup@3 profile install mearlhq/wechat-profile
+npx @mearl/setup profile install mearlhq/wechat-profile
 ```
 
 The source can be a public GitHub `owner/repo`, `owner/repo@ref`, or a full HTTPS bundle manifest URL. GitHub sources load the root `bundle.json` from the resolved commit. The command installs every App emulation configuration declared by that bundle and preserves the active Preset. When multiple local extensions are connected, select a target with `--browser`. Confirm source access in the extension if prompted.
@@ -42,11 +42,11 @@ In the extension's quick settings, open the App selector and choose **Add App em
 Install a Skill and register its CLI, SDK, and MCP capabilities with one command:
 
 ```bash
-npx @mearl/setup@3 plugin install https://github.com/mearlhq/mearl --skill browser-tab-manager --yes
+npx @mearl/setup plugin install https://github.com/mearlhq/mearl --skill browser-tab-manager --yes
 mearl tabs summary
 ```
 
-Installation arguments pass to a pinned public Skills CLI (currently skills@1.5.0, compatible with the project's minimum Node version) using the global shared directory. Both default symlink and copy modes support registration. Copy mode uses list --global --json to confirm the canonical path for this successful install, without guessing directories or scanning other Skills. Set MEARL_SKILLS_PATH for a custom CLI. Arguments reject the -- separator, which would truncate trailing options.
+Installation arguments pass to the public Skills CLI using the global shared directory. By default, `npx` resolves `skills` for the current Node.js version. Both default symlink and copy modes support registration. Copy mode uses list --global --json to confirm the canonical path for this successful install, without guessing directories or scanning other Skills. Set MEARL_SKILLS_PATH for a custom CLI. Arguments reject the -- separator, which would truncate trailing options.
 
 The installation host's local plugin catalog determines preset-managed capabilities. install/update maintains managed registrations and preserves user registrations. Removing the last dependent environment removes managed plugins and the Mearl Skill; other dependent environments retain them. Configuration preparation, host synchronization, and actual status share the [installation contract](../../docs/preset-installation.en.md).
 
@@ -55,7 +55,7 @@ New registrations created by Native preset batches are setup-managed and retain
 GUI and CLI share the preset installer and override rules. If a saved installation is incomplete, `preset repair` retries accepted local resources without redownloading the preset or implicitly replacing conflicting sources. Explicit repeated `--replace-skill` authorizes replacing those Skills' sources or same-name plugin registrations for this invocation:
 
 ```bash
-npx @mearl/setup@3 preset repair --replace-skill example-skill --replace-skill another-skill
+npx @mearl/setup preset repair --replace-skill example-skill --replace-skill another-skill
 ```
 
 Already installed Skills receive registration repair only; source conflicts reinstall. Unlisted conflicts still block installation, and undeclared tool names or changed installation identities are rejected. Replacement authorization does not persist into later repairs or automatic updates. Missing browser permissions still require extension authorization. Output uses preset JSON: ready exits `0`, pending components `3`, installation failure `1`, and invalid arguments `2`.
@@ -67,8 +67,8 @@ Reinstallation refreshes same-name bindings. JavaScript entries must default-exp
 Register a Skill distributed elsewhere or a custom entry directly by path:
 
 ```bash
-npx @mearl/setup@3 plugin /absolute/path/to/browser-tab-manager
-npx @mearl/setup@3 plugin custom ./skills/custom/entry.mjs
+npx @mearl/setup plugin /absolute/path/to/browser-tab-manager
+npx @mearl/setup plugin custom ./skills/custom/entry.mjs
 ```
 
 path accepts a directory or file. Directories default to `scripts/main.mjs` or `scripts/main.py`; relative paths resolve against the calling working directory. Plugin names prefer explicit name, then entry `name` metadata, then the Skill directory name. Normal registration needs only path; explicit name is for overrides or older entries. Python requires `python3 >= 3.9`; `MEARL_PYTHON` selects an interpreter. setup validates loading but does not install Python or run `pip install`.
@@ -83,7 +83,7 @@ After registration, run `mearl <name> --help` anywhere, use SDK `invokePlugin`,
 To remove a plugin:
 
 ```bash
-npx @mearl/setup@3 plugin uninstall tabs
+npx @mearl/setup plugin uninstall tabs
 ```
 
 For entries under `~/.agents/skills/<skill>/`, setup first runs
@@ -99,9 +99,9 @@ for global package lifecycle and reads `package.json#mearl.provider` to register
 browser type name, and form arguments:
 
 ```bash
-npx @mearl/setup@3 provider install @example/mearl-provider-device
-npx @mearl/setup@3 provider update example-device
-npx @mearl/setup@3 provider uninstall example-device
+npx @mearl/setup provider install @example/mearl-provider-device
+npx @mearl/setup provider update example-device
+npx @mearl/setup provider uninstall example-device
 ```
 
 Install accepts package names, versions, and dist-tags; update/remove accept providerId or full package name. Core @mearl packages always use public npm; other scopes follow caller package-manager settings. Installation uses the package manager launching setup;
@@ -112,8 +112,8 @@ Registration clears only after successful package removal, allowing retries.
 ## Behavior
 
 - Mearl-owned npm packages install and update from `https://registry.npmjs.org/`, matching version queries. Third-party packages use current manager registry settings.
-- `install` is optional: `npx @mearl/setup@3` equals `npx @mearl/setup@3 install`.
-  An initial option also implies installation, such as `npx @mearl/setup@3 --cloud --yes`.
+- `install` is optional: `npx @mearl/setup` equals `npx @mearl/setup install`.
+  An initial option also implies installation, such as `npx @mearl/setup --cloud --yes`.
 - `install` defaults to `--local` when no environment is specified.
 - `-h` / `--help` shows help; `-v` / `--version` shows setup's version.
 - Without environment flags, `update` and `uninstall` detect
@@ -159,17 +159,17 @@ Registration clears only after successful package removal, allowing retries.
 
 ## Install or update the browser extension
 
-For first use, run `npx @mearl/setup@3` and load the matching release ZIP. You can also use the Chrome Web Store when it offers the matching version. [Installation steps](../../README.en.md#install-locally)
+For first use, run `npx @mearl/setup` and load the matching release ZIP. You can also use the Chrome Web Store when it offers the matching version. [Installation steps](../../README.en.md#install-locally)
 
 Use this command to let setup manage the extension.
 
 ```bash
-npx @mearl/setup@3 extension
+npx @mearl/setup extension
 ```
 
 Add `--full` to also install the local CLI, Native Host, and Skill in the same run.
 
-To load the extension manually, run `npx @mearl/setup@3 extension --extract`. Setup downloads the release ZIP,
+To load the extension manually, run `npx @mearl/setup extension --extract`. Setup downloads the release ZIP,
 unpacks it into a new directory under `~/.mearl/extension-downloads/`, and prints the full path. Open
 `chrome://extensions/`, enable **Developer mode**, click **Load unpacked**, and select that directory.
 Keep the directory while Chrome uses the extension. This works with Chrome closed and with remote debugging disabled.
@@ -177,7 +177,7 @@ Keep the directory while Chrome uses the extension. This works with Chrome close
 Automatic installation uses CDP for first installation, initial migration of older setup extensions, or unavailable Native Host reload. If
 Chrome has not enabled CDP, interactive setup prompts you to open
 `chrome://inspect/#remote-debugging`, enable remote debugging, and allow the connection, then waits for installation. Human-facing
-instructions should omit `--yes`. Without a TTY, use `npx @mearl/setup@3 extension --yes`: it tries
+instructions should omit `--yes`. Without a TTY, use `npx @mearl/setup extension --yes`: it tries
 once and stops immediately if CDP is unavailable. If setup ownership cannot be confirmed and CDP is unavailable, it does not download or modify
 the extension directory. Enable CDP and rerun the same command. If Chrome lacks required extension-installation CDP methods,
 the command stops and asks for a Chrome upgrade.
@@ -207,7 +207,7 @@ starts the new version. Success requires both local CLI versions to match and be
 
 Automatic updates never downgrade a newer Host or modify cloud, MCP, or independently installed Mearl Skills.
 If the npm version is unpublished, the network unavailable, or updating fails, the old Host keeps running. The next extension background
-lifecycle may retry; manual updates use `npx @mearl/setup@3 update --local`.
+lifecycle may retry; manual updates use `npx @mearl/setup update --local`.
 
 ## Human and Agent use
 
@@ -222,41 +222,41 @@ lifecycle may retry; manual updates use `npx @mearl/setup@3 update --local`.
 
 ```bash
 # Default local browser environment installation
-npx @mearl/setup@3
+npx @mearl/setup
 
 # Equivalent to the previous command
-npx @mearl/setup@3 install
+npx @mearl/setup install
 
 # Noninteractive Agent / CI installation
-npx @mearl/setup@3 --yes
+npx @mearl/setup --yes
 
 # Install the cloud Agent environment
-npx @mearl/setup@3 --cloud
+npx @mearl/setup --cloud
 
 # Use one machine as both a local browser host and cloud Agent
-npx @mearl/setup@3 --local --cloud
+npx @mearl/setup --local --cloud
 
 # Update all detected Mearl environments in the current PATH
-npx @mearl/setup@3 update
+npx @mearl/setup update
 
 # Independently install or update the latest browser extension
-npx @mearl/setup@3 extension
+npx @mearl/setup extension
 
 # Complete local environment: client, Native Host, Skill, and extension
-npx @mearl/setup@3 extension --full
+npx @mearl/setup extension --full
 
 # Remove only the local environment
-npx @mearl/setup@3 uninstall --local
+npx @mearl/setup uninstall --local
 
 # Detect and uninstall without interaction
-npx @mearl/setup@3 uninstall --yes
+npx @mearl/setup uninstall --yes
 
 # Uninstall environments and all CLI plugins and Providers
-npx @mearl/setup@3 uninstall --full
+npx @mearl/setup uninstall --full
 
 # Install an optional browser Provider
-npx @mearl/setup@3 provider install @example/mearl-provider-device
-npx @mearl/setup@3 provider install @example/mearl-provider-cloud
+npx @mearl/setup provider install @example/mearl-provider-device
+npx @mearl/setup provider install @example/mearl-provider-cloud
 ```
 
 Existing npm/npx installation methods and CLIs for Mearl environment packages remain available; setup is the unified convenience entry.
@@ -273,4 +273,4 @@ The default directory is the public site's `installation.json`; override with HT
 
 Explicit setup first reuses the local preset. Without one, after runtime initialization and before Skill installation, it adopts the connected browser's trusted preset. Explicit `--preset <source>` wins. Differing browser selections, untrusted sources, or failed state reads require an explicit choice. First connection waits about one minute; closed browsers receive only the base environment and retry guidance. Ordinary connections and background core updates do not install an initial local preset.
 
-Distributions can set local-process `MEARL_SETUP_DEFAULT_PRESET` to a default manifest source. It applies only when neither side has a selection. Plugin, Provider, removal, and other subcommands keep their behavior. The public installer still owns installation and status verification.
+Distributions can set local-process `MEARL_SETUP_DEFAULT_PRESET` to a default manifest source. It applies only when neither side has a selection. Plugin, Provider, removal, and other subcommands keep their behavior. Setup performs installation and verifies its status.

package/README.md

@@ -9,17 +9,17 @@ Mearl 环境的一次性安装、更新、卸载与配置工具。无需先全
 安装前用 `node --version` 确认 Node.js >= 20.18.0。
 
 ```bash
-npx @mearl/setup@3 [install] [--local] [--cloud] [--cloud-mode <id>] [--mcp]
-npx @mearl/setup@3 update [--local] [--cloud] [--cloud-mode <id>] [--mcp]
-npx @mearl/setup@3 uninstall [--local] [--cloud] [--cloud-mode <id>] [--mcp] [--full]
-npx @mearl/setup@3 extension [--full] [--force]
-npx @mearl/setup@3 extension --extract
-npx @mearl/setup@3 plugin [name] <path>
-npx @mearl/setup@3 plugin install <skills add 参数...>
-npx @mearl/setup@3 plugin uninstall <name>
-npx @mearl/setup@3 provider <install|update|uninstall> <package|id>
-npx @mearl/setup@3 profile install <来源> [--browser <标识或名称>]
-npx @mearl/setup@3 preset repair [--replace-skill <name> ...]
+npx @mearl/setup [install] [--local] [--cloud] [--cloud-mode <id>] [--mcp]
+npx @mearl/setup update [--local] [--cloud] [--cloud-mode <id>] [--mcp]
+npx @mearl/setup uninstall [--local] [--cloud] [--cloud-mode <id>] [--mcp] [--full]
+npx @mearl/setup extension [--full] [--force]
+npx @mearl/setup extension --extract
+npx @mearl/setup plugin [name] <path>
+npx @mearl/setup plugin install <skills add 参数...>
+npx @mearl/setup plugin uninstall <name>
+npx @mearl/setup provider <install|update|uninstall> <package|id>
+npx @mearl/setup profile install <来源> [--browser <标识或名称>]
+npx @mearl/setup preset repair [--replace-skill <name> ...]
 ```
 
 浏览器 Provider 独立安装和演进。安装后运行 `mearl <providerId>` 查看该版本声明的能力、
@@ -30,7 +30,7 @@ npx @mearl/setup@3 preset repair [--replace-skill <name> ...]
 ## 安装端模拟
 
 ```bash
-npx @mearl/setup@3 profile install mearlhq/wechat-profile
+npx @mearl/setup profile install mearlhq/wechat-profile
 ```
 
 来源支持公开 GitHub 仓库的 `owner/repo`、`owner/repo@ref`，或能力包清单的完整 HTTPS 地址。GitHub 来源从解析后的提交读取根目录 `bundle.json`。命令安装能力包声明的全部端模拟配置，保留当前 Preset。有多个本地扩展连接时，用 `--browser` 选择目标。若扩展提示授权，请确认来源。
@@ -42,11 +42,11 @@ npx @mearl/setup@3 profile install mearlhq/wechat-profile
 一个命令安装 skill 并注册它的 CLI、SDK 和 MCP 能力：
 
 ```bash
-npx @mearl/setup@3 plugin install https://github.com/mearlhq/mearl --skill browser-tab-manager --yes
+npx @mearl/setup plugin install https://github.com/mearlhq/mearl --skill browser-tab-manager --yes
 mearl tabs summary
 ```
 
-安装参数传给固定版本的公共 Skills CLI（当前 skills@1.5.0，兼容项目的 Node 最低版本），使用全局共享目录。公共 CLI 的默认 symlink 和复制模式都可注册；复制模式通过 list --global --json 确认本次成功结果对应的 canonical path，不猜测目录，也不扫描其他 Skills。自定义 CLI 可通过 MEARL_SKILLS_PATH 指定。参数不接受截断后置选项的 -- 分隔符。
+安装参数传给公共 Skills CLI，使用全局共享目录。默认由 `npx` 按当前 Node.js 版本解析 `skills`。公共 CLI 的默认 symlink 和复制模式都可注册；复制模式通过 list --global --json 确认本次成功结果对应的 canonical path，不猜测目录，也不扫描其他 Skills。自定义 CLI 可通过 MEARL_SKILLS_PATH 指定。参数不接受截断后置选项的 -- 分隔符。
 
 安装宿主提供的本地插件目录决定哪些能力由 preset 管理。install/update 维护目录中的托管注册，保留用户自行注册的插件。卸载最后一个依赖环境时移除托管插件与 Mearl Skill；其他环境需要时保留。配置准备、宿主同步和实际安装状态共用 [安装合同](../../docs/preset-installation.md)。
 
@@ -55,7 +55,7 @@ Native preset 批次新建的插件注册使用 setup 托管归属，后续通
 GUI 和 CLI 使用同一套 preset 安装器及覆盖规则。已保存的安装尚未完成时，运行 `preset repair` 从接受的本地资源重试，不重新下载 preset，也不隐式覆盖冲突来源。显式重复指定 `--replace-skill` 即授权本次替换这些 Skill 的来源或同名旧插件注册：
 
 ```bash
-npx @mearl/setup@3 preset repair --replace-skill example-skill --replace-skill another-skill
+npx @mearl/setup preset repair --replace-skill example-skill --replace-skill another-skill
 ```
 
 已安装的 Skill 仅修复注册；来源冲突项重新安装。未列出的冲突仍会阻止安装，声明外的工具名与变更后的安装身份也会被拒绝。覆盖授权不会保留到后续普通修复或自动更新。缺少浏览器权限时仍需在扩展中授权。输出沿用 preset JSON，已就绪退出 `0`、仍有待完成项退出 `3`、安装失败退出 `1`，无效参数退出 `2`。
@@ -67,8 +67,8 @@ npx @mearl/setup@3 preset repair --replace-skill example-skill --replace-skill a
 已通过其他渠道分发的 skill 或自定义入口，可以直接传入路径注册：
 
 ```bash
-npx @mearl/setup@3 plugin /absolute/path/to/browser-tab-manager
-npx @mearl/setup@3 plugin custom ./skills/custom/entry.mjs
+npx @mearl/setup plugin /absolute/path/to/browser-tab-manager
+npx @mearl/setup plugin custom ./skills/custom/entry.mjs
 ```
 
 path 接受目录或具体文件；目录默认读取 `scripts/main.mjs` 或 `scripts/main.py`，相对路径基于调用工作目录解析。插件名优先使用显式 name，其次读取入口的 `name` metadata，最后回退到 Skill 目录名；常规注册只传 path，显式 name 仅用于覆盖或兼容旧入口。Python 插件要求 `python3 >= 3.9`，可通过 `MEARL_PYTHON` 指定解释器路径；setup 只验证入口可加载，不安装 Python，也不执行 `pip install`。
@@ -83,7 +83,7 @@ JavaScript 插件可导出 `setup({ runCommand })`，在注册前准备 Skill
 不再需要插件时执行：
 
 ```bash
-npx @mearl/setup@3 plugin uninstall tabs
+npx @mearl/setup plugin uninstall tabs
 ```
 
 若入口位于 `~/.agents/skills/<skill>/`，setup 会先执行
@@ -99,9 +99,9 @@ Provider 由 npm 包分发，但包本身无需暴露 CLI 或安装脚本。setu
 可创建的浏览器类型名称及其表单参数：
 
 ```bash
-npx @mearl/setup@3 provider install @example/mearl-provider-device
-npx @mearl/setup@3 provider update example-device
-npx @mearl/setup@3 provider uninstall example-device
+npx @mearl/setup provider install @example/mearl-provider-device
+npx @mearl/setup provider update example-device
+npx @mearl/setup provider uninstall example-device
 ```
 
 安装参数接受包名、版本或 dist-tag；更新和卸载可使用 providerId 或完整包名。核心 @mearl 包固定使用公共 npm registry；其余 scope 沿用调用方的包管理器配置。安装沿用启动 setup 的包管理器，
@@ -112,8 +112,8 @@ npx @mearl/setup@3 provider uninstall example-device
 ## 行为
 
 - Mearl 自有 npm 包的安装和更新固定使用 `https://registry.npmjs.org/`，与最新版本查询使用同一来源；第三方包沿用当前包管理器的源配置。
-- `install` 可以省略；直接执行 `npx @mearl/setup@3` 等同于 `npx @mearl/setup@3 install`。
-  以选项开头时也默认安装，例如 `npx @mearl/setup@3 --cloud --yes`。
+- `install` 可以省略；直接执行 `npx @mearl/setup` 等同于 `npx @mearl/setup install`。
+  以选项开头时也默认安装，例如 `npx @mearl/setup --cloud --yes`。
 - `install` 未指定环境时默认 `--local`。
 - `-h` / `--help` 显示帮助，`-v` / `--version` 显示 setup 版本。
 - `update` 和 `uninstall` 未指定环境时，从当前 `PATH` 中的
@@ -159,17 +159,17 @@ npx @mearl/setup@3 provider uninstall example-device
 
 ## 安装或更新浏览器扩展
 
-首次使用时，先运行 `npx @mearl/setup@3`，再加载同版的离线 ZIP。商店提供同版扩展时，也可以直接安装。[安装步骤](../../README.md#安装本机环境)
+首次使用时，先运行 `npx @mearl/setup`，再加载同版的离线 ZIP。商店提供同版扩展时，也可以直接安装。[安装步骤](../../README.md#安装本机环境)
 
 如需由 setup 管理扩展，运行下面的命令。
 
 ```bash
-npx @mearl/setup@3 extension
+npx @mearl/setup extension
 ```
 
 加上 `--full` 可以在同一次运行中安装本机 CLI、Native Host 和 Skill。
 
-需要手动导入时，运行 `npx @mearl/setup@3 extension --extract`。setup 会下载发行 ZIP，
+需要手动导入时，运行 `npx @mearl/setup extension --extract`。setup 会下载发行 ZIP，
 在 `~/.mearl/extension-downloads/` 下创建新目录并解压，然后打印完整路径。打开
 `chrome://extensions/`，启用**开发者模式**，点击**加载已解压的扩展程序**并选择该目录。
 Chrome 使用扩展期间请保留目录。Chrome 关闭或远程调试关闭时也可以下载。
@@ -177,7 +177,7 @@ Chrome 使用扩展期间请保留目录。Chrome 关闭或远程调试关闭时
 自动安装在首次安装、旧版 setup 扩展首次迁移，或 Native Host reload 不可用时使用 CDP。如果
 Chrome 尚未开放 CDP，交互命令会提示打开
 `chrome://inspect/#remote-debugging`、启用远程调试并允许连接，然后等待安装完成。面向人的
-安装指引不要添加 `--yes`。无 TTY 环境使用 `npx @mearl/setup@3 extension --yes`；它只尝试
+安装指引不要添加 `--yes`。无 TTY 环境使用 `npx @mearl/setup extension --yes`；它只尝试
 一次，CDP 不可用时立即中断。无法确认 setup 管理来源且 CDP 不可用时不会下载或修改插件
 目录，打开 CDP 后重新执行同一命令即可。Chrome 版本过低、缺少扩展安装所需的 CDP 方法时，
 命令会中断并提示升级 Chrome。
@@ -207,7 +207,7 @@ DevTools 面板的设置按钮会显示红点，快捷设置中提供“立即
 
 自动更新不会降级较新的 Host，也不会改动 cloud、MCP 或独立安装的 Mearl Skill。
 目标 npm 版本尚未发布、网络不可用或更新失败时，旧 Host 会继续运行；下一次扩展后台
-生命周期可重新尝试，也可手动执行 `npx @mearl/setup@3 update --local`。
+生命周期可重新尝试，也可手动执行 `npx @mearl/setup update --local`。
 
 ## 人工与 Agent 使用
 
@@ -222,41 +222,41 @@ DevTools 面板的设置按钮会显示红点，快捷设置中提供“立即
 
 ```bash
 # 默认安装本地浏览器环境
-npx @mearl/setup@3
+npx @mearl/setup
 
 # 与上一条等价
-npx @mearl/setup@3 install
+npx @mearl/setup install
 
 # Agent / CI 无交互安装
-npx @mearl/setup@3 --yes
+npx @mearl/setup --yes
 
 # 安装云端 Agent 环境
-npx @mearl/setup@3 --cloud
+npx @mearl/setup --cloud
 
 # 同一台机器同时作为本地浏览器宿主和云端 Agent
-npx @mearl/setup@3 --local --cloud
+npx @mearl/setup --local --cloud
 
 # 自动更新当前 PATH 中检测到的全部 Mearl 环境
-npx @mearl/setup@3 update
+npx @mearl/setup update
 
 # 独立安装或更新到最新浏览器扩展
-npx @mearl/setup@3 extension
+npx @mearl/setup extension
 
 # 安装完整本地环境（client、Native Host、Skill 和扩展）
-npx @mearl/setup@3 extension --full
+npx @mearl/setup extension --full
 
 # 只卸载本地环境
-npx @mearl/setup@3 uninstall --local
+npx @mearl/setup uninstall --local
 
 # 自动检测并无交互卸载
-npx @mearl/setup@3 uninstall --yes
+npx @mearl/setup uninstall --yes
 
 # 卸载环境，并清理全部 CLI 插件与 Provider
-npx @mearl/setup@3 uninstall --full
+npx @mearl/setup uninstall --full
 
 # 安装可选浏览器 Provider
-npx @mearl/setup@3 provider install @example/mearl-provider-device
-npx @mearl/setup@3 provider install @example/mearl-provider-cloud
+npx @mearl/setup provider install @example/mearl-provider-device
+npx @mearl/setup provider install @example/mearl-provider-cloud
 ```
 
 原有 Mearl 环境包的 npm/npx 安装方式和 CLI 保持可用；setup 是统一的便利入口。
@@ -273,4 +273,4 @@ install/update 在替换包前保存选中 Preset 的确切资源和期望选择
 
 主动执行 setup 时，先沿用本机已选 preset；本机未选择时，在运行时初始化后、安装 Skill 前采用已连接浏览器的受信 preset。显式 `--preset <source>` 优先。多个浏览器的选择不同、来源不受信或状态读取失败时要求显式选择。首次连接最多等待约一分钟；浏览器关闭时只安装基础环境并说明重试方式。普通连接和后台核心更新不会自动安装首次本机 preset。
 
-发行包可设置本机进程环境变量 `MEARL_SETUP_DEFAULT_PRESET` 提供默认清单来源；默认值仅在两端均无选择时生效，插件、Provider、卸载等子命令保持原行为。安装与状态核验仍由公共安装器负责。
+发行包可设置本机进程环境变量 `MEARL_SETUP_DEFAULT_PRESET` 提供默认清单来源；默认值仅在两端均无选择时生效，插件、Provider、卸载等子命令保持原行为。安装与状态核验仍由安装器负责。

package/dist/skills.d.ts

@@ -2,7 +2,7 @@ import { inspectGlobalSkill } from './skillSources.js';
 import type { PluginCatalogSelection } from '@mearl/client/plugin';
 import type { ResolvedComponent } from '@mearl/preset';
 import { type CommandRunner, type CommandResult, type RunCommandOptions } from '@mearl/daemon-core';
-export declare const SKILLS_CLI_PACKAGE = "skills@1.5.0";
+export declare const SKILLS_CLI_PACKAGE = "skills";
 export declare const MEARL_SKILL_SOURCE: string;
 export interface ResolveSkillsOptions {
     env?: NodeJS.ProcessEnv;

package/dist/skills.js

@@ -5,7 +5,7 @@ import { NodeCapabilityRegistry } from '@mearl/daemon-core/capabilities';
 import { inspectGlobalSkill, readTrackedSkillSources } from './skillSources.js';
 import { PresetInstallationStore } from './presetStore.js';
 import { findExecutable, isExecutable, npmExecEnvironment, prependCommandPath, prependNodePath, runCommand, } from '@mearl/daemon-core';
-export const SKILLS_CLI_PACKAGE = 'skills@1.5.0';
+export const SKILLS_CLI_PACKAGE = 'skills';
 export const MEARL_SKILL_SOURCE = SETUP_VERSION.includes('-beta.')
     ? `https://github.com/mearlhq/mearl/tree/v${SETUP_VERSION}`
     : 'https://github.com/mearlhq/mearl';
@@ -40,7 +40,7 @@ export function resolveSkillsInvocation(options = {}) {
         return null;
     return {
         command: npx,
-        argsPrefix: ['-y', SKILLS_CLI_PACKAGE],
+        argsPrefix: ['-y', `--package=${SKILLS_CLI_PACKAGE}`, '--', 'skills'],
         env: npmExecEnvironment(prependNodePath(prependCommandPath(npx, env), processExecPath)),
     };
 }
@@ -49,37 +49,81 @@ export async function captureSkillsCli(options = {}) {
     const env = options.env ?? process.env;
     const runner = options.runCommand ?? runCommand;
     const directory = env.MEARL_CAPABILITY_DIR || path.join(homedir(), '.mearl', 'capabilities');
-    const current = await new PresetInstallationStore({ directory }).current({ verifyResources: false });
+    const current = await new PresetInstallationStore({ directory }).current({
+        verifyResources: false,
+    });
     const registry = new NodeCapabilityRegistry({ env: Object.freeze({ ...env }), runCommand: runner }, directory, { hooks: ['skills.manager'] });
     await registry.refresh();
-    if (current.activation?.revision !== registry.revision || current.activation?.installationRevision !== registry.installationRevision)
+    if (current.activation?.revision !== registry.revision ||
+        current.activation?.installationRevision !== registry.installationRevision)
         throw new Error('SKILL_MANAGER_CHANGED');
     const readSources = (scope, cwd) => readTrackedSkillSources(scope, cwd, { env });
-    const selection = current.rawHash ? { path: path.resolve(directory, 'active-node.json'), sha256: current.rawHash } : undefined;
+    const selection = current.rawHash
+        ? { path: path.resolve(directory, 'active-node.json'), sha256: current.rawHash }
+        : undefined;
     const managedSkills = Object.fromEntries(Object.entries(current.preset?.skills ?? {}).filter(([, entry]) => entry.enabled !== false));
     const backend = registry.get('skills.manager')?.();
     if (backend !== undefined) {
         if (backend?.readSources !== undefined && typeof backend.readSources !== 'function')
             throw new Error('Invalid Skill source reader');
-        if (!backend || typeof backend.id !== 'string' || !/^[a-z][a-z0-9-]{0,63}$/.test(backend.id) || typeof backend.cli !== 'function')
+        if (!backend ||
+            typeof backend.id !== 'string' ||
+            !/^[a-z][a-z0-9-]{0,63}$/.test(backend.id) ||
+            typeof backend.cli !== 'function')
             throw new Error('The selected Skill manager requires a preset update for CLI operations');
-        return { id: backend.id, managedSkills, selection, inspectGlobal: (source, name, version, inspection) => inspectGlobalSkill(source, name, version, { migrateFrom: inspection?.migrateFrom, externalManager: true, normalizeSource: backend.normalizeSource, readSources: backend.readSources ?? readSources }), run: async (args, settings) => {
+        return {
+            id: backend.id,
+            managedSkills,
+            selection,
+            inspectGlobal: (source, name, version, inspection) => inspectGlobalSkill(source, name, version, {
+                migrateFrom: inspection?.migrateFrom,
+                externalManager: true,
+                normalizeSource: backend.normalizeSource,
+                readSources: backend.readSources ?? readSources,
+            }),
+            run: async (args, settings) => {
                 const result = await backend.cli([...args], settings);
-                if (!result || !Number.isInteger(result.code) || typeof result.stdout !== 'string' || typeof result.stderr !== 'string')
+                if (!result ||
+                    !Number.isInteger(result.code) ||
+                    typeof result.stdout !== 'string' ||
+                    typeof result.stderr !== 'string')
                     throw new Error('Invalid Skill manager CLI result');
                 return result;
-            } };
+            },
+        };
     }
     const invocation = resolveSkillsInvocation(options);
     if (!invocation)
         return undefined;
-    return { id: 'skills', managedSkills, selection, inspectGlobal: (source, name, version, inspection) => inspectGlobalSkill(source, name, version, { migrateFrom: inspection?.migrateFrom, readSources }), run: (args, settings) => runner(invocation.command, [...invocation.argsPrefix, ...args], { ...settings, env: invocation.env }) };
+    return {
+        id: 'skills',
+        managedSkills,
+        selection,
+        inspectGlobal: (source, name, version, inspection) => inspectGlobalSkill(source, name, version, {
+            migrateFrom: inspection?.migrateFrom,
+            readSources,
+        }),
+        run: (args, settings) => runner(invocation.command, [...invocation.argsPrefix, ...args], {
+            ...settings,
+            env: invocation.env,
+        }),
+    };
 }
 export function parseInstalledSkills(output) {
     const value = JSON.parse(stripAnsi(output).trim());
-    if (!Array.isArray(value) || value.some(item => !item || typeof item.name !== 'string' || typeof item.path !== 'string' || !['global', 'project'].includes(item.scope)))
+    if (!Array.isArray(value))
         throw new Error('Skills returned an invalid skill list');
-    return value;
+    const installed = [];
+    for (const item of value) {
+        if (!item || typeof item.name !== 'string' || !['global', 'project'].includes(item.scope))
+            throw new Error('Skills returned an invalid skill list');
+        if (item.status === 'missing' && item.path === null)
+            continue;
+        if (typeof item.path !== 'string')
+            throw new Error('Skills returned an invalid skill list');
+        installed.push(item);
+    }
+    return installed;
 }
 export function parseGlobalMearlSkillPaths(output) {
     const parsed = parseInstalledSkills(output);
@@ -201,12 +245,14 @@ export async function runGlobalMearlSkillOperation(operation, options = {}) {
 ${result.stderr}`).trim();
     if (detail)
         writeLine(detail);
-    if (/Failed to (?:update|remove)\s+[1-9]\d*\s+skills?/i.test(detail) || (operation === 'update' && !/\bInstalled [1-9]\d* skills?\b/.test(detail))) {
+    if (/Failed to (?:update|remove)\s+[1-9]\d*\s+skills?/i.test(detail) ||
+        (operation === 'update' && !/\bInstalled [1-9]\d* skills?\b/.test(detail))) {
         writeLine(`Skill: ${operation} failed.`);
         return false;
     }
     const remainingPaths = await listMearlPaths();
-    if (!remainingPaths || (operation === 'uninstall' ? remainingPaths.length !== 0 : remainingPaths.length === 0)) {
+    if (!remainingPaths ||
+        (operation === 'uninstall' ? remainingPaths.length !== 0 : remainingPaths.length === 0)) {
         writeLine(`Skill: ${operation} did not reach the expected installation state.`);
         return false;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/setup",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "One-shot environment setup and configuration for Mearl",
   "type": "module",
   "main": "dist/index.js",
@@ -79,11 +79,11 @@
     "ws": "^8.18.3",
     "semver": "^7.8.5",
     "adm-zip": "^0.6.1",
-    "@mearl/client": "3.0.0",
-    "@mearl/provider": "3.0.0",
-    "@mearl/daemon-core": "3.0.0",
-    "@mearl/preset": "3.0.0",
-    "@mearl/browser-core": "3.0.0"
+    "@mearl/client": "3.0.1",
+    "@mearl/provider": "3.0.1",
+    "@mearl/daemon-core": "3.0.1",
+    "@mearl/preset": "3.0.1",
+    "@mearl/browser-core": "3.0.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",