@lark-apaas/miaoda-cli 0.1.17 → 0.1.18-alpha.5fd4656

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

@@ -166,6 +166,7 @@ function registerAppInit(parent) {
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
         .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
+        .option('--async-install', '派发后台进程装依赖并立即返回（与 --skip-install 互斥）', false)
         .addOption((0, shared_1.appIdOption)())
         .addHelpText('after', `
 幂等
@@ -194,17 +195,31 @@ function registerAppInit(parent) {
     为空都会 fallback npm install。
   JSON 模式下子进程 stdout 重定向到 stderr，避免污染最终 emit 的 JSON。
 
+异步安装（--async-install）
+  跳过同步 npm install，派发一个 detached 后台进程装依赖后立即返回。
+  .spark/meta.json 在返回前写出（= 脚手架就绪），install 真实结果由 event marker 表达。
+  仅沙箱（SANDBOX_ID 非空）写 marker（presence 定成败，content 给排障）：
+    成功 → /tmp/event/WORKSPACE_READY
+    失败 → /tmp/event/WORKSPACE_FAILED
+  安装日志：/tmp/async_install_dep.std.log
+  失败恢复：靠后续 'miaoda app sync'（dev.sh 入口 / 沙箱 pod 启动会跑）兜底，init 不重试。
+  与 --skip-install 互斥。
+
 JSON 输出
   已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
   新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
                      "appId": "...", "platformStackFound": true, "platformSyncedFiles": [...],
                      "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
+  async 模式：{"data": {"initialized": true, "asyncInstall": true, "installed": false,
+                      "installSource": "async", "installPid": 123, "installLogPath": "...",
+                      "eventReadyPath": "...", "eventFailedPath": "..."}}
 
 示例
   $ miaoda app init --template vite-react
   $ miaoda app init --template nestjs-react-fullstack --app-id app_xxx
   $ miaoda app init --template vite-react --conf '{"version": "0.1.0"}'
   $ miaoda app init --template vite-react --skip-install
+  $ miaoda app init --template vite-react --async-install
   $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
@@ -214,6 +229,7 @@ JSON 输出
             conf,
             skipInstall: rawOpts.skipInstall,
             appId: rawOpts.appId,
+            asyncInstall: rawOpts.asyncInstall,
         });
     }));
 }

package/dist/cli/commands/index.js

@@ -14,6 +14,7 @@ const index_6 = require("../../cli/commands/skills/index");
 //   3 = AppType_APPLICATION(全栈应用,当前仅 nestjs-react-fullstack 一个 stack)
 //   4 = AppType_DESIGN(design-stack,SSR 渲染、无业务逻辑、无数据库)
 //   7 = miaoda-cli 自定义 modern 占位(后端枚举无 7,沙箱目前不传)
+//   8 = AppType_DESIGN_HTML(design-html,buildless 静态 HTML,命令集同 modern)
 //   其它(0/1/2/5/6 / 未设)→ default(命令全开,本地 dev / CI / 兼容回退)
 // stack 维度(nestjs-react-fullstack / vite-react / ...)是正交的,
 // skills sync 内部按 .spark/meta.json.stack 拉对应 coding-steering/steering/<stack>/ 子目录。
@@ -24,6 +25,8 @@ function resolveScene(appType, _archType) {
         return 'application';
     if (appType === '4')
         return 'design';
+    if (appType === '8')
+        return 'design-html';
     return 'default';
 }
 const SCENE_REGISTRARS = {
@@ -62,6 +65,13 @@ const SCENE_REGISTRARS = {
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
     },
+    // design-html scene(AppType_DESIGN_HTML=8):buildless 静态 HTML,
+    // 命令集与 modern 一致(app init/sync + modern 拆分版 deploy + skills),不挂 db/file/observability。
+    'design-html': (p) => {
+        (0, index_4.registerAppCommands)(p, { includeInit: true });
+        (0, modern_1.registerDeployCommandsModern)(p);
+        (0, index_6.registerSkillsCommands)(p);
+    },
 };
 function readEnv(name) {
     const v = process.env[name]?.trim();

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

@@ -10,6 +10,7 @@ const index_1 = require("../../../services/app/init/index");
 const coding_steering_1 = require("../../../utils/coding-steering");
 const logger_1 = require("../../../utils/logger");
 const githooks_1 = require("../../../utils/githooks");
+const logs_dir_1 = require("../../../utils/logs-dir");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 /**
@@ -60,9 +61,15 @@ async function handleAppInit(opts) {
             next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
         });
     }
+    if (opts.asyncInstall && opts.skipInstall) {
+        throw new error_1.AppError('ARGS_INVALID', '--async-install 与 --skip-install 互斥');
+    }
     const version = opts.conf?.version;
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
+    // 先建 logs/,防止 user 跑 dev 之前 AI/工具 redirect 到 logs/*.log 因为父目录不存在直接挂
+    // (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)
+    (0, logs_dir_1.ensureLogsDir)(targetDir);
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
     // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
     // 按运行环境（SANDBOX_ID）分流 outputLayout，不绑 stack:
@@ -86,13 +93,17 @@ async function handleAppInit(opts) {
         (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
         steeringResult = { version: 'unknown', syncedSkills: [], techSynced: false };
     }
-    // 装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
+    // 依赖安装：async 模式留到 meta 落盘后派发后台进程（不等装完），同步模式当场装。
+    // 同步：装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
     // —— "升管控包到 latest" 是 sync 的职责,在 dev.sh 入口跑 `miaoda app sync` 时触发。
-    const installResult = (0, index_1.installDependencies)({
-        targetDir,
-        skip: opts.skipInstall,
-        quietStdout: (0, output_1.isJsonMode)(),
-    });
+    let installResult;
+    if (!opts.asyncInstall) {
+        installResult = (0, index_1.installDependencies)({
+            targetDir,
+            skip: opts.skipInstall,
+            quietStdout: (0, output_1.isJsonMode)(),
+        });
+    }
     // template 自带 .githooks/pre-commit；如果用户项目已 git init,顺便设上 core.hooksPath。
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
     (0, index_1.writeSparkMeta)(targetDir, {
@@ -101,8 +112,18 @@ async function handleAppInit(opts) {
         archType: tplResult.archType,
         app_id: opts.appId,
     });
+    // async 模式：meta 已落盘（= 脚手架就绪），再派发后台安装并立即返回（不等装完）。
+    let asyncDispatch;
+    if (opts.asyncInstall) {
+        asyncDispatch = (0, index_1.dispatchAsyncInstall)({ targetDir });
+    }
     if (!(0, output_1.isJsonMode)()) {
-        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
+        if (opts.asyncInstall && asyncDispatch) {
+            process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install dispatched in background pid ${String(asyncDispatch.pid)}) in ${targetDir}\n`);
+        }
+        else if (installResult) {
+            process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
+        }
     }
     (0, output_1.emit)({
         data: {
@@ -117,11 +138,23 @@ async function handleAppInit(opts) {
             techSynced: steeringResult.techSynced,
             steeringError,
             gitHooks: hookActivation.action,
-            installed: installResult.installed,
-            installSource: installResult.source,
-            installHash: installResult.hash,
-            cacheZip: installResult.cacheZip,
-            installError: installResult.error,
+            ...(opts.asyncInstall && asyncDispatch
+                ? {
+                    asyncInstall: true,
+                    installed: false,
+                    installSource: 'async',
+                    installPid: asyncDispatch.pid,
+                    installLogPath: asyncDispatch.logPath,
+                    eventReadyPath: asyncDispatch.eventReadyPath,
+                    eventFailedPath: asyncDispatch.eventFailedPath,
+                }
+                : {
+                    installed: installResult?.installed,
+                    installSource: installResult?.source,
+                    installHash: installResult?.hash,
+                    cacheZip: installResult?.cacheZip,
+                    installError: installResult?.error,
+                }),
         },
     });
 }

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

