@lark-apaas/miaoda-cli 0.1.18-alpha.5fd4656 → 0.1.18-beta.9194d39

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

@@ -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

package/dist/cli/commands/index.js

@@ -14,7 +14,6 @@ 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>/ 子目录。
@@ -25,8 +24,6 @@ function resolveScene(appType, _archType) {
         return 'application';
     if (appType === '4')
         return 'design';
-    if (appType === '8')
-        return 'design-html';
     return 'default';
 }
 const SCENE_REGISTRARS = {
@@ -65,13 +62,6 @@ 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/config/sync-configs/index.js

@@ -23,7 +23,6 @@ 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 兜底。
@@ -31,7 +30,6 @@ const design_html_1 = __importDefault(require("./design-html"));
 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

@@ -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,7 +15,6 @@ 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/index.js

@@ -1,16 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = exports.uploadDesignArtifacts = exports.runDesignBuild = exports.runBuild = exports.preRelease = exports.prepareDeployContext = void 0;
+exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = 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");

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

@@ -5,13 +5,14 @@ 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',
@@ -31,6 +32,28 @@ 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 {
@@ -43,6 +66,106 @@ 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)
@@ -53,7 +176,7 @@ function uploadTosTarget(tosutilPath, target, localPath, data) {
     }
     const cred = (0, protocol_1.parseTosUploadCredential)(credRaw, target.dataKey);
     (0, logger_1.log)('deploy', `Uploading ${target.dir}...`);
-    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, localPath, (0, tosutil_1.tosutilUploadFromTos)(cred), target.dir);
+    uploadDirWithCredential(tosutilPath, localPath, tosutilUploadFromTos(cred), target.dir);
     return true;
 }
 function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
@@ -65,7 +188,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}...`);
-    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, localPath, tosutilUploadFromPaasStorage(cred, target.dataKey), target.dir);
+    uploadDirWithCredential(tosutilPath, localPath, tosutilUploadFromPaasStorage(cred, target.dataKey), target.dir);
     return cred;
 }
 /**
@@ -79,7 +202,7 @@ function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
  * 目录不存在的可选项跳过；output 不存在或凭证缺失抛错。
  */
 async function uploadArtifacts(opts) {
-    const tosutilPath = (0, tosutil_1.resolveTosutilPath)();
+    const tosutilPath = 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/pipelines/index.js

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.designLocalPublishPipeline = exports.localBuildLocalPublishPipeline = void 0;
+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,13 +33,6 @@ 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,19 +1,13 @@
 "use strict";
 // modern deploy 主入口（dispatch 层）。
 //
-// 按 templateKey 选 pipeline：design_local_deploy → design pipeline，其余 → client pipeline。
-// 仅为路由轻量解析 templateKey（读 meta.stack + 映射），不跑前置检查——前置检查在各
-// pipeline 内部的 prepareDeployContext 里做。client 分支与原行为完全一致。
-// pipeline 之间彼此独立、不共享中间状态。
+// 当前阶段（Scope A）只接入"本地构建 + 本地部署"一条 pipeline；
+// 后续接入"本地构建 + 远端部署 / 远端构建 + 远端部署"时，在此处按 template_key
+// 或显式 flag 选不同 pipeline。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,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DESIGN_LOCAL_DEPLOY = void 0;
 exports.resolveTemplateKey = resolveTemplateKey;
 /**
  * 本地 stack 短名 → 后端发布模板 key 的映射。
@@ -11,12 +10,9 @@ 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/dist/utils/coding-steering.js

@@ -8,10 +8,11 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const npm_pack_1 = require("../utils/npm-pack");
 const logger_1 = require("../utils/logger");
+const env_1 = require("../utils/env");
 const STEERING_PACKAGE = '@lark-apaas/coding-steering';
 function inferMode() {
-    // process.env.SANDBOX_ID 非空 → 沙箱；其他（undefined / 空串）→ 本地
-    return process.env.SANDBOX_ID ? 'sandbox' : 'local';
+    // 沙箱（MIAODA_DEP_CACHE_DIR 非空）→ sandbox；本地 → local
+    return (0, env_1.isSandboxEnv)() ? 'sandbox' : 'local';
 }
 /**
  * 把 coding-steering 包内 <stack>/skills_common + 专有层（skills 或 skills_local）同步到
@@ -19,7 +20,7 @@ function inferMode() {
  *
  * 包内目录约定（每个 stack 三层）：
  *   <stack>/skills_common  → 沙箱 + 本地都下发的共有层
- *   <stack>/skills         → 沙箱专有（沙箱端 update-skills.sh / SANDBOX_ID 非空时拿）
+ *   <stack>/skills         → 沙箱专有（沙箱端 update-skills.sh / mode=sandbox 时拿）
  *   <stack>/skills_local   → 本地专有（本地 dev / agent 环境拿）
  *
  * 下发组合（mode）：
@@ -31,8 +32,8 @@ function inferMode() {
  *   'flat'：拷到 .agents/skills/（平铺），tech.md → .agents/tech.md，并创建 .claude/skills
  *           软链指向 ../.agents/skills 让 Claude Code 识别同一份
  *
- * 同名 skill 覆盖顺序：common < 专有（专有覆盖 common 同名）。mode 缺省按 SANDBOX_ID env
- * 推断（沙箱平台运行时注入应用所属沙箱 ID；空 / undefined 则视为本地）。
+ * 同名 skill 覆盖顺序：common < 专有（专有覆盖 common 同名）。mode 缺省按 isSandboxEnv()
+ * 推断（MIAODA_DEP_CACHE_DIR 非空 → sandbox；空 / undefined → local）。
  *
  * 纯本地 atom（pull npm package + 拷贝文件），不属于任何 cli 域；放在 utils 让
  * app init handler 与独立 skills sync handler 都能复用。

package/dist/utils/env.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSandboxEnv = isSandboxEnv;
+/**
+ * 运行环境判定：当前进程是否跑在妙搭沙箱里。
+ *
+ * 口径：`process.env.MIAODA_DEP_CACHE_DIR` 非空（既非 undefined 也非空串）即为沙箱。
+ * 沙箱平台运行时会给应用进程注入依赖缓存目录；本地 dev / agent 环境拿不到该变量。
+ *
+ * 历史上用 `SANDBOX_ID` 判断，但该变量在部分沙箱场景下并不会注入，判断不可靠，已换成
+ * `MIAODA_DEP_CACHE_DIR`。注意：下发给 user app 的 `scripts/dev.sh` 仍按 `SANDBOX_ID`
+ * 判断（独立 bash 链路，不复用本函数）。
+ *
+ * 这是 CLI 运行时沙箱判定的 SSOT —— init outputLayout 分流、migrate 重启 dev process、
+ * coding-steering 同步 mode 推断、async-install 写 marker 都走这里，别再各处内联读环境变量。
+ */
+function isSandboxEnv() {
+    return process.env.MIAODA_DEP_CACHE_DIR !== undefined && process.env.MIAODA_DEP_CACHE_DIR !== '';
+}

package/dist/utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pollUntilDone = exports.msToSec = exports.msToNs = exports.parseToSec = exports.parseToNs = exports.parseToMs = exports.parseTimeToMs = exports.getInnerApi = exports.postInnerApi = exports.setRuntimeHttpClient = exports.setHttpClient = exports.resetHttpClient = exports.getRuntimeHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.fmt = exports.isJsonMode = exports.emitPaged = exports.emitOk = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
+exports.pollUntilDone = exports.msToSec = exports.msToNs = exports.parseToSec = exports.parseToNs = exports.parseToMs = exports.parseTimeToMs = exports.isSandboxEnv = exports.getInnerApi = exports.postInnerApi = exports.setRuntimeHttpClient = exports.setHttpClient = exports.resetHttpClient = exports.getRuntimeHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.fmt = exports.isJsonMode = exports.emitPaged = exports.emitOk = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
 var error_1 = require("./error");
 Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return error_1.AppError; } });
 Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return error_1.HttpError; } });
@@ -30,6 +30,8 @@ Object.defineProperty(exports, "setHttpClient", { enumerable: true, get: functio
 Object.defineProperty(exports, "setRuntimeHttpClient", { enumerable: true, get: function () { return http_1.setRuntimeHttpClient; } });
 Object.defineProperty(exports, "postInnerApi", { enumerable: true, get: function () { return http_1.postInnerApi; } });
 Object.defineProperty(exports, "getInnerApi", { enumerable: true, get: function () { return http_1.getInnerApi; } });
+var env_1 = require("./env");
+Object.defineProperty(exports, "isSandboxEnv", { enumerable: true, get: function () { return env_1.isSandboxEnv; } });
 var time_1 = require("./time");
 Object.defineProperty(exports, "parseTimeToMs", { enumerable: true, get: function () { return time_1.parseTimeToMs; } });
 Object.defineProperty(exports, "parseToMs", { enumerable: true, get: function () { return time_1.parseToMs; } });

package/package.json

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

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

@@ -1,25 +0,0 @@
-"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/services/deploy/modern/atoms/design-build.js

@@ -1,20 +0,0 @@
-"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

@@ -1,73 +0,0 @@
-"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/tosutil.js

@@ -1,234 +0,0 @@
-"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) {
-    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.`);
-    }
-}
-/** 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 -r -s 精简格式）。 */
-function listRemoteKeys(tosutilPath, cred) {
-    const base = normalizeTosDest(cred.bucket, cred.prefix); // tos://bucket/prefix
-    const confPath = writeTosutilConfig(tosutilPath, cred, 'ls');
-    let out;
-    try {
-        out = (0, node_child_process_1.execFileSync)(tosutilPath, ['ls', base, '-r', '-s', '-conf', confPath], {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe'],
-        });
-    }
-    catch (err) {
-        const e = err;
-        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `tosutil ls exited status ${String(e.status ?? -1)} for ${base}: ${(e.stderr ?? '').trim()}`);
-    }
-    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);
-        if (rel.length > 0 && !rel.endsWith('/'))
-            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/pipelines/design-local.js

@@ -1,47 +0,0 @@
-"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 走 runDesignBuild、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.runDesignBuild)({ 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/upgrade/templates/design-html/templates/scripts/build.sh

@@ -1,70 +0,0 @@
-#!/bin/bash
-set -e
-
-# design-html 的「构建」= 打包，不是编译。
-# 1. 把源文件原样拷进 dist/output/（保留目录层级），排除工具/公共文件；
-# 2. 扫描 .html 生成 dist/output/routes.json（schema 与 vite-react 对齐：[{ path }]）。
-# 无 bundler、无 transpile —— 源码即产物。
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-OUTPUT="$ROOT/dist/output"
-
-# basePath：平台注入 CLIENT_BASE_PATH 作为路由前缀（如 /app/<id>）；
-# 本地裸跑不设则为空（routes 退到 '/'）。
-BASE_PATH="${CLIENT_BASE_PATH:-}"
-
-# 不进产物的公共 / 工具文件（rsync 模式，相对 ROOT）
-EXCLUDES=(
-  ".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"
-)
-
-# 清理 & 拷贝
-rm -rf "$ROOT/dist"
-mkdir -p "$OUTPUT"
-
-rsync_args=(-a)
-for e in "${EXCLUDES[@]}"; do rsync_args+=(--exclude "$e"); done
-rsync "${rsync_args[@]}" "$ROOT/" "$OUTPUT/"
-
-# 生成 routes.json
-OUTPUT="$OUTPUT" BASE_PATH="$BASE_PATH" node --input-type=module <<'NODE'
-import { readdirSync, statSync, writeFileSync } from 'node:fs';
-import { join, relative, sep } from 'node:path';
-
-const out = process.env.OUTPUT;
-const base = (process.env.BASE_PATH || '').replace(/\/+$/, '');
-
-const htmls = [];
-(function walk(dir) {
-  for (const name of readdirSync(dir)) {
-    const p = join(dir, name);
-    if (statSync(p).isDirectory()) walk(p);
-    else if (name.toLowerCase().endsWith('.html')) htmls.push(relative(out, p));
-  }
-})(out);
-
-function toRoute(rel) {
-  let r = '/' + rel.split(sep).join('/'); // '/about.html' | '/blog/index.html'
-  r = r.replace(/\.html$/i, '');          // '/about'      | '/blog/index'
-  r = r.replace(/(^|\/)index$/, '$1');    // '/about'      | '/blog/'
-  if (r.length > 1) r = r.replace(/\/$/, ''); // 去掉非根的尾斜杠 → '/blog'
-  const full = base + r;
-  return full === '' ? '/' : full;
-}
-
-const routes = [...new Set(htmls.map(toRoute))]
-  .sort()
-  .map((path) => ({ path }));
-
-// 空白画布或无 html 时给一个默认根路由，保证 routes.json 始终可用
-if (routes.length === 0) routes.push({ path: base ? `${base}/` : '/' });
-
-writeFileSync(join(out, 'routes.json'), JSON.stringify(routes, null, 2) + '\n');
-console.log(`Generated routes.json (${routes.length} routes)`);
-NODE
-
-echo "Build complete"
-echo "  Output → dist/output/ (+ routes.json)"