@lark-apaas/miaoda-cli 0.1.16-alpha.f013f1c → 0.1.16-beta.6cd807b

package/dist/cli/commands/app/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAppCommands = registerAppCommands;
+const commander_1 = require("commander");
 const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../cli/handlers/app/index");
 const index_2 = require("../../../config/migrate-configs/index");
@@ -30,8 +31,13 @@ function registerAppMigrate(parent) {
     const supportedDesc = (0, index_2.listSupportedMigrations)()
         .map((m) => `${m.from} → ${m.to}`)
         .join(', ');
-    const cmd = parent
-        .command('migrate')
+    // 渐进式披露：migrate 是给妙搭平台 / 用户主动触发的命令，**不暴露给 Agent**。
+    //   - `miaoda app -h` / `miaoda app help` 都不列出此命令
+    //   - 但 `miaoda app migrate --to xxx` 仍能直接调用（仅命令注册时打 hidden 标记，行为不变）
+    //   - `--help` 也不显示 ——commander hidden 命令仅显式 invoke 时才暴露
+    // 用 addCommand(cmd, { hidden: true }) 而非 parent.command(...)，因为 commander 13
+    // 的 fluent `.command()` 不支持设置 hidden。
+    const cmd = new commander_1.Command('migrate')
         .description('跨 stack 原地迁移：按 MigrateConfig 全套 apply（move + delete + 模板覆盖 + 字段 merge + set-stack）')
         .requiredOption('--to <stack>', '目标 stack 短名')
         .option('--from <stack>', '源 stack；默认读 .spark/meta.json 当前 stack')
@@ -40,19 +46,6 @@ function registerAppMigrate(parent) {
 已支持的迁移路径
   ${supportedDesc || '(none)'}
 
-执行流
-  1. 校验 .spark/meta.json 存在且当前 stack 匹配 --from（或自动读 meta）
-  2. 按 (from, to) 在 src/config/migrate-configs/ 取 MigrateConfig
-  3. 顺序执行 rules：
-       move-directory / move-file   → 用户领地搬到新布局（src → client/src 等）
-       delete-file / delete-directory → 清理老 stack 的残留文件
-       delete-json-keys             → 从 user package.json 删 vite-react 专属字段
-       file / directory             → 拷新 stack 的模板资产覆盖
-       merge-json                   → package.json 等字段级深合并
-       add-script / patch-script / add-line / remove-line → 局部修补
-       set-stack                    → 收尾切 .spark/meta.json 的 stack 字段
-  4. 不做 npm install —— 让用户自行 review 改动后再装依赖（package-lock.json 已删）
-
 JSON 输出
   {"data": {"from": "...", "to": "...",
             "appliedRules": [{"type": "...", "action": "...", "path": "...", "detail": "..."}],
@@ -72,6 +65,7 @@ JSON 输出
             to: rawOpts.to,
         });
     }));
+    parent.addCommand(cmd, { hidden: true });
 }
 function registerAppSync(parent) {
     const cmd = parent

package/dist/cli/commands/deploy/modern.js

@@ -16,6 +16,7 @@ function registerDeployCommandsModern(program) {
         .description('触发 modern 应用发布：本地构建 + 本地部署（preRelease + localPublish）')
         .option('--dir <path>', '项目目录', '.')
         .option('--skip-build', '跳过 build 步骤（已构建好时使用）', false)
+        .option('--conf <json>', '关联元信息 JSON，仅识别 checkPointVersion / commitID 两字段')
         .addHelpText('after', `
 不要用异步模式或后台模式调用 deploy，否则调用可能提前结束，Agent 会误判发布已完成。
 
@@ -32,6 +33,12 @@ function registerDeployCommandsModern(program) {
   6. savePluginInstances（扫描 dist/output_capabilities/*.json 批量注册）
   7. finalizeLocalRelease(Finished|Failed)
 
+--conf（关联元信息透传）
+  值为 JSON string，只识别两个字段，其余 key 忽略：
+    checkPointVersion  关联的 checkpoint 版本
+    commitID           关联的代码 commit ID
+  两字段均可选；非法 JSON / 非对象 / 字段值非字符串会报错。
+
 JSON 输出（stdout）
   {"data": {"appId": "...", "version": <n>, "url": "...", "releaseID": "...", "preReleaseID": "..."}}
 
@@ -39,12 +46,14 @@ JSON 输出（stdout）
   $ miaoda deploy
   $ miaoda deploy --dir ./my-app
   $ miaoda deploy --skip-build
+  $ miaoda deploy --conf '{"checkPointVersion":"v3","commitID":"a1b2c3d"}'
 `);
     deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
         await (0, modern_1.handleDeployModern)({
             dir: rawOpts.dir ?? '.',
             appId: (0, shared_1.resolveAppId)({}),
             skipBuild: rawOpts.skipBuild,
+            conf: rawOpts.conf,
         });
     }));
 }