@@ -139,9 +139,13 @@ async function handleAppMigrate(opts) {
     // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,
     // 新进程用新 deps + 新 scripts,正常进入 fullstack 模式。
     //   - 只在 SANDBOX_ID 非空时做(本地环境用户进程混杂,主动 pkill 风险大)
+    //   - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
+    //     留着旧进程让用户先处理 installError
     //   - 软失败:pkill 无匹配进程退出 1,catch 吞掉
     let devRestarted = false;
-    if (process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '') {
+    if (installError === undefined &&
+        process.env.SANDBOX_ID !== undefined &&
+        process.env.SANDBOX_ID !== '') {
         (0, logger_1.log)('migrate', '沙箱环境,重启 dev process(平台 supervisor 会自动拉起)...');
         try {
             (0, node_child_process_1.execFileSync)('pkill', ['-f', 'node.*scripts/dev\\.js'], { stdio: 'ignore' });

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

@@ -16,6 +16,7 @@ const sync_configs_1 = require("../../../config/sync-configs");
 const sync_rule_1 = require("../../../utils/sync-rule");
 const platform_sync_1 = require("../../../utils/platform-sync");
 const githooks_1 = require("../../../utils/githooks");
+const logs_dir_1 = require("../../../utils/logs-dir");
 const install_1 = require("../../../services/app/init/install");
 const spark_meta_1 = require("../../../utils/spark-meta");
 const error_1 = require("../../../utils/error");
@@ -81,6 +82,10 @@ async function handleAppSync(opts) {
     }
     // 2. activate git hooks（template 自带 .githooks/pre-commit，core.hooksPath 一次性设置）
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
+    // logs/ 兜底:dev.js / dev-local.js 启动后才 mkdir,启动前任何想 redirect 到 logs/*.log 的
+    // shell 命令都会因父目录不存在直接 ENOENT 挂掉。sync 也建一次,长期使用的 user app 老仓库
+    // 第一次升级也能拿到这个目录。
+    (0, logs_dir_1.ensureLogsDir)(targetDir);
     // 3. snapshot 当前 user app 装的管控包版本，供 install 后 diff 用
     const beforeSpecs = snapshotManagedDepSpecs(targetDir);
     // 4. npm install —— 跟 init 一样软失败,install 挂了不该阻断 emit / sync 总结输出。

package/dist/config/sync-configs/design-html.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * design-html 的 sync 规则。
+ *
+ * design-html 是 buildless 静态 HTML stack（design-html scene，MIAODA_APP_TYPE=8），
+ * 无依赖、无 nest 后端、无数据库、无 dev 链路，只有一个打包脚本 scripts/build.sh
+ * （源码即产物：rsync 到 dist/output + 生成 routes.json）。
+ *
+ * 所以 sync 只做一件事：把 cli 自带的 scripts/build.sh 派生覆盖到 user app，
+ * 让 build 脚本可独立于模板版本更新。不同步 .githooks、不加 dev:local、
+ * 不动 .gitignore（卫生项直接在 coding 仓模板 _gitignore 里维护）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_CONFIG = void 0;
+exports.SYNC_CONFIG = {
+    sync: [
+        {
+            type: 'directory',
+            from: 'scripts',
+            to: 'scripts',
+            overwrite: true,
+        },
+    ],
+};
+exports.default = exports.SYNC_CONFIG;

package/dist/config/sync-configs/index.js

@@ -23,6 +23,7 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const nestjs_react_fullstack_1 = __importDefault(require("./nestjs-react-fullstack"));
 const design_stack_1 = __importDefault(require("./design-stack"));
+const design_html_1 = __importDefault(require("./design-html"));
 /**
  * 已纳入新 sync 机制的 stack 注册表。未在表里的 stack（如老 vite-react / html）走旧的
  * `upgrade/templates/<stack>/{files,patches}` 机制，由 sync handler 兜底。
@@ -30,6 +31,7 @@ const design_stack_1 = __importDefault(require("./design-stack"));
 const STACK_REGISTRY = {
     'nestjs-react-fullstack': nestjs_react_fullstack_1.default,
     'design-stack': design_stack_1.default,
+    'design-html': design_html_1.default,
 };
 /** 返回该 stack 的 SyncConfig；表里没有时返回 null。 */
 function getSyncConfig(stack) {

package/dist/services/app/init/async-install.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASYNC_INSTALL_LOG = void 0;
+exports.isSandboxEnv = isSandboxEnv;
+exports.runAsyncInstallWorker = runAsyncInstallWorker;
+exports.dispatchAsyncInstall = dispatchAsyncInstall;
+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 install_1 = require("./install");
+/** event marker 目录，写死；写前 mkdir -p。沙箱里 code server 轮询此目录。 */
+const EVENT_DIR = '/tmp/event';
+/** 安装成功 marker 名 */
+const MARKER_READY = 'WORKSPACE_READY';
+/** 安装失败 marker 名 */
+const MARKER_FAILED = 'WORKSPACE_FAILED';
+/** 后台 worker stdout/stderr 落盘路径 */
+exports.ASYNC_INSTALL_LOG = '/tmp/async_install_dep.std.log';
+/** 沙箱判定：SANDBOX_ID 非空。与 init handler 的 outputLayout 分流口径一致。 */
+function isSandboxEnv() {
+    return process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '';
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function clearStaleMarkers(eventDir) {
+    for (const name of [MARKER_READY, MARKER_FAILED]) {
+        const p = node_path_1.default.join(eventDir, name);
+        if (node_fs_1.default.existsSync(p))
+            node_fs_1.default.rmSync(p, { force: true });
+    }
+}
+function writeMarker(eventDir, name, content) {
+    node_fs_1.default.mkdirSync(eventDir, { recursive: true });
+    node_fs_1.default.writeFileSync(node_path_1.default.join(eventDir, name), JSON.stringify(content) + '\n', 'utf-8');
+}
+/**
+ * 后台 install worker 体：跑 installDependencies，按结果写 marker（仅沙箱）。
+ * 由 dispatchAsyncInstall 通过 `node -e` 在 detached 子进程里调用（见下）。
+ * presence 定成败：成功写 WORKSPACE_READY，失败写 WORKSPACE_FAILED；content 给排障。
+ */
+function runAsyncInstallWorker(opts) {
+    const eventDir = opts.eventDir ?? EVENT_DIR;
+    const sandbox = isSandboxEnv();
+    if (sandbox)
+        clearStaleMarkers(eventDir);
+    const start = Date.now();
+    let result;
+    try {
+        result = (0, install_1.installDependencies)({ targetDir: opts.targetDir, quietStdout: false });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (sandbox) {
+            writeMarker(eventDir, MARKER_FAILED, {
+                ts: nowIso(),
+                error: msg,
+                logPath: exports.ASYNC_INSTALL_LOG,
+            });
+        }
+        return;
+    }
+    if (!sandbox)
+        return;
+    if (result.source === 'failed') {
+        writeMarker(eventDir, MARKER_FAILED, {
+            ts: nowIso(),
+            error: result.error ?? 'npm install failed',
+            logPath: exports.ASYNC_INSTALL_LOG,
+        });
+    }
+    else {
+        writeMarker(eventDir, MARKER_READY, {
+            ts: nowIso(),
+            durationMs: Date.now() - start,
+            source: result.source,
+        });
+    }
+}
+/**
+ * 派发 detached 后台进程跑依赖安装并立即返回。
+ * 用 `node -e` 直接 require 本模块（编译产物）调 runAsyncInstallWorker，
+ * 不挂任何 CLI 子命令、对外不暴露；worker 内复用 installDependencies（cache / registry / fallback）。
+ * 沙箱下派发前清旧 marker；stdout/stderr 重定向到 logPath。
+ */
+function dispatchAsyncInstall(opts) {
+    const eventDir = opts.eventDir ?? EVENT_DIR;
+    const logPath = opts.logPath ?? exports.ASYNC_INSTALL_LOG;
+    const sandbox = isSandboxEnv();
+    if (sandbox)
+        clearStaleMarkers(eventDir);
+    // targetDir 走 argv 传，不拼进代码串（免转义）；只把本模块路径 JSON 内联进去。
+    const workerCode = `require(${JSON.stringify(__filename)}).runAsyncInstallWorker({ targetDir: process.argv[1] })`;
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logPath), { recursive: true });
+    const fd = node_fs_1.default.openSync(logPath, 'w');
+    try {
+        const child = (0, node_child_process_1.spawn)(process.execPath, ['-e', workerCode, opts.targetDir], {
+            detached: true,
+            stdio: ['ignore', fd, fd],
+        });
+        child.unref();
+        return {
+            pid: child.pid,
+            logPath,
+            eventReadyPath: sandbox ? node_path_1.default.join(eventDir, MARKER_READY) : undefined,
+            eventFailedPath: sandbox ? node_path_1.default.join(eventDir, MARKER_FAILED) : undefined,
+        };
+    }
+    finally {
+        // 父进程关掉自己那份 fd；子进程已通过 stdio dup 持有独立副本。
+        node_fs_1.default.closeSync(fd);
+    }
+}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+exports.ASYNC_INSTALL_LOG = exports.isSandboxEnv = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = 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; } });
@@ -11,3 +11,8 @@ Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: functi
 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; } });
