@mearl/setup 2.14.0 → 2.15.1

package/README.md

@@ -12,24 +12,17 @@ npx @mearl/setup plugin uninstall <name>
 npx @mearl/setup provider <install|update|uninstall> <package|id>
 ```
 
-配置 AgentBay API Key 时只需执行一次下面的命令，然后在隐藏输入提示中粘贴 Key。
-重复执行会更新现有 Key，并保留 `~/.mearl/.env` 中的其他配置：
-
-```bash
-npx @mearl/setup agentbay
-```
-
-无交互环境可使用 `--stdin` 或 `--key-file <path>`。为避免 Key 进入 shell history 和
-进程参数，不接受把 Key 直接写在命令行中。
+浏览器 Provider 独立安装和演进。安装后运行 `mearl <providerId>` 查看该版本声明的能力、
+配置和启动参数。
 
 在 Qoder Cloud Agent 环境中，使用 `npx @mearl/setup --qoder-cloud --yes` 选择 Qoder
 配对模式。它与 `--cloud` 安装同一套 cloud-server、client 和 Skill，只把 cloud-server
 模式记录为 Qoder；`mearl-cloud-server` 的命令交互保持不变，`start` 和 `restart` 输出新的
 配对指令后退出，不监听端口或保留守护进程。配对 URL 不包含 Qoder PAT。
 
-## 安装与注册 Skill CLI 插件
+## 安装与注册 Skill 插件
 
-一个命令安装 skill 并注册它的 CLI 能力：
+一个命令安装 skill 并注册它的 CLI、SDK 和 MCP 能力：
 
 ```bash
 npx @mearl/setup plugin install trip/mearl --skill yuque-doc-fetch --yes
@@ -41,9 +34,16 @@ mearl yuque read "https://aliyuque.antfin.com/group/book/doc"
 setup 从 `Installed … skill(s)` 成功区块提取路径，仅注册本次安装且包含 `scripts/main.mjs` 的 skill。
 普通 skill 正常安装。输出格式无法识别时提示手动注册，不扫描其他 skill 或猜测安装结果。
 
+默认 `install` 和 `update` 完成后，setup 会用最多 5 秒的 `npm ping` 检查阿里内网 registry。
+可访问时通过上述 Ali Skills 链路依次自动安装并注册 `buc-request` 与 `tdbank-account`；该 registry 不用于下载插件。
+探测不可用或插件安装失败不会破坏 Mearl 主环境的安装；`--skip-skill` 和
+`--target-line` 安装不执行自动插件步骤。
+
+Mearl client 内置官方插件名称与安装来源目录。CLI、SDK、MCP 或另一个插件首次调用尚未注册的官方插件时，会通过内部幂等流程安装并重试一次；未知名称不会触发安装。
+
 自动注册默认使用安装目录名；入口可用 `export const name = 'yuque'` 指定简短命令名。
 重装会刷新同名绑定。每个入口必须默认导出 `register(app)`；完整协议见
-[CLI 插件规范](../skills/mearl-skill-creator/references/cli-plugin.md)。
+[Skill 插件规范](../skills/mearl-skill-creator/references/cli-plugin.md)。
 
 已通过其他渠道分发的 skill 或自定义入口，可以直接传入路径注册：
 
@@ -57,7 +57,7 @@ path 接受目录或具体文件；目录默认读取 `scripts/main.mjs`，相
 两种注册流程都会检查本机 `@mearl/client` 和 `@mearl/native-host`：缺失或低于当前 setup 版本时，
 复用已有包管理器安装 setup 的对应版本，更新后再次验证；更高版本保持不动。
 native-host 会幂等初始化 Skills 模式。基础环境补齐或初始化失败时保留已安装的 skill，并停止注册。
-注册后可在任意目录运行 `mearl <name> --help`，日常业务调用不执行安装或版本检查。
+注册后可在任意目录运行 `mearl <name> --help`，也可通过 `@mearl/client` 的 `invokePlugin` 或 MCP 的 `mearl_plugin` 调用。已注册插件的日常调用不执行安装或版本检查；只有缺失的官方插件会触发一次按需安装。
 
 不再需要插件时执行：
 
@@ -211,11 +211,9 @@ npx @mearl/setup uninstall --local
 # 自动检测并无交互卸载
 npx @mearl/setup uninstall --yes
 