package/dist/cli/handlers/app/migrate.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleAppMigrate = handleAppMigrate;
+const node_child_process_1 = require("node:child_process");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -30,11 +31,14 @@ const logger_1 = require("../../../utils/logger");
  *   2. 拿到 (from, to) 对应的 MigrateConfig 与模板源根目录
  *   3. 顺序执行 rules：move-* → delete-* → delete-json-keys → file/directory →
  *      merge-json → set-stack
- *   4. emit 结果；不做 npm install（用户接下来跑 `npm install` 或 `miaoda app sync` 时自然装）
+ *   4. 清掉 node_modules（package-lock.json 已经在 rules 里 delete），跑 npm install
+ *      物化新依赖集合 —— migrate 改了 dependencies / devDependencies 集合（删 lite +
+ *      加 NestJS 全套），不重装就跑不起来。
+ *      同一条 npm install 顺手把 config.followLatestPackages 钉 `@latest`，覆盖
+ *      template caret range 拉不到 pre-release 的盲区（详见 MigrateConfig 注释）。
  *
  * 不做事：
  *   - 不自动 commit / stash —— 让用户自己用 git review 改动
- *   - 不跑 npm install —— 留给后续 sync 或用户手动
  *   - 不动 .agent/skills/（那是 miaoda skills sync 的事，迁移后用户应该单独跑一次切到新 stack 的 skills）
  */
 async function handleAppMigrate(opts) {
@@ -94,6 +98,42 @@ async function handleAppMigrate(opts) {
     // 的 miaodaTemplate.archType 拿到的动态值，rule 配置时不知道，由 handler 在拿到
     // renderTemplate 结果后单独写。version 也一并写回方便 sync 后续诊断。
     (0, spark_meta_1.writeSparkMeta)(targetDir, { archType: templateArchType, version: templateVersion });
+    // 清掉 user app 的 node_modules —— migrate 改了 dependencies 集合（删 lite + 加 NestJS
+    // 全套）+ rule 已经把 package-lock.json 删了。如果 node_modules 留着，npm install 时旧
+    // 包还在 node_modules 顶层 hoist 树里，可能跟新 package.json spec 撞 peer 冲突
+    // （比如旧 coding-preset-vite-react@1.0.8 peer vite@^8 跟新 vite@^7 撞）。
+    // 软失败：node_modules 不存在不报错。
+    const nodeModulesPath = node_path_1.default.join(targetDir, 'node_modules');
+    if (node_fs_1.default.existsSync(nodeModulesPath)) {
+        (0, logger_1.log)('migrate', '清理 node_modules（dependencies 集合已变）...');
+        node_fs_1.default.rmSync(nodeModulesPath, { recursive: true, force: true });
+    }
+    // 跑 npm install 物化新依赖集合 + 把 followLatestPackages 钉 latest
+    // --ignore-scripts 绕开 action-plugin postinstall 在缺平台 env 时的 ENOENT
+    // --registry 钉同一份 npmmirror（跟 init / sync 行为一致）
+    // 软失败：install 挂了不阻断 emit；用户拿到详细 error，自行 npm install 兜底
+    const followLatest = config.followLatestPackages ?? [];
+    const installArgs = [
+        'install',
+        '--no-audit',
+        '--no-fund',
+        '--ignore-scripts',
+        '--registry',
+        (0, index_2.resolveNpmInstallRegistry)(),
+        ...followLatest.map((pkg) => `${pkg}@latest`),
+    ];
+    (0, logger_1.log)('migrate', `Running npm ${installArgs.join(' ')}...`);
+    let installError;
+    try {
+        (0, node_child_process_1.execFileSync)('npm', installArgs, {
+            cwd: targetDir,
+            stdio: (0, output_1.isJsonMode)() ? ['ignore', 'ignore', 'inherit'] : 'inherit',
+        });
+    }
+    catch (err) {
+        installError = err instanceof Error ? err.message : String(err);
+        (0, logger_1.log)('migrate', `⚠ npm install failed (continuing): ${installError}`);
+    }
     (0, output_1.emit)({
         data: {
             from,
@@ -106,9 +146,10 @@ async function handleAppMigrate(opts) {
                 detail: r.detail,
             })),
             ...summarizeResults(results),
+            followLatestPackages: followLatest,
+            installError,
             nextActions: [
                 'git status / git diff 评估改动并 commit',
-                'npm install 装新依赖（package-lock.json 已被删除，将重新生成）',
                 'miaoda skills sync 同步到新 stack 的 agent skills',
             ],
         },

package/dist/cli/handlers/deploy/modern.js

@@ -3,10 +3,46 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDeployConf = parseDeployConf;
 exports.handleDeployModern = handleDeployModern;
 const node_path_1 = __importDefault(require("node:path"));
 const output_1 = require("../../../utils/output");
+const error_1 = require("../../../utils/error");
 const index_1 = require("../../../services/deploy/modern/index");
+const CONF_EXPECTED = '期望形如 {"checkPointVersion":"...","commitID":"..."} 的 JSON 对象';
+/**
+ * 解析 `--conf` JSON string，只取 checkPointVersion / commitID 两个白名单字段。
+ * - 未传 → 返回 {}（行为不变）。
+ * - 非法 JSON / 非 object / 字段值非 string → 抛 DEPLOY_CONF_INVALID。
+ * - 空串字段视为未提供（不进 body，保持可选语义）；未知 key 忽略。
+ */
+function parseDeployConf(raw) {
+    if (raw === undefined || raw === '')
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new error_1.AppError('DEPLOY_CONF_INVALID', `--conf 不是合法 JSON，${CONF_EXPECTED}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new error_1.AppError('DEPLOY_CONF_INVALID', `--conf 必须是 JSON 对象，${CONF_EXPECTED}`);
+    }
+    const source = parsed;
+    const conf = {};
+    for (const key of ['checkPointVersion', 'commitID']) {
+        const value = source[key];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string') {
+            throw new error_1.AppError('DEPLOY_CONF_INVALID', `--conf.${key} 必须是字符串，${CONF_EXPECTED}`);
+        }
+        if (value !== '')
+            conf[key] = value;
+    }
+    return conf;
+}
 /**
  * miaoda deploy（modern scene 专用，CLI 表面对齐 openclaw-cli）
  *
@@ -14,10 +50,13 @@ const index_1 = require("../../../services/deploy/modern/index");
  */
 async function handleDeployModern(opts) {
     const projectDir = node_path_1.default.resolve(opts.dir);
+    const conf = parseDeployConf(opts.conf);
     const result = await (0, index_1.runModernDeploy)({
         projectDir,
         appId: opts.appId,
         skipBuild: opts.skipBuild ?? false,
+        checkPointVersion: conf.checkPointVersion,
+        commitID: conf.commitID,
     });
     (0, output_1.emit)({
         data: {

package/dist/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js

@@ -55,18 +55,28 @@ exports.MIGRATE_CONFIG = {
                 'dependencies.@lark-apaas/client-toolkit-lite',
             ],
         },
-        // ===== 4. NestJS server runtime 资产（新增，不覆盖 user 已有同名文件） =====
+        // ===== 4. fullstack 形态必需资产（覆盖 user 已有同名文件） =====
         // server/ 整目录：main.ts / app.module.ts / common/ / modules/view/ 等（fullstack 必需）
         { type: 'directory', from: 'server', to: 'server', overwrite: true },
         // nest-cli.json：nest build 入口
         { type: 'file', from: 'nest-cli.json', to: 'nest-cli.json', overwrite: true },
-        // tsconfig.node.json：server 端 ts 编译配置
+        // tsconfig.* —— vite-react 时代 tsconfig 配 include: ["src"]，迁完代码搬到 client/src，
+        // include 路径不对 + 老 tsconfig.app 还 extends @lark-apaas/coding-presets-react；
+        // 整体覆盖到 fullstack 版本（include 改 client/** + shared/**、extends fullstack-presets）。
+        // user 自己加的 paths / strict 等设置如有需要，按 git diff 手动加回。
+        { type: 'file', from: 'tsconfig.json', to: 'tsconfig.json', overwrite: true },
+        { type: 'file', from: 'tsconfig.app.json', to: 'tsconfig.app.json', overwrite: true },
         { type: 'file', from: 'tsconfig.node.json', to: 'tsconfig.node.json', overwrite: true },
+        // ESLint 9 flat config —— vite-react 用 eslint.config.mjs 已删，fullstack 用
+        // eslint.config.js (commonjs) + extends @lark-apaas/fullstack-presets；user 通常不改
+        { type: 'file', from: 'eslint.config.js', to: 'eslint.config.js', overwrite: true },
         // client/index.html：HBS 模板（fullstack 用，vite-react 用根 index.html 已删）
         { type: 'file', from: 'client/index.html', to: 'client/index.html', overwrite: true },
-        // scripts/dev.sh + build.sh：并发起 nest + vite 的脚本（fullstack 形态必需）
-        { type: 'file', from: 'scripts/dev.sh', to: 'scripts/dev.sh', overwrite: true },
-        { type: 'file', from: 'scripts/build.sh', to: 'scripts/build.sh', overwrite: true },
+        // scripts/ 整目录：fullstack 形态启动 / 构建 / lint 所需的 8 个平台脚本（dev.sh /
+        // dev.js / dev-local.js / build.sh / lint.js / prune-smart.js / run.sh / hooks/）。
+        // dev.sh exec node dev.js，dev.js 才是并发起 nest + vite 的核心 —— 漏一个 dev 跑不起来。
+        // overwrite: true：这些脚本由平台 cli 维护，user 一般不改；按 fullstack 版本覆盖。
+        { type: 'directory', from: 'scripts', to: 'scripts', overwrite: true },
         // .githooks（fallback，user 已有则保留）
         { type: 'directory', from: '.githooks', to: '.githooks', overwrite: false },
         // shared/ fallback（user 已有同名文件保留，template 新增文件加入）
@@ -183,6 +193,10 @@ exports.MIGRATE_CONFIG = {
                 '@types/node',
                 // 并发跑 nest + vite（scripts/dev.sh 用 concurrently）
                 'concurrently',
+                // fullstack server 端 tsconfig.node.json 通过 extends 引这个包
+                // （@lark-apaas/fullstack-presets/lib/simple/tsconfig/tsconfig.node.json）;
+                // 不装会导致 nest build / type:check:server / vite dev 解析 tsconfig 时 ENOENT
+                '@lark-apaas/fullstack-presets',
             ],
         },
         // ===== 7. 业务代码 codemod：lite → client-toolkit 包名替换 =====
@@ -198,5 +212,10 @@ exports.MIGRATE_CONFIG = {
         // ===== 9. 切 stack =====
         { type: 'set-stack', stack: 'nestjs-react-fullstack' },
     ],
+    // install 收尾要钉 latest 的关键平台包 —— 见 MigrateConfig.followLatestPackages 注释。
+    //   - client-toolkit：codemod 后业务代码依赖 lite 兼容 API（getCurrentUserProfile 等），
+    //     这些 API 当前只在 alpha 版本里。template caret range 不匹配 pre-release，必须显式 latest。
+    //   - coding-preset-vite-react：本次切到 MIAODA_APP_TYPE='3' env 检测，老版本 preset 不认 env。
+    followLatestPackages: ['@lark-apaas/client-toolkit', '@lark-apaas/coding-preset-vite-react'],
 };
 exports.default = exports.MIGRATE_CONFIG;

package/dist/services/app/init/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
@@ -10,3 +10,4 @@ Object.defineProperty(exports, "readSparkMeta", { enumerable: true, get: functio
 Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: function () { return spark_meta_1.writeSparkMeta; } });
 var install_1 = require("./install");
 Object.defineProperty(exports, "installDependencies", { enumerable: true, get: function () { return install_1.installDependencies; } });
+Object.defineProperty(exports, "resolveNpmInstallRegistry", { enumerable: true, get: function () { return install_1.resolveNpmInstallRegistry; } });

package/dist/services/deploy/modern/atoms/local-release.js

@@ -10,8 +10,13 @@ const logger_1 = require("../../../../utils/logger");
  * 创建本地发布单（加锁；不挂 pipeline）。
  * 返回的 releaseId 必须由 finalizeLocalRelease 翻为终态，否则发布单一直挂着。
  */
-async function createLocalRelease(appId, version) {
-    return (0, index_1.createLocalRelease)({ appID: appId, version });
+async function createLocalRelease(appId, version, extra) {
+    return (0, index_1.createLocalRelease)({
+        appID: appId,
+        version,
+        checkPointVersion: extra?.checkPointVersion,
+        commitID: extra?.commitID,
+    });
 }
 /**
  * 把本地发布单翻为终态。Finished / Failed 由 pipeline 视上下游结果决定。

package/dist/services/deploy/modern/pipelines/local.js

@@ -43,7 +43,10 @@ async function localBuildLocalPublishPipeline(opts) {
         });
     }
     (0, logger_1.log)('deploy', 'Creating local release...');
-    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version);
+    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version, {
+        checkPointVersion: opts.checkPointVersion,
+        commitID: opts.commitID,
+    });
     try {
         (0, logger_1.log)('deploy', 'Uploading artifacts...');
         await (0, index_1.uploadArtifacts)({ projectDir: ctx.projectDir, appId: ctx.appId, data });

package/dist/utils/migrate-rule.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyMigrateRules = applyMigrateRules;
 exports.rewriteViteConfigForFullstack = rewriteViteConfigForFullstack;
+exports.rewriteAliasSrcPaths = rewriteAliasSrcPaths;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const sync_rule_1 = require("./sync-rule");
@@ -182,260 +183,71 @@ function applyCodemodViteConfigFullstack(rule, opts) {
         return { rule, action: 'skipped', path: rel };
     }
     const before = node_fs_1.default.readFileSync(dest, 'utf-8');
-    const { text, changed, alreadyDone } = rewriteViteConfigForFullstack(before);
-    if (alreadyDone) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rel} (fullstack: true already present)`);
+    const { text, aliasRewriteCount } = rewriteViteConfigForFullstack(before);
+    if (aliasRewriteCount === 0) {
+        (0, logger_1.log)(logPrefix, `  ○ ${rel} (no src alias path to rewrite)`);
         return { rule, action: 'noop', path: rel };
     }
-    if (!changed) {
-        (0, logger_1.log)(logPrefix, `  ⚠ ${rel} (defineConfig call not found; please add { fullstack: true } manually)`);
-        return { rule, action: 'noop', path: rel, detail: 'defineConfig call not found' };
-    }
     node_fs_1.default.writeFileSync(dest, text);
-    (0, logger_1.log)(logPrefix, `  ✓ ${rel} (added { fullstack: true } to defineConfig)`);
-    return { rule, action: 'patched', path: rel };
+    (0, logger_1.log)(logPrefix, `  ✓ ${rel} (rewrote ${aliasRewriteCount.toString()} alias path(s) src → client/src)`);
+    return {
+        rule,
+        action: 'patched',
+        path: rel,
+        detail: `${aliasRewriteCount.toString()} alias path(s)`,
+    };
 }
 /**
- * 给 vite.config.ts 的 `defineConfig(...)` 调用加上 `{ fullstack: true }` 第二参。
+ * 把 vite.config.ts 里 alias 字符串里 `src` 起头的路径重写到 `client/src`。
  *
- * 支持的形态：
- *   defineConfig({ ... })             → defineConfig({ ... }, { fullstack: true })
- *   defineConfig({ ... }, { ... })    → 已有第二参，把 fullstack: true 注入对象字面量
- *   defineConfig()                    → defineConfig({}, { fullstack: true })
+ * vite-react 时代 user 业务代码在 `src/`，迁移后搬到 `client/src/`，vite.config
+ * 里的 alias（典型如 `'@': path.resolve(__dirname, 'src')`）必须同步改：
+ *   path.resolve(<args>, 'src')        → 'src' 替换为 'client/src'
+ *   path.resolve(<args>, 'src/<rest>') → 同上
+ *   path.join(<args>, 'src')           → 同上
+ *   './src' / './src/<rest>' 字符串    → './client/src' / './client/src/<rest>'
+ * 边界：仅匹配整段 'src' 起头（避免 'sub/src' 误改），保留单/双引号原样。
  *
- * 跨多行 + 嵌套 arrow function / 字符串 / 模板字符串都要保留，所以用括号匹配而非正则。
- * 已经含 `fullstack: true` 字面量则跳过（视为已迁移）。
+ * 注：fullstack 形态识别 **不再** 通过 `defineConfig` 的 option 第二参，而是
+ * 由 `coding-preset-vite-react` 内部读 `process.env.MIAODA_APP_TYPE === '3'`
+ * 自动判断（fullstack stack 的 archType 是 3）—— 所以 vite.config 完全不需要
+ * 加 option，只需 alias 路径同步即可。
  */
 function rewriteViteConfigForFullstack(source) {
-    const callRe = /defineConfig\s*\(/g;
-    const m = callRe.exec(source);
-    if (m === null) {
-        return { text: source, changed: false, alreadyDone: false };
-    }
-    const openIdx = m.index + m[0].length - 1; // 指向 '('
-    const closeIdx = findMatchingParen(source, openIdx);
-    if (closeIdx < 0) {
-        return { text: source, changed: false, alreadyDone: false };
-    }
-    const argsRaw = source.slice(openIdx + 1, closeIdx);
-    if (/fullstack\s*:\s*true/.test(argsRaw)) {
-        return { text: source, changed: false, alreadyDone: true };
-    }
-    const { firstArgEnd, secondArgRange } = splitFirstTwoArgs(source, openIdx + 1, closeIdx);
-    if (secondArgRange === null) {
-        // 单参 / 无参：在第一参之后插 ", { fullstack: true }"
-        const insertAt = firstArgEnd ?? openIdx + 1;
-        const head = source.slice(0, insertAt);
-        const tail = source.slice(insertAt, closeIdx);
-        // 第一参是否非空（去空白）
-        const arg1 = source.slice(openIdx + 1, insertAt).trim();
-        const sep = arg1.length === 0 ? '{}, { fullstack: true }' : ', { fullstack: true }';
-        return {
-            text: head + (arg1.length === 0 ? sep : sep) + tail + source.slice(closeIdx),
-            changed: true,
-            alreadyDone: false,
-        };
-    }
-    // 双参：在第二参对象 `{` 之后插 ` fullstack: true,`
-    const arg2 = source.slice(secondArgRange.start, secondArgRange.end);
-    const objOpen = arg2.indexOf('{');
-    if (objOpen < 0) {
-        // 第二参不是对象字面量（罕见），保守跳过
-        return { text: source, changed: false, alreadyDone: false };
-    }
-    const absObjOpen = secondArgRange.start + objOpen;
-    const inserted = '\n  fullstack: true,';
-    return {
-        text: source.slice(0, absObjOpen + 1) + inserted + source.slice(absObjOpen + 1),
-        changed: true,
-        alreadyDone: false,
-    };
+    const { text, count } = rewriteAliasSrcPaths(source);
+    return { text, aliasRewriteCount: count };
 }
 /**
- * 从 openIdx（指向 `(`）开始扫到匹配的 `)`，跳过 string / template / 括号嵌套。
- * 找不到匹配返回 -1。
- */
-function findMatchingParen(text, openIdx) {
-    let depth = 0;
-    let i = openIdx;
-    let inSingle = false;
-    let inDouble = false;
-    let inTpl = false;
-    let inLineComment = false;
-    let inBlockComment = false;
-    while (i < text.length) {
-        const c = text[i];
-        const next = i + 1 < text.length ? text[i + 1] : '';
-        if (inLineComment) {
-            if (c === '\n')
-                inLineComment = false;
-            i++;
-            continue;
-        }
-        if (inBlockComment) {
-            if (c === '*' && next === '/') {
-                inBlockComment = false;
-                i += 2;
-                continue;
-            }
-            i++;
-            continue;
-        }
-        if (inSingle) {
-            if (c === '\\')
-                i += 2;
-            else if (c === "'") {
-                inSingle = false;
-                i++;
-            }
-            else
-                i++;
-            continue;
-        }
-        if (inDouble) {
-            if (c === '\\')
-                i += 2;
-            else if (c === '"') {
-                inDouble = false;
-                i++;
-            }
-            else
-                i++;
-            continue;
-        }
-        if (inTpl) {
-            if (c === '\\')
-                i += 2;
-            else if (c === '`') {
-                inTpl = false;
-                i++;
-            }
-            else
-                i++;
-            continue;
-        }
-        if (c === '/' && next === '/') {
-            inLineComment = true;
-            i += 2;
-            continue;
-        }
-        if (c === '/' && next === '*') {
-            inBlockComment = true;
-            i += 2;
-            continue;
-        }
-        if (c === "'") {
-            inSingle = true;
-            i++;
-            continue;
-        }
-        if (c === '"') {
-            inDouble = true;
-            i++;
-            continue;
-        }
-        if (c === '`') {
-            inTpl = true;
-            i++;
-            continue;
-        }
-        if (c === '(' || c === '{' || c === '[') {
-            depth++;
-            i++;
-            continue;
-        }
-        if (c === ')' || c === '}' || c === ']') {
-            depth--;
-            if (depth === 0 && c === ')')
-                return i;
-            i++;
-            continue;
-        }
-        i++;
-    }
-    return -1;
-}
-/**
- * 在 `argsStart`（`(` 之后第一字符）到 `argsEnd`（`)` 位置）范围内识别顶层 `,`，
- * 拿到第一参结束位置和（如果存在）第二参的范围。
+ * vite.config 里 alias 路径重写：`src` 起头的路径加 `client/` 前缀。
+ *
+ * 匹配的形态（不限制在 resolve.alias 块内 —— vite.config 顶层很少出现非 alias 用的
+ * `src` 字符串，业务 import 走 `@/...`，所以全文匹配是安全的）：
+ *
+ *   path.resolve(<args>, 'src')             → path.resolve(<args>, 'client/src')
+ *   path.resolve(<args>, 'src/<rest>')      → path.resolve(<args>, 'client/src/<rest>')
+ *   path.join(<args>, 'src')                → 同上
+ *   './src' / './src/<rest>'（独立字符串）  → './client/src' / './client/src/<rest>'
+ *
+ * 已含 `client/src` 的不动（视为已迁移），`sub/src` 之类（src 不在词首）不动。
  */
-function splitFirstTwoArgs(text, argsStart, argsEnd) {
-    let depth = 0;
-    let i = argsStart;
-    let inSingle = false;
-    let inDouble = false;
-    let inTpl = false;
-    let firstComma = -1;
-    while (i < argsEnd) {
-        const c = text[i];
-        if (inSingle) {
-            if (c === '\\') {
-                i += 2;
-                continue;
-            }
-            if (c === "'")
-                inSingle = false;
-            i++;
-            continue;
-        }
-        if (inDouble) {
-            if (c === '\\') {
-                i += 2;
-                continue;
-            }
-            if (c === '"')
-                inDouble = false;
-            i++;
-            continue;
-        }
-        if (inTpl) {
-            if (c === '\\') {
-                i += 2;
-                continue;
-            }
-            if (c === '`')
-                inTpl = false;
-            i++;
-            continue;
-        }
-        if (c === "'") {
-            inSingle = true;
-            i++;
-            continue;
-        }
-        if (c === '"') {
-            inDouble = true;
-            i++;
-            continue;
-        }
-        if (c === '`') {
-            inTpl = true;
-            i++;
-            continue;
-        }
-        if (c === '(' || c === '{' || c === '[') {
-            depth++;
-            i++;
-            continue;
-        }
-        if (c === ')' || c === '}' || c === ']') {
-            depth--;
-            i++;
-            continue;
-        }
-        if (c === ',' && depth === 0) {
-            firstComma = i;
-            break;
-        }
-        i++;
-    }
-    if (firstComma < 0) {
-        return { firstArgEnd: argsEnd, secondArgRange: null };
-    }
-    return {
-        firstArgEnd: firstComma,
-        secondArgRange: { start: firstComma + 1, end: argsEnd },
-    };
+function rewriteAliasSrcPaths(source) {
+    let count = 0;
+    // path.resolve(...) / path.join(...) 的最后一个参数是 'src' 或 'src/...' 起头
+    // 匹配 ['"]src[/'"]，保留引号
+    const pathCallRe = /(\bpath\s*\.\s*(?:resolve|join)\s*\([^)]*?,\s*)(['"`])(src)(\/[^'"`]*)?(['"`])/g;
+    let next = source.replace(pathCallRe, (_match, prefix, q1, _src, rest, q2) => {
+        count++;
+        return `${prefix}${q1}client/src${rest ?? ''}${q2}`;
+    });
+    // 独立的相对路径字符串字面量 './src' 或 './src/...'（不在 path.resolve 参数里）
+    // 注意：path.resolve / join 已被上一步处理，这里只匹配剩下的 './src...' 字面量。
+    // 这种用法在 vite.config 较少（典型是直接给 alias 字符串值），但兜底处理。
+    const relativeRe = /(['"`])\.\/(src)(\/[^'"`]*)?(['"`])/g;
+    next = next.replace(relativeRe, (_match, q1, _src, rest, q2) => {
+        count++;
+        return `${q1}./client/src${rest ?? ''}${q2}`;
+    });
+    return { text: next, count };
 }
 function applyAddDepsFromTemplate(rule, opts) {
     const logPrefix = opts.logPrefix ?? 'migrate';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.16-alpha.f013f1c",
+  "version": "0.1.16-beta.6cd807b",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {