@bams-app/work-cli 0.0.1

package/commands/create.js

@@ -0,0 +1,195 @@
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const { copyDir, exists, isDirectory, toKebabCase, error, success, info, log } = require('../lib/utils');
+
+const WORK_CLI_ROOT = path.resolve(__dirname, '../');
+const TEMPLATES_DIR = path.join(WORK_CLI_ROOT, 'templates');
+const PROJECT_TEMPLATE_DIR = path.join(TEMPLATES_DIR, 'project');
+
+/**
+ * 探测 work 仓库根目录（本地验证模式定位 file: 引用来源）
+ * 1. WORK_PROJECT_ROOT 环境变量优先
+ * 2. 通过 file: 安装的 @bams-app/ui-dev-server 包真实路径上溯（ui-dev-server -> cli -> work -> 仓库根）
+ * 3. 均不可用（registry 安装）时返回空，走发布模式
+ * @returns {string} work 仓库根目录或空字符串
+ */
+function detectWorkRoot() {
+    if (process.env.WORK_PROJECT_ROOT) {
+        return process.env.WORK_PROJECT_ROOT;
+    }
+    try {
+        const pkgPath = require.resolve('@bams-app/ui-dev-server/package.json');
+        const candidate = path.resolve(path.dirname(pkgPath), '../../..');
+        if (isDirectory(path.join(candidate, 'work', 'packages'))) {
+            return candidate;
+        }
+    } catch (e) {
+        // 忽略探测失败，回退发布模式
+    }
+    return '';
+}
+
+/**
+ * 生成 ui-dev-server 依赖声明
+ * - 本地验证模式（探测到 work 仓库）使用 file: 引用 work 仓库本地包
+ * - 否则使用 registry 版本号（发布后模式）
+ */
+function buildUiDevServerDep() {
+    const workRoot = detectWorkRoot();
+    if (workRoot) {
+        const pkgDir = path.join(workRoot, 'work', 'cli', 'ui-dev-server');
+        if (isDirectory(pkgDir)) {
+            return `"@bams-app/ui-dev-server": "file:${pkgDir}"`;
+        }
+    }
+    return `"@bams-app/ui-dev-server": "^0.1.0"`;
+}
+
+/**
+ * 生成能力包依赖声明（单一来源：ui-dev-server 的 dependencies 中 @bams-app/*）
+ * - 本地验证模式（探测到 work 仓库）使用 file: 引用 work 仓库本地包（覆盖未发布包）
+ * - 否则返回空（发布后能力包由 ui-dev-server 的 dependencies 自动安装）
+ */
+function buildCapabilityDeps() {
+    const workRoot = detectWorkRoot();
+    if (!workRoot) {
+        return '';
+    }
+    const uiDevServerPkg = require(require.resolve('@bams-app/ui-dev-server/package.json'));
+    return Object.entries(uiDevServerPkg.dependencies || {})
+        .filter(([name]) => name.startsWith('@bams-app/'))
+        .map(([name]) => {
+            const short = name.replace('@bams-app/', '');
+            // 在 work/configs、work/packages、work/ui、work/cli 多个位置依次查找包目录
+            const pkgDir = short === 'configs' && isDirectory(path.join(workRoot, 'work', 'configs'))
+                ? path.join(workRoot, 'work', 'configs')
+                : [
+                    path.join(workRoot, 'work', 'packages', short),
+                    path.join(workRoot, 'work', 'ui', short),
+                    path.join(workRoot, 'work', 'cli', short)
+                ].find(dir => isDirectory(dir));
+            return `,\n    "${name}": "file:${pkgDir}"`;
+        })
+        .join('');
+}
+
+/**
+ * 委托 @bams-app/create-ui-component 创建示例组件（复用 work 的模板与命令）
+ */
+function createDemoComponent(targetDir) {
+    const createComponentBin = require.resolve('@bams-app/create-ui-component/bin/create-ui-component.js');
+
+    return new Promise((resolve) => {
+        const child = spawn(
+            process.execPath,
+            [
+                createComponentBin,
+                '--dir', path.join(targetDir, 'bams-components'),
+                '--name', 'ui-component-demo',
+                '--desc', 'componentDemo',
+                '--no-install'
+            ],
+            {
+                cwd: targetDir,
+                stdio: 'inherit'
+            }
+        );
+        child.on('error', (err) => {
+            error(`创建示例组件失败: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+
+async function main(args) {
+    const force = args.includes('--force') || args.includes('-f');
+    const projectNameArg = args.find((a) => !a.startsWith('-'));
+
+    if (!projectNameArg) {
+        error('用法: bams-work create <project-name> [--force]');
+        process.exit(1);
+    }
+
+    const projectName = toKebabCase(projectNameArg);
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(projectName)) {
+        error(`项目名不合法: ${projectNameArg}（仅允许小写字母、数字、连字符）`);
+        process.exit(1);
+    }
+
+    const targetDir = path.resolve(process.cwd(), projectName);
+
+    if (exists(targetDir)) {
+        if (!isDirectory(targetDir)) {
+            error(`目标路径已存在且不是目录: ${targetDir}`);
+            process.exit(1);
+        }
+        const hasContent = fs.readdirSync(targetDir).length > 0;
+        if (hasContent && !force) {
+            error(`目录已存在且非空: ${targetDir}（如需覆盖请加 --force）`);
+            process.exit(1);
+        }
+        if (hasContent) {
+            fs.rmSync(targetDir, { recursive: true, force: true });
+        }
+    }
+
+    // 1. 拷贝项目模板
+    copyDir(PROJECT_TEMPLATE_DIR, targetDir);
+
+    const gitignoreTpl = path.join(targetDir, 'gitignore.tpl');
+    if (fs.existsSync(gitignoreTpl)) {
+        fs.renameSync(gitignoreTpl, path.join(targetDir, '.gitignore'));
+    }
+
+    // 2. 生成 .bams-work 标记目录（findProjectRoot 定位项目根）
+    fs.mkdirSync(path.join(targetDir, '.bams-work'), { recursive: true });
+    fs.writeFileSync(
+        path.join(targetDir, '.bams-work', 'README.md'),
+        '本目录为 BAMS-Work 项目标记，请勿删除。\n',
+        'utf8'
+    );
+
+    // 3. 替换项目 package.json 占位符
+    const projectPackageJson = path.join(targetDir, 'package.json');
+    const pkgContent = fs.readFileSync(projectPackageJson, 'utf8')
+        .split('__PROJECT_NAME__').join(projectName)
+        .split('__UI_DEV_SERVER_DEP__').join(buildUiDevServerDep())
+        .split('__CAPABILITY_DEPS__').join(buildCapabilityDeps());
+    fs.writeFileSync(projectPackageJson, pkgContent, 'utf8');
+
+    // 4. 创建示例组件（复用 work 的 create-ui-component 模板与命令）
+    const demoCode = await createDemoComponent(targetDir);
+    if (demoCode !== 0) {
+        error('示例组件创建失败，请检查后重试');
+        process.exit(1);
+    }
+
+    log('');
+    success(`项目创建成功: ${projectName}`);
+    log('');
+    info('下一步：');
+    log(`  cd ${projectName}`);
+    log('  npm install            # 或 yarn install（ui-dev-server 与能力包将安装到根 node_modules）');
+    log('');
+    log('启动 work 开发环境：');
+    log(`  bams-work dev demo ui-component-demo   # 加载 .envs/.env.dev-demo`);
+    log('');
+    log('创建新组件：');
+    log('  bams-work add --dir energy-ui --name ui-order-list');
+    log('');
+    log('更多命令：bams-work --help');
+    log('');
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}

package/commands/dev.js

@@ -0,0 +1,95 @@
+const fs = require('fs');
+const path = require('path');
+const { findProjectRoot, error, info, run } = require('../lib/utils');
+
+/**
+ * 用法: bams-work dev <env> [component] [--layout pc|touch] [-- <vue-cli args>]
+ * 委托 @bams-app/shared-env 加载环境变量，并启动 @bams-app/ui-dev-server 开发服务
+ */
+async function main(args) {
+    const projectRoot = findProjectRoot(process.cwd());
+    if (!projectRoot) {
+        error('未找到 BAMS-Work 项目（缺少 .bams-work 目录），请先执行 bams-work create <name>');
+        process.exit(1);
+    }
+
+    let envAlias = null;
+    let component = '';
+    let layout = 'pc';
+    let serviceArgs = [];
+    let i = 0;
+
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--') {
+            serviceArgs = args.slice(i + 1);
+            break;
+        } else if (arg === '--layout' || arg === '-l') {
+            layout = args[i + 1];
+            i += 2;
+        } else if (arg === '--component' || arg === '-c') {
+            component = args[i + 1];
+            i += 2;
+        } else if (arg.startsWith('--')) {
+            serviceArgs = args.slice(i);
+            break;
+        } else if (!envAlias) {
+            envAlias = arg;
+        } else if (!component) {
+            component = arg;
+        } else {
+            serviceArgs = args.slice(i);
+            break;
+        }
+        i++;
+    }
+
+    if (!envAlias) {
+        error('用法: bams-work dev <env> [component] [--layout pc|touch]');
+        error('示例: bams-work dev demo ui-component-demo');
+        process.exit(1);
+    }
+
+    const envFile = `.envs/.env.dev-${envAlias}`;
+    if (!fs.existsSync(path.join(projectRoot, envFile))) {
+        error(`环境文件不存在: ${envFile}（项目根: ${projectRoot}）`);
+        process.exit(1);
+    }
+
+    let sharedEnvBin;
+    let uiDevServerBin;
+    try {
+        sharedEnvBin = require.resolve('@bams-app/shared-env/bin/shared-env.js');
+        uiDevServerBin = require.resolve('@bams-app/ui-dev-server/bin/ui-dev-server.js');
+    } catch (err) {
+        error('未安装 work 依赖包，请先在 work-cli 目录执行 npm install');
+        process.exit(1);
+    }
+
+    info(`环境: ${envAlias}  组件: ${component || 'ui-component-demo'}  布局: ${layout}`);
+    info(`工作目录: ${projectRoot}`);
+
+    const uiArgs = [uiDevServerBin];
+    if (component) {
+        uiArgs.push('-c', component);
+    }
+    uiArgs.push('-l', layout);
+    uiArgs.push(...serviceArgs);
+
+    const env = { ...process.env, WORK_PROJECT_ROOT: projectRoot };
+    const code = await run(
+        process.execPath,
+        [sharedEnvBin, '--project', '.', '--env', envFile, '--', ...uiArgs],
+        { cwd: projectRoot, env }
+    );
+    process.exit(code);
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}

package/commands/env.js

@@ -0,0 +1,39 @@
+const path = require('path');
+const { spawn } = require('child_process');
+const { error, findProjectRoot } = require('../lib/utils');
+
+/**
+ * 委托 @bams-app/create-env 创建开发环境（.envs/.env.dev-<alias>）
+ * 环境文件始终写入用户项目根（.bams-work 标记目录所在处）
+ */
+function main(args) {
+    const binPath = require.resolve('@bams-app/create-env/bin/create-env.js');
+    const projectRoot = findProjectRoot(process.cwd()) || process.cwd();
+
+    return new Promise((resolve) => {
+        const child = spawn(
+            process.execPath,
+            [binPath, ...args],
+            {
+                cwd: projectRoot,
+                stdio: 'inherit'
+            }
+        );
+        child.on('error', (err) => {
+            error(`启动 create-env 失败: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}

package/commands/pages-entry.js

@@ -0,0 +1,37 @@
+const path = require('path');
+const { spawn } = require('child_process');
+const { error } = require('../lib/utils');
+
+/**
+ * 委托 @bams-app/create-pages-entry 扫描 page-* 与 ui-* 目录生成 webpack 动态入口
+ */
+function main(args) {
+    const binPath = require.resolve('@bams-app/create-pages-entry/bin/create-pages-entry.js');
+
+    return new Promise((resolve) => {
+        const child = spawn(
+            process.execPath,
+            [binPath, ...args],
+            {
+                cwd: process.cwd(),
+                stdio: 'inherit'
+            }
+        );
+        child.on('error', (err) => {
+            error(`启动 create-pages-entry 失败: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}

package/commands/pages-from-components.js

@@ -0,0 +1,37 @@
+const path = require('path');
+const { spawn } = require('child_process');
+const { error } = require('../lib/utils');
+
+/**
+ * 委托 @bams-app/create-pages-from-components 批量将 ui-* 组件转为 page-* 页面
+ */
+function main(args) {
+    const binPath = require.resolve('@bams-app/create-pages-from-components/bin/create-pages-from-components.js');
+
+    return new Promise((resolve) => {
+        const child = spawn(
+            process.execPath,
+            [binPath, ...args],
+            {
+                cwd: process.cwd(),
+                stdio: 'inherit'
+            }
+        );
+        child.on('error', (err) => {
+            error(`启动 create-pages-from-components 失败: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}

package/commands/umd.js

@@ -0,0 +1,172 @@
+const fs = require('fs');
+const path = require('path');
+const { findProjectRoot, toCamelCase, exists, isDirectory, readJson, error, info, run } = require('../lib/utils');
+
+/**
+ * 用法: bams-work umd [component] [--out <dir>] [--name <name>] [--entry <file>]
+ * component 缺省时自动收集 workspaces 下所有组件
+ * 委托 @bams-app/ui-dev-server/bin/build-umd.js 构建组件 UMD 产物
+ */
+function parseArgs(args) {
+    let component = '';
+    let outDir = '';
+    let outputName = '';
+    let entryFile = '';
+    let serviceArgs = [];
+    let i = 0;
+
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--') {
+            serviceArgs = args.slice(i + 1);
+            break;
+        } else if (arg === '--out' || arg === '-o') {
+            outDir = args[i + 1];
+            i += 2;
+        } else if (arg === '--name' || arg === '-n') {
+            outputName = args[i + 1];
+            i += 2;
+        } else if (arg === '--entry' || arg === '-e') {
+            entryFile = args[i + 1];
+            i += 2;
+        } else if (arg.startsWith('--')) {
+            serviceArgs = args.slice(i);
+            break;
+        } else if (!component) {
+            component = arg;
+        } else {
+            serviceArgs = args.slice(i);
+            break;
+        }
+        i++;
+    }
+
+    return { component, outDir, outputName, entryFile, serviceArgs };
+}
+
+/**
+ * 收集 workspaces 下所有组件目录（scope 目录模式，兼容旧 apps/ 结构）
+ * @returns {Array<{name: string, relPath: string}>}
+ */
+function collectComponents(projectRoot) {
+    const packageJson = readJson(path.join(projectRoot, 'package.json'));
+    const workspaces = packageJson.workspaces || [];
+    const components = [];
+    const seen = new Set();
+
+    const scanDir = (dir) => {
+        if (!isDirectory(dir)) {
+            return;
+        }
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory() || !/^(ui-|page-)/.test(entry.name)) {
+                continue;
+            }
+            const componentDir = path.join(dir, entry.name);
+            if (
+                fs.existsSync(path.join(componentDir, 'index.js')) ||
+                fs.existsSync(path.join(componentDir, 'index.vue')) ||
+                fs.existsSync(path.join(componentDir, 'src', 'component.vue'))
+            ) {
+                if (!seen.has(entry.name)) {
+                    seen.add(entry.name);
+                    components.push({ name: entry.name, relPath: path.relative(projectRoot, componentDir) });
+                }
+            }
+        }
+    };
+
+    for (const pattern of workspaces) {
+        if (pattern.startsWith('!')) {
+            continue;
+        }
+        const match = pattern.match(/^([^/*]+)(?:\/\*)?$/);
+        if (match) {
+            scanDir(path.join(projectRoot, match[1]));
+        }
+    }
+
+    // 兼容旧 apps/ 结构
+    scanDir(path.join(projectRoot, 'apps'));
+
+    return components;
+}
+
+/**
+ * 生成 build-components-entry.js（import 路径相对项目根）
+ */
+function generateEntryFile({ projectRoot, components }) {
+    const entries = components.map(({ name, relPath }) => {
+        const camelCaseName = toCamelCase(name);
+        const importPath = `./${relPath.split(path.sep).join('/')}`;
+        return `export const ${camelCaseName} = () => import(/* webpackChunkName: "${name}" */ "${importPath}");`;
+    });
+
+    const entryFile = path.join(projectRoot, 'build-components-entry.js');
+    fs.writeFileSync(entryFile, entries.join('\n') + '\n', 'utf8');
+    return entryFile;
+}
+
+async function main(args) {
+    const projectRoot = findProjectRoot(process.cwd());
+    if (!projectRoot) {
+        error('未找到 BAMS-Work 项目（缺少 .bams-work 目录），请先执行 bams-work create <name>');
+        process.exit(1);
+    }
+
+    const { component, outDir, outputName, entryFile, serviceArgs } = parseArgs(args);
+
+    let components = [];
+    if (component) {
+        const collected = collectComponents(projectRoot).find((c) => c.name === component);
+        components = collected ? [collected] : [{ name: component, relPath: component }];
+    } else {
+        components = collectComponents(projectRoot);
+    }
+
+    if (components.length === 0) {
+        error('未找到任何组件（workspaces 下需存在 ui-* / page-* 目录），请先执行 bams-work add --dir <scope> --name ui-xxx');
+        process.exit(1);
+    }
+
+    const finalEntryFile = entryFile
+        ? (path.isAbsolute(entryFile) ? entryFile : path.resolve(process.cwd(), entryFile))
+        : generateEntryFile({ projectRoot, components });
+
+    if (!exists(finalEntryFile)) {
+        error(`入口文件不存在: ${finalEntryFile}`);
+        process.exit(1);
+    }
+
+    let buildUmdBin;
+    try {
+        buildUmdBin = require.resolve('@bams-app/ui-dev-server/bin/build-umd.js');
+    } catch (err) {
+        error('未安装 work 依赖包，请先在 work-cli 目录执行 npm install');
+        process.exit(1);
+    }
+
+    info(`构建 UMD 产物，组件: ${components.map((c) => c.name).join(', ')}`);
+    info(`工作目录: ${projectRoot}`);
+
+    const umdArgs = [buildUmdBin, '--entry', finalEntryFile];
+    if (outDir) {
+        umdArgs.push('--output-dir', path.isAbsolute(outDir) ? outDir : path.resolve(projectRoot, outDir));
+    }
+    if (outputName) {
+        umdArgs.push('--name', outputName);
+    }
+
+    const env = { ...process.env, WORK_PROJECT_ROOT: projectRoot };
+    const code = await run(process.execPath, umdArgs.concat(serviceArgs), { cwd: projectRoot, env });
+    process.exit(code);
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}

package/commands/update.js

@@ -0,0 +1,119 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { findProjectRoot, readJson, writeJson, run, error, warn, success, info, log } = require('../lib/utils');
+
+const UI_DEV_SERVER = '@bams-app/ui-dev-server';
+
+// 解析版本范围中声明的基础版本（如 ^0.1.0 -> 0.1.0）
+function parseRangeVersion(range) {
+    if (!range) return null;
+    const match = String(range)
+        .replace(/^[~^]/, '')
+        .match(/(\d+)\.(\d+)\.(\d+)/);
+    return match ? `${match[1]}.${match[2]}.${match[3]}` : null;
+}
+
+// 简单三段的版本比较：a > b 返回 1，相等 0，小于 -1
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) > (pb[i] || 0)) return 1;
+        if ((pa[i] || 0) < (pb[i] || 0)) return -1;
+    }
+    return 0;
+}
+
+// 查询 registry 上的最新版本（继承项目 .npmrc 的 @bams-app:registry 配置）
+function fetchLatestVersion(projectRoot) {
+    try {
+        const output = execSync(`npm view ${UI_DEV_SERVER} version --no-audit --no-fund`, {
+            cwd: projectRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore']
+        });
+        return String(output).trim() || null;
+    } catch (e) {
+        return null;
+    }
+}
+
+async function main(args) {
+    const skipInstall = args.includes('--skip-install');
+    const projectRoot = findProjectRoot();
+    if (!projectRoot) {
+        error('未找到 BAMS-Work 项目（缺少 .bams-work 目录），请在用户项目根目录执行');
+        process.exit(1);
+    }
+
+    const pkgPath = path.join(projectRoot, 'package.json');
+    const pkg = readJson(pkgPath);
+    const declared = (pkg.dependencies || {})[UI_DEV_SERVER];
+
+    if (!declared) {
+        warn(`未在 package.json 中找到 ${UI_DEV_SERVER} 依赖`);
+        process.exit(0);
+    }
+
+    // 本地验证模式：file: 引用，升级 = 清除缓存 + 重装以同步 work 最新源码
+    if (declared.startsWith('file:')) {
+        if (skipInstall) {
+            warn('本地验证模式需重装才能同步源码，忽略 --skip-install');
+        }
+        info(`当前为本地验证模式（${declared}）`);
+        // npm 对已安装的 file: 依赖会直接跳过（即使源码已变化），
+        // 需先清除 node_modules 中的安装缓存，再重装强制重新复制
+        const fileDeps = Object.entries(pkg.dependencies || {})
+            .filter(([, v]) => typeof v === 'string' && v.startsWith('file:'))
+            .map(([name]) => name);
+        let removed = 0;
+        for (const name of fileDeps) {
+            const target = path.join(projectRoot, 'node_modules', name);
+            try {
+                if (fs.lstatSync(target)) {
+                    fs.rmSync(target, { recursive: true, force: true });
+                    removed++;
+                }
+            } catch (e) {
+                // 目标不存在，跳过
+            }
+        }
+        info(`已清除 ${removed} 个 file: 依赖缓存，将重新同步 work 源码`);
+    } else {
+        // 发布后模式：查询 registry 最新版本并升级声明
+        const current = parseRangeVersion(declared);
+        const latest = fetchLatestVersion(projectRoot);
+        if (!latest) {
+            warn(`查询 ${UI_DEV_SERVER} 最新版本失败（请检查项目 .npmrc 的 @bams-app:registry 配置与网络）`);
+        } else if (current && compareVersions(latest, current) > 0) {
+            info(`发现新版本: ${current} -> ${latest}`);
+            pkg.dependencies[UI_DEV_SERVER] = `^${latest}`;
+            writeJson(pkgPath, pkg);
+            success(`已更新 ${UI_DEV_SERVER} 为 ^${latest}`);
+        } else {
+            info(`${UI_DEV_SERVER} 已是最新版本（${latest}）`);
+        }
+        if (skipInstall) {
+            info('已跳过依赖安装（--skip-install），请手动执行 npm install');
+            process.exit(0);
+        }
+    }
+
+    log('正在重新安装依赖（能力包为 * 范围，将自动对齐最新版）...');
+    const code = await run('npm', ['install'], { cwd: projectRoot });
+    if (code !== 0) {
+        error('依赖安装失败');
+        process.exit(code);
+    }
+    success('升级完成');
+}
+
+module.exports = main;
+
+if (require.main === module) {
+    main(process.argv.slice(2)).catch((err) => {
+        error(err.message || err);
+        process.exit(1);
+    });
+}