@lark-apaas/miaoda-cli 0.1.33-alpha.59a1bf2 → 0.1.33-alpha.d63e9fb

package/README.md

@@ -48,9 +48,32 @@ miaoda file ls --output json
 | `miaoda observability ...` | 线上日志、链路、前端源码堆栈反查、监控指标、运营指标 |
 | `miaoda comment ...`       | 应用评论：查看评论列表、解决评论（仅 design-html 场景开放）        |
 | `miaoda registry ...`      | 组件 registry：列出 / copy-in SDK 文件（本地执行）                 |
+| `miaoda app ...`           | 应用生命周期：元数据、初始化、平台同步、源码导出、静态产物导出     |
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
 
+## 打包可本地访问的静态产物
+
+`miaoda app pack`（默认 `--mode standalone`）把当前应用构建成一份自包含静态产物，可脱离妙搭平台本地打开。
+
+```bash
+miaoda app pack                    # → dist/standalone.zip（中间目录打完即删）
+miaoda app pack --out dist/share
+miaoda app pack --json
+miaoda app pack --upload-url 'https://tos.example.com/x.zip?sign=...'
+```
+
+支持 `design-html` / `html` / `vite-react` / `nestjs-react-fullstack`。页面与代码里字面以
+`/spark/app` 开头的存储图片会经沙箱网关（localhost:8080）下载到 `images/` 并改写成相对路径。
+
+默认输出落在 `dist/` 下是刻意的：`dist` 已在部署扫描的 EXCLUDES 与各模板 `.gitignore` 中，
+产物不会污染部署包、不会被误提交；代价是下一次构建会清掉它。
+
+**只保证纯静态可看** —— 接口调用会失败，不做数据快照。多路由 SPA 在 `file://` 下不可用
+（`BrowserRouter` 匹配不上路径），需用本地 HTTP server 打开，命令会在 `warnings` 里提示。
+
+> 与 `miaoda app export` **语义无关**：后者拉的是**其他应用**的源码归档（创意应用升级链路的只读参考物）。
+
 ## 组件 registry
 
 `miaoda registry` 提供 shadcn 式的「组件 registry」：把 SDK 文件**拷进**当前项目（copy-in），而非作为依赖安装。registry 是独立 npm 包，按运行时分发（design-html / html → buildless runtime → `@lark-apaas/coding-registry-buildless`）。

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

@@ -22,6 +22,7 @@ function registerAppCommands(program, opts = {}) {
     registerAppGet(appCmd);
     registerAppUpdate(appCmd);
     registerAppExport(appCmd);
+    registerAppPack(appCmd);
     if (opts.includeInit) {
         registerAppInit(appCmd);
         registerAppSync(appCmd);
@@ -127,6 +128,10 @@ function registerAppExport(parent) {
         .option('--out <dir>', '输出目录（相对当前目录）', 'source_package/creative')
         .option('--checkpoint <n>', '按检查点版本导出；缺省为最新提交（HEAD）')
         .addHelpText('after', `
+与 'miaoda app pack' 的区别（**两个命令语义无关，别选错**）
+  app export             拉「其他应用」的源码归档（本命令）
+  app pack               把「当前应用」打包成产物（默认 standalone 形态）
+
 说明
   从服务端导出源应用（可以不是当前应用）的源码归档并解压到 --out 目录，导出完成后写
   --out/.upgrade-manifest.json（含 sourceAppId / 导出时间 / 文件数），供升级链路幂等
@@ -173,6 +178,82 @@ JSON 输出
         });
     }));
 }
+function registerAppPack(parent) {
+    const cmd = parent
+        .command('pack')
+        .description('打包应用产物。默认 standalone 模式：自包含静态产物（目录 + zip），可脱离妙搭平台本地访问')
+        .option('--dir <path>', '项目目录，默认 cwd（需含 .spark/meta.json）')
+        .option('--mode <mode>', `打包形态（${index_1.PACK_MODES.join(' / ')}）`, index_1.DEFAULT_PACK_MODE)
+        .option('--out <dir>', '产物路径（相对项目根），实际产出 <out>.zip', index_1.DEFAULT_PACK_OUT)
+        .option('--upload-url <url>', '打包后把 zip 以 PUT 上传到该预签名 URL（http/https）；上传成功后清掉本地产物')
+        .addHelpText('after', `
+与 'miaoda app export' 的区别（**两个命令语义无关，别选错**）
+  app export   拉「其他应用」的源码归档（创意应用升级链路的只读参考物）
+  app pack     把「当前应用」打包成产物（本命令）
+
+打包形态（--mode）
+  standalone（默认）  自包含静态产物，可脱离妙搭平台本地访问
+  后续新增形态时在此列出；不传 --mode 的行为永远等同 standalone。
+
+支持的 stack
+  design-html / html / vite-react / nestjs-react-fullstack
+
+产物
+  <out>.zip       **唯一交付物**。内含 index.html + assets/ + images/
+                  （+ static/，vite 系有 shared/static 时）
+  <out>/          打包用的中间目录，**打完包即删除**——它与 zip 内容重复，
+                  留着占双份磁盘。要预览请先解压。
+  传了 --upload-url 时，zip 会以 PUT 裸 body（Content-Type: application/zip）
+  上传到该地址——预签名 URL 的标准形态，鉴权由 URL 自带签名承担，不加额外 header。
+  **上传成功后本地 zip 也会被清掉**（目录本就已删），交付物以远端为准，
+  JSON 里 localRemoved=true。上传失败则保留 zip，便于修正后重跑或手动上传。
+  默认 <out> 是 dist/standalone —— 落在 dist/ 下是刻意的：dist 已在部署扫描的
+  EXCLUDES 与各模板 .gitignore 中，产物不会污染部署包、不会被误提交。
+  代价：下一次构建会 rm -rf dist，导出产物是易失的。
+
+图片本地化
+  只处理页面/代码里字面以 /spark/app 开头的 URL，经沙箱网关（localhost:8080）下载到
+  <out>/images/ 并改写成相对路径。其它挂载前缀（/spark/p/、/app/<id>、反代）不处理。
+  接口运行时返回的 download_url 属动态 URL，静态扫描覆盖不到。
+
+已知限制
+  只保证纯静态可看——接口调用会失败，不做数据快照。
+  多路由 SPA 在 file:// 下不可用（BrowserRouter 匹配不上路径、pushState 抛 SecurityError），
+  请用本地 HTTP server 打开；检测到时会在 warnings 里给 SPA_ROUTER_FILE_PROTOCOL。
+  design-html 的 cd-elements SDK 是 CDN 外链，断网打开自定义元素不渲染。
+
+JSON 输出
+  {"data": {"appId": "...", "stack": "...", "out": "dist/standalone", "zip": "dist/standalone.zip",
+            "fileCount": N, "bytes": N,
+            "images": {"matched": N, "downloaded": N, "failed": [{"url": "...", "reason": "..."}]},
+            "localRemoved": false,
+            "rewrittenFiles": [...],
+            "warnings": [{"code": "...", "message": "..."}]}}
+
+失败
+  单张图片下载失败 → 跳过并计入 images.failed + warnings，退出码 0。
+  命中 > 0 但全部失败 → PACK_IMAGE_ALL_FAILED，退出码 1（系统性问题）。
+  stack 不支持 → PACK_STACK_UNSUPPORTED。
+  构建失败 → PACK_BUILD_FAILED。
+  上传失败（非 2xx / 网络异常）→ PACK_UPLOAD_FAILED，退出码 1。
+    本地产物保留，可修正 URL 后重跑或手动上传。
+  --upload-url 非 http/https → ARGS_INVALID，退出码 2。
+
+示例
+  $ miaoda app pack
+  $ miaoda app pack --out dist/share
+  $ miaoda app pack --json
+  $ miaoda app pack --upload-url 'https://tos.example.com/x.zip?sign=...'
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        await (0, index_1.handleAppPack)({
+            dir: rawOpts.dir,
+            out: rawOpts.out,
+            uploadUrl: rawOpts.uploadUrl,
+            mode: rawOpts.mode,
+        });
+    }));
+}
 function registerAppGet(parent) {
     const cmd = parent
         .command('get')

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

@@ -72,7 +72,7 @@ JSON 输出（stdout）
     }));
     const patchCmd = deployCmd
         .command('patch')
-        .description('design-html 增量发布：按文件 create/update/delete，.html 增删时同步 routes.json')
+        .description('design-html 增量发布：按文件 create/update/delete，.html 变动时同步 routes.json')
         .option('--create <relpath>', '新增文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--update <relpath>', '覆盖已有文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--delete <relpath>', '删除文件（可重复）', shared_1.collectRepeatedOption, [])
@@ -80,10 +80,11 @@ JSON 输出（stdout）
         .addHelpText('after', `
 --dir 为项目目录（与 deploy 同名参数，默认当前目录）。
 仅支持 design-html（design_local_deploy）。路径为工程根相对路径（= 服务端 latest 下 key），
-禁绝对路径与 ".."。--create/--update 的本地文件必须存在。.html 被新增/删除（路由集合变化）
-时自动重算并随包更新 routes.json；纯 --update 现有 .html 只改内容，不动 routes.json。
-routes.json 每项为 {path, file}：path 为相对路径（不含 base 前缀，由消费侧拼接），file 为
-对应源文件（如 / → index.html）。
+禁绝对路径与 ".."。--create/--update 的本地文件必须存在。改动里含任意 .html（增 / 改 / 删）
+时自动重算并随包更新 routes.json；纯非 .html 改动不动 routes.json。
+routes.json 每项为 {path, file, name?}：path 为相对路径（不含 base 前缀，由消费侧拼接），
+file 为对应源文件（如 / → index.html），name 为该 HTML 的 <title> 文本（方案名，可缺省，
+缺省时由消费侧 fallback 到 path）。
 
 JSON 输出
   {"data": {"upsertCount": <n>, "deleteCount": <n>, "actionsSent": <n>, "routesRegenerated": <bool>}}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_STACKS = exports.handleAppMigrate = exports.UPGRADE_MANIFEST_FILENAME = exports.DEFAULT_EXPORT_OUT = exports.handleAppExport = exports.handleAppUpgrade = exports.handleAppSync = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.PACK_MODES = exports.DEFAULT_PACK_MODE = exports.DEFAULT_PACK_OUT = exports.handleAppPack = exports.SUPPORTED_STACKS = exports.handleAppMigrate = exports.UPGRADE_MANIFEST_FILENAME = exports.DEFAULT_EXPORT_OUT = exports.handleAppExport = exports.handleAppUpgrade = exports.handleAppSync = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
 var get_1 = require("./get");
 Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
 var update_1 = require("./update");
@@ -19,3 +19,8 @@ Object.defineProperty(exports, "handleAppMigrate", { enumerable: true, get: func
 // commands 层渲染 help 时需要这份枚举；从 handler barrel 转发，避免 commands → services 越界
 var index_1 = require("../../../services/app/init/index");
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return index_1.SUPPORTED_STACKS; } });
+var pack_1 = require("./pack");
+Object.defineProperty(exports, "handleAppPack", { enumerable: true, get: function () { return pack_1.handleAppPack; } });
+Object.defineProperty(exports, "DEFAULT_PACK_OUT", { enumerable: true, get: function () { return pack_1.DEFAULT_PACK_OUT; } });
+Object.defineProperty(exports, "DEFAULT_PACK_MODE", { enumerable: true, get: function () { return pack_1.DEFAULT_PACK_MODE; } });
+Object.defineProperty(exports, "PACK_MODES", { enumerable: true, get: function () { return pack_1.PACK_MODES; } });

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

@@ -15,7 +15,6 @@ const spark_meta_1 = require("../../../utils/spark-meta");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const env_1 = require("../../../utils/env");
-const preview_control_1 = require("../../../utils/preview-control");
 const logger_1 = require("../../../utils/logger");
 /**
  * miaoda app migrate --to <stack> [--from <stack>] [--dir <path>]
@@ -100,130 +99,78 @@ async function handleAppMigrate(opts) {
     // 的 miaodaTemplate.archType 拿到的动态值，rule 配置时不知道，由 handler 在拿到
     // renderTemplate 结果后单独写。version 也一并写回方便 sync 后续诊断。
     (0, spark_meta_1.writeSparkMeta)(targetDir, { archType: templateArchType, version: templateVersion });
-    // 沙箱环境下先停掉 dev server（预览）—— 保活由 code-server 管，`pkill dev.js` 会被立刻
-    // 重新拉起，拿不到"停住"的状态。dev server 活着时 vite 持续往 node_modules/.vite/deps 写
-    // 文件，下面 rm node_modules 走到顶层 rmdir 时目录又非空，直接 ENOTEMPTY 失败（历史故障）。
-    //   - 只在沙箱内做（本地用户自己管 dev 进程，不该被 CLI 动）
-    //   - 软失败：接口不存在（老版本 code-server 返 404）/ 连不上都不阻断，降级回老路径
-    //     （带重试的 rm + 结尾 pkill 让保活拉起）
-    //   - ⚠️ stop 成功后必须恢复：下面整段包在 try/finally 里，任何异常路径都会走 startPreview
-    let previewStopped = false;
-    let previewStopError;
-    if ((0, env_1.isSandboxEnv)()) {
-        (0, logger_1.log)('migrate', '停止 dev server(预览)以便安全重装依赖...');
-        const stopped = await (0, preview_control_1.stopPreview)({ logPrefix: 'migrate' });
-        previewStopped = stopped.ok;
-        if (!stopped.ok) {
-            previewStopError = stopped.error;
-            (0, logger_1.log)('migrate', `⚠ 停止预览失败 (continuing, 降级为不停 dev 直接重装): ${stopped.error ?? ''}`);
-        }
+    // 清掉 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;
-    let nodeModulesCleanError;
-    let previewRestarted = false;
-    let previewRestartError;
     try {
-        // 清掉 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 撞）。
-        //   - maxRetries：force 只吞 ENOENT，不管 ENOTEMPTY/EBUSY；这类错误 node 只在
-        //     maxRetries>0 时才重试。停预览失败降级时靠它兜住残余写入。
-        //   - 软失败：删不干净也继续跑 npm install 让 npm 自己 reconcile —— 半迁移态
-        //     （package-lock 已删 + 新 deps 没装）比"清理不彻底"糟得多。
-        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 集合已变）...');
+        (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}`);
+    }
+    // 重启 dev process 前清 vite cache —— migrate 改了 package.json + lockfile,
+    // 老 vite 进程的 .vite/deps cache 的 lockfileHash 跟新 lockfile 不一致。
+    // 不清的话 supervisor 拉起的新 vite cold start 会立即 "Re-optimizing because
+    // lockfile has changed", re-optimize 期间 ModuleGraph transform cache 跟
+    // deps middleware metadata 短暂不同步, 浏览器请求老 hash 触发
+    // ERR_OUTDATED_OPTIMIZED_DEP → 504 死锁(详见 fullstack-plugin#1143 的 504
+    // ignoreOutdatedRequests fix 注释)。直接 rm -rf 让新 vite 从干净状态 cold
+    // optimize, 一次写到位 lockfile 一致的 metadata, 不再触发中途 re-optimize。
+    //
+    //   - 只在 SANDBOX_ID 非空时做(本地一般不会撞这条链路)
+    //   - 只在 install 成功时做(install 挂了 node_modules 状态不对, 清 cache 也救不回来)
+    //   - 软失败:.vite 不存在 / 删失败都不阻断
+    if (installError === undefined &&
+        process.env.SANDBOX_ID !== undefined &&
+        process.env.SANDBOX_ID !== '') {
+        const viteCacheDir = node_path_1.default.join(targetDir, 'node_modules', '.vite');
+        if (node_fs_1.default.existsSync(viteCacheDir)) {
+            (0, logger_1.log)('migrate', '清理 node_modules/.vite (vite cache 跟新 lockfile 错位会 504)...');
             try {
-                node_fs_1.default.rmSync(nodeModulesPath, {
-                    recursive: true,
-                    force: true,
-                    maxRetries: 5,
-                    retryDelay: 300,
-                });
+                node_fs_1.default.rmSync(viteCacheDir, { recursive: true, force: true });
             }
             catch (err) {
-                nodeModulesCleanError = err instanceof Error ? err.message : String(err);
-                (0, logger_1.log)('migrate', `⚠ 清理 node_modules 失败 (continuing): ${nodeModulesCleanError}`);
-            }
-        }
-        // 跑 npm install 物化新依赖集合 + 把 followLatestPackages 钉 latest
-        // --ignore-scripts 绕开 action-plugin postinstall 在缺平台 env 时的 ENOENT
-        // --registry 钉同一份 npmmirror（跟 init / sync 行为一致）
-        // 软失败：install 挂了不阻断 emit；用户拿到详细 error，自行 npm install 兜底
-        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(' ')}...`);
-        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}`);
-        }
-        // 重启 dev process 前清 vite cache —— migrate 改了 package.json + lockfile,
-        // 老 vite 进程的 .vite/deps cache 的 lockfileHash 跟新 lockfile 不一致。
-        // 不清的话拉起的新 vite cold start 会立即 "Re-optimizing because
-        // lockfile has changed", re-optimize 期间 ModuleGraph transform cache 跟
-        // deps middleware metadata 短暂不同步, 浏览器请求老 hash 触发
-        // ERR_OUTDATED_OPTIMIZED_DEP → 504 死锁(详见 fullstack-plugin#1143 的 504
-        // ignoreOutdatedRequests fix 注释)。直接 rm -rf 让新 vite 从干净状态 cold
-        // optimize, 一次写到位 lockfile 一致的 metadata, 不再触发中途 re-optimize。
-        //
-        //   - 只在 SANDBOX_ID 非空时做(本地一般不会撞这条链路)
-        //   - 只在 install 成功时做(install 挂了 node_modules 状态不对, 清 cache 也救不回来)
-        //   - 软失败:.vite 不存在 / 删失败都不阻断
-        if (installError === undefined &&
-            process.env.SANDBOX_ID !== undefined &&
-            process.env.SANDBOX_ID !== '') {
-            const viteCacheDir = node_path_1.default.join(targetDir, 'node_modules', '.vite');
-            if (node_fs_1.default.existsSync(viteCacheDir)) {
-                (0, logger_1.log)('migrate', '清理 node_modules/.vite (vite cache 跟新 lockfile 错位会 504)...');
-                try {
-                    node_fs_1.default.rmSync(viteCacheDir, { recursive: true, force: true });
-                }
-                catch (err) {
-                    (0, logger_1.log)('migrate', `⚠ 清 .vite 失败 (continuing): ${err instanceof Error ? err.message : String(err)}`);
-                }
-            }
-        }
-    }
-    finally {
-        // 恢复 dev server —— 只要上面 stop 成功过就必须调，且必须在 finally 里：
-        // rule 应用 / install / 清 cache 任何一步抛异常都不能把保活留在关闭状态，否则用户沙箱
-        // 的预览再也起不来（比迁移失败严重得多）。
-        // 无条件恢复（不看 installError）：dev 进程已经被停了，留着不起来只会更糟；新 scripts/dev.js
-        // + 新依赖也正是靠这次 start 生效。
-        if (previewStopped) {
-            (0, logger_1.log)('migrate', '恢复 dev server(预览)...');
-            const started = await (0, preview_control_1.startPreview)({ logPrefix: 'migrate' });
-            previewRestarted = started.ok;
-            if (!started.ok) {
-                previewRestartError = started.error;
-                (0, logger_1.log)('migrate', `✗ 恢复预览失败, 需人工处理: ${started.error ?? ''}`);
+                (0, logger_1.log)('migrate', `⚠ 清 .vite 失败 (continuing): ${err instanceof Error ? err.message : String(err)}`);
             }
         }
     }
-    // 降级路径：preview stop 没成功（老版本 code-server / 接口连不上），dev 进程还是老的，
-    // 按历史行为 pkill 掉 dev.js 主进程，靠平台 supervisor 自动重新 exec dev.sh → dev.js，
-    // 让新 deps + 新 scripts 生效。
+    // 沙箱环境下重启 dev process —— scripts/dev.js 被 fullstack 版本覆盖了,但当前正在
+    // 跑的 node 进程仍按老逻辑工作(只起 vite,没起 nest),整体没切到 fullstack 模式。
+    // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,
+    // 新进程用新 deps + 新 scripts,正常进入 fullstack 模式。
     //   - 只在沙箱内做(isSandboxEnv;本地环境用户进程混杂,主动 pkill 风险大)
     //   - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
     //     留着旧进程让用户先处理 installError
     //   - 软失败:pkill 无匹配进程退出 1,catch 吞掉
-    let devRestarted = previewRestarted;
-    if (!previewStopped && installError === undefined && (0, env_1.isSandboxEnv)()) {
+    let devRestarted = false;
+    if (installError === undefined && (0, env_1.isSandboxEnv)()) {
         (0, logger_1.log)('migrate', '沙箱环境,重启 dev process(平台 supervisor 会自动拉起)...');
         try {
             (0, node_child_process_1.execFileSync)('pkill', ['-f', 'node.*scripts/dev\\.js'], { stdio: 'ignore' });
@@ -247,22 +194,11 @@ async function handleAppMigrate(opts) {
             ...summarizeResults(results),
             followLatestPackages: followLatest,
             installError,
-            nodeModulesCleanError,
             devRestarted,
-            previewStopped,
-            previewStopError,
-            previewRestarted,
-            previewRestartError,
             nextActions: (0, env_1.isSandboxEnv)()
                 ? [
                     'git status / git diff 评估改动并 commit',
                     'miaoda skills sync 同步到新 stack 的 agent skills',
-                    // 预览恢复失败时置顶一条人工兜底动作 —— 保活已被关掉且不会自愈
-                    ...(previewRestartError === undefined
-                        ? []
-                        : [
-                            `⚠ dev server(预览)未恢复成功，需手动 curl -X POST ${(0, preview_control_1.resolveCodeServerBaseUrl)()}/api/v1/preview/start 恢复保活`,
-                        ]),
                 ]
                 : [
                     'git status / git diff 评估改动并 commit',