@mearl/setup 2.20.3 → 2.20.4

package/README.md

@@ -106,6 +106,8 @@ npx @mearl/setup provider uninstall brow
 - `--local`、`--cloud` 与 `--mcp` 可以组合，显式传入时只处理选中的环境；
   `--qoder-cloud` 选择相同的 cloud 环境并记录 Qoder 配对模式，不能与 `--cloud` 同时使用。
 - 已有环境沿用其原包管理器和全局安装前缀；首次安装沿用启动 setup 的包管理器。
+- `uninstall` 也识别 `npm link` 或 `dev:link` 注册到 npm 全局目录的开发软链，
+  通过原 npm 前缀移除包与命令链接，保留仓库源码。安装和更新的自动检测仅处理常规全局安装。
 - cloud 环境统一管理 `@mearl/cloud-server` 与 `@mearl/client`：WebSocket 模式首次安装后
   启动 Server，更新后仅在 Server 原本运行时重启；Qoder 模式由相同的 `start` 命令生成
   新配对但不起服务；卸载前均调用 `stop`。

package/dist/lifecycle.d.ts

@@ -1,7 +1,7 @@
 import { listPluginNames } from '@mearl/client/plugin';
 import { listInstalledProviders } from '@mearl/provider/host';
 import { runGlobalMearlSkillOperation } from './aliSkills.js';
-import { detectGlobalPackage, type PackageManagerInstallation } from './packageManager.js';
+import { detectGlobalPackage, type PackageManagerInstallation, type PackageDetectionOptions } from './packageManager.js';
 import { type DetectedMearlProfiles, type MearlProfile } from './profiles.js';
 import { uninstallNativeHostArtifacts } from './nativeHost.js';
 import { type CommandRunner } from './process.js';
@@ -26,7 +26,7 @@ export interface MearlLifecycleDependencies {
     cleanupNativeHost?: typeof uninstallNativeHostArtifacts;
     confirm?: (message: string) => Promise<boolean>;
     detectPackage?: typeof detectGlobalPackage;
-    detectProfiles?: (env: NodeJS.ProcessEnv) => DetectedMearlProfiles;
+    detectProfiles?: (env: NodeJS.ProcessEnv, options?: Pick<PackageDetectionOptions, 'includeLinked'>) => DetectedMearlProfiles;
     existsSync?: (filePath: string) => boolean;
     installInternalPlugins?: typeof installAlibabaInternalPlugins;
     listPlugins?: typeof listPluginNames;

package/dist/lifecycle.js

@@ -178,7 +178,8 @@ export async function runMearlLifecycle(options, dependencies = {}) {
     const runner = dependencies.runCommand ?? runCommand;
     const cleanupNativeHost = dependencies.cleanupNativeHost ?? uninstallNativeHostArtifacts;
     const detectPackage = dependencies.detectPackage ?? detectGlobalPackage;
-    const detectProfiles = dependencies.detectProfiles ?? (childEnv => detectMearlProfiles({ env: childEnv }));
+    const detectProfiles = dependencies.detectProfiles ??
+        ((childEnv, detectionOptions) => detectMearlProfiles({ env: childEnv, ...detectionOptions }));
     const resolveInvokingManager = dependencies.resolveInvokingManager ??
         (childEnv => resolveInvokingPackageManager({ env: childEnv }));
     const runSkill = dependencies.runSkillOperation ?? runGlobalMearlSkillOperation;
@@ -186,7 +187,13 @@ export async function runMearlLifecycle(options, dependencies = {}) {
     const detectionEnv = options.operation === 'update' && env.MEARL_AUTO_UPDATE_SEARCH_PATH !== undefined
         ? { ...env, PATH: env.MEARL_AUTO_UPDATE_SEARCH_PATH }
         : env;
-    const detected = detectProfiles(detectionEnv);
+    const detected = options.operation === 'uninstall'
+        ? detectProfiles(detectionEnv, { includeLinked: true })
+        : detectProfiles(detectionEnv);
+    const packageDetectionOptions = {
+        env,
+        ...(options.operation === 'uninstall' ? { includeLinked: true } : {}),
+    };
     const requestedProfiles = options.profiles ??
         (options.profile ? [options.profile] : undefined) ??
         (options.operation === 'update' ? autoUpdateProfiles(env) : undefined);
@@ -275,7 +282,7 @@ export async function runMearlLifecycle(options, dependencies = {}) {
     }
     let packagesOk = true;
     if (lifecycleSelected.includes('cloud')) {
-        const legacyCloudClient = detectPackage(LEGACY_CLOUD_CLIENT, ['mearl-cloud'], { env });
+        const legacyCloudClient = detectPackage(LEGACY_CLOUD_CLIENT, ['mearl-cloud'], packageDetectionOptions);
         if (legacyCloudClient?.packageName === LEGACY_CLOUD_CLIENT) {
             const command = buildGlobalPackageCommand(legacyCloudClient, 'uninstall', [
                 LEGACY_CLOUD_CLIENT,
@@ -293,7 +300,7 @@ export async function runMearlLifecycle(options, dependencies = {}) {
     const selectedUsesClient = autoUpdateClient !== null ||
         lifecycleSelected.some(profile => CLIENT_PROFILES.includes(profile));
     const detectedClientCandidate = selectedUsesClient && !autoUpdateClient
-        ? detectPackage(UNIFIED_CLIENT, ['mearl'], { env })
+        ? detectPackage(UNIFIED_CLIENT, ['mearl'], packageDetectionOptions)
         : null;
     const detectedClient = detectedClientCandidate?.packageName === UNIFIED_CLIENT ? detectedClientCandidate : null;
     const remainingClientProfiles = selectedUsesClient && options.operation === 'uninstall'

package/dist/packageManager.d.ts

@@ -17,6 +17,8 @@ export interface DetectedGlobalPackage extends PackageManagerInstallation {
     executable: string;
 }
 export interface PackageDetectionOptions {
+    /** Include npm global links when selecting packages for explicit removal. */
+    includeLinked?: boolean;
     env?: NodeJS.ProcessEnv;
     existsSync?: (filePath: string) => boolean;
     platform?: NodeJS.Platform;

package/dist/packageManager.js

@@ -224,7 +224,20 @@ export function detectGlobalPackage(packageName, binNames, options = {}) {
         const cli = detectCliPackage(packageName, [binName], options);
         if (!cli)
             continue;
-        const installation = resolvePackageManagerInstallation(cli.packageRoot, packageName, options);
+        let installation = resolvePackageManagerInstallation(cli.packageRoot, packageName, options);
+        if (!installation && options.includeLinked) {
+            const linkedRoot = path.resolve(path.dirname(cli.executable), '../lib/node_modules', packageName);
+            try {
+                // A global package link must resolve to the package owning this CLI;
+                // an arbitrary executable symlink does not establish npm ownership.
+                if ((options.realpathSync ?? fs.realpathSync)(linkedRoot) === cli.packageRoot) {
+                    installation = resolvePackageManagerInstallation(linkedRoot, packageName, options);
+                }
+            }
+            catch {
+                // The global package registration may be absent or a stale symlink.
+            }
+        }
         if (!installation)
             continue;
         return {

package/package.json

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