+var async_install_1 = require("./async-install");
+Object.defineProperty(exports, "dispatchAsyncInstall", { enumerable: true, get: function () { return async_install_1.dispatchAsyncInstall; } });
+Object.defineProperty(exports, "runAsyncInstallWorker", { enumerable: true, get: function () { return async_install_1.runAsyncInstallWorker; } });
+Object.defineProperty(exports, "isSandboxEnv", { enumerable: true, get: function () { return async_install_1.isSandboxEnv; } });
+Object.defineProperty(exports, "ASYNC_INSTALL_LOG", { enumerable: true, get: function () { return async_install_1.ASYNC_INSTALL_LOG; } });

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

@@ -15,6 +15,7 @@ exports.TEMPLATE_PACKAGE_BY_STACK = {
     'vite-react': '@lark-apaas/coding-template-vite-react',
     html: '@lark-apaas/coding-template-html',
     'nestjs-react-fullstack': '@lark-apaas/coding-template-nestjs-react-fullstack',
+    'design-html': '@lark-apaas/coding-template-design-html',
 };
 /**
  * 短名 → template 包钉版表。renderTemplate 默认按这张表取版本号，表外 stack 跟 npm latest。

package/dist/services/deploy/modern/atoms/design-build.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDesignBuild = runDesignBuild;
+const node_child_process_1 = require("node:child_process");
+const error_1 = require("../../../../utils/error");
+const logger_1 = require("../../../../utils/logger");
+/**
+ * design-html 本地构建：跑 `npm run build`（模板里即 bash scripts/build.sh）。
+ * build.sh 读 process.env.CLIENT_BASE_PATH（平台预置），子进程继承 env 即透传，
+ * 不需要 CDN 凭证、不注入 MIAODA_*。
+ */
+function runDesignBuild(opts) {
+    (0, logger_1.log)('deploy', 'Building (design)...');
+    try {
+        (0, node_child_process_1.execSync)('npm run build', { cwd: opts.projectDir, stdio: 'inherit', env: process.env });
+    }
+    catch (err) {
+        throw new error_1.AppError('DEPLOY_BUILD_FAILED', `npm run build failed: ${err.message}`);
+    }
+}

package/dist/services/deploy/modern/atoms/design-upload.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadDesignArtifacts = uploadDesignArtifacts;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const error_1 = require("../../../../utils/error");
+const logger_1 = require("../../../../utils/logger");
+const constants_1 = require("../constants");
+const protocol_1 = require("../protocol");
+const tosutil_1 = require("./tosutil");
+/** 递归收集 dir 下相对路径（posix 分隔），与 -flat 上传后远端 key 对齐。 */
+function listLocalRelKeys(dir) {
+    const out = new Set();
+    const walk = (cur, rel) => {
+        for (const entry of node_fs_1.default.readdirSync(cur, { withFileTypes: true })) {
+            const childRel = rel ? `${rel}/${entry.name}` : entry.name;
+            if (entry.isDirectory())
+                walk(node_path_1.default.join(cur, entry.name), childRel);
+            else
+                out.add(childRel);
+        }
+    };
+    walk(dir, '');
+    return out;
+}
+/**
+ * design 部署上传（省带宽）：
+ *   1. 本地 dist/output ──cp(local→tos)──▶ output_backup_path/    （唯一一次上传）
+ *   2. output_backup_path ──cp(tos→tos,同凭证同桶)──▶ output_latest_path  （服务端复制）
+ *   3. ls latest → 跟本地 diff → rm latest 里源端已无的对象          （精确镜像）
+ * design-html 只产 dist/output，无 output_resource / output_static / capability。
+ */
+async function uploadDesignArtifacts(opts) {
+    await Promise.resolve();
+    const tosutilPath = (0, tosutil_1.resolveTosutilPath)();
+    const outputDir = node_path_1.default.join(opts.projectDir, constants_1.DIST_DIR, constants_1.OUTPUT_DIR);
+    if (!node_fs_1.default.existsSync(outputDir)) {
+        throw new error_1.AppError('DEPLOY_NO_BUILD_OUTPUT', `Required directory missing: ${constants_1.DIST_DIR}/${constants_1.OUTPUT_DIR}`);
+    }
+    // 空产物防呆：本地一个文件都没有时，绝不继续（否则 latest 会被整体 prune 清空）。
+    const localKeys = listLocalRelKeys(outputDir);
+    if (localKeys.size === 0) {
+        throw new error_1.AppError('DEPLOY_UPLOAD_EMPTY', `No files under ${constants_1.DIST_DIR}/${constants_1.OUTPUT_DIR} to upload — check build output.`);
+    }
+    const cred = (0, protocol_1.parseTosUploadCredential)((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.OUTPUT_ALL_TOS_UPLOAD_CREDENTIAL), protocol_1.DataKey.OUTPUT_ALL_TOS_UPLOAD_CREDENTIAL);
+    const backupPath = (0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.OUTPUT_BACKUP_PATH);
+    const latestPath = (0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.OUTPUT_LATEST_PATH);
+    const base = (0, tosutil_1.tosutilUploadFromTos)(cred); // 鉴权 + bucket
+    // 1. 本地 → backup（version）：唯一一次本地上传
+    (0, logger_1.log)('deploy', `Uploading ${constants_1.OUTPUT_DIR} → ${backupPath}...`);
+    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, outputDir, { ...base, prefix: backupPath }, 'output_backup');
+    // 2. backup → latest：服务端 tos→tos cp（不占带宽）
+    (0, logger_1.log)('deploy', `Server-side copy ${backupPath} → ${latestPath}...`);
+    (0, tosutil_1.copyTosToTos)(tosutilPath, base, backupPath, latestPath);
+    // 3. latest 精确镜像：删源端已不存在的对象。
+    //    安全阀：远端有对象但跟本地零重合时，判定为 key 形态/ls 解析不匹配，跳过 prune——
+    //    宁可漏删（latest 残留旧文件）也绝不误删整目录（数据丢失）。design-html 的 build.sh
+    //    必产稳定名的 routes.json / *.html，正常重合不会为空，零重合即异常信号。
+    const remoteKeys = (0, tosutil_1.listRemoteKeys)(tosutilPath, { ...base, prefix: latestPath });
+    const overlap = remoteKeys.filter((k) => localKeys.has(k));
+    if (remoteKeys.length > 0 && overlap.length === 0) {
+        (0, logger_1.log)('deploy', `⚠ latest 远端 ${String(remoteKeys.length)} 个对象与本地零重合，疑似 key 形态不匹配，跳过 prune（避免误删）`);
+        return;
+    }
+    const staleKeys = remoteKeys.filter((k) => !localKeys.has(k));
+    if (staleKeys.length > 0) {
+        (0, logger_1.log)('deploy', `Pruning ${String(staleKeys.length)} stale object(s) from latest...`);
+        (0, tosutil_1.removeRemoteKeys)(tosutilPath, { ...base, prefix: latestPath }, staleKeys);
+    }
+}