-# 配置或更新 AgentBay API Key
-npx @mearl/setup agentbay
-
-# 无交互配置（从权限受控的文件读取）
-npx @mearl/setup agentbay --key-file ./agentbay.key
+# 安装可选浏览器 Provider
+npx @mearl/setup provider install @ali/mearl-provider-brow
+npx @mearl/setup provider install @ali/mearl-provider-agentbay
 ```
 
 原有 Mearl 环境包的 npm/npx 安装方式和 CLI 保持可用；setup 是统一的便利入口。

package/dist/cli.d.ts

@@ -1,22 +1,20 @@
 #!/usr/bin/env node
-import { configureAgentBayApiKey, promptAgentBayApiKey, readAgentBayApiKeyFile, readAgentBayApiKeyStdin } from './agentBay.js';
 import { installMearlBrowserExtension } from './browserExtension.js';
 import { runMearlLifecycle, type MearlLifecycleOperation } from './lifecycle.js';
 import type { MearlProfile } from './profiles.js';
-import { installPlugins, setupPlugin, uninstallPlugin } from './plugin.js';
+import { ensureOfficialPlugin, installPlugins, setupPlugin, uninstallPlugin } from './plugin.js';
 import { installProviderPackage, uninstallProviderPackage, updateProviderPackage } from './provider.js';
 export declare const SETUP_VERSION: string;
 interface ParsedArgs {
-    agentBayKeyFile?: string;
-    agentBayReadStdin: boolean;
     cloudMode?: 'websocket' | 'qoder';
     force?: boolean;
     full?: boolean;
     help: boolean;
-    operation?: MearlLifecycleOperation | 'agentbay' | 'extension' | 'plugin' | 'provider';
+    operation?: MearlLifecycleOperation | 'extension' | 'plugin' | 'provider';
     pluginName?: string;
     pluginPath?: string;
     pluginInstallArgs?: string[];
+    pluginEnsureName?: string;
     pluginUninstallName?: string;
     providerCommand?: 'install' | 'uninstall' | 'update';
     providerTarget?: string;
@@ -28,12 +26,9 @@ interface ParsedArgs {
 }
 export interface SetupCliDependencies {
     registerPlugin?: typeof setupPlugin;
+    ensureOfficialPlugin?: typeof ensureOfficialPlugin;
     installPlugins?: typeof installPlugins;
     uninstallPlugin?: typeof uninstallPlugin;
-    configureAgentBay?: typeof configureAgentBayApiKey;
-    promptAgentBayKey?: typeof promptAgentBayApiKey;
-    readAgentBayKeyFile?: typeof readAgentBayApiKeyFile;
-    readAgentBayKeyStdin?: typeof readAgentBayApiKeyStdin;
     installBrowserExtension?: typeof installMearlBrowserExtension;
     installProvider?: typeof installProviderPackage;
     runLifecycle?: typeof runMearlLifecycle;

package/dist/cli.js

@@ -1,16 +1,14 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { Command, CommanderError } from 'commander';
-import { configureAgentBayApiKey, promptAgentBayApiKey, readAgentBayApiKeyFile, readAgentBayApiKeyStdin, } from './agentBay.js';
 import { installMearlBrowserExtension } from './browserExtension.js';
 import { runMearlLifecycle } from './lifecycle.js';
 import { isMearlReleaseLine } from './version.js';
-import { installPlugins, setupPlugin, uninstallPlugin } from './plugin.js';
+import { ensureOfficialPlugin, installPlugins, setupPlugin, uninstallPlugin } from './plugin.js';
 import { installProviderPackage, uninstallProviderPackage, updateProviderPackage, } from './provider.js';
 const require = createRequire(import.meta.url);
 export const SETUP_VERSION = require('../package.json').version;
 const baseParsedArgs = () => ({
-    agentBayReadStdin: false,
     help: false,
     skipSkill: false,
     yes: false,
@@ -43,6 +41,12 @@ export function parseSetupArgs(argv) {
     if (argv[0] === 'plugin' && argv[1] === 'install') {
         return { ...baseParsedArgs(), operation: 'plugin', pluginInstallArgs: argv.slice(2) };
     }
+    if (argv[0] === 'plugin' && argv[1] === 'ensure') {
+        if (argv.length !== 3 || !argv[2]) {
+            throw new Error('plugin ensure requires exactly one official plugin name');
+        }
+        return { ...baseParsedArgs(), operation: 'plugin', pluginEnsureName: argv[2] };
+    }
     if (argv[0] === 'plugin' && argv[1] === 'uninstall') {
         if (argv.length !== 3 || !argv[2]) {
             throw new Error('plugin uninstall requires exactly one plugin name');
@@ -128,31 +132,6 @@ export function parseSetupArgs(argv) {
         };
     });
     program.addCommand(extension);
-    const agentbay = new Command('agentbay')
-        .exitOverride()
-        .configureOutput({ writeErr: () => { }, writeOut: () => { } })
-        .argument('[api-key]')
-        .option('--stdin')
-        .option('--key-file <path>')
-        .action((apiKey) => {
-        const options = agentbay.opts();
-        if (apiKey) {
-            throw new Error('API keys are not accepted as command-line arguments');
-        }
-        if (options.stdin && options.keyFile) {
-            throw new Error('--stdin and --key-file cannot be used together');
-        }
-        if (options.keyFile !== undefined && !options.keyFile.trim()) {
-            throw new Error('--key-file requires a non-empty path');
-        }
-        parsed = {
-            ...baseParsedArgs(),
-            ...(options.keyFile ? { agentBayKeyFile: options.keyFile } : {}),
-            agentBayReadStdin: options.stdin === true,
-            operation: 'agentbay',
-        };
-    });
-    program.addCommand(agentbay);
     const normalizedArgv = argv[0] === undefined || argv[0].startsWith('-') ? ['install', ...argv] : argv;
     try {
         program.parse(['node', 'mearl-setup', ...normalizedArgv]);
@@ -182,14 +161,12 @@ Usage:
   npx @mearl/setup plugin install <ali-skills add arguments...>
   npx @mearl/setup plugin uninstall <name>
   npx @mearl/setup provider <install|update|uninstall> <package|id>
-  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    Install or update the browser extension; --full also installs the local environment
-  agentbay     Save or update AGENTBAY_KEY without changing other Mearl settings
   plugin       Register, install, or uninstall a CLI plugin
   provider     Install npm Provider packages and manage their Mearl registration
 
@@ -199,8 +176,6 @@ Options:
   --qoder-cloud
                Manage the same cloud packages in Qoder pairing mode
   --mcp        Manage @mearl/mcp-server and its configuration
-  --stdin      Read the AgentBay API key from standard input
-  --key-file   Read the AgentBay API key from a local file
   --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
@@ -224,7 +199,7 @@ Examples:
   npx @mearl/setup extension --full
   npx @mearl/setup plugin uninstall yuque
   npx @mearl/setup provider install @ali/mearl-provider-brow
-  npx @mearl/setup agentbay
+  npx @mearl/setup provider install @ali/mearl-provider-agentbay
   npx @mearl/setup --qoder-cloud --yes
   npx @mearl/setup update --local --target-line 2.3.x --skip-skill
   npx @mearl/setup uninstall --local`;
@@ -256,6 +231,13 @@ export async function main(argv = process.argv.slice(2), interactiveTerminal = p
             if (parsed.pluginInstallArgs) {
                 return await (dependencies.installPlugins ?? installPlugins)(parsed.pluginInstallArgs);
             }
+            if (parsed.pluginEnsureName) {
+                const result = await (dependencies.ensureOfficialPlugin ?? ensureOfficialPlugin)(parsed.pluginEnsureName);
+                console.error(result === 'installed'
+                    ? `Official plugin ${parsed.pluginEnsureName} installed.`
+                    : `Official plugin ${parsed.pluginEnsureName} is already registered.`);
+                return 0;
+            }
             if (parsed.pluginUninstallName) {
                 const result = await (dependencies.uninstallPlugin ?? uninstallPlugin)(parsed.pluginUninstallName);
                 if (!result.removed) {
@@ -307,31 +289,6 @@ export async function main(argv = process.argv.slice(2), interactiveTerminal = p
             return 1;
         }
     }
-    if (parsed.operation === 'agentbay') {
-        try {
-            const configureAgentBay = dependencies.configureAgentBay ?? configureAgentBayApiKey;
-            let apiKey;
-            if (parsed.agentBayKeyFile) {
-                apiKey = (dependencies.readAgentBayKeyFile ?? readAgentBayApiKeyFile)(parsed.agentBayKeyFile);
-            }
-            else if (parsed.agentBayReadStdin) {
-                apiKey = await (dependencies.readAgentBayKeyStdin ?? readAgentBayApiKeyStdin)();
-            }
-            else {
-                if (!interactiveTerminal) {
-                    throw new Error('Interactive input is unavailable. Re-run with --stdin or --key-file <path>.');
-                }
-                apiKey = await (dependencies.promptAgentBayKey ?? promptAgentBayApiKey)();
-            }
-            const result = configureAgentBay(apiKey);
-            console.error(`AgentBay API key saved to ${result.envFile}.`);
-            return 0;
-        }
-        catch (error) {
-            console.error(error instanceof Error ? error.message : String(error));
-            return 1;
-        }
-    }
     if (parsed.operation === 'extension') {
         if (!interactiveTerminal && !parsed.yes) {
             console.error('Non-interactive input detected. Re-run with --yes or --non-interactive.');

package/dist/index.d.ts

@@ -1,8 +1,6 @@
 export { buildGlobalPackageCommand, detectGlobalPackage, resolveInvokingPackageManager, resolvePackageManagerInstallation, } from './packageManager.js';
-export { configureAgentBayApiKey, promptAgentBayApiKey, readAgentBayApiKeyFile, readAgentBayApiKeyStdin, } from './agentBay.js';
 export { BrowserExtensionConflictError, extensionArchiveUrl, fetchBrowserExtensionRelease, findLatestExtensionVersion, installMearlBrowserExtension, inspectMearlExtensionViaCdp, loadUnpackedViaCdp, MEARL_EXTENSION_DIRECTORY_NAME, MEARL_EXTENSION_DOWNLOAD_PAGE, MEARL_EXTENSION_ID, MEARL_EXTENSION_REMOTE_CONFIG_URL, resolveChromeUserDataDirectory, resolveMearlExtensionDirectory, updateSetupManagedBrowserExtensionFiles, } from './browserExtension.js';
 export type { BrowserExtensionDependencies, BrowserExtensionInstallOptions, BrowserExtensionInstallResult, BrowserExtensionRelease, InstalledBrowserExtension, SetupManagedBrowserExtensionUpdateOptions, SetupManagedBrowserExtensionUpdateResult, } from './browserExtension.js';
-export type { AgentBayConfigurationOptions, AgentBayConfigurationResult, AgentBaySecretInput, AgentBaySecretOutput, } from './agentBay.js';
 export type { DetectedGlobalPackage, GlobalPackageCommand, GlobalPackageManager, PackageManagerInstallation, PackageOperation, PackageDetectionOptions, } from './packageManager.js';
 export { runMearlLifecycle } from './lifecycle.js';
 export type { MearlLifecycleDependencies, MearlLifecycleOperation, MearlLifecycleOptions, } from './lifecycle.js';

package/dist/index.js

@@ -1,5 +1,4 @@
 export { buildGlobalPackageCommand, detectGlobalPackage, resolveInvokingPackageManager, resolvePackageManagerInstallation, } from './packageManager.js';
-export { configureAgentBayApiKey, promptAgentBayApiKey, readAgentBayApiKeyFile, readAgentBayApiKeyStdin, } from './agentBay.js';
 export { BrowserExtensionConflictError, extensionArchiveUrl, fetchBrowserExtensionRelease, findLatestExtensionVersion, installMearlBrowserExtension, inspectMearlExtensionViaCdp, loadUnpackedViaCdp, MEARL_EXTENSION_DIRECTORY_NAME, MEARL_EXTENSION_DOWNLOAD_PAGE, MEARL_EXTENSION_ID, MEARL_EXTENSION_REMOTE_CONFIG_URL, resolveChromeUserDataDirectory, resolveMearlExtensionDirectory, updateSetupManagedBrowserExtensionFiles, } from './browserExtension.js';
 export { runMearlLifecycle } from './lifecycle.js';
 export { MEARL_PROFILES, detectMearlProfiles } from './profiles.js';

package/dist/internalPlugins.d.ts

@@ -0,0 +1,21 @@
+import { findPluginRegistration } from '@mearl/client/plugin';
+import { installPlugins, uninstallPlugin } from './plugin.js';
+import { findExecutable, type CommandRunner } from './process.js';
+export declare const ALIBABA_NPM_REGISTRY = "https://registry.anpm.alibaba-inc.com/";
+export declare const ALIBABA_INTERNAL_PLUGIN_NAMES: string[];
+export interface InternalPluginOptions {
+    env?: NodeJS.ProcessEnv;
+    runCommand?: CommandRunner;
+    writeLine?: (line: string) => void;
+}
+export interface InternalPluginDependencies {
+    findExecutable?: typeof findExecutable;
+    findPluginRegistration?: typeof findPluginRegistration;
+    installPlugins?: typeof installPlugins;
+    probeAlibabaRegistry?: (options: InternalPluginOptions) => Promise<boolean>;
+    uninstallPlugin?: typeof uninstallPlugin;
+}
+export declare function canAccessAlibabaNpmRegistry(options?: InternalPluginOptions, dependencies?: Pick<InternalPluginDependencies, 'findExecutable'>): Promise<boolean>;
+/** Uses the internal registry only as an intranet probe; Ali Skills installs the plugins. */
+export declare function installAlibabaInternalPlugins(options?: InternalPluginOptions, dependencies?: InternalPluginDependencies): Promise<'installed' | 'skipped' | 'failed'>;
+export declare function uninstallAlibabaInternalPlugins(options?: InternalPluginOptions, dependencies?: InternalPluginDependencies): Promise<'uninstalled' | 'skipped' | 'failed'>;

package/dist/internalPlugins.js

@@ -0,0 +1,97 @@
+import { dirname } from 'node:path';
+import { findOfficialPlugin, findPluginRegistration, listOfficialPluginNames, OFFICIAL_PLUGIN_MANAGER, } from '@mearl/client/plugin';
+import { installPlugins, uninstallPlugin } from './plugin.js';
+import { findExecutable, prependCommandPath, runCommand } from './process.js';
+export const ALIBABA_NPM_REGISTRY = 'https://registry.anpm.alibaba-inc.com/';
+export const ALIBABA_INTERNAL_PLUGIN_NAMES = listOfficialPluginNames('alibaba');
+export async function canAccessAlibabaNpmRegistry(options = {}, dependencies = {}) {
+    const env = options.env ?? process.env;
+    const runner = options.runCommand ?? runCommand;
+    const npm = (dependencies.findExecutable ?? findExecutable)('npm', {
+        env,
+        extraDirectories: [dirname(process.execPath)],
+    });
+    if (!npm)
+        return false;
+    try {
+        const result = await runner(npm, [
+            'ping',
+            `--registry=${ALIBABA_NPM_REGISTRY}`,
+            '--fetch-retries=0',
+            '--fetch-timeout=3000',
+            '--loglevel=silent',
+        ], {
+            capture: true,
+            env: prependCommandPath(npm, env),
+            timeoutMs: 5_000,
+        });
+        return result.code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** Uses the internal registry only as an intranet probe; Ali Skills installs the plugins. */
+export async function installAlibabaInternalPlugins(options = {}, dependencies = {}) {
+    const writeLine = options.writeLine ?? (line => console.error(line));
+    const registrationFor = dependencies.findPluginRegistration ?? findPluginRegistration;
+    const candidates = ALIBABA_INTERNAL_PLUGIN_NAMES.filter(name => {
+        const registration = registrationFor(name);
+        if (registration && registration.managedBy !== OFFICIAL_PLUGIN_MANAGER) {
+            writeLine(`${name} plugin: existing user registration kept.`);
+            return false;
+        }
+        return true;
+    });
+    if (candidates.length === 0)
+        return 'skipped';
+    const probe = dependencies.probeAlibabaRegistry ?? (input => canAccessAlibabaNpmRegistry(input));
+    if (!(await probe(options)))
+        return 'skipped';
+    let installed = false;
+    let failed = false;
+    for (const name of candidates) {
+        const definition = findOfficialPlugin(name);
+        try {
+            const code = await (dependencies.installPlugins ?? installPlugins)([...definition.installArgs], options.runCommand, { registrationManagedBy: OFFICIAL_PLUGIN_MANAGER });
+            if (code !== 0) {
+                failed = true;
+                writeLine(`${name} plugin: install failed (exit ${code}).`);
+                continue;
+            }
+            installed = true;
+            writeLine(`${name} plugin: installed and registered.`);
+        }
+        catch (error) {
+            failed = true;
+            writeLine(`${name} plugin: ${error instanceof Error ? error.message : String(error)}; skipped.`);
+        }
+    }
+    return failed ? 'failed' : installed ? 'installed' : 'skipped';
+}
+export async function uninstallAlibabaInternalPlugins(options = {}, dependencies = {}) {
+    const writeLine = options.writeLine ?? (line => console.error(line));
+    const registrationFor = dependencies.findPluginRegistration ?? findPluginRegistration;
+    let uninstalled = false;
+    let failed = false;
+    for (const name of [...ALIBABA_INTERNAL_PLUGIN_NAMES].reverse()) {
+        try {
+            const registration = registrationFor(name);
+            if (registration?.managedBy !== OFFICIAL_PLUGIN_MANAGER) {
+                if (registration)
+                    writeLine(`${name} plugin: existing user registration kept.`);
+                continue;
+            }
+            const result = await (dependencies.uninstallPlugin ?? uninstallPlugin)(name, options.runCommand);
+            if (!result.removed)
+                continue;
+            uninstalled = true;
+            writeLine(`${name} plugin: uninstalled.`);
+        }
+        catch (error) {
+            failed = true;
+            writeLine(`${name} plugin: ${error instanceof Error ? error.message : String(error)}; uninstall failed.`);
+        }
+    }
+    return failed ? 'failed' : uninstalled ? 'uninstalled' : 'skipped';
+}

package/dist/lifecycle.d.ts

@@ -3,6 +3,7 @@ import { detectGlobalPackage, type PackageManagerInstallation } from './packageM
 import { type DetectedMearlProfiles, type MearlProfile } from './profiles.js';
 import { uninstallNativeHostArtifacts } from './nativeHost.js';
 import { type CommandRunner } from './process.js';
+import { installAlibabaInternalPlugins, uninstallAlibabaInternalPlugins } from './internalPlugins.js';
 export type MearlLifecycleOperation = 'install' | 'update' | 'uninstall';
 export interface MearlLifecycleOptions {
     operation: MearlLifecycleOperation;
@@ -21,9 +22,11 @@ export interface MearlLifecycleDependencies {
     detectPackage?: typeof detectGlobalPackage;
     detectProfiles?: (env: NodeJS.ProcessEnv) => DetectedMearlProfiles;
     existsSync?: (filePath: string) => boolean;
+    installInternalPlugins?: typeof installAlibabaInternalPlugins;
     resolveInvokingManager?: (env: NodeJS.ProcessEnv) => PackageManagerInstallation;
     runCommand?: CommandRunner;
     runSkillOperation?: typeof runGlobalMearlSkillOperation;
+    uninstallInternalPlugins?: typeof uninstallAlibabaInternalPlugins;
     writeLine?: (line: string) => void;
 }
 export declare function runMearlLifecycle(options: MearlLifecycleOptions, dependencies?: MearlLifecycleDependencies): Promise<boolean>;

package/dist/lifecycle.js

@@ -8,6 +8,7 @@ import { MEARL_PROFILES, detectMearlProfiles, } from './profiles.js';
 import { uninstallNativeHostArtifacts } from './nativeHost.js';
 import { executableNames, prependCommandPath, runCommand, } from './process.js';
 import { isMearlReleaseLine } from './version.js';
+import { installAlibabaInternalPlugins, uninstallAlibabaInternalPlugins, } from './internalPlugins.js';
 const LEGACY_CLOUD_CLIENT = '@mearl/cloud-client';
 const UNIFIED_CLIENT = '@mearl/client';
 const PROFILE_ORDER = ['local', 'cloud', 'mcp'];
@@ -202,6 +203,9 @@ export async function runMearlLifecycle(options, dependencies = {}) {
         ? detectPackage(UNIFIED_CLIENT, ['mearl'], { env })
         : null;
     const detectedClient = detectedClientCandidate?.packageName === UNIFIED_CLIENT ? detectedClientCandidate : null;
+    const remainingClientProfiles = selectedUsesClient && options.operation === 'uninstall'
+        ? CLIENT_PROFILES.filter(profile => detected.has(profile) && !selected.includes(profile))
+        : [];
     if (selectedUsesClient && options.operation !== 'uninstall') {
         const clientInstallation = detectedClient ??
             detected.get('local') ??
@@ -264,7 +268,6 @@ export async function runMearlLifecycle(options, dependencies = {}) {
         }
     }
     if (selectedUsesClient && options.operation === 'uninstall') {
-        const remainingClientProfiles = CLIENT_PROFILES.filter(profile => detected.has(profile) && !selected.includes(profile));
         if (remainingClientProfiles.length > 0) {
             writeLine(`Packages (shared client): kept for ${remainingClientProfiles.join(', ')}.`);
         }
@@ -306,7 +309,41 @@ export async function runMearlLifecycle(options, dependencies = {}) {
             skillOk = false;
         }
     }
-    if (packagesOk && skillOk) {
+    let internalPluginsOk = true;
+    if (packagesOk && skillOk && selectedUsesClient && options.skipSkill !== true) {
+        if (options.operation === 'uninstall') {
+            if (remainingClientProfiles.length > 0) {
+                writeLine(`Internal plugins: kept for ${remainingClientProfiles.join(', ')}.`);
+            }
+            else {
+                try {
+                    internalPluginsOk =
+                        (await (dependencies.uninstallInternalPlugins ?? uninstallAlibabaInternalPlugins)({
+                            env,
+                            runCommand: runner,
+                            writeLine,
+                        })) !== 'failed';
+                }
+                catch (error) {
+                    writeLine(`Internal plugins: ${error instanceof Error ? error.message : String(error)}; uninstall failed.`);
+                    internalPluginsOk = false;
+                }
+            }
+        }
+        else if (options.targetLine === undefined) {
+            try {
+                await (dependencies.installInternalPlugins ?? installAlibabaInternalPlugins)({
+                    env,
+                    runCommand: runner,
+                    writeLine,
+                });
+            }
+            catch (error) {
+                writeLine(`Internal plugins: ${error instanceof Error ? error.message : String(error)}; skipped.`);
+            }
+        }
+    }
+    if (packagesOk && skillOk && internalPluginsOk) {
         writeLine('Mearl setup complete.');
         return true;
     }

package/dist/plugin.d.ts

@@ -1,5 +1,6 @@
 import { type CommandRunner } from './process.js';
 export declare function setupPlugin(name: string, target: string): Promise<string>;
+export declare function ensureOfficialPlugin(name: string, runner?: CommandRunner): Promise<'existing' | 'installed'>;
 export interface PluginUninstallResult {
     entryMissing?: boolean;
     removed: boolean;
@@ -9,4 +10,6 @@ export interface PluginUninstallResult {
 export declare function uninstallPlugin(name: string, runner?: CommandRunner): Promise<PluginUninstallResult>;
 /** Ali Skills 的 Installed 区块列出成功路径；计数校验避免输出变化导致漏注册。 */
 export declare function parseInstalledPluginPaths(output: string): string[];
-export declare function installPlugins(args: string[], runner?: CommandRunner): Promise<number>;
+export declare function installPlugins(args: string[], runner?: CommandRunner, options?: {
+    registrationManagedBy?: string;
+}): Promise<number>;

package/dist/plugin.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, rmdirSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-import { assertPluginName, findPluginEntry, listPluginNames, loadPlugin, registerPlugin, resolvePluginEntry, unregisterPlugin, } from '@mearl/client/plugin';
+import { assertPluginName, findOfficialPlugin, findPluginEntry, findPluginRegistration, listPluginNames, loadPlugin, OFFICIAL_PLUGIN_MANAGER, registerPlugin, resolvePluginEntry, unregisterPlugin, } from '@mearl/client/plugin';
 import { ensurePluginRuntime } from './pluginRuntime.js';
 import { resolveAliSkillsInvocation, stripAnsi } from './aliSkills.js';
 import { findExecutable, prependNodePath, runCommand } from './process.js';
@@ -21,6 +21,22 @@ export async function setupPlugin(name, target) {
     await ensurePluginRuntime();
     return registerPlugin(name, entry, plugin.description);
 }
+export async function ensureOfficialPlugin(name, runner = runCommand) {
+    const definition = findOfficialPlugin(name);
+    if (!definition)
+        throw new Error(`未知官方插件: ${name}`);
+    if (findPluginRegistration(name))
+        return 'existing';
+    const code = await installPlugins([...definition.installArgs], runner, {
+        registrationManagedBy: OFFICIAL_PLUGIN_MANAGER,
+    });
+    if (code !== 0)
+        throw new Error(`官方插件 ${name} 安装失败 (exit ${code})`);
+    const registration = findPluginRegistration(name);
+    if (!registration)
+        throw new Error(`官方插件 ${name} 安装完成后仍未注册`);
+    return 'installed';
+}
 function globalAliSkill(entry) {
     const globalSkillsDirectory = join(homedir(), '.agents', 'skills');
     const relativeEntry = relative(globalSkillsDirectory, resolve(entry));
@@ -137,7 +153,7 @@ function permitsEmptyInstallResult(args, output) {
         args.some(argument => ['--help', '-h', '--list'].includes(argument)) ||
         /\b(?:installation\s+)?cancel(?:led|ed)\b/i.test(output));
 }
-export async function installPlugins(args, runner = runCommand) {
+export async function installPlugins(args, runner = runCommand, options = {}) {
     if (args.includes('--')) {
         throw new Error('plugin install 不支持 -- 参数分隔符，以确保全局 symlink 安装选项生效。');
     }
@@ -178,7 +194,7 @@ export async function installPlugins(args, runner = runCommand) {
     }
     await ensurePluginRuntime(runner);
     for (const [name, { entry, description }] of plugins) {
-        registerPlugin(name, entry, description);
+        registerPlugin(name, entry, description, { managedBy: options.registrationManagedBy });
         console.error(`Plugin ${name} registered: ${entry}\nRun: mearl ${name} --help`);
     }
     return 0;

package/dist/provider.js

@@ -11,9 +11,10 @@ export function parseProviderPackageSpec(value) {
     }
     return { packageName: nameMatch[1], target: nameMatch[2] || 'latest' };
 }
-function providerManager(packageName, env, dependencies) {
-    const resolved = (dependencies.resolveInvokingManager ??
-        (childEnv => resolveInvokingPackageManager({ env: childEnv })))(env);
+function providerManager(packageName, env, dependencies, resolvedManager) {
+    const resolved = resolvedManager ??
+        (dependencies.resolveInvokingManager ??
+            (childEnv => resolveInvokingPackageManager({ env: childEnv })))(env);
     if (!packageName.startsWith('@ali/') || resolved.command.includes('tnpm'))
         return resolved;
     const tnpm = (dependencies.findExecutable ?? findExecutable)('tnpm', {
@@ -96,7 +97,8 @@ export async function updateProviderPackage(selector, dependencies = {}) {
     const current = findRegisteredProvider(selector, listProviders);
     const env = process.env;
     const runner = dependencies.runCommand ?? runCommand;
-    const installation = (dependencies.resolvePackageManager ?? resolvePackageManagerInstallation)(current.packageRoot, current.packageName) ?? providerManager(current.packageName, env, dependencies);
+    const detectedManager = (dependencies.resolvePackageManager ?? resolvePackageManagerInstallation)(current.packageRoot, current.packageName) ?? undefined;
+    const installation = providerManager(current.packageName, env, dependencies, detectedManager);
     (dependencies.stopProvider ?? stopProvider)(current.providerId);
     await runPackageCommand(installation, 'update', current.packageName, 'latest', runner, env);
     const manifest = (dependencies.registerPackage ?? registerProviderPackage)(current.packageRoot);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/setup",
-  "version": "2.14.0",
+  "version": "2.15.1",
   "description": "One-shot environment setup and configuration for Mearl",
   "type": "module",
   "main": "dist/index.js",
@@ -26,10 +26,6 @@
       "types": "./dist/nativeHost.d.ts",
       "import": "./dist/nativeHost.js"
     },
-    "./agentbay": {
-      "types": "./dist/agentBay.d.ts",
-      "import": "./dist/agentBay.js"
-    },
     "./version": {
       "types": "./dist/version.d.ts",
       "import": "./dist/version.js"
@@ -65,8 +61,8 @@
     "commander": "^15.0.0",
     "extract-zip": "^2.0.1",
     "ws": "^8.18.3",
-    "@mearl/client": "2.14.0",
-    "@mearl/provider": "2.14.0"
+    "@mearl/client": "2.15.1",
+    "@mearl/provider": "2.15.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",

package/dist/agentBay.d.ts

@@ -1,23 +0,0 @@
-export interface AgentBayConfigurationOptions {
-    envFile?: string;
-}
-export interface AgentBayConfigurationResult {
-    envFile: string;
-    updated: boolean;
-}
-export interface AgentBaySecretInput {
-    isRaw?: boolean;
-    isTTY?: boolean;
-    on(event: 'data', listener: (chunk: Buffer | string) => void): unknown;
-    pause(): unknown;
-    removeListener(event: 'data', listener: (chunk: Buffer | string) => void): unknown;
-    resume(): unknown;
-    setRawMode?(mode: boolean): unknown;
-}
-export interface AgentBaySecretOutput {
-    write(value: string): unknown;
-}
-export declare function readAgentBayApiKeyFile(file: string): string;
-export declare function readAgentBayApiKeyStdin(input?: NodeJS.ReadableStream): Promise<string>;
-export declare function promptAgentBayApiKey(input?: AgentBaySecretInput, output?: AgentBaySecretOutput): Promise<string>;
-export declare function configureAgentBayApiKey(apiKey: string, options?: AgentBayConfigurationOptions): AgentBayConfigurationResult;

package/dist/agentBay.js

@@ -1,114 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-const AGENTBAY_ENV_KEY = 'AGENTBAY_KEY';
-const AGENTBAY_ENV_LINE = /^\s*(?:export\s+)?AGENTBAY_KEY\s*=/;
-function normalizeApiKey(apiKey) {
-    const value = apiKey.trim();
-    if (!value)
-        throw new Error('AgentBay API key is required.');
-    if (/[\r\n\0]/.test(value)) {
-        throw new Error('AgentBay API key must be a single-line value.');
-    }
-    return value;
-}
-export function readAgentBayApiKeyFile(file) {
-    const resolved = path.resolve(file);
-    return normalizeApiKey(fs.readFileSync(resolved, 'utf8'));
-}
-export async function readAgentBayApiKeyStdin(input = process.stdin) {
-    let value = '';
-    for await (const chunk of input)
-        value += chunk.toString();
-    return normalizeApiKey(value);
-}
-export function promptAgentBayApiKey(input = process.stdin, output = process.stderr) {
-    if (!input.isTTY || !input.setRawMode) {
-        return Promise.reject(new Error('A TTY is required to enter the AgentBay API key securely.'));
-    }
-    const setRawMode = input.setRawMode.bind(input);
-    return new Promise((resolvePrompt, rejectPrompt) => {
-        const wasRaw = input.isRaw === true;
-        let value = '';
-        let settled = false;
-        const finish = (error) => {
-            if (settled)
-                return;
-            settled = true;
-            input.removeListener('data', onData);
-            setRawMode(wasRaw);
-            input.pause();
-            output.write('\n');
-            if (error)
-                rejectPrompt(error);
-            else {
-                try {
-                    resolvePrompt(normalizeApiKey(value));
-                }
-                catch (validationError) {
-                    rejectPrompt(validationError instanceof Error ? validationError : new Error(String(validationError)));
-                }
-            }
-        };
-        const onData = (chunk) => {
-            for (const character of chunk.toString()) {
-                if (character === '\u0003') {
-                    finish(new Error('AgentBay API key input cancelled.'));
-                    return;
-                }
-                if (character === '\r' || character === '\n') {
-                    finish();
-                    return;
-                }
-                if (character === '\u007f' || character === '\b') {
-                    value = Array.from(value).slice(0, -1).join('');
-                    continue;
-                }
-                if (character >= ' ')
-                    value += character;
-            }
-        };
-        output.write('AgentBay API key: ');
-        setRawMode(true);
-        input.resume();
-        input.on('data', onData);
-    });
-}
-function updateEnvContent(content, apiKey) {
-    const newline = content.includes('\r\n') ? '\r\n' : '\n';
-    const lines = content ? content.split(/\r?\n/) : [];
-    if (lines.at(-1) === '')
-        lines.pop();
-    const entry = `${AGENTBAY_ENV_KEY}=${apiKey}`;
-    const output = [];
-    let updated = false;
-    for (const line of lines) {
-        if (!AGENTBAY_ENV_LINE.test(line)) {
-            output.push(line);
-            continue;
-        }
-        if (!updated)
-            output.push(entry);
-        updated = true;
-    }
-    if (!updated)
-        output.push(entry);
-    return { content: `${output.join(newline)}${newline}`, updated };
-}
-export function configureAgentBayApiKey(apiKey, options = {}) {
-    const value = normalizeApiKey(apiKey);
-    const envFile = options.envFile ?? path.join(os.homedir(), '.mearl', '.env');
-    let current = '';
-    try {
-        current = fs.readFileSync(envFile, 'utf8');
-    }
-    catch (error) {
-        if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
-            throw error;
-    }
-    const next = updateEnvContent(current, value);
-    fs.mkdirSync(path.dirname(envFile), { recursive: true, mode: 0o700 });
-    fs.writeFileSync(envFile, next.content, { encoding: 'utf8', mode: 0o600 });
-    fs.chmodSync(envFile, 0o600);
-    return { envFile, updated: next.updated };
-}