@lark-apaas/miaoda-cli 0.1.18 → 0.1.19-alpha.4bf5458

package/dist/api/deploy/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.batchSavePluginInstances = exports.LocalReleaseStatus = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.callbackStatic = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
+exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.batchSavePluginInstances = exports.TosActionType = exports.LocalReleaseStatus = exports.applyTosDiff = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.callbackStatic = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
 Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
@@ -14,8 +14,10 @@ Object.defineProperty(exports, "callbackStatic", { enumerable: true, get: functi
 Object.defineProperty(exports, "createModernRelease", { enumerable: true, get: function () { return modern_1.createRelease; } });
 Object.defineProperty(exports, "getModernReleaseStatus", { enumerable: true, get: function () { return modern_1.getReleaseStatus; } });
 Object.defineProperty(exports, "getModernLastPublishedVersion", { enumerable: true, get: function () { return modern_1.getLastPublishedVersion; } });
+Object.defineProperty(exports, "applyTosDiff", { enumerable: true, get: function () { return modern_1.applyTosDiff; } });
 var modern_types_1 = require("./modern-types");
 Object.defineProperty(exports, "LocalReleaseStatus", { enumerable: true, get: function () { return modern_types_1.LocalReleaseStatus; } });
+Object.defineProperty(exports, "TosActionType", { enumerable: true, get: function () { return modern_types_1.TosActionType; } });
 var plugin_instances_1 = require("./plugin-instances");
 Object.defineProperty(exports, "batchSavePluginInstances", { enumerable: true, get: function () { return plugin_instances_1.batchSavePluginInstances; } });
 var schemas_1 = require("./schemas");

package/dist/api/deploy/modern-types.js

@@ -8,7 +8,7 @@
 //
 // 远端部署链路（B/C）所需的 release 接口先预留类型骨架，待 B/C 落地时启用。
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocalReleaseStatus = void 0;
+exports.TosActionType = exports.LocalReleaseStatus = void 0;
 /**
  * localPublish 状态枚举（数值，与服务端 IDL 对齐）。
  * CLI updateLocalRelease 只翻 Finished / Failed 两个终态；其它由后端流转。
@@ -21,3 +21,6 @@ exports.LocalReleaseStatus = {
     Canceled: 4,
     Rollback: 5,
 };
+// ── applyTosDiff（design-html 增量发布；后端应用 TOS diff） ──
+/** 对齐 IDL publish.TosActionType（UNSPECIFIED=0 不用） */
+exports.TosActionType = { CREATE: 1, UPDATE: 2, DELETE: 3 };

package/dist/api/deploy/modern.js

@@ -17,6 +17,7 @@ exports.callbackStatic = callbackStatic;
 exports.createRelease = createRelease;
 exports.getReleaseStatus = getReleaseStatus;
 exports.getLastPublishedVersion = getLastPublishedVersion;
+exports.applyTosDiff = applyTosDiff;
 const http_1 = require("../../utils/http");
 const devops_error_1 = require("../../utils/devops-error");
 const DEFAULT_ERR_CODE = 'INTERNAL_DEVOPS_ERROR';
@@ -76,3 +77,10 @@ async function getLastPublishedVersion(req) {
     const url = `/v1/devops/app/${encodeURIComponent(appID)}/last_published_version`;
     return (0, http_1.postInnerApi)(url, {}, envelopeOpts('Failed to get last published version'));
 }
+// ── applyTosDiff ──
+/** POST /v1/devops/app/:appID/apply_tos_diff —— 增量应用 TOS 文件 diff */
+async function applyTosDiff(req) {
+    const { appID, ...body } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/apply_tos_diff`;
+    return (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to apply tos diff'));
+}

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

@@ -164,7 +164,7 @@ function registerAppInit(parent) {
         .command('init')
         .description('初始化应用代码：抓 template 渲染、同步 upgrade/templates、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
-        .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
+        .option('--conf [json]', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
         .option('--async-install', '派发后台进程装依赖并立即返回（与 --skip-install 互斥）', false)
         .addOption((0, shared_1.appIdOption)())
@@ -198,7 +198,7 @@ function registerAppInit(parent) {
 异步安装（--async-install）
   跳过同步 npm install，派发一个 detached 后台进程装依赖后立即返回。
   .spark/meta.json 在返回前写出（= 脚手架就绪），install 真实结果由 event marker 表达。
-  仅沙箱（SANDBOX_ID 非空）写 marker（presence 定成败，content 给排障）：
+  仅沙箱（MIAODA_DEP_CACHE_DIR 非空）写 marker（presence 定成败，content 给排障）：
     成功 → /tmp/event/WORKSPACE_READY
     失败 → /tmp/event/WORKSPACE_FAILED
   安装日志：/tmp/async_install_dep.std.log
@@ -234,7 +234,9 @@ JSON 输出
     }));
 }
 function parseInitConf(raw) {
-    if (raw === undefined)
+    // --conf 为可选值：未传（undefined）、裸 --conf（Commander 给 true）、空/纯空白字符串
+    // 一律视为不配置，回退默认（latest）。
+    if (raw === undefined || typeof raw === 'boolean' || raw.trim() === '')
         return undefined;
     let parsed;
     try {

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDeployCommandsModern = registerDeployCommandsModern;
 const shared_1 = require("../../../cli/commands/shared");
 const modern_1 = require("../../../cli/handlers/deploy/modern");
+const index_1 = require("../../../cli/handlers/deploy/index");
 /**
  * modern scene (MIAODA_APP_TYPE=7) 专用 deploy 注册。
  * 仅披露顶层 `miaoda deploy`，CLI 表面对齐 openclaw-cli：`--dir / --skip-build`。
@@ -56,4 +57,33 @@ JSON 输出（stdout）
             conf: rawOpts.conf,
         });
     }));
+    const patchCmd = deployCmd
+        .command('patch')
+        .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, [])
+        .addHelpText('after', `
+--dir 为项目目录（与 deploy 同名参数，默认当前目录）。
+仅支持 design-html（design_local_deploy）。路径为工程根相对路径（= 服务端 latest 下 key），
+禁绝对路径与 ".."。--create/--update 的本地文件必须存在。改动集含 .html 时自动重算并随包
+更新 routes.json。
+
+JSON 输出
+  {"data": {"upsertCount": <n>, "deleteCount": <n>, "actionsSent": <n>, "routesRegenerated": <bool>}}
+
+示例
+  $ miaoda deploy patch --update index.html
+  $ miaoda deploy patch --create blog/post.html --delete blog/old.html
+  $ miaoda deploy patch --update assets/app.js --update assets/app.css
+`);
+    patchCmd.action((0, shared_1.withHelp)(patchCmd, async (rawOpts) => {
+        await (0, index_1.handleDeployPatch)({
+            appId: (0, shared_1.resolveAppId)({}),
+            dir: deployCmd.opts().dir ?? '.',
+            creates: rawOpts.create,
+            updates: rawOpts.update,
+            deletes: rawOpts.delete,
+        });
+    }));
 }

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

@@ -11,6 +11,7 @@ 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 env_1 = require("../../../utils/env");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 /**
@@ -72,12 +73,12 @@ async function handleAppInit(opts) {
     (0, logs_dir_1.ensureLogsDir)(targetDir);
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
     // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
-    // 按运行环境（SANDBOX_ID）分流 outputLayout，不绑 stack:
-    //   - 沙箱内（SANDBOX_ID 非空）→ nested (.agent/skills/steering/<stack>/skills/),
+    // 按运行环境（isSandboxEnv：MIAODA_DEP_CACHE_DIR 非空）分流 outputLayout，不绑 stack:
+    //   - 沙箱内 → nested (.agent/skills/steering/<stack>/skills/),
     //     跟沙箱端 update-skills.sh 链路对齐
-    //   - 本地（SANDBOX_ID 空）→ flat (.agents/skills + .claude/skills 软链),
+    //   - 本地 → flat (.agents/skills + .claude/skills 软链),
     //     Agent / Claude Code 用同一份;nrf 在本地是主战场,vite-react 等也一样适用
-    const outputLayout = process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '' ? 'nested' : 'flat';
+    const outputLayout = (0, env_1.isSandboxEnv)() ? 'nested' : 'flat';
     let steeringResult;
     let steeringError;
     try {

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

@@ -14,6 +14,7 @@ const migrate_rule_1 = require("../../../utils/migrate-rule");
 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 logger_1 = require("../../../utils/logger");
 /**
  * miaoda app migrate --to <stack> [--from <stack>] [--dir <path>]
@@ -138,14 +139,12 @@ async function handleAppMigrate(opts) {
     // 跑的 node 进程仍按老逻辑工作(只起 vite,没起 nest),整体没切到 fullstack 模式。
     // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,
     // 新进程用新 deps + 新 scripts,正常进入 fullstack 模式。
-    //   - 只在 SANDBOX_ID 非空时做(本地环境用户进程混杂,主动 pkill 风险大)
+    //   - 只在沙箱内做(isSandboxEnv;本地环境用户进程混杂,主动 pkill 风险大)
     //   - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
     //     留着旧进程让用户先处理 installError
     //   - 软失败:pkill 无匹配进程退出 1,catch 吞掉
     let devRestarted = false;
-    if (installError === undefined &&
-        process.env.SANDBOX_ID !== undefined &&
-        process.env.SANDBOX_ID !== '') {
+    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' });
@@ -170,7 +169,7 @@ async function handleAppMigrate(opts) {
             followLatestPackages: followLatest,
             installError,
             devRestarted,
-            nextActions: process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== ''
+            nextActions: (0, env_1.isSandboxEnv)()
                 ? [
                     'git status / git diff 评估改动并 commit',
                     'miaoda skills sync 同步到新 stack 的 agent skills',

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_POLL_INTERVAL_MS = exports.waitForPipeline = exports.handleDeployErrorLog = exports.handleDeployHistory = exports.handleDeployGet = exports.handleDeploy = void 0;
+exports.handleDeployPatch = exports.DEFAULT_POLL_INTERVAL_MS = exports.waitForPipeline = exports.handleDeployErrorLog = exports.handleDeployHistory = exports.handleDeployGet = exports.handleDeploy = void 0;
 var deploy_1 = require("./deploy");
 Object.defineProperty(exports, "handleDeploy", { enumerable: true, get: function () { return deploy_1.handleDeploy; } });
 var get_1 = require("./get");
@@ -12,3 +12,5 @@ Object.defineProperty(exports, "handleDeployErrorLog", { enumerable: true, get:
 var polling_1 = require("./polling");
 Object.defineProperty(exports, "waitForPipeline", { enumerable: true, get: function () { return polling_1.waitForPipeline; } });
 Object.defineProperty(exports, "DEFAULT_POLL_INTERVAL_MS", { enumerable: true, get: function () { return polling_1.DEFAULT_POLL_INTERVAL_MS; } });
+var patch_1 = require("./patch");
+Object.defineProperty(exports, "handleDeployPatch", { enumerable: true, get: function () { return patch_1.handleDeployPatch; } });

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDeployPatch = handleDeployPatch;
+const index_1 = require("../../../services/deploy/modern/patch/index");
+const output_1 = require("../../../utils/output");
+/** miaoda deploy patch —— design-html 文件级增量发布 */
+async function handleDeployPatch(opts) {
+    const result = await (0, index_1.patchDesignDeploy)({
+        appId: opts.appId,
+        projectDir: opts.dir ?? process.cwd(),
+        creates: opts.creates,
+        updates: opts.updates,
+        deletes: opts.deletes,
+    });
+    (0, output_1.emit)({ data: result });
+}

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

@@ -4,12 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (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 env_1 = require("../../../utils/env");
 const install_1 = require("./install");
 /** event marker 目录，写死；写前 mkdir -p。沙箱里 code server 轮询此目录。 */
 const EVENT_DIR = '/tmp/event';
@@ -19,10 +19,6 @@ const MARKER_READY = 'WORKSPACE_READY';
 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();
 }
@@ -44,7 +40,7 @@ function writeMarker(eventDir, name, content) {
  */
 function runAsyncInstallWorker(opts) {
     const eventDir = opts.eventDir ?? EVENT_DIR;
-    const sandbox = isSandboxEnv();
+    const sandbox = (0, env_1.isSandboxEnv)();
     if (sandbox)
         clearStaleMarkers(eventDir);
     const start = Date.now();
@@ -89,7 +85,7 @@ function runAsyncInstallWorker(opts) {
 function dispatchAsyncInstall(opts) {
     const eventDir = opts.eventDir ?? EVENT_DIR;
     const logPath = opts.logPath ?? exports.ASYNC_INSTALL_LOG;
-    const sandbox = isSandboxEnv();
+    const sandbox = (0, env_1.isSandboxEnv)();
     if (sandbox)
         clearStaleMarkers(eventDir);
     // targetDir 走 argv 传，不拼进代码串（免转义）；只把本模块路径 JSON 内联进去。

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.ASYNC_INSTALL_LOG = 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; } });
@@ -14,5 +14,4 @@ Object.defineProperty(exports, "resolveNpmInstallRegistry", { enumerable: true,
 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,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDesignOutput = buildDesignOutput;
+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 source_scan_1 = require("../patch/source-scan");
+const routes_1 = require("../patch/routes");
+/**
+ * design-html buildless 闭环 build（替代模板 scripts/build.sh）：
+ *   1. rm -rf <projectDir>/dist
+ *   2. 拷源码 → dist/output（套 EXCLUDES，与 routes 同一份 listSourceFiles）
+ *   3. 写 dist/output/routes.json = generateRoutes(projectDir)
+ * 不跑 npm run build、不依赖技术栈内 build.sh。
+ * fs / scan / routes 任何失败统一包成 AppError('DEPLOY_BUILD_FAILED')，与旧 runDesignBuild 对齐。
+ */
+function buildDesignOutput(opts) {
+    (0, logger_1.log)('deploy', 'Building (design, CLI)...');
+    try {
+        const distDir = node_path_1.default.join(opts.projectDir, constants_1.DIST_DIR);
+        const outputDir = node_path_1.default.join(distDir, constants_1.OUTPUT_DIR);
+        node_fs_1.default.rmSync(distDir, { recursive: true, force: true });
+        node_fs_1.default.mkdirSync(outputDir, { recursive: true });
+        for (const rel of (0, source_scan_1.listSourceFiles)(opts.projectDir)) {
+            const dest = node_path_1.default.join(outputDir, rel);
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(dest), { recursive: true });
+            node_fs_1.default.copyFileSync(node_path_1.default.join(opts.projectDir, rel), dest);
+        }
+        node_fs_1.default.writeFileSync(node_path_1.default.join(outputDir, 'routes.json'), (0, routes_1.generateRoutes)(opts.projectDir), 'utf-8');
+    }
+    catch (err) {
+        if (err instanceof error_1.AppError)
+            throw err;
+        throw new error_1.AppError('DEPLOY_BUILD_FAILED', `design build failed: ${err.message}`);
+    }
+}

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

@@ -0,0 +1,74 @@
+"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）：唯一一次本地上传。
+    //    -ddo（noDirObjects）：不上传文件夹占位对象，避免 latest 残留 `src/` 这类空目录。
+    (0, logger_1.log)('deploy', `Uploading ${constants_1.OUTPUT_DIR} → ${backupPath}...`);
+    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, outputDir, { ...base, prefix: backupPath }, 'output_backup', true);
+    // 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.buildDesignOutput = 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, "buildDesignOutput", { enumerable: true, get: function () { return design_build_1.buildDesignOutput; } });
+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");