package/dist/services/deploy/modern/atoms/index.js

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = exports.runBuild = exports.preRelease = exports.prepareDeployContext = void 0;
+exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = exports.uploadDesignArtifacts = exports.runDesignBuild = exports.runBuild = exports.preRelease = exports.prepareDeployContext = void 0;
 var context_1 = require("./context");
 Object.defineProperty(exports, "prepareDeployContext", { enumerable: true, get: function () { return context_1.prepareDeployContext; } });
 var pre_release_1 = require("./pre-release");
 Object.defineProperty(exports, "preRelease", { enumerable: true, get: function () { return pre_release_1.preRelease; } });
 var build_1 = require("./build");
 Object.defineProperty(exports, "runBuild", { enumerable: true, get: function () { return build_1.runBuild; } });
+var design_build_1 = require("./design-build");
+Object.defineProperty(exports, "runDesignBuild", { enumerable: true, get: function () { return design_build_1.runDesignBuild; } });
+var design_upload_1 = require("./design-upload");
+Object.defineProperty(exports, "uploadDesignArtifacts", { enumerable: true, get: function () { return design_upload_1.uploadDesignArtifacts; } });
 var upload_1 = require("./upload");
 Object.defineProperty(exports, "uploadArtifacts", { enumerable: true, get: function () { return upload_1.uploadArtifacts; } });
 var local_release_1 = require("./local-release");