@lark-apaas/miaoda-cli 0.1.18-alpha.b094028 → 0.1.18-alpha.b809ecc

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/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/migrate.js

@@ -134,42 +134,6 @@ async function handleAppMigrate(opts) {
         installError = err instanceof Error ? err.message : String(err);
         (0, logger_1.log)('migrate', `⚠ npm install failed (continuing): ${installError}`);
     }
-    // 预热 vite deps cache —— 绕开 dev server 内嵌 optimizer 在沙箱里的 silent hang。
-    //
-    // 背景:migrate 跑完 npm install 后,fullstack user app 的 lockfile 是新的,但
-    // node_modules/.vite/deps/_metadata.json 还是旧/不存在。下一次 dev:client 启动时
-    // vite 看到 lockfile hash 跟 metadata 不一致,触发内嵌 optimizer 重跑 prebundle。
-    // 偶发(看起来跟沙箱 CPU / esbuild worker 状态有关) optimizer 静默 hang —— bundle 不
-    // 完成、不写产物、不报错,但 vite middleware 仍 serve 请求:transform 写一个 hash、
-    // load 又拿到另一个 hash, 持续 504。详见
-    // ~/docs/miaoda-fullstack-vite-deps-504-20260624.md
-    //
-    // 解法:这里 standalone `npx vite optimize --force` 跑一次,只用 vite optimizer 子流程
-    // (不加载 preset 那一堆 plugin 的 dev server lifecycle hook),沙箱里实测 1~2 秒就能
-    // 完成,写出 _metadata.json + 当下 lockfileHash。下一次 dev:client 启动时 vite 看
-    // hash 跟 cache 一致就跳过 Re-optimize, 直接复用 cache,绕开 hang 路径。
-    //
-    //   - 只在 SANDBOX_ID 非空时做(本地环境 vite 自带 optimizer 不卡, 没必要拖慢 migrate)
-    //   - 只在 install 成功时做(install 失败时 node_modules 状态不对, optimize 也会挂)
-    //   - 软失败:optimize 挂了不阻断后续 pkill —— 即使没预热成功, dev server 自己跑
-    //     optimizer 偶尔也能通过, 不要因为这一步丢掉重启 dev 的机会
-    let optimizeError;
-    if (installError === undefined &&
-        process.env.SANDBOX_ID !== undefined &&
-        process.env.SANDBOX_ID !== '') {
-        (0, logger_1.log)('migrate', 'Pre-warming vite deps cache (vite optimize --force)...');
-        try {
-            (0, node_child_process_1.execFileSync)('npx', ['-y', 'vite', 'optimize', '--force'], {
-                cwd: targetDir,
-                stdio: (0, output_1.isJsonMode)() ? ['ignore', 'ignore', 'inherit'] : 'inherit',
-                timeout: 120_000,
-            });
-        }
-        catch (err) {
-            optimizeError = err instanceof Error ? err.message : String(err);
-            (0, logger_1.log)('migrate', `⚠ vite optimize prewarm failed (continuing): ${optimizeError}`);
-        }
-    }
     // 沙箱环境下重启 dev process —— scripts/dev.js 被 fullstack 版本覆盖了,但当前正在
     // 跑的 node 进程仍按老逻辑工作(只起 vite,没起 nest),整体没切到 fullstack 模式。
     // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,
@@ -205,7 +169,6 @@ async function handleAppMigrate(opts) {
             ...summarizeResults(results),
             followLatestPackages: followLatest,
             installError,
-            optimizeError,
             devRestarted,
             nextActions: process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== ''
                 ? [

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/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");

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

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTosutilPath = resolveTosutilPath;
+exports.tosutilUploadFromTos = tosutilUploadFromTos;
+exports.writeTosutilConfig = writeTosutilConfig;
+exports.streamTosutilOutput = streamTosutilOutput;
+exports.normalizeTosDest = normalizeTosDest;
+exports.uploadDirWithCredential = uploadDirWithCredential;
+exports.copyTosToTos = copyTosToTos;
+exports.listRemoteKeys = listRemoteKeys;
+exports.removeRemoteKeys = removeRemoteKeys;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const error_1 = require("../../../../utils/error");
+const logger_1 = require("../../../../utils/logger");
+function resolveTosutilPath() {
+    try {
+        const resolved = (0, node_child_process_1.execFileSync)('which', ['tosutil'], { encoding: 'utf-8' }).trim();
+        if (resolved)
+            return resolved;
+    }
+    catch {
+        /* fallthrough */
+    }
+    throw new error_1.AppError('DEPLOY_TOSUTIL_MISSING', 'tosutil is not installed or not in PATH. modern deploy requires sandbox preinstalled tosutil.');
+}
+function tosutilUploadFromTos(cred) {
+    return {
+        accessKeyID: cred.accessKeyID,
+        secretAccessKey: cred.secretAccessKey,
+        sessionToken: cred.sessionToken,
+        endpoint: cred.endpoint,
+        region: cred.region,
+        bucket: cred.bucket,
+        prefix: cred.prefix,
+    };
+}
+/**
+ * 写一个 tosutil 临时 config 文件，注入 STS 凭证 + endpoint + region。
+ * 返回 config 路径，调用方负责清理。
+ */
+function writeTosutilConfig(tosutilPath, cred, label) {
+    const confPath = node_path_1.default.join(node_os_1.default.tmpdir(), `.tosutilconfig-miaoda-${label}-${String(process.pid)}-${String(Date.now())}`);
+    node_fs_1.default.writeFileSync(confPath, '');
+    (0, node_child_process_1.execFileSync)(tosutilPath, [
+        'config',
+        '-conf',
+        confPath,
+        '-e',
+        cred.endpoint,
+        '-i',
+        cred.accessKeyID,
+        '-k',
+        cred.secretAccessKey,
+        '-t',
+        cred.sessionToken,
+        '-re',
+        cred.region,
+    ], { stdio: 'pipe' });
+    return confPath;
+}
+/** 把 tosutil 进程的输出按行回放到 stderr，便于线上排查（沙箱里无法 attach 进程）。 */
+function streamTosutilOutput(output) {
+    if (!output)
+        return;
+    for (const line of output.split('\n')) {
+        if (line.length === 0)
+            continue;
+        process.stderr.write(`[tosutil] ${line}\n`);
+    }
+}
+function normalizeTosDest(bucket, prefix) {
+    const bucketPart = bucket.startsWith('tos://') ? bucket : `tos://${bucket}`;
+    const normalized = prefix.replace(/^\/+/, '');
+    return `${bucketPart.replace(/\/+$/, '')}/${normalized}`;
+}
+/**
+ * 用 tosutil 把目录批量上传到 tos://bucket/prefix（STS 凭证从 config 文件读取）。
+ */
+function uploadDirWithCredential(tosutilPath, sourceDir, cred, label, 
+/**
+ * 传 true 时加 tosutil `-ddo`：上传时不把文件夹本身作为单独对象上传，
+ * 避免在 TOS 留下 `src/` 这类零字节目录占位对象（删空目录下最后一个文件后“文件夹”仍残留）。
+ * 仅 design 链路传 true；client/nrf 上传保持原行为（不传）。
+ */
+noDirObjects = false) {
+    const entries = node_fs_1.default.readdirSync(sourceDir);
+    if (entries.length === 0) {
+        (0, logger_1.debug)(`upload: skip empty dir ${sourceDir}`);
+        return;
+    }
+    const dest = normalizeTosDest(cred.bucket, cred.prefix);
+    (0, logger_1.debug)(`upload: ${sourceDir} -> ${dest} (${String(entries.length)} entries)`);
+    const confPath = writeTosutilConfig(tosutilPath, cred, label);
+    let output;
+    try {
+        output = (0, node_child_process_1.execFileSync)(tosutilPath, [
+            'cp',
+            sourceDir,
+            dest,
+            '-r',
+            '-flat',
+            '-j',
+            '5',
+            '-p',
+            '3',
+            '-ps',
+            '10485760',
+            '-f',
+            ...(noDirObjects ? ['-ddo'] : []),
+            '-conf',
+            confPath,
+        ], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        streamTosutilOutput(output);
+    }
+    catch (err) {
+        const e = err;
+        const stderr = (e.stderr ?? '').trim();
+        const stdout = (e.stdout ?? '').trim();
+        streamTosutilOutput(stdout);
+        streamTosutilOutput(stderr);
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `tosutil cp exited with status ${String(e.status ?? -1)} for ${sourceDir}\n` +
+            `  stderr: ${stderr || '(empty)'}\n` +
+            `  stdout: ${stdout.slice(0, 500) || '(empty)'}`);
+    }
+    finally {
+        try {
+            node_fs_1.default.unlinkSync(confPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    const succeedMatch = /Succeed count is:\s*(\d+)/.exec(output);
+    const failedMatch = /Failed count is:\s*(\d+)/.exec(output);
+    const succeedCount = succeedMatch ? Number.parseInt(succeedMatch[1], 10) : 0;
+    const failedCount = failedMatch ? Number.parseInt(failedMatch[1], 10) : 0;
+    if (failedCount > 0) {
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `Upload failed: ${String(failedCount)} files failed, ${String(succeedCount)} succeeded. source=${sourceDir}`);
+    }
+    if (succeedCount === 0) {
+        throw new error_1.AppError('DEPLOY_UPLOAD_EMPTY', `Upload failed: 0 files uploaded. source=${sourceDir}. Check tosutil credentials and bucket permissions.`);
+    }
+}
+/** version→latest 同桶同凭证服务端复制：tosutil cp tos://src tos://dst -r -flat -f */
+function copyTosToTos(tosutilPath, cred, srcPrefix, dstPrefix) {
+    const src = normalizeTosDest(cred.bucket, srcPrefix);
+    const dst = normalizeTosDest(cred.bucket, dstPrefix);
+    const confPath = writeTosutilConfig(tosutilPath, cred, 'tos2tos');
+    try {
+        const out = (0, node_child_process_1.execFileSync)(tosutilPath, ['cp', src, dst, '-r', '-flat', '-f', '-j', '5', '-conf', confPath], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        streamTosutilOutput(out);
+    }
+    catch (err) {
+        const e = err;
+        streamTosutilOutput((e.stdout ?? '').trim());
+        streamTosutilOutput((e.stderr ?? '').trim());
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `tosutil cp(tos→tos) exited status ${String(e.status ?? -1)}: ${src} → ${dst}`);
+    }
+    finally {
+        try {
+            node_fs_1.default.unlinkSync(confPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/** 列 tos://bucket/prefix 下所有对象，返回相对 prefix 的 key 集合（用 ls -s 精简格式，ls 默认递归）。 */
+function listRemoteKeys(tosutilPath, cred) {
+    const base = normalizeTosDest(cred.bucket, cred.prefix); // tos://bucket/prefix
+    const confPath = writeTosutilConfig(tosutilPath, cred, 'ls');
+    let out;
+    try {
+        // 注意：tosutil ls 没有 -r（默认就递归，-d 才是只列一层），别套 cp/rm 的 -r。
+        out = (0, node_child_process_1.execFileSync)(tosutilPath, ['ls', base, '-s', '-conf', confPath], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        const e = err;
+        // tosutil 把参数类错误打到 stdout，故 stderr/stdout 都带上，避免错误信息为空难排查。
+        const detail = [(e.stderr ?? '').trim(), (e.stdout ?? '').trim()].filter(Boolean).join(' | ');
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `tosutil ls exited status ${String(e.status ?? -1)} for ${base}: ${detail || '(no output)'}`);
+    }
+    finally {
+        try {
+            node_fs_1.default.unlinkSync(confPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    const prefixUri = base.replace(/\/+$/, '') + '/';
+    const keys = [];
+    for (const line of out.split('\n')) {
+        const t = line.trim();
+        if (!t.startsWith(prefixUri))
+            continue;
+        const rel = t.slice(prefixUri.length);
+        // 含以 / 结尾的目录占位对象（如 `src/`）：本地文件集永远不含此类 key，
+        // 故它们必落入镜像 prune 的“stale”集合被删除——清掉历史 -ddo 之前留下的空目录残留。
+        if (rel.length > 0)
+            keys.push(rel);
+    }
+    return keys;
+}
+/** 删除 tos://bucket/prefix 下指定相对 key（逐个 rm -f）。 */
+function removeRemoteKeys(tosutilPath, cred, relKeys) {
+    if (relKeys.length === 0)
+        return;
+    const confPath = writeTosutilConfig(tosutilPath, cred, 'rm');
+    const prefix = cred.prefix.replace(/\/+$/, '');
+    const failed = [];
+    try {
+        for (const rel of relKeys) {
+            // 用与 cp/ls 同一份 normalizeTosDest 拼目标 URI，避免删除路径与其它操作漂移。
+            const dest = normalizeTosDest(cred.bucket, `${prefix}/${rel}`);
+            try {
+                (0, node_child_process_1.execFileSync)(tosutilPath, ['rm', dest, '-f', '-conf', confPath], {
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+            }
+            catch {
+                failed.push(rel);
+            }
+        }
+    }
+    finally {
+        try {
+            node_fs_1.default.unlinkSync(confPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (failed.length > 0) {
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `prune latest failed for: ${failed.join(', ')}`);
+    }
+}

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

@@ -5,14 +5,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadArtifacts = uploadArtifacts;
 const node_fs_1 = __importDefault(require("node:fs"));
-const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
-const node_child_process_1 = require("node:child_process");
 const index_1 = require("../../../../api/deploy/index");
 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");
 const UPLOAD_PLAN = [
     {
         kind: 'tos',
@@ -32,28 +31,6 @@ const UPLOAD_PLAN = [
         dataKey: protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL,
     },
 ];
-function resolveTosutilPath() {
-    try {
-        const resolved = (0, node_child_process_1.execFileSync)('which', ['tosutil'], { encoding: 'utf-8' }).trim();
-        if (resolved)
-            return resolved;
-    }
-    catch {
-        /* fallthrough */
-    }
-    throw new error_1.AppError('DEPLOY_TOSUTIL_MISSING', 'tosutil is not installed or not in PATH. modern deploy requires sandbox preinstalled tosutil.');
-}
-function tosutilUploadFromTos(cred) {
-    return {
-        accessKeyID: cred.accessKeyID,
-        secretAccessKey: cred.secretAccessKey,
-        sessionToken: cred.sessionToken,
-        endpoint: cred.endpoint,
-        region: cred.region,
-        bucket: cred.bucket,
-        prefix: cred.prefix,
-    };
-}
 function tosutilUploadFromPaasStorage(cred, dataKey) {
     const { bucket, prefix } = (0, protocol_1.parseTosUploadPrefix)(cred.uploadPrefix, dataKey);
     return {
@@ -66,106 +43,6 @@ function tosutilUploadFromPaasStorage(cred, dataKey) {
         prefix,
     };
 }
-/**
- * 写一个 tosutil 临时 config 文件，注入 STS 凭证 + endpoint + region。
- * 返回 config 路径，调用方负责清理。
- */
-function writeTosutilConfig(tosutilPath, cred, label) {
-    const confPath = node_path_1.default.join(node_os_1.default.tmpdir(), `.tosutilconfig-miaoda-${label}-${String(process.pid)}-${String(Date.now())}`);
-    node_fs_1.default.writeFileSync(confPath, '');
-    (0, node_child_process_1.execFileSync)(tosutilPath, [
-        'config',
-        '-conf',
-        confPath,
-        '-e',
-        cred.endpoint,
-        '-i',
-        cred.accessKeyID,
-        '-k',
-        cred.secretAccessKey,
-        '-t',
-        cred.sessionToken,
-        '-re',
-        cred.region,
-    ], { stdio: 'pipe' });
-    return confPath;
-}
-/** 把 tosutil 进程的输出按行回放到 stderr，便于线上排查（沙箱里无法 attach 进程）。 */
-function streamTosutilOutput(output) {
-    if (!output)
-        return;
-    for (const line of output.split('\n')) {
-        if (line.length === 0)
-            continue;
-        process.stderr.write(`[tosutil] ${line}\n`);
-    }
-}
-function normalizeTosDest(bucket, prefix) {
-    const bucketPart = bucket.startsWith('tos://') ? bucket : `tos://${bucket}`;
-    const normalized = prefix.replace(/^\/+/, '');
-    return `${bucketPart.replace(/\/+$/, '')}/${normalized}`;
-}
-/**
- * 用 tosutil 把目录批量上传到 tos://bucket/prefix（STS 凭证从 config 文件读取）。
- */
-function uploadDirWithCredential(tosutilPath, sourceDir, cred, label) {
-    const entries = node_fs_1.default.readdirSync(sourceDir);
-    if (entries.length === 0) {
-        (0, logger_1.debug)(`upload: skip empty dir ${sourceDir}`);
-        return;
-    }
-    const dest = normalizeTosDest(cred.bucket, cred.prefix);
-    (0, logger_1.debug)(`upload: ${sourceDir} -> ${dest} (${String(entries.length)} entries)`);
-    const confPath = writeTosutilConfig(tosutilPath, cred, label);
-    let output;
-    try {
-        output = (0, node_child_process_1.execFileSync)(tosutilPath, [
-            'cp',
-            sourceDir,
-            dest,
-            '-r',
-            '-flat',
-            '-j',
-            '5',
-            '-p',
-            '3',
-            '-ps',
-            '10485760',
-            '-f',
-            '-conf',
-            confPath,
-        ], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
-        streamTosutilOutput(output);
-    }
-    catch (err) {
-        const e = err;
-        const stderr = (e.stderr ?? '').trim();
-        const stdout = (e.stdout ?? '').trim();
-        streamTosutilOutput(stdout);
-        streamTosutilOutput(stderr);
-        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `tosutil cp exited with status ${String(e.status ?? -1)} for ${sourceDir}\n` +
-            `  stderr: ${stderr || '(empty)'}\n` +
-            `  stdout: ${stdout.slice(0, 500) || '(empty)'}`);
-    }
-    finally {
-        try {
-            node_fs_1.default.unlinkSync(confPath);
-        }
-        catch {
-            /* ignore */
-        }
-    }
-    const succeedMatch = /Succeed count is:\s*(\d+)/.exec(output);
-    const failedMatch = /Failed count is:\s*(\d+)/.exec(output);
-    const succeedCount = succeedMatch ? Number.parseInt(succeedMatch[1], 10) : 0;
-    const failedCount = failedMatch ? Number.parseInt(failedMatch[1], 10) : 0;
-    if (failedCount > 0) {
-        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `Upload failed: ${String(failedCount)} files failed, ${String(succeedCount)} succeeded. source=${sourceDir}`);
-    }
-    if (succeedCount === 0) {
-        throw new error_1.AppError('DEPLOY_UPLOAD_EMPTY', `Upload failed: 0 files uploaded. source=${sourceDir}. Check tosutil credentials and bucket permissions.`);
-    }
-}
 function uploadTosTarget(tosutilPath, target, localPath, data) {
     const credRaw = target.required
         ? (0, protocol_1.requireDataKey)(data, target.dataKey)
@@ -176,7 +53,7 @@ function uploadTosTarget(tosutilPath, target, localPath, data) {
     }
     const cred = (0, protocol_1.parseTosUploadCredential)(credRaw, target.dataKey);
     (0, logger_1.log)('deploy', `Uploading ${target.dir}...`);
-    uploadDirWithCredential(tosutilPath, localPath, tosutilUploadFromTos(cred), target.dir);
+    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, localPath, (0, tosutil_1.tosutilUploadFromTos)(cred), target.dir);
     return true;
 }
 function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
@@ -188,7 +65,7 @@ function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
     }
     const cred = (0, protocol_1.parsePaasStorageCredential)((0, protocol_1.requireDataKey)(data, target.dataKey), target.dataKey);
     (0, logger_1.log)('deploy', `Uploading ${target.dir}...`);
-    uploadDirWithCredential(tosutilPath, localPath, tosutilUploadFromPaasStorage(cred, target.dataKey), target.dir);
+    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, localPath, tosutilUploadFromPaasStorage(cred, target.dataKey), target.dir);
     return cred;
 }
 /**
@@ -202,7 +79,7 @@ function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
  * 目录不存在的可选项跳过；output 不存在或凭证缺失抛错。
  */
 async function uploadArtifacts(opts) {
-    const tosutilPath = resolveTosutilPath();
+    const tosutilPath = (0, tosutil_1.resolveTosutilPath)();
     const distDir = node_path_1.default.join(opts.projectDir, constants_1.DIST_DIR);
     const outcome = { uploaded: 0 };
     for (const target of UPLOAD_PLAN) {

package/dist/services/deploy/modern/patch/actions.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTosActions = buildTosActions;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const error_1 = require("../../../../utils/error");
+const index_1 = require("../../../../api/deploy/index");
+const content_1 = require("./content");
+const routes_1 = require("./routes");
+/** 校验相对路径：禁绝对路径、禁含 ".." 段；normalize 成 posix 相对。 */
+function normalizeRel(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 readAction(projectDir, rel, actionType) {
+    const filePath = normalizeRel(rel);
+    const abs = node_path_1.default.join(projectDir, filePath);
+    if (!node_fs_1.default.existsSync(abs) || !node_fs_1.default.statSync(abs).isFile()) {
+        throw new error_1.AppError('ARGS_INVALID', `文件不存在：${filePath}`);
+    }
+    const { content, base64Content } = (0, content_1.encodeContent)(node_fs_1.default.readFileSync(abs));
+    return { actionType, filePath, content, base64Content };
+}
+function isHtml(rel) {
+    return rel.toLowerCase().endsWith('.html');
+}
+/**
+ * 把 changeset 组成 TosFileAction[]：
+ *   - create/update 读本地文件、自动编码；delete 仅 FilePath。
+ *   - 任一改动是 .html → 追加 routes.json（TS 重算）的 UPDATE action。
+ */
+function buildTosActions(projectDir, cs) {
+    const actions = [];
+    for (const rel of cs.creates)
+        actions.push(readAction(projectDir, rel, index_1.TosActionType.CREATE));
+    for (const rel of cs.updates)
+        actions.push(readAction(projectDir, rel, index_1.TosActionType.UPDATE));
+    for (const rel of cs.deletes) {
+        actions.push({ actionType: index_1.TosActionType.DELETE, filePath: normalizeRel(rel) });
+    }
+    const touchesHtml = [...cs.creates, ...cs.updates, ...cs.deletes].some(isHtml);
+    if (touchesHtml) {
+        actions.push({
+            actionType: index_1.TosActionType.UPDATE,
+            filePath: 'routes.json',
+            content: (0, routes_1.generateRoutes)(projectDir),
+            base64Content: false,
+        });
+    }
+    return actions;
+}

package/dist/services/deploy/modern/patch/content.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeContent = encodeContent;
+/**
+ * 自动判别文件内容编码：
+ *   - 含 0x00 字节 → 二进制 → base64
+ *   - 否则 round-trip 校验 UTF-8：能无损 decode→encode → 文本直传；否则 base64
+ */
+function encodeContent(buf) {
+    if (buf.includes(0x00)) {
+        return { content: buf.toString('base64'), base64Content: true };
+    }
+    const text = buf.toString('utf8');
+    if (Buffer.from(text, 'utf8').equals(buf)) {
+        return { content: text, base64Content: false };
+    }
+    return { content: buf.toString('base64'), base64Content: true };
+}

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

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTosActions = void 0;
+exports.patchDesignDeploy = patchDesignDeploy;
+const spark_meta_1 = require("../../../../utils/spark-meta");
+const error_1 = require("../../../../utils/error");
+const logger_1 = require("../../../../utils/logger");
+const index_1 = require("../../../../api/deploy/index");
+const template_key_map_1 = require("../template-key-map");
+const actions_1 = require("./actions");
+var actions_2 = require("./actions");
+Object.defineProperty(exports, "buildTosActions", { enumerable: true, get: function () { return actions_2.buildTosActions; } });
+/**
+ * design-html 增量发布：读本地文件组 TosFileAction（含 .html 时带 routes.json），
+ * 调后端 applyTosDiff 应用到 latest。scope 限 design_local_deploy。
+ */
+async function patchDesignDeploy(opts) {
+    if (opts.creates.length + opts.updates.length + opts.deletes.length === 0) {
+        throw new error_1.AppError('ARGS_INVALID', '至少指定一个 --create / --update / --delete');
+    }
+    const stack = (0, spark_meta_1.readSparkMeta)(opts.projectDir).stack ?? '';
+    const templateKey = (0, template_key_map_1.resolveTemplateKey)(stack);
+    if (templateKey !== template_key_map_1.DESIGN_LOCAL_DEPLOY) {
+        throw new error_1.AppError('ARGS_INVALID', `deploy patch 仅支持 design-html（design_local_deploy），当前 stack=${stack || '(空)'}`);
+    }
+    const actions = (0, actions_1.buildTosActions)(opts.projectDir, {
+        creates: opts.creates,
+        updates: opts.updates,
+        deletes: opts.deletes,
+    });
+    const routesRegenerated = actions.some((a) => a.filePath === 'routes.json');
+    (0, logger_1.log)('deploy', `Applying ${String(actions.length)} file action(s)...`);
+    const res = await (0, index_1.applyTosDiff)({ appID: opts.appId, templateKey, actions });
+    (0, logger_1.log)('deploy', `Patched: upsert=${String(res.upsertCount)} delete=${String(res.deleteCount)}`);
+    return {
+        upsertCount: res.upsertCount,
+        deleteCount: res.deleteCount,
+        actionsSent: actions.length,
+        routesRegenerated,
+    };
+}

package/dist/services/deploy/modern/patch/routes.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateRoutes = generateRoutes;
+const source_scan_1 = require("./source-scan");
+/** 与 build.sh 一致的 .html → route path 推导。rel 为 posix 相对路径。 */
+function toRoute(rel, base) {
+    let r = '/' + rel;
+    r = r.replace(/\.html$/i, '');
+    r = r.replace(/(^|\/)index$/, '$1');
+    if (r.length > 1)
+        r = r.replace(/\/$/, '');
+    const full = base + r;
+    return full === '' ? '/' : full;
+}
+/**
+ * 扫描 projectDir 下所有 .html（套 source-scan 的 EXCLUDES），生成与 build.sh 同款 routes.json
+ * 文本（含尾换行）。CLIENT_BASE_PATH 取自 process.env（平台预置），去尾斜杠后作前缀。
+ */
+function generateRoutes(projectDir) {
+    const base = (process.env.CLIENT_BASE_PATH ?? '').replace(/\/+$/, '');
+    const htmls = (0, source_scan_1.listSourceFiles)(projectDir).filter((f) => f.toLowerCase().endsWith('.html'));
+    const routes = [...new Set(htmls.map((rel) => toRoute(rel, base)))]
+        .sort()
+        .map((p) => ({ path: p }));
+    if (routes.length === 0)
+        routes.push({ path: base ? `${base}/` : '/' });
+    return JSON.stringify(routes, null, 2) + '\n';
+}

package/dist/services/deploy/modern/patch/source-scan.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXCLUDES = void 0;
+exports.listSourceFiles = listSourceFiles;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+// 与模板 scripts/build.sh 的 rsync EXCLUDES 对齐：这些名字（任意层级 basename）不进产物/不计入路由。
+exports.EXCLUDES = new Set([
+    '.git',
+    'node_modules',
+    'dist',
+    'scripts',
+    'package.json',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'yarn.lock',
+    '.gitignore',
+    '.npmrc',
+    '.agent',
+    '.env',
+    '.env.local',
+    'README.md',
+    '.DS_Store',
+    '.spark',
+]);
+/**
+ * 递归列出 root 下所有文件的相对 posix 路径，跳过 EXCLUDES（任意层级 basename），
+ * 用 statSync 判定目录/文件以 follow 符号链接（含指向目录的软链），断链等无法 stat 的条目跳过。
+ */
+function listSourceFiles(root) {
+    const out = [];
+    const walk = (dir, rel) => {
+        for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+            if (exports.EXCLUDES.has(entry.name))
+                continue;
+            const childRel = rel ? `${rel}/${entry.name}` : entry.name;
+            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)
+                walk(abs, childRel);
+            else
+                out.push(childRel);
+        }
+    };
+    walk(root, '');
+    return out;
+}

package/dist/services/deploy/modern/pipelines/design-local.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.designLocalPublishPipeline = designLocalPublishPipeline;
+const spark_meta_1 = require("../../../../utils/spark-meta");
+const error_1 = require("../../../../utils/error");
+const logger_1 = require("../../../../utils/logger");
+const index_1 = require("../atoms/index");
+/**
+ * design（design_local_deploy）本地构建 + 本地部署 pipeline。
+ *
+ * 与 client 版差异：build 走 buildDesignOutput（CLI 闭环，不跑 npm run build）、upload 走 uploadDesignArtifacts（version+latest
+ * 双写、latest 精确镜像）、不注册插件能力（design-html 无 capability）。其余复用同一套 atom。
+ */
+async function designLocalPublishPipeline(opts) {
+    const ctx = (0, index_1.prepareDeployContext)(opts.projectDir, opts.appId);
+    (0, logger_1.log)('deploy', 'Pre-releasing...');
+    const pre = await (0, index_1.preRelease)(ctx.appId, ctx.templateKey);
+    (0, logger_1.log)('deploy', `pre_release_id=${pre.preReleaseID} version=${pre.version}`);
+    if (pre.data === undefined) {
+        throw new error_1.AppError('DEPLOY_PRE_RELEASE_DATA_MISSING', 'preRelease did not return a `data` map — backend tcc may not be configured for current template_key');
+    }
+    const data = pre.data;
+    if (!opts.skipBuild) {
+        (0, index_1.buildDesignOutput)({ projectDir: ctx.projectDir });
+    }
+    (0, logger_1.log)('deploy', 'Creating local release...');
+    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version);
+    try {
+        await (0, index_1.uploadDesignArtifacts)({ projectDir: ctx.projectDir, data });
+        await (0, index_1.finalizeLocalRelease)(ctx.appId, release.releaseID, index_1.LocalReleaseStatus.Finished);
+    }
+    catch (err) {
+        await (0, index_1.finalizeLocalRelease)(ctx.appId, release.releaseID, index_1.LocalReleaseStatus.Failed);
+        throw err;
+    }
+    if (release.onlineUrl !== undefined && release.onlineUrl !== '') {
+        (0, spark_meta_1.writeSparkMeta)(ctx.projectDir, { appUrl: release.onlineUrl });
+    }
+    (0, logger_1.log)('deploy', 'Deployed successfully');
+    return {
+        appId: ctx.appId,
+        version: pre.version,
+        url: release.onlineUrl ?? '',
+        releaseID: release.releaseID,
+        preReleaseID: pre.preReleaseID,
+    };
+}

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

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localBuildLocalPublishPipeline = void 0;
+exports.designLocalPublishPipeline = exports.localBuildLocalPublishPipeline = void 0;
 var local_1 = require("./local");
 Object.defineProperty(exports, "localBuildLocalPublishPipeline", { enumerable: true, get: function () { return local_1.localBuildLocalPublishPipeline; } });
+var design_local_1 = require("./design-local");
+Object.defineProperty(exports, "designLocalPublishPipeline", { enumerable: true, get: function () { return design_local_1.designLocalPublishPipeline; } });

package/dist/services/deploy/modern/protocol.js

@@ -33,6 +33,13 @@ exports.DataKey = {
     // downloadURLPrefix 替代原 static_cdn_prefix 注入 build env。
     /** dist/output_static 上传凭证（仅当目录存在时使用） */
     OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL: 'output_static_paas_storage_credential',
+    // ── design 部署专用（design_local_deploy） ──
+    /** 覆盖整个 {app_id} 文件夹的上传凭证（形态同 TosUploadCredential） */
+    OUTPUT_ALL_TOS_UPLOAD_CREDENTIAL: 'output_all_tos_upload_credential',
+    /** version/备份份真实路径（后端已替换 {app_id}/{version}） */
+    OUTPUT_BACKUP_PATH: 'output_backup_path',
+    /** latest 份真实路径（后端已替换 {app_id}/latest） */
+    OUTPUT_LATEST_PATH: 'output_latest_path',
 };
 /** 取必传 key，缺失抛 AppError（带 key 名，便于后端 tcc 配置排查） */
 function requireDataKey(data, key) {

package/dist/services/deploy/modern/run.js

@@ -1,13 +1,19 @@
 "use strict";
 // modern deploy 主入口（dispatch 层）。
 //
-// 当前阶段（Scope A）只接入"本地构建 + 本地部署"一条 pipeline；
-// 后续接入"本地构建 + 远端部署 / 远端构建 + 远端部署"时，在此处按 template_key
-// 或显式 flag 选不同 pipeline。pipeline 之间彼此独立、不共享中间状态。
+// 按 templateKey 选 pipeline：design_local_deploy → design pipeline，其余 → client pipeline。
+// 仅为路由轻量解析 templateKey（读 meta.stack + 映射），不跑前置检查——前置检查在各
+// pipeline 内部的 prepareDeployContext 里做。client 分支与原行为完全一致。
+// pipeline 之间彼此独立、不共享中间状态。
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runModernDeploy = runModernDeploy;
+const spark_meta_1 = require("../../../utils/spark-meta");
+const template_key_map_1 = require("./template-key-map");
 const index_1 = require("./pipelines/index");
 async function runModernDeploy(opts) {
-    // 暂只支持本地构建 + 本地部署
+    const stack = (0, spark_meta_1.readSparkMeta)(opts.projectDir).stack ?? '';
+    if ((0, template_key_map_1.resolveTemplateKey)(stack) === template_key_map_1.DESIGN_LOCAL_DEPLOY) {
+        return (0, index_1.designLocalPublishPipeline)(opts);
+    }
     return (0, index_1.localBuildLocalPublishPipeline)(opts);
 }

package/dist/services/deploy/modern/template-key-map.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DESIGN_LOCAL_DEPLOY = void 0;
 exports.resolveTemplateKey = resolveTemplateKey;
 /**
  * 本地 stack 短名 → 后端发布模板 key 的映射。
@@ -10,9 +11,12 @@ exports.resolveTemplateKey = resolveTemplateKey;
  * 未来出现需要走别的 templateKey 的 stack，再在表里加一行覆盖默认。
  */
 const DEFAULT_TEMPLATE_KEY = 'client_local_deploy';
+/** design 部署 templateKey（run.ts 据此分流到 design pipeline） */
+exports.DESIGN_LOCAL_DEPLOY = 'design_local_deploy';
 const TEMPLATE_KEY_MAP = {
     'vite-react': DEFAULT_TEMPLATE_KEY,
     html: DEFAULT_TEMPLATE_KEY,
+    'design-html': exports.DESIGN_LOCAL_DEPLOY,
 };
 /**
  * 把本地 stack 短名映射到后端 templateKey；未配置的 stack 走默认 client_local_deploy。

package/package.json

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