@mearl/setup

@mearl/setup

Mearl 环境的一次性安装、更新与卸载工具。无需先全局安装 setup：

npx @mearl/setup <install|update|uninstall> [--local|--cloud|--mcp] [--yes]

行为

• install 未指定环境时默认 --local。
• update 和 uninstall 未指定环境时，从当前 PATH 中的 mearl-native-host、mearl-cloud、mearl-mcp-server 自动检测，可同时处理 多个已安装环境。
• 显式传入 --local、--cloud 或 --mcp 时只处理指定环境。
• 已有环境沿用其原包管理器和全局安装前缀；首次安装沿用启动 setup 的包管理器。
• local/cloud 共用的全局 mearl skill 通过 ali-skills 的 JSON 清单定位，只处理一次。
• 卸载一个环境但另一个仍依赖全局 mearl skill 时会保留 skill。
• --mcp 的客户端配置和清理由 @mearl/mcp-server 自己的命令完成。

人工与 Agent 使用

• 人工在终端执行时不加 --yes，需要选择 Skill 安装目标或 MCP 客户端时会显示交互提示。
• Agent、CI 或其他无 TTY 环境应加 --yes（也可写 --non-interactive）。首次安装会选择已检测到的 Agent / MCP 客户端，卸载会清理 所有已检测到的相关配置。
• 无 TTY 环境执行 install 或 uninstall 却未加上述参数时，会在任何改动前退出并提示正确命令。
• 退出码 0 表示完整成功，1 表示执行未完成，2 表示参数或交互模式不适用。

示例

# 默认安装本地浏览器环境
npx @mearl/setup install

# Agent / CI 无交互安装
npx @mearl/setup install --yes

# 安装云端 Agent 环境
npx @mearl/setup install --cloud

# 自动更新当前 PATH 中检测到的全部 Mearl 环境
npx @mearl/setup update

# 只卸载本地环境
npx @mearl/setup uninstall --local

# 自动检测并无交互卸载
npx @mearl/setup uninstall --yes

原有的 npm/npx 安装方式和各包 CLI 保持可用；setup 只是统一的便利入口。