@lark-apaas/miaoda-cli 0.1.33-alpha.e318de2 → 0.1.33-alpha.fbcdd20

package/README.md

@@ -48,9 +48,31 @@ 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 export-standalone` 把当前应用构建成一份自包含静态产物，可脱离妙搭平台本地打开。
+
+```bash
+miaoda app export-standalone                    # → dist/standalone/ + dist/standalone.zip
+miaoda app export-standalone --out dist/share
+miaoda app export-standalone --json
+```
+
+支持 `design-html` / `html` / `vite-react` / `nestjs-react-fullstack`。页面与代码里字面以
+`/spark/app` 开头的存储图片会经 dev server 代理下载到 `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);
+    registerAppExportStandalone(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 export-standalone' 的区别（**两个命令语义无关，别选错**）
+  app export             导出源码归档（本命令）
+  app export-standalone  导出可本地访问的构建产物
+
 说明
   从服务端导出源应用（可以不是当前应用）的源码归档并解压到 --out 目录，导出完成后写
   --out/.upgrade-manifest.json（含 sourceAppId / 导出时间 / 文件数），供升级链路幂等
@@ -173,6 +178,65 @@ JSON 输出
         });
     }));
 }
+function registerAppExportStandalone(parent) {
+    const cmd = parent
+        .command('export-standalone')
+        .description('把当前应用构建成自包含静态产物（目录 + zip），可脱离妙搭平台本地访问')
+        .option('--dir <path>', '项目目录，默认 cwd（需含 .spark/meta.json）')
+        .option('--out <dir>', '输出目录（相对项目根）', index_1.DEFAULT_STANDALONE_OUT)
+        .option('--dev-server <url>', 'dev server 基址，默认 http://localhost:${CLIENT_DEV_PORT:-8080}')
+        .addHelpText('after', `
+与 'miaoda app export' 的区别（**两个命令语义无关，别选错**）
+  app export             导出源码归档（创意应用升级链路的只读参考物）
+  app export-standalone  导出可本地访问的构建产物（本命令）
+
+支持的 stack
+  design-html / html / vite-react / nestjs-react-fullstack
+
+产物
+  <out>/          index.html + assets/ + images/（+ static/，vite 系有 shared/static 时）
+  <out>.zip       同内容的压缩包
+  默认 <out> 是 dist/standalone —— 落在 dist/ 下是刻意的：dist 已在部署扫描的
+  EXCLUDES 与各模板 .gitignore 中，产物不会污染部署包、不会被误提交。
+  代价：下一次构建会 rm -rf dist，导出产物是易失的。
+
+图片本地化
+  只处理页面/代码里字面以 /spark/app 开头的 URL，经 dev server 代理下载到
+  <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": "..."}]},
+            "rewrittenFiles": [...],
+            "warnings": [{"code": "...", "message": "..."}]}}
+
+失败
+  单张图片下载失败 → 跳过并计入 images.failed + warnings，退出码 0。
+  命中 > 0 但全部失败 → EXPORT_STANDALONE_IMAGE_ALL_FAILED，退出码 1（系统性问题）。
+  stack 不支持 → EXPORT_STANDALONE_STACK_UNSUPPORTED。
+  构建失败 → EXPORT_STANDALONE_BUILD_FAILED。
+
+示例
+  $ miaoda app export-standalone
+  $ miaoda app export-standalone --out dist/share
+  $ miaoda app export-standalone --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        await (0, index_1.handleAppExportStandalone)({
+            dir: rawOpts.dir,
+            out: rawOpts.out,
+            devServer: rawOpts.devServer,
+        });
+    }));
+}
 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/export-standalone.js

@@ -0,0 +1,171 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STANDALONE_OUT = void 0;
+exports.handleAppExportStandalone = handleAppExportStandalone;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const spark_meta_1 = require("../../../utils/spark-meta");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const logger_1 = require("../../../utils/logger");
+const index_1 = require("../../../services/app/export-standalone/index");
+exports.DEFAULT_STANDALONE_OUT = 'dist/standalone';
+/** 校验相对输出路径：禁绝对路径、禁含 ".." 段（与 app export 的 normalizeOutDir 同口径）。 */
+function normalizeOutDir(rel) {
+    if (node_path_1.default.isAbsolute(rel) || rel.startsWith('/')) {
+        throw new error_1.AppError('ARGS_INVALID', `输出目录不能是绝对路径：${rel}`);
+    }
+    const posix = rel.split(node_path_1.default.sep).join('/').replace(/^\.\//, '');
+    if (posix.split('/').includes('..')) {
+        throw new error_1.AppError('ARGS_INVALID', `输出目录不能包含 "..":${rel}`);
+    }
+    return posix;
+}
+function resolveDevServerBase(explicit) {
+    if (explicit)
+        return explicit.replace(/\/+$/, '');
+    const port = process.env.CLIENT_DEV_PORT ?? '8080';
+    return `http://localhost:${port}`;
+}
+/** 遍历产物树里的文本文件，返回 posix 相对路径。 */
+function* walkText(dir, rel = '') {
+    for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const childRel = rel ? `${rel}/${entry.name}` : entry.name;
+        const abs = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory())
+            yield* walkText(abs, childRel);
+        else if (index_1.TEXT_EXTENSIONS.has(node_path_1.default.extname(entry.name).toLowerCase()))
+            yield childRel;
+    }
+}
+/** 统计产物树的文件数与总字节数。 */
+function measure(dir) {
+    let fileCount = 0;
+    let bytes = 0;
+    const walk = (cur) => {
+        for (const entry of node_fs_1.default.readdirSync(cur, { withFileTypes: true })) {
+            const abs = node_path_1.default.join(cur, entry.name);
+            if (entry.isDirectory())
+                walk(abs);
+            else {
+                fileCount += 1;
+                bytes += node_fs_1.default.statSync(abs).size;
+            }
+        }
+    };
+    walk(dir);
+    return { fileCount, bytes };
+}
+/**
+ * 扫产物里是否残留 BrowserRouter —— standalone 不做 HashRouter 改造（明确决策），
+ * 多路由 SPA 在 file:// 下 `location.pathname` 是完整文件系统路径，匹配不上任何 Route，
+ * 且 pushState 在 opaque origin 下抛 SecurityError。检测到就告知用户改用本地 server。
+ */
+function detectBrowserRouter(outDir) {
+    for (const rel of walkText(outDir)) {
+        const text = node_fs_1.default.readFileSync(node_path_1.default.join(outDir, rel), 'utf-8');
+        if (/\b(BrowserRouter|createBrowserRouter)\b/.test(text))
+            return true;
+    }
+    return false;
+}
+/**
+ * miaoda app export-standalone [--out <dir>]
+ *
+ * 把当前应用构建成自包含静态产物：按 stack 走各自的 strategy 产出可静态服务的目录树，
+ * 再扫出 `/spark/app` 图片经 dev server 代理下载到 `images/` 并改写成相对路径，最后打 zip。
+ *
+ * 设计文档：docs/superpowers/specs/2026-08-19-app-export-standalone-design.md
+ */
+async function handleAppExportStandalone(opts) {
+    const projectDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(projectDir);
+    if (!meta.stack) {
+        throw new error_1.AppError('ARGS_INVALID', '.spark/meta.json 缺少 stack —— 请先跑 miaoda app init', {
+            next_actions: ['cd 到应用根目录后重试，或先执行 miaoda app init'],
+        });
+    }
+    const strategy = (0, index_1.resolveStrategy)(meta.stack);
+    const outRel = normalizeOutDir(opts.out ?? exports.DEFAULT_STANDALONE_OUT);
+    const outDir = node_path_1.default.join(projectDir, outRel);
+    const zipRel = `${outRel}.zip`;
+    const zipPath = node_path_1.default.join(projectDir, zipRel);
+    // 1. stack-specific：产出可静态服务的目录树
+    strategy({ projectDir, outDir });
+    if (!node_fs_1.default.existsSync(outDir) || node_fs_1.default.readdirSync(outDir).length === 0) {
+        throw new error_1.AppError('EXPORT_STANDALONE_EMPTY_OUTPUT', '构建产物为空', {
+            next_actions: ['先手动跑一次该 stack 的构建命令确认工程本身可构建'],
+        });
+    }
+    // 2. 扫描
+    const urls = [];
+    const seen = new Set();
+    for (const rel of walkText(outDir)) {
+        for (const url of (0, index_1.scanSparkAppUrls)(node_fs_1.default.readFileSync(node_path_1.default.join(outDir, rel), 'utf-8'))) {
+            if (seen.has(url))
+                continue;
+            seen.add(url);
+            urls.push(url);
+        }
+    }
+    // 3. 下载
+    const devServerBase = resolveDevServerBase(opts.devServer);
+    (0, logger_1.log)('export-standalone', `Matched ${String(urls.length)} image url(s), fetching via ${devServerBase}`);
+    const { mapping, failed } = await (0, index_1.downloadImages)(urls, {
+        imagesDir: node_path_1.default.join(outDir, 'images'),
+        devServerBase,
+    });
+    // 命中 > 0 且全部失败 = 系统性问题（代理挂了 / 路径口径错），静默成功会误导调用方
+    if (urls.length > 0 && mapping.size === 0) {
+        throw new error_1.AppError('EXPORT_STANDALONE_IMAGE_ALL_FAILED', `命中 ${String(urls.length)} 张图片但全部下载失败`, {
+            next_actions: [
+                '确认 dev server 正在运行且能代理 /spark/app 路径',
+                `首个失败：${failed[0]?.url ?? '?'} → ${failed[0]?.reason ?? 'unknown'}`,
+                ...(failed.length > 1
+                    ? [`其余 ${String(failed.length - 1)} 条见 --verbose（每条请求地址都会打到 stderr）`]
+                    : []),
+                `实际请求前缀：${devServerBase}（来自 ${opts.devServer ? '--dev-server' : process.env.CLIENT_DEV_PORT ? 'CLIENT_DEV_PORT env' : '默认 8080'}）`,
+                '若端口不对，可用 --dev-server http://localhost:<port> 覆盖',
+            ],
+        });
+    }
+    // 4. 改写
+    const rewrittenFiles = (0, index_1.rewriteTree)(outDir, mapping);
+    // 5. 打包
+    (0, index_1.zipDir)(outDir, zipPath);
+    // 6. 输出
+    const warnings = [];
+    if (failed.length > 0) {
+        warnings.push({
+            code: 'IMAGE_DOWNLOAD_PARTIAL_FAILURE',
+            message: `${String(failed.length)} 张图片下载失败，产物中保留原始绝对路径（离线打不开）`,
+        });
+    }
+    if (detectBrowserRouter(outDir)) {
+        warnings.push({
+            code: 'SPA_ROUTER_FILE_PROTOCOL',
+            message: '检测到 BrowserRouter：产物在 file:// 下不可用（路由匹配不上、pushState 抛 SecurityError），请用本地 HTTP server 打开',
+        });
+    }
+    const { fileCount, bytes } = measure(outDir);
+    (0, output_1.emit)({
+        data: {
+            appId: meta.app_id ?? '',
+            stack: meta.stack,
+            out: outRel,
+            zip: zipRel,
+            fileCount,
+            bytes,
+            images: {
+                matched: urls.length,
+                downloaded: mapping.size,
+                failed,
+            },
+            rewrittenFiles,
+            warnings,
+        },
+    });
+}

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.DEFAULT_STANDALONE_OUT = exports.handleAppExportStandalone = 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,6 @@ 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 export_standalone_1 = require("./export-standalone");
+Object.defineProperty(exports, "handleAppExportStandalone", { enumerable: true, get: function () { return export_standalone_1.handleAppExportStandalone; } });
+Object.defineProperty(exports, "DEFAULT_STANDALONE_OUT", { enumerable: true, get: function () { return export_standalone_1.DEFAULT_STANDALONE_OUT; } });

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,139 +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 失败（历史故障）。
-    // stop 返回成功即代表 dev 进程已确认退出（服务端等到 exit 事件才返回），不需要再 pkill。
-    //   - 只在沙箱内做（本地用户自己管 dev 进程，不该被 CLI 动）
-    //   - 软失败：接口不存在（老版本 code-server 返 404）/ 连不上都不阻断，降级回老路径
-    //     （带重试的 rm + 结尾 pkill 让保活拉起）
-    //   - ⚠️ 恢复条件用 mayBeSuspended 而不是 ok：服务端在抛错前就置了暂停位，stop 失败
-    //     （500 / 超时）时暂停位可能已生效，不恢复就等于永久关掉保活。只有 404 能确定无副作用。
-    let previewStopped = false;
-    let previewMayBeSuspended = 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;
-        previewMayBeSuspended = stopped.mayBeSuspended;
-        if (!stopped.ok) {
-            previewStopError = stopped.error;
-            const tail = previewMayBeSuspended ? '结束时仍会尝试恢复' : '降级为不停 dev 直接重装';
-            (0, logger_1.log)('migrate', `⚠ 停止预览失败 (continuing, ${tail}): ${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 —— 只要暂停位可能已生效就必须调，且必须在 finally 里：
-        // rule 应用 / install / 清 cache 任何一步抛异常都不能把保活留在关闭状态，否则用户沙箱
-        // 的预览再也起不来（比迁移失败严重得多）。
-        // 无条件恢复（不看 installError）：dev 进程已经被停了，留着不起来只会更糟；新 scripts/dev.js
-        // + 新依赖也正是靠这次 start 生效。
-        // 用 previewMayBeSuspended 而非 previewStopped：stop 超时/500 时服务端暂停位已经置上了。
-        // 多余的 start 无害（服务端未暂停且进程在跑时 no-op）。
-        if (previewMayBeSuspended) {
-            (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 接口不存在（老版本 code-server 返 404，确定没进暂停态），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 风险大)
-    //   - previewMayBeSuspended 时不做 —— 新 code-server 上暂停位管着重建，pkill 无意义；
-    //     进程该由上面的 startPreview 拉起
     //   - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
     //     留着旧进程让用户先处理 installError
     //   - 软失败:pkill 无匹配进程退出 1,catch 吞掉
-    let devRestarted = previewRestarted;
-    if (!previewMayBeSuspended && 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' });
@@ -256,24 +194,11 @@ async function handleAppMigrate(opts) {
             ...summarizeResults(results),
             followLatestPackages: followLatest,
             installError,
-            nodeModulesCleanError,
             devRestarted,
-            previewStopped,
-            previewStopError,
-            previewMayBeSuspended,
-            previewRestarted,
-            previewRestartError,
             nextActions: (0, env_1.isSandboxEnv)()
                 ? [
                     'git status / git diff 评估改动并 commit',
                     'miaoda skills sync 同步到新 stack 的 agent skills',
-                    // 预览恢复失败时补一条人工兜底动作 —— 暂停位还挂着，预览不会自己起来。
-                    // 兜底自愈：暂停位只存 code-server 内存，重启 code-server 也能恢复。
-                    ...(previewRestartError === undefined
-                        ? []
-                        : [
-                            `⚠ dev server(预览)未恢复成功，需手动 curl -X POST ${(0, preview_control_1.resolveCodeServerBaseUrl)()}/api/v1/preview/start 恢复保活（暂停状态只存内存，重启 code-server 亦可自愈）`,
-                        ]),
                 ]
                 : [
                     'git status / git diff 评估改动并 commit',

package/dist/services/app/export-standalone/archive.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zipDir = zipDir;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const error_1 = require("../../../utils/error");
+/**
+ * 把 `dir` 的**内容**打成 zip（解压后直接是 index.html，不多一层目录）。
+ *
+ * 走系统 `zip` 而非引 npm 依赖：仓库现有的 `app export` 也是 shell 出去调 `unzip`/`tar`，
+ * 保持一致，且避免为一个收尾动作增加运行时依赖。
+ *
+ * 覆盖语义：`zip` 默认是**增量更新**已存在的归档（会残留上次的文件），
+ * 所以先删掉目标文件再打，保证重跑导出幂等。
+ */
+function zipDir(dir, zipPath) {
+    if (!node_fs_1.default.existsSync(dir)) {
+        throw new error_1.AppError('EXPORT_STANDALONE_ARCHIVE_FAILED', `待打包目录不存在：${dir}`);
+    }
+    node_fs_1.default.rmSync(zipPath, { force: true });
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(zipPath), { recursive: true });
+    try {
+        // cwd=dir + '.' → 归档内是目录内容而非目录本身
+        (0, node_child_process_1.execFileSync)('zip', ['-qr', zipPath, '.'], { cwd: dir, stdio: 'pipe' });
+    }
+    catch (err) {
+        throw new error_1.AppError('EXPORT_STANDALONE_ARCHIVE_FAILED', `zip failed: ${err.message}`, { next_actions: ['确认运行环境有 zip 命令（沙箱镜像应自带）'] });
+    }
+}