@lark-apaas/miaoda-cli 0.1.33-alpha.155f17e → 0.1.33-alpha.2ce4ff9

package/README.md

@@ -52,14 +52,15 @@ miaoda file ls --output json
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
 
-## 导出可本地访问的静态产物
+## 打包可本地访问的静态产物
 
-`miaoda app export-standalone` 把当前应用构建成一份自包含静态产物，可脱离妙搭平台本地打开。
+`miaoda app pack`（默认 `--mode standalone`）把当前应用构建成一份自包含静态产物，可脱离妙搭平台本地打开。
 
 ```bash
-miaoda app export-standalone                    # → dist/standalone/ + dist/standalone.zip
-miaoda app export-standalone --out dist/share
-miaoda app export-standalone --json
+miaoda app pack                    # → dist/standalone/ + 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`。页面与代码里字面以
@@ -71,7 +72,7 @@ miaoda app export-standalone --json
 **只保证纯静态可看** —— 接口调用会失败，不做数据快照。多路由 SPA 在 `file://` 下不可用
 （`BrowserRouter` 匹配不上路径），需用本地 HTTP server 打开，命令会在 `warnings` 里提示。
 
-> 与 `miaoda app export` **语义无关**：后者导出的是源码归档（创意应用升级链路的只读参考物）。
+> 与 `miaoda app export` **语义无关**：后者拉的是**其他应用**的源码归档（创意应用升级链路的只读参考物）。
 
 ## 组件 registry
 

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

@@ -22,7 +22,7 @@ function registerAppCommands(program, opts = {}) {
     registerAppGet(appCmd);
     registerAppUpdate(appCmd);
     registerAppExport(appCmd);
-    registerAppExportStandalone(appCmd);
+    registerAppPack(appCmd);
     if (opts.includeInit) {
         registerAppInit(appCmd);
         registerAppSync(appCmd);
@@ -128,9 +128,9 @@ function registerAppExport(parent) {
         .option('--out <dir>', '输出目录（相对当前目录）', 'source_package/creative')
         .option('--checkpoint <n>', '按检查点版本导出；缺省为最新提交（HEAD）')
         .addHelpText('after', `
-与 'miaoda app export-standalone' 的区别（**两个命令语义无关，别选错**）
-  app export             导出源码归档（本命令）
-  app export-standalone  导出可本地访问的构建产物
+与 'miaoda app pack' 的区别（**两个命令语义无关，别选错**）
+  app export             拉「其他应用」的源码归档（本命令）
+  app pack               把「当前应用」打包成产物（默认 standalone 形态）
 
 说明
   从服务端导出源应用（可以不是当前应用）的源码归档并解压到 --out 目录，导出完成后写
@@ -178,17 +178,23 @@ JSON 输出
         });
     }));
 }
-function registerAppExportStandalone(parent) {
+function registerAppPack(parent) {
     const cmd = parent
-        .command('export-standalone')
-        .description('把当前应用构建成自包含静态产物（目录 + zip），可脱离妙搭平台本地访问')
+        .command('pack')
+        .description('打包应用产物。默认 standalone 模式：自包含静态产物（目录 + zip），可脱离妙搭平台本地访问')
         .option('--dir <path>', '项目目录，默认 cwd（需含 .spark/meta.json）')
-        .option('--out <dir>', '输出目录（相对项目根）', index_1.DEFAULT_STANDALONE_OUT)
+        .option('--mode <mode>', `打包形态（${index_1.PACK_MODES.join(' / ')}）`, index_1.DEFAULT_PACK_MODE)
+        .option('--out <dir>', '输出目录（相对项目根）', index_1.DEFAULT_PACK_OUT)
         .option('--dev-server <url>', '图片下载的请求前缀，默认沙箱网关 http://localhost:8080')
+        .option('--upload-url <url>', '打包后把 zip 以 PUT 上传到该预签名 URL（http/https）；上传成功后清掉本地产物')
         .addHelpText('after', `
 与 'miaoda app export' 的区别（**两个命令语义无关，别选错**）
-  app export             导出源码归档（创意应用升级链路的只读参考物）
-  app export-standalone  导出可本地访问的构建产物（本命令）
+  app export   拉「其他应用」的源码归档（创意应用升级链路的只读参考物）
+  app pack     把「当前应用」打包成产物（本命令）
+
+打包形态（--mode）
+  standalone（默认）  自包含静态产物，可脱离妙搭平台本地访问
+  后续新增形态时在此列出；不传 --mode 的行为永远等同 standalone。
 
 支持的 stack
   design-html / html / vite-react / nestjs-react-fullstack
@@ -196,6 +202,11 @@ function registerAppExportStandalone(parent) {
 产物
   <out>/          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；此时不要再去读 out / zip 路径。
+  上传失败则保留本地产物，便于修正后重跑或手动上传。
   默认 <out> 是 dist/standalone —— 落在 dist/ 下是刻意的：dist 已在部署扫描的
   EXCLUDES 与各模板 .gitignore 中，产物不会污染部署包、不会被误提交。
   代价：下一次构建会 rm -rf dist，导出产物是易失的。
@@ -215,25 +226,32 @@ 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 但全部失败 → EXPORT_STANDALONE_IMAGE_ALL_FAILED，退出码 1（系统性问题）。
-  stack 不支持 → EXPORT_STANDALONE_STACK_UNSUPPORTED。
-  构建失败 → EXPORT_STANDALONE_BUILD_FAILED。
+  命中 > 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 export-standalone
-  $ miaoda app export-standalone --out dist/share
-  $ miaoda app export-standalone --json
+  $ 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.handleAppExportStandalone)({
+        await (0, index_1.handleAppPack)({
             dir: rawOpts.dir,
             out: rawOpts.out,
             devServer: rawOpts.devServer,
+            uploadUrl: rawOpts.uploadUrl,
+            mode: rawOpts.mode,
         });
     }));
 }

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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,6 +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 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; } });
+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/{export-standalone.js → pack.js}

@@ -3,16 +3,27 @@ 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;
+exports.DEFAULT_PACK_OUT = exports.DEFAULT_PACK_MODE = exports.PACK_MODES = void 0;
+exports.handleAppPack = handleAppPack;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const exclude_patterns_1 = require("../../../utils/exclude-patterns");
 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';
+const index_1 = require("../../../services/app/pack/index");
+/**
+ * 支持的打包形态。当前只有 `standalone`；留成枚举是为了让扩展点显式可见 ——
+ * 新增形态时只需往这里加，命令 help 会自动列出。
+ *
+ * ⚠️ 不传 `--mode` 的行为永远等同 `standalone`，这是对调用方的稳定契约：
+ * 将来加了新形态也不能改默认值，否则存量调用会静默换语义。
+ */
+exports.PACK_MODES = ['standalone'];
+exports.DEFAULT_PACK_MODE = 'standalone';
+/** standalone 形态的默认输出目录。新增形态时各自用自己的目录名。 */
+exports.DEFAULT_PACK_OUT = 'dist/standalone';
 /** 校验相对输出路径：禁绝对路径、禁含 ".." 段（与 app export 的 normalizeOutDir 同口径）。 */
 function normalizeOutDir(rel) {
     if (node_path_1.default.isAbsolute(rel) || rel.startsWith('/')) {
@@ -69,27 +80,66 @@ function measure(dir) {
     return { fileCount, bytes };
 }
 /**
- * 扫产物里是否残留 BrowserRouter —— standalone 不做 HashRouter 改造（明确决策），
- * 多路由 SPA 在 file:// 下 `location.pathname` 是完整文件系统路径，匹配不上任何 Route，
- * 且 pushState 在 opaque origin 下抛 SecurityError。检测到就告知用户改用本地 server。
+ * 扫**项目源码**里是否用了 BrowserRouter。
+ *
+ * preset 在 standalone 下会把它编译期换成 HashRouter（`standaloneRouterPlugin`），
+ * 换完 file:// 下路由完全可用。这里保留检测是为了**覆盖不到时给提示**：插件只替换
+ * 用户源码里字面的 `BrowserRouter` / `createBrowserRouter`，碰不到的情况有——
+ * 用户二次封装（`export const Router = BrowserRouter`）、非 react-router 的路由库、
+ * 代码里硬编码 `window.location.href = '/about'`。
+ *
+ * 命中时只是提示"若路由异常请用本地 server"，不代表一定坏。
+ *
+ * ⚠️ **必须扫源码，不能扫产物**：编译型 stack 的产物经过 minify，`BrowserRouter`
+ * 这个标识符会被改名，扫产物永远命中不了 —— 而那恰恰是最需要这条警告的场景。
+ * 真机踩过：vite-react 应用源码里明明有 BrowserRouter、产物首屏渲染成 404，
+ * 但因为扫的是产物，warnings 是空的。
+ *
+ * 扫描面套 EXCLUDES（跳过 node_modules / dist 等），四个 stack 统一按项目根扫。
  */
-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;
+function detectBrowserRouter(projectDir) {
+    const walk = (dir) => {
+        for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+            if (exclude_patterns_1.EXCLUDES.has(entry.name))
+                continue;
+            const abs = node_path_1.default.join(dir, entry.name);
+            let isDir;
+            try {
+                isDir = node_fs_1.default.statSync(abs).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (isDir) {
+                if (walk(abs))
+                    return true;
+                continue;
+            }
+            if (!index_1.TEXT_EXTENSIONS.has(node_path_1.default.extname(entry.name).toLowerCase()))
+                continue;
+            if (/\b(BrowserRouter|createBrowserRouter)\b/.test(node_fs_1.default.readFileSync(abs, 'utf-8'))) {
+                return true;
+            }
+        }
+        return false;
+    };
+    return walk(projectDir);
 }
 /**
- * miaoda app export-standalone [--out <dir>]
+ * miaoda app pack [--mode standalone] [--out <dir>]
  *
  * 把当前应用构建成自包含静态产物：按 stack 走各自的 strategy 产出可静态服务的目录树，
  * 再扫出 `/spark/app` 图片经 dev server 代理下载到 `images/` 并改写成相对路径，最后打 zip。
  *
- * 设计文档：docs/superpowers/specs/2026-08-19-app-export-standalone-design.md
+ * 设计文档：docs/superpowers/specs/2026-08-19-app-pack-design.md
  */
-async function handleAppExportStandalone(opts) {
+async function handleAppPack(opts) {
+    const mode = opts.mode ?? exports.DEFAULT_PACK_MODE;
+    if (!exports.PACK_MODES.includes(mode)) {
+        throw new error_1.AppError('ARGS_INVALID', `不支持的打包形态：${mode}`, {
+            next_actions: [`可用形态：${exports.PACK_MODES.join(', ')}`],
+        });
+    }
     const projectDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
     const meta = (0, spark_meta_1.readSparkMeta)(projectDir);
     if (!meta.stack) {
@@ -98,14 +148,17 @@ async function handleAppExportStandalone(opts) {
         });
     }
     const strategy = (0, index_1.resolveStrategy)(meta.stack);
-    const outRel = normalizeOutDir(opts.out ?? exports.DEFAULT_STANDALONE_OUT);
+    // 参数校验一律前置：URL 写错不该等到构建 + 下载 + 打包跑完才报（那是几十秒）
+    if (opts.uploadUrl)
+        (0, index_1.assertValidUploadUrl)(opts.uploadUrl);
+    const outRel = normalizeOutDir(opts.out ?? exports.DEFAULT_PACK_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', '构建产物为空', {
+        throw new error_1.AppError('PACK_EMPTY_OUTPUT', '构建产物为空', {
             next_actions: ['先手动跑一次该 stack 的构建命令确认工程本身可构建'],
         });
     }
@@ -122,14 +175,14 @@ async function handleAppExportStandalone(opts) {
     }
     // 3. 下载
     const devServerBase = resolveDevServerBase(opts.devServer);
-    (0, logger_1.log)('export-standalone', `Matched ${String(urls.length)} image url(s), fetching via ${devServerBase}`);
+    (0, logger_1.log)('pack', `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)} 张图片但全部下载失败`, {
+        throw new error_1.AppError('PACK_IMAGE_ALL_FAILED', `命中 ${String(urls.length)} 张图片但全部下载失败`, {
             next_actions: [
                 '确认 dev server 正在运行且能代理 /spark/app 路径',
                 `首个失败：${failed[0]?.url ?? '?'} → ${failed[0]?.reason ?? 'unknown'}`,
@@ -145,27 +198,59 @@ async function handleAppExportStandalone(opts) {
     const rewrittenFiles = (0, index_1.rewriteTree)(outDir, mapping);
     // 5. 打包
     (0, index_1.zipDir)(outDir, zipPath);
-    // 6. 输出
+    // 6. 统计。**必须在清理之前**——上传成功后本地产物会被删掉，那时就量不到了。
+    const { fileCount, bytes } = measure(outDir);
+    // 7. 上传（可选）。放在 emit 之前——传了 --upload-url 就说明上传是目的，
+    // 失败要让整个命令失败（退出码 1），不能先 emit 成功再抛。
+    // JSON 输出里**不回显 URL**（凭证类信息），只给状态码与服务端 log_id。
+    const upload = opts.uploadUrl ? await (0, index_1.uploadZip)(zipPath, opts.uploadUrl) : undefined;
     const warnings = [];
+    // 8. 上传成功后清掉本地产物：交付物已在远端，沙箱磁盘不必留一份目录 + 一份 zip。
+    //
+    // **只在上传成功后清**。上传失败时产物必须留着——错误提示里明确写了「本地产物已保留，
+    // 可修正 --upload-url 后重跑，或手动上传」，清掉会让那句话变成谎话，且用户得重跑
+    // 整轮构建。失败路径走 uploadZip 抛错，根本到不了这里。
+    //
+    // 清理失败不算命令失败：上传已经成功，目的达到了，删不掉只是留了点垃圾 → 降级为 warning。
+    let localRemoved = false;
+    if (upload) {
+        try {
+            node_fs_1.default.rmSync(outDir, { recursive: true, force: true });
+            node_fs_1.default.rmSync(zipPath, { force: true });
+            localRemoved = true;
+            (0, logger_1.log)('pack', `Uploaded, local artifacts removed (${outRel}, ${zipRel})`);
+        }
+        catch (err) {
+            warnings.push({
+                code: 'LOCAL_CLEANUP_FAILED',
+                message: `上传成功但本地产物清理失败：${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
     if (failed.length > 0) {
         warnings.push({
             code: 'IMAGE_DOWNLOAD_PARTIAL_FAILURE',
             message: `${String(failed.length)} 张图片下载失败，产物中保留原始绝对路径（离线打不开）`,
         });
     }
-    if (detectBrowserRouter(outDir)) {
+    if (detectBrowserRouter(projectDir)) {
         warnings.push({
             code: 'SPA_ROUTER_FILE_PROTOCOL',
-            message: '检测到 BrowserRouter：产物在 file:// 下不可用（路由匹配不上、pushState 抛 SecurityError），请用本地 HTTP server 打开',
+            message: '检测到 BrowserRouter：standalone 构建已自动换成 HashRouter，路由形如 index.html#/about。' +
+                '若你对 router 做过二次封装或用了非 react-router 的方案，替换可能覆盖不到 —— ' +
+                '此时产物在 file:// 下路由会失效（首屏落 404 页），请改用本地 HTTP server 并从 / 访问。',
         });
     }
-    const { fileCount, bytes } = measure(outDir);
     (0, output_1.emit)({
         data: {
             appId: meta.app_id ?? '',
             stack: meta.stack,
+            mode,
             out: outRel,
             zip: zipRel,
+            // 上传成功后本地产物已被清掉——调用方**不要**再去读 out / zip 这两个路径，
+            // 它们只描述"产出过什么"，不代表现在还在。
+            localRemoved,
             fileCount,
             bytes,
             images: {
@@ -174,6 +259,8 @@ async function handleAppExportStandalone(opts) {
                 failed,
             },
             rewrittenFiles,
+            // 只在传了 --upload-url 时出现：{ status, logId? }。刻意不含 URL。
+            ...(upload ? { upload } : {}),
             warnings,
         },
     });

package/dist/services/app/{export-standalone → pack}/archive.js

@@ -19,7 +19,7 @@ const error_1 = require("../../../utils/error");
  */
 function zipDir(dir, zipPath) {
     if (!node_fs_1.default.existsSync(dir)) {
-        throw new error_1.AppError('EXPORT_STANDALONE_ARCHIVE_FAILED', `待打包目录不存在：${dir}`);
+        throw new error_1.AppError('PACK_ARCHIVE_FAILED', `待打包目录不存在：${dir}`);
     }
     node_fs_1.default.rmSync(zipPath, { force: true });
     node_fs_1.default.mkdirSync(node_path_1.default.dirname(zipPath), { recursive: true });
@@ -28,6 +28,8 @@ function zipDir(dir, zipPath) {
         (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 命令（沙箱镜像应自带）'] });
+        throw new error_1.AppError('PACK_ARCHIVE_FAILED', `zip failed: ${err.message}`, {
+            next_actions: ['确认运行环境有 zip 命令（沙箱镜像应自带）'],
+        });
     }
 }

package/dist/services/app/{export-standalone → pack}/copy-tree.js

@@ -18,7 +18,7 @@ const error_1 = require("../../../utils/error");
  */
 function copyTree(root, out, excludes) {
     if (!node_fs_1.default.existsSync(root)) {
-        throw new error_1.AppError('EXPORT_STANDALONE_EMPTY_OUTPUT', `源目录不存在：${root}`, {
+        throw new error_1.AppError('PACK_EMPTY_OUTPUT', `源目录不存在：${root}`, {
             next_actions: ['确认已在应用根目录下执行，且项目结构完整'],
         });
     }

package/dist/services/app/{export-standalone → pack}/download.js

@@ -26,7 +26,7 @@ async function downloadImages(urls, opts) {
     const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     for (const url of urls) {
         const target = `${opts.devServerBase}${url}`;
-        (0, logger_1.debug)(`export-standalone: GET ${target}`);
+        (0, logger_1.debug)(`pack: GET ${target}`);
         try {
             // 刻意串行（见函数注释）：图片量级通常个位数到几十，并发收益有限；
             // 串行能让每张图的失败归因清晰，且不对沙箱 dev server 造成并发压力。
@@ -42,7 +42,7 @@ async function downloadImages(urls, opts) {
             const name = (0, naming_1.localImageName)(url, resp.headers.get('content-type') ?? undefined);
             node_fs_1.default.writeFileSync(node_path_1.default.join(opts.imagesDir, name), buf);
             mapping.set(url, name);
-            (0, logger_1.debug)(`export-standalone: downloaded ${url} -> images/${name} (${String(buf.length)}B)`);
+            (0, logger_1.debug)(`pack: downloaded ${url} -> images/${name} (${String(buf.length)}B)`);
         }
         catch (err) {
             failed.push({ url, reason: err instanceof Error ? err.message : String(err) });

package/dist/services/app/{export-standalone → pack}/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STANDALONE_SUPPORTED_STACKS = exports.resolveStrategy = exports.buildStandaloneEnv = exports.scanSparkAppUrls = exports.TEXT_EXTENSIONS = exports.rewriteTree = exports.localImageName = exports.extFromContentType = exports.inlineBabelScripts = exports.downloadImages = exports.copyTree = exports.zipDir = void 0;
+exports.PACK_SUPPORTED_STACKS = exports.resolveStrategy = exports.buildStandaloneEnv = exports.uploadZip = exports.redactUrl = exports.assertValidUploadUrl = exports.scanSparkAppUrls = exports.TEXT_EXTENSIONS = exports.rewriteTree = exports.localImageName = exports.extFromContentType = exports.inlineBabelScripts = exports.downloadImages = exports.copyTree = exports.zipDir = void 0;
 var archive_1 = require("./archive");
 Object.defineProperty(exports, "zipDir", { enumerable: true, get: function () { return archive_1.zipDir; } });
 var copy_tree_1 = require("./copy-tree");
@@ -17,7 +17,11 @@ Object.defineProperty(exports, "rewriteTree", { enumerable: true, get: function
 Object.defineProperty(exports, "TEXT_EXTENSIONS", { enumerable: true, get: function () { return rewrite_1.TEXT_EXTENSIONS; } });
 var scan_1 = require("./scan");
 Object.defineProperty(exports, "scanSparkAppUrls", { enumerable: true, get: function () { return scan_1.scanSparkAppUrls; } });
+var upload_1 = require("./upload");
+Object.defineProperty(exports, "assertValidUploadUrl", { enumerable: true, get: function () { return upload_1.assertValidUploadUrl; } });
+Object.defineProperty(exports, "redactUrl", { enumerable: true, get: function () { return upload_1.redactUrl; } });
+Object.defineProperty(exports, "uploadZip", { enumerable: true, get: function () { return upload_1.uploadZip; } });
 var strategies_1 = require("./strategies");
 Object.defineProperty(exports, "buildStandaloneEnv", { enumerable: true, get: function () { return strategies_1.buildStandaloneEnv; } });
 Object.defineProperty(exports, "resolveStrategy", { enumerable: true, get: function () { return strategies_1.resolveStrategy; } });
-Object.defineProperty(exports, "STANDALONE_SUPPORTED_STACKS", { enumerable: true, get: function () { return strategies_1.STANDALONE_SUPPORTED_STACKS; } });
+Object.defineProperty(exports, "PACK_SUPPORTED_STACKS", { enumerable: true, get: function () { return strategies_1.PACK_SUPPORTED_STACKS; } });

package/dist/services/app/{export-standalone → pack}/inline-babel.js

@@ -77,7 +77,7 @@ function inlineBabelScripts(root) {
             // `</script` 出现在 JS 字符串里会提前闭合标签，必须转义
             const code = node_fs_1.default.readFileSync(target, 'utf-8').replace(/<\/script/gi, '<\\/script');
             const keptAttrs = attrs.replace(SRC_ATTR_RE, '').replace(/\s+/g, ' ').trimEnd();
-            (0, logger_1.debug)(`export-standalone: inlined ${src} into ${rel}`);
+            (0, logger_1.debug)(`pack: inlined ${src} into ${rel}`);
             return `<script${keptAttrs} data-inlined-from="${src}">\n${code}\n</script>`;
         });
         // 用「文本是否变化」判定，不用外层 flag —— 回调里的赋值 TS 控制流分析看不到，

package/dist/services/app/{export-standalone → pack}/strategies.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STANDALONE_SUPPORTED_STACKS = void 0;
+exports.PACK_SUPPORTED_STACKS = void 0;
 exports.buildStandaloneEnv = buildStandaloneEnv;
 exports.liftNestedEntry = liftNestedEntry;
 exports.resolveStrategy = resolveStrategy;
@@ -11,11 +11,12 @@ 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");
+const output_1 = require("../../../utils/output");
 const exclude_patterns_1 = require("../../../utils/exclude-patterns");
 const logger_1 = require("../../../utils/logger");
 const copy_tree_1 = require("./copy-tree");
 const inline_babel_1 = require("./inline-babel");
-exports.STANDALONE_SUPPORTED_STACKS = new Set([
+exports.PACK_SUPPORTED_STACKS = new Set([
     'design-html',
     'html',
     'vite-react',
@@ -36,9 +37,15 @@ function buildStandaloneEnv(base) {
     delete env.MIAODA_APP_ID;
     delete env.CLIENT_BASE_PATH;
     env.MIAODA_BUILD_TARGET = 'standalone';
+    env.NODE_ENV = 'production';
+    // vite-react 走 build.sh，由它把 MIAODA_RESOURCE_CDN_PREFIX 映射成 ASSETS_CDN_PATH
     env.MIAODA_RESOURCE_CDN_PREFIX = './';
+    // nestjs 走 `npm run build:client` 直接调 vite，**没有 build.sh 那层映射** ——
+    // 必须直接给 preset 认的名字，否则 publicPath 为空 → base '/' → 产物里是
+    // `/assets/x.js` 绝对路径，file:// 下指向文件系统根，页面白屏（真机踩过）。
+    // vite-react 那边 build.sh 会用同样的值覆盖它，两条路结果一致。
+    env.ASSETS_CDN_PATH = './';
     env.STATIC_ASSETS_BASE_URL = './static';
-    env.NODE_ENV = 'production';
     return env;
 }
 /** 把 `from` 目录内容并入 `into`（into 已存在，不清空）。from 不存在则静默跳过。 */
@@ -77,6 +84,31 @@ function liftNestedEntry(outDir) {
     if (node_fs_1.default.readdirSync(nestedDir).length === 0)
         node_fs_1.default.rmdirSync(nestedDir);
 }
+/**
+ * 从产物树里删掉 sourcemap（`*.map`）。
+ *
+ * preset 的 prod 配置是 `sourcemap: 'hidden'` —— map 文件会产出，但产物里**没有**
+ * `sourceMappingURL` 注释，即没人引用它。留在 standalone 包里有两个实打实的问题：
+ *
+ * 1. **体积**：实测真实应用 4.7MB map / 5.9MB 总体积，占 80%
+ * 2. **泄源码**：map 的 `sourcesContent` 内嵌原始源码（实测含 12 个业务文件，
+ *    如 `src/lib/utils.ts`）。standalone 包是拿来分发给人的，等于附赠全部源码
+ *
+ * 只对有编译步骤的 stack 调用；buildless 栈（design-html / html）的产物就是源码，
+ * 那里的 `.map`（若有）是用户自己的文件，不该动。
+ */
+function dropSourceMaps(outDir) {
+    const walk = (dir) => {
+        for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+            const abs = node_path_1.default.join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(abs);
+            else if (entry.name.toLowerCase().endsWith('.map'))
+                node_fs_1.default.rmSync(abs, { force: true });
+        }
+    };
+    walk(outDir);
+}
 /** 从产物树里删掉 routes.json —— 平台/server 路由用，standalone 无人读取。 */
 function dropRoutesJson(outDir) {
     node_fs_1.default.rmSync(node_path_1.default.join(outDir, 'routes.json'), { force: true });
@@ -85,17 +117,22 @@ function runProjectBuild(projectDir, command) {
     try {
         (0, node_child_process_1.execSync)(command, {
             cwd: projectDir,
-            stdio: 'inherit',
+            // JSON 模式下把子进程 stdout 重定向到父进程 stderr（fd 2）——构建工具会往
+            // stdout 打一大堆进度，会把最终 emit 的 JSON 信封冲掉，下游 parse 直接失败。
+            // 终端仍看得到进度（走 stderr）。与 app init 的 stdioFor 同一套做法。
+            stdio: (0, output_1.isJsonMode)() ? ['ignore', 2, 'inherit'] : 'inherit',
             env: buildStandaloneEnv(process.env),
         });
     }
     catch (err) {
-        throw new error_1.AppError('EXPORT_STANDALONE_BUILD_FAILED', `${command} failed: ${err.message}`, { next_actions: ['先手动跑一次该构建命令确认工程本身可构建'] });
+        throw new error_1.AppError('PACK_BUILD_FAILED', `${command} failed: ${err.message}`, {
+            next_actions: ['先手动跑一次该构建命令确认工程本身可构建'],
+        });
     }
 }
 /** design-html：项目根纯拷贝，套 deploy 同一份 EXCLUDES。 */
 const designHtmlStrategy = ({ projectDir, outDir }) => {
-    (0, logger_1.log)('export-standalone', 'Copying source (design-html)...');
+    (0, logger_1.log)('pack', 'Copying source (design-html)...');
     (0, copy_tree_1.copyTree)(projectDir, outDir, exclude_patterns_1.EXCLUDES);
     (0, inline_babel_1.inlineBabelScripts)(outDir);
     dropRoutesJson(outDir);
@@ -106,7 +143,7 @@ const designHtmlStrategy = ({ projectDir, outDir }) => {
  * 调它再逐项撤销不如不调（设计文档「html 跳过 coding-html-devserver build」）。
  */
 const htmlStrategy = ({ projectDir, outDir }) => {
-    (0, logger_1.log)('export-standalone', 'Copying src/ (html)...');
+    (0, logger_1.log)('pack', 'Copying src/ (html)...');
     (0, copy_tree_1.copyTree)(node_path_1.default.join(projectDir, 'src'), outDir);
     (0, inline_babel_1.inlineBabelScripts)(outDir);
     dropRoutesJson(outDir);
@@ -117,7 +154,7 @@ const htmlStrategy = ({ projectDir, outDir }) => {
  * `virtual:capabilities` 虚拟模块，产物目录不引用它。
  */
 const viteReactStrategy = ({ projectDir, outDir }) => {
-    (0, logger_1.log)('export-standalone', 'Building (vite-react)...');
+    (0, logger_1.log)('pack', 'Building (vite-react)...');
     runProjectBuild(projectDir, 'bash scripts/build.sh');
     const dist = node_path_1.default.join(projectDir, 'dist');
     node_fs_1.default.rmSync(outDir, { recursive: true, force: true });
@@ -125,6 +162,7 @@ const viteReactStrategy = ({ projectDir, outDir }) => {
     mergeInto(node_path_1.default.join(dist, 'output'), outDir);
     mergeInto(node_path_1.default.join(dist, 'output_resource', 'assets'), node_path_1.default.join(outDir, 'assets'));
     mergeInto(node_path_1.default.join(dist, 'output_static'), node_path_1.default.join(outDir, 'static'));
+    dropSourceMaps(outDir);
     dropRoutesJson(outDir);
 };
 /**
@@ -137,16 +175,34 @@ const viteReactStrategy = ({ projectDir, outDir }) => {
  * （standalone 不挂 preset 的 vite-html-output 插件），需 `liftNestedEntry` 提到根。
  */
 const nestjsStrategy = ({ projectDir, outDir }) => {
-    (0, logger_1.log)('export-standalone', 'Building client (nestjs-react-fullstack)...');
-    runProjectBuild(projectDir, 'npm run build:client');
-    const clientDist = node_path_1.default.join(projectDir, 'dist', 'client');
-    if (!node_fs_1.default.existsSync(clientDist)) {
-        throw new error_1.AppError('EXPORT_STANDALONE_EMPTY_OUTPUT', 'client 构建产物 dist/client 不存在');
+    (0, logger_1.log)('pack', 'Building client (nestjs-react-fullstack)...');
+    // 构建到**独立临时目录**，不碰 `dist/client`。
+    //
+    // 两个原因：
+    // 1. preset 设了 `emptyOutDir: false`（它指望 `scripts/build.sh` 先 `rm -rf dist`），
+    //    而我们绕过 build.sh 直接跑 `build:client`，没人清目录 —— 复用 `dist/client`
+    //    会把上次构建的 chunk 一起带进产物（真机见过新旧两个 index-<hash>.js 并存）。
+    // 2. `dist/client` 是平台链路的产物目录（dev 期 html-output 会往里写、NestJS 从
+    //    那儿取 HTML），导出这种旁路动作**不该清它**，否则破坏既有目录结构。
+    //
+    // vite CLI 的 `--outDir` 优先级高于 config，`--emptyOutDir` 覆盖 `emptyOutDir: false`。
+    // 放在 dist/ 下是为了留在 vite root 内（root 外 vite 会告警）。
+    const tmpDist = node_path_1.default.join(projectDir, 'dist', '.standalone-client');
+    try {
+        runProjectBuild(projectDir, `npm run build:client -- --outDir ${JSON.stringify(node_path_1.default.relative(projectDir, tmpDist))} --emptyOutDir`);
+        if (!node_fs_1.default.existsSync(tmpDist)) {
+            throw new error_1.AppError('PACK_EMPTY_OUTPUT', `client 构建产物 ${node_path_1.default.relative(projectDir, tmpDist)} 不存在`);
+        }
+        node_fs_1.default.rmSync(outDir, { recursive: true, force: true });
+        node_fs_1.default.mkdirSync(outDir, { recursive: true });
+        mergeInto(tmpDist, outDir);
+    }
+    finally {
+        // 临时构建目录不留在用户项目里
+        node_fs_1.default.rmSync(tmpDist, { recursive: true, force: true });
     }
-    node_fs_1.default.rmSync(outDir, { recursive: true, force: true });
-    node_fs_1.default.mkdirSync(outDir, { recursive: true });
-    mergeInto(clientDist, outDir);
     liftNestedEntry(outDir);
+    dropSourceMaps(outDir);
     dropRoutesJson(outDir);
 };
 const STRATEGY_BY_STACK = new Map([
@@ -158,7 +214,9 @@ const STRATEGY_BY_STACK = new Map([
 function resolveStrategy(stack) {
     const strategy = STRATEGY_BY_STACK.get(stack);
     if (!strategy) {
-        throw new error_1.AppError('EXPORT_STANDALONE_STACK_UNSUPPORTED', `stack "${stack}" 不支持 standalone 导出`, { next_actions: [`支持的 stack：${[...exports.STANDALONE_SUPPORTED_STACKS].join(', ')}`] });
+        throw new error_1.AppError('PACK_STACK_UNSUPPORTED', `stack "${stack}" 不支持 standalone 导出`, {
+            next_actions: [`支持的 stack：${[...exports.PACK_SUPPORTED_STACKS].join(', ')}`],
+        });
     }
     return strategy;
 }

package/dist/services/app/pack/upload.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactUrl = redactUrl;
+exports.assertValidUploadUrl = assertValidUploadUrl;
+exports.uploadZip = uploadZip;
+const node_fs_1 = __importDefault(require("node:fs"));
+const error_1 = require("../../../utils/error");
+const logger_1 = require("../../../utils/logger");
+/**
+ * 从响应头取排查用的 log id。字节侧网关/对象存储统一给 `x-tt-logid`；
+ * 拿不到时退到通用的 `x-request-id`，两个都没有就不报（不编造）。
+ */
+function pickLogId(resp) {
+    return resp.headers.get('x-tt-logid') ?? resp.headers.get('x-request-id') ?? undefined;
+}
+/** 有 log id 时拼成错误信息后缀，没有就什么都不加。 */
+function logIdSuffix(logId) {
+    return logId ? `，log_id=${logId}` : '';
+}
+/** 上传超时。产物可达数 MB，给足余量；沙箱到对象存储通常是内网，不会真跑满。 */
+const UPLOAD_TIMEOUT_MS = 120_000;
+/**
+ * 抹掉 URL 的 query 再用于日志 / 错误信息。
+ *
+ * **预签名 URL 的签名等同于一份凭证** —— 谁拿到谁就能往那个位置写。原样打进日志、
+ * 错误上报或 JSON 输出，就等于把上传能力泄漏出去。所以对外可见的地方一律走这里。
+ */
+function redactUrl(raw) {
+    try {
+        const u = new URL(raw);
+        return u.search ? `${u.origin}${u.pathname}?<redacted>` : `${u.origin}${u.pathname}`;
+    }
+    catch {
+        // 连解析都失败的串，更不能原样回显
+        return '<unparseable url>';
+    }
+}
+/**
+ * 把 zip 以 **PUT 裸 body** 传到预签名 URL（TOS / S3 的标准上传形态）。
+ *
+ * 鉴权完全由 URL 自带的签名承担，不加任何额外 header —— 多带 header 反而可能破坏
+ * 某些实现的签名校验。
+ *
+ * 失败一律抛 `PACK_UPLOAD_FAILED`：调用方传了 `--upload-url` 就说明上传
+ * 是目的，传不上去等于没完成（设计决策：整个命令失败，退出码 1）。
+ */
+/**
+ * 校验 `--upload-url` 合法性。**必须在动手构建之前调用** —— 否则 URL 写错要等一整轮
+ * 构建 + 图片下载 + 打包之后才被告知参数非法，白等几十秒。
+ */
+function assertValidUploadUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new error_1.AppError('ARGS_INVALID', `--upload-url 不是合法 URL：${redactUrl(url)}`);
+    }
+    // 只允许 http(s)：file: 会把产物写到本地路径，其它协议 fetch 也不支持
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new error_1.AppError('ARGS_INVALID', `--upload-url 只支持 http/https，收到 ${parsed.protocol}`);
+    }
+}
+async function uploadZip(zipPath, url) {
+    assertValidUploadUrl(url);
+    if (!node_fs_1.default.existsSync(zipPath)) {
+        throw new error_1.AppError('ARGS_INVALID', `待上传的 zip 不存在：${zipPath}`);
+    }
+    const body = node_fs_1.default.readFileSync(zipPath);
+    // 默认输出**不带 URL**（连脱敏版也不带）：预签名 URL 属于凭证类信息，常规日志
+    // 里没有它的位置；排查靠响应头的 log_id 就够，那才是服务端能据以定位的东西。
+    // 完整地址只在显式 --verbose 时给出。
+    (0, logger_1.log)('pack', `Uploading ${String(body.length)} bytes...`);
+    (0, logger_1.debug)(`pack: PUT ${url}`);
+    let resp;
+    try {
+        resp = await fetch(url, {
+            method: 'PUT',
+            headers: {
+                'content-type': 'application/zip',
+                'content-length': String(body.length),
+            },
+            body,
+            signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        throw new error_1.AppError('PACK_UPLOAD_FAILED', `上传失败：${err instanceof Error ? err.message : String(err)}`, {
+            next_actions: [
+                '本地产物已保留，可修正 --upload-url 后重跑，或手动上传',
+                '--verbose 可打印完整请求地址',
+            ],
+        });
+    }
+    const logId = pickLogId(resp);
+    if (!resp.ok) {
+        throw new error_1.AppError('PACK_UPLOAD_FAILED', `上传失败：HTTP ${String(resp.status)}${logIdSuffix(logId)}`, {
+            next_actions: [
+                '预签名 URL 可能已过期或签名不匹配，确认后重试',
+                '本地产物已保留，也可手动上传',
+                '--verbose 可打印完整请求地址',
+            ],
+        });
+    }
+    (0, logger_1.log)('pack', `Uploaded (HTTP ${String(resp.status)}${logIdSuffix(logId)})`);
+    return { status: resp.status, ...(logId ? { logId } : {}) };
+}

package/dist/utils/exclude-patterns.js

@@ -5,7 +5,7 @@ exports.EXCLUDES = void 0;
  * 与模板 `scripts/build.sh` 的 rsync EXCLUDES 对齐：这些名字（任意层级 basename）不进产物/不计入路由。
  *
  * 放在 `utils/` 而非某个 domain 的 service 下，是因为它被 `deploy`（`source-scan.ts` 的
- * `listSourceFiles`）与 `app`（`export-standalone` 的 `copyTree`）两个 domain 共用 ——
+ * `listSourceFiles`）与 `app`（`pack` 的 `copyTree`）两个 domain 共用 ——
  * service 层跨域互调被 `boundaries/dependencies` 禁止（见 docs/dependency-rules.md F4），
  * 共享的纯数据/纯逻辑必须下沉到 `utils/`。
  */

package/package.json

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