@mearl/setup 2.20.0 → 2.20.1

package/README.md

@@ -30,7 +30,7 @@ npx @mearl/setup plugin install trip/mearl --skill yuque-doc-fetch --yes
 mearl yuque read "https://aliyuque.antfin.com/group/book/doc"
 ```
 
-安装参数透传给 `npx -y ali-skills add`，末尾统一追加 `--global --install-mode symlink`；不接受会截断后置选项的 `--` 参数分隔符，
+安装参数透传给 `npx -y ali-skills add`，统一使用全局 symlink 安装；不接受会截断后置选项的 `--` 参数分隔符，
 确保 skill 存放在 `~/.agents/skills` 并共享给所选 agent。安装日志实时显示，保留交互；
 setup 从 `Installed … skill(s)` 成功区块提取路径，仅注册本次安装且包含 `scripts/main.mjs` 或 `scripts/main.py` 的 skill；两者同时存在时使用 JavaScript 入口。
 普通 skill 正常安装。输出格式无法识别时提示手动注册，不扫描其他 skill 或猜测安装结果。
@@ -95,6 +95,7 @@ npx @mearl/setup provider uninstall brow
 
 ## 行为
 
+- Mearl 自有 npm 包的安装和更新固定使用 `https://registry.npmjs.org/`，与最新版本查询使用同一来源；第三方包沿用当前包管理器的源配置。
 - `install` 可以省略；直接执行 `npx @mearl/setup` 等同于 `npx @mearl/setup install`。
   以选项开头时也默认安装，例如 `npx @mearl/setup --cloud --yes`。
 - `install` 未指定环境时默认 `--local`。
@@ -111,7 +112,7 @@ npx @mearl/setup provider uninstall brow
 - local/cloud 共用一份 `@mearl/client`；组合安装只处理一次，卸载单个环境时若另一个环境仍在使用则保留。
 - 从 2.5.x 更新 cloud 环境时会先卸载旧 `@mearl/cloud-client`，避免它遗留的 `mearl` bin 与统一 client 冲突。
 - local/cloud 共用的全局 mearl skill 通过 `ali-skills` 的 JSON 清单定位，只处理一次。
-- 安装始终通过 `ali-skills add --install-mode symlink` 写入最新的全局 mearl skill，并关联当前检测到的 Agent；
+- 安装始终通过 `ali-skills add` 以 symlink 方式写入最新的全局 mearl skill，并关联当前检测到的 Agent；
   可用 `--skip-skill` 跳过。
 - 卸载一个环境但另一个仍依赖全局 mearl skill 时会保留 skill。
 - `uninstall --full` 在环境卸载之外，还会逐项卸载所有已注册 CLI 插件与浏览器 Provider。

package/dist/lifecycle.js

@@ -13,6 +13,7 @@ import { isMearlReleaseLine } from './version.js';
 import { installAlibabaInternalPlugins, uninstallAlibabaInternalPlugins, } from './internalPlugins.js';
 import { uninstallPlugin } from './plugin.js';
 import { uninstallProviderPackage } from './provider.js';
+import { packageRegistryEnvironment } from './npmRegistry.js';
 const LEGACY_CLOUD_CLIENT = '@mearl/cloud-client';
 const UNIFIED_CLIENT = '@mearl/client';
 const PROFILE_ORDER = ['local', 'cloud', 'mcp'];
@@ -79,7 +80,9 @@ async function runLifecycleCommand(runner, command, args, env, label, writeLine,
 async function runPackageOperation(installation, operation, packages, targetLine, runner, env, label, writeLine) {
     const command = buildGlobalPackageCommand(installation, operation, packages, targetLine);
     writeLine(`${label}: ${command.manager}`);
-    const result = await runLifecycleCommand(runner, command.command, command.args, env, label, writeLine);
+    const result = await runLifecycleCommand(runner, command.command, command.args, operation === 'uninstall'
+        ? env
+        : packages.reduce((childEnv, name) => packageRegistryEnvironment(name, childEnv), env), label, writeLine);
     if (!result)
         return { command, ok: false };
     if (result.code !== 0) {

package/dist/npmRegistry.d.ts

@@ -1,2 +1,3 @@
+export declare const OFFICIAL_NPM_REGISTRY = "https://registry.npmjs.org/";
 export declare const ALIBABA_NPM_REGISTRY = "https://registry.anpm.alibaba-inc.com/";
 export declare function packageRegistryEnvironment(packageName: string, env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist/npmRegistry.js

@@ -1,6 +1,20 @@
+export const OFFICIAL_NPM_REGISTRY = 'https://registry.npmjs.org/';
 export const ALIBABA_NPM_REGISTRY = 'https://registry.anpm.alibaba-inc.com/';
 export function packageRegistryEnvironment(packageName, env) {
-    if (!packageName.startsWith('@ali/'))
+    const scope = packageName.split('/')[0];
+    const registry = scope === '@mearl'
+        ? OFFICIAL_NPM_REGISTRY
+        : scope === '@ali'
+            ? ALIBABA_NPM_REGISTRY
+            : undefined;
+    if (!registry)
         return env;
-    return { ...env, npm_config_registry: ALIBABA_NPM_REGISTRY };
+    // npm-compatible managers and Bun receive the same registry, including scoped npm overrides.
+    return {
+        ...env,
+        npm_config_registry: registry,
+        NPM_CONFIG_REGISTRY: registry,
+        BUN_CONFIG_REGISTRY: registry,
+        [`npm_config_${scope}:registry`]: registry,
+    };
 }

package/dist/pluginRuntime.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 import { buildGlobalPackageCommand, detectCliPackage, detectGlobalPackage, resolveInvokingPackageManager, } from './packageManager.js';
 import { prependCommandPath, runCommand } from './process.js';
 import { compareMearlReleaseVersions, isMearlReleaseVersion } from './version.js';
+import { packageRegistryEnvironment } from './npmRegistry.js';
 const require = createRequire(import.meta.url);
 export const PLUGIN_RUNTIME_VERSION = require('../package.json').version;
 /** 插件使用当前 setup 同版本的运行时；已安装的更高版本保持不动。 */
@@ -36,7 +37,7 @@ export async function ensurePluginRuntime(runner = runCommand) {
             const command = buildGlobalPackageCommand(manager, 'install', [packageName], PLUGIN_RUNTIME_VERSION);
             console.error(`${packageName}: ${before.version ?? '未安装'} → ${PLUGIN_RUNTIME_VERSION}`);
             const result = await runner(command.command, command.args, {
-                env: prependCommandPath(command.command),
+                env: prependCommandPath(command.command, packageRegistryEnvironment(packageName, process.env)),
             });
             if (result.code !== 0)
                 throw new Error(`${packageName} 安装失败 (exit ${result.code})，插件尚未注册。`);

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@mearl/setup",
-  "version": "2.20.0",
+  "version": "2.20.1",
   "description": "One-shot environment setup and configuration for Mearl",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
+    "./npm-registry": {
+      "types": "./dist/npmRegistry.d.ts",
+      "import": "./dist/npmRegistry.js"
+    },
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -65,8 +69,8 @@
     "commander": "^15.0.0",
     "extract-zip": "^2.0.1",
     "ws": "^8.18.3",
-    "@mearl/client": "2.20.0",
-    "@mearl/provider": "2.20.0"
+    "@mearl/client": "2.20.1",
+    "@mearl/provider": "2.20.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",