@lark-apaas/miaoda-cli 0.1.19-alpha.6a5cefe → 0.1.19-alpha.7f0b693

package/README.md

@@ -41,9 +41,36 @@ miaoda file ls --output json
 | `miaoda file ...`          | 文件操作：上传、下载、元数据、签名下载、批量删除     |
 | `miaoda db ...`            | 数据操作：SQL 执行、表结构查询、数据导入导出         |
 | `miaoda observability ...` | 线上日志、链路、前端源码堆栈反查、监控指标、运营指标 |
+| `miaoda registry ...`      | 组件 registry：列出 / copy-in design-html SDK 文件（本地执行）     |
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
 
+## 组件 registry（design-html）
+
+`miaoda registry` 为 design-html 技术栈提供 shadcn 式的「组件 registry」：把 SDK 文件**拷进**当前项目（copy-in），而非作为依赖安装。registry 是独立 npm 包，按运行时分发（design-html → buildless runtime → `@lark-apaas/coding-registry-buildless`）。
+
+前置：当前目录（或 `--dir`）已走过 `miaoda app init`，`.spark/meta.json` 含 `stack=design-html`。
+
+```bash
+# 列出可用 SDK 条目（输出各文件 USAGE 注释块原文，便于 Agent 直接读用法）
+miaoda registry list
+miaoda registry list --json
+
+# 把条目 copy-in 到当前项目（自动按 USAGE 块的 Depends 解析依赖闭包一并拷入）
+miaoda registry add deck-slide
+miaoda registry add foo.css theme --dry-run        # 只报告将写 / 将跳，不落盘
+miaoda registry add deck-slide --overwrite         # 目标已存在时覆盖（默认跳过以保护改动）
+```
+
+要点：
+
+- **条目**：registry 包根 `components/` · `scripts/` · `stylesheets/` 三个顶层目录（任意深度）下的代码文件即条目。USAGE 注释块**可选**（有则提供描述 + Depends，无则空描述、无依赖）；包根直放文件、其它目录、非代码文件都不算条目。
+- **寻址**：`add` / `Depends` 的 token 可写三种形式 —— `name`（去扩展名，如 `foo`）/ 完整文件名（如 `foo.css`）/ relPath（如 `stylesheets/foo.css`）。`name` **不要求唯一**，`list --json` 的 `file`（relPath）是永远无歧义的 canonical 地址。
+- **多匹配全拉**：token 命中多个同名条目时全部 copy-in（如 `add foo` 把 `foo.jsx` + `foo.css` 一起拉），想只要其一就用完整文件名或 relPath。
+- **拍平落地**：所有文件**拍平**到项目根（`scripts/deck-slide.js` → 项目 `deck-slide.js`，不保留子目录）；闭包内同名 basename 撞车时后者覆盖前者。
+- **skip-by-disk**：项目已有同名（拍平后的 basename）文件默认跳过，`--overwrite` 才覆盖；不写任何安装记账文件，项目文件树即状态。
+- `--version <ver>` 指定 registry 包版本或 dist-tag（缺省 `latest`），`--dir <path>` 指定项目目录（缺省当前目录）。
+
 ## 全局参数
 
 - `--json [fields]`：输出结构化 JSON，可选字段级选择（如 `--json id,name`）。

package/dist/api/deploy/index.js

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

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

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

package/dist/api/deploy/modern.js

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

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

@@ -164,7 +164,7 @@ function registerAppInit(parent) {
         .command('init')
         .description('初始化应用代码：抓 template 渲染、同步 upgrade/templates、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
-        .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
+        .option('--conf [json]', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
         .option('--async-install', '派发后台进程装依赖并立即返回（与 --skip-install 互斥）', false)
         .addOption((0, shared_1.appIdOption)())
@@ -234,7 +234,9 @@ JSON 输出
     }));
 }
 function parseInitConf(raw) {
-    if (raw === undefined)
+    // --conf 为可选值：未传（undefined）、裸 --conf（Commander 给 true）、空/纯空白字符串
+    // 一律视为不配置，回退默认（latest）。
+    if (raw === undefined || typeof raw === 'boolean' || raw.trim() === '')
         return undefined;
     let parsed;
     try {

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

@@ -481,6 +481,7 @@ Examples:
         '应用到 online；online 将无法直接更改数据库结构（仍可进行数据 DML 操作）。')
         .usage('[flags]')
         .option('--sync-data', '启用时将现有数据同步一份到 dev 环境')
+        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function () {
         await (0, index_1.handleDbMigrationInit)(this.optsWithGlobals());
     })
@@ -561,6 +562,7 @@ Examples:
         .summary('将 dev 的变更发布到 online（单事务原子）')
         .description('将 dev 的变更发布到 online。')
         .usage('[flags]')
+        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function () {
         await (0, index_1.handleDbMigrationApply)(this.optsWithGlobals());
     })
@@ -679,6 +681,7 @@ Examples:
         .description('将数据库恢复到指定时间点的状态。')
         .usage('<timestamp> [flags]')
         .argument('<timestamp>', '目标时间')
+        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function (target) {
         await (0, index_1.handleDbRecoveryApply)(target, this.optsWithGlobals());
     })

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,35 @@ 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；纯 --update 现有 .html 只改内容，不动 routes.json。
+routes.json 每项为 {path, file}：path 为相对路径（不含 base 前缀，由消费侧拼接），file 为
+对应源文件（如 / → index.html）。
+
+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/file/index.js

@@ -146,10 +146,9 @@ Examples:
         .usage('[paths...] [flags]')
         .argument('[paths...]', '要删除的文件，每项可填路径或文件名（自动识别）')
         .option('-n, --name <name>', '按文件名删除（可重复指定）', (value, prev) => [...(prev ?? []), value])
-        // --yes 是 root 全局 option（见 main.ts），不在此重复声明；必须经 optsWithGlobals
-        // 读取（值挂在 root 上，本地 this.opts().yes 为 undefined），否则非交互场景确认门会误拦。
-        .action(async function (paths) {
-        await (0, index_1.handleFileRm)(paths, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
+        .option('-y, --yes', '跳过交互确认；非交互场景必加')
+        .action(async (paths, opts) => {
+        await (0, index_1.handleFileRm)(paths, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText('after', `
 Notes:

package/dist/cli/commands/index.js

@@ -9,11 +9,13 @@ const index_4 = require("../../cli/commands/app/index");
 const index_5 = require("../../cli/commands/deploy/index");
 const modern_1 = require("../../cli/commands/deploy/modern");
 const index_6 = require("../../cli/commands/skills/index");
+const index_7 = require("../../cli/commands/registry/index");
 // scene 跟 dispatcher(MIAODA_APP_TYPE)同语义层级 —— app 业务类型维度,
 // 对齐后端 devops app_common.AppType 枚举:
 //   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 +26,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 +66,15 @@ 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。
+    // 额外挂 registry(shadcn 式 copy-in SDK,design-html scene 专属)。
+    'design-html': (p) => {
+        (0, index_4.registerAppCommands)(p, { includeInit: true });
+        (0, modern_1.registerDeployCommandsModern)(p);
+        (0, index_6.registerSkillsCommands)(p);
+        (0, index_7.registerRegistryCommands)(p);
+    },
 };
 function readEnv(name) {
     const v = process.env[name]?.trim();

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

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRegistryCommands = registerRegistryCommands;
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/registry/index");
+/**
+ * miaoda registry：design-html 技术栈的「组件 registry」（shadcn 式 copy-in）。
+ *
+ * registry 是独立 npm 包，按 runtime 命名分发（buildless runtime → @lark-apaas/coding-registry-buildless）。
+ * SDK 文件放在包根的 components/ · scripts/ · stylesheets/ 三个目录下（这三个顶层目录里的代码文件
+ * 才算条目）；文件可带 USAGE 注释块（可选，声明描述 / 用法 / Depends）。CLI 抓 tarball、按
+ * .spark/meta.json.stack → runtime → 包名 选包，把 SDK 文件**拍平**copy-in 到用户项目根。
+ * 不写安装记账文件——项目文件树即状态（skip-by-disk）。
+ */
+function registerRegistryCommands(program) {
+    const registryCmd = program
+        .command('registry')
+        .description('组件 registry：列出 / copy-in design-html SDK 文件')
+        .usage('<command> [flags]');
+    registryCmd.action(() => {
+        registryCmd.outputHelp();
+    });
+    registryCmd.addHelpText('after', `
+概念
+  - registry 包：独立 npm 包（按 runtime 命名）
+  - 条目 (entry)：包根 components/ · scripts/ · stylesheets/ 顶层目录（任意深度）下的代码文件；
+    name = 文件名去扩展名（不要求唯一）。包根直放文件、其它目录、非代码文件都不算条目
+  - 寻址：add / Depends 的 token 可写三种形式——name（foo）/ 完整文件名（foo.css）/ relPath（stylesheets/foo.css）
+  - 多匹配全拉：token 命中多个同名条目时全部 copy-in（不报歧义）；想只要其一就写完整文件名 / relPath
+  - USAGE 块：可选元数据，声明描述 / Exports / Usage / Depends；无 USAGE 也是条目（空描述、无依赖）
+  - Depends：从 USAGE 块解析的跨条目依赖，add 时传递解析、一并 copy-in
+  - add 落地：拍平到项目根（包根 scripts/x.js → 项目 x.js）；同名 basename 撞车时后者覆盖前者
+
+前置
+  当前目录（或 --dir）已走过 'miaoda app init'（.spark/meta.json 含 stack=design-html）
+`);
+    registerRegistryList(registryCmd);
+    registerRegistryAdd(registryCmd);
+}
+function registerRegistryList(parent) {
+    const cmd = parent
+        .command('list')
+        .description('列出 registry 可用 SDK 条目，输出各文件的 USAGE 块原文')
+        .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .option('--version <ver>', 'registry 包版本或 dist-tag，缺省 latest')
+        .addHelpText('after', `
+输出
+  默认（pretty）：各条目 USAGE 块原文拼接，带文件名分隔，给 Agent 直接读注释
+
+JSON 输出
+  {"data": [{"name": "...", "file": "...", "usage": "<原文>", "dependsOn": [...]}, ...]}
+  （usage 保持 USAGE 块原文，不解析成结构化字段）
+
+示例
+  $ miaoda registry list
+  $ miaoda registry list --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        await (0, index_1.handleRegistryList)({
+            dir: rawOpts.dir,
+            version: rawOpts.version,
+        });
+    }));
+}
+function registerRegistryAdd(parent) {
+    const cmd = parent
+        .command('add')
+        .description('把一个或多个 SDK 文件 copy-in 到当前项目（拍平到项目根，含 Depends 闭包）')
+        .argument('<token...>', 'name / 完整文件名 / relPath，可传多个；同名多匹配全拉，Depends 自动传递解析')
+        .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .option('--version <ver>', 'registry 包版本或 dist-tag，缺省 latest')
+        .option('--overwrite', '目标文件已存在时覆盖（默认跳过以保护用户改动）', false)
+        .option('--dry-run', '只报告将写 / 将跳哪些文件，不落盘', false)
+        .addHelpText('after', `
+行为
+  - token 寻址：name（foo）/ 完整文件名（foo.css）/ relPath（stylesheets/foo.css）任一形式
+  - 多匹配全拉：token 命中多个同名条目时全部 copy-in；想只要其一就写完整文件名 / relPath
+  - 解析 USAGE 块 Depends 传递闭包，把 SDK 文件**拍平**拷到项目根
+    （包根 scripts/deck-stage.js → 项目 deck-stage.js；同名 basename 撞车时后者覆盖前者）
+  - skip-by-disk：目标文件已存在默认跳过；--overwrite 才覆盖
+  - 不写任何安装记账文件（项目文件树即状态）
+
+JSON 输出
+  {"data": {"registryVersion": "...", "requested": [...], "resolved": [...],
+            "added": [...], "skipped": [...], "dryRun": false}}
+  （resolved 为来源 relPath；added / skipped 为拍平后的落地 basename，如 deck-stage.js）
+
+示例
+  $ miaoda registry add deck-slide
+  $ miaoda registry add deck-slide theme --dry-run
+  $ miaoda registry add deck-slide --overwrite --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (names, rawOpts) => {
+        await (0, index_1.handleRegistryAdd)({
+            names,
+            dir: rawOpts.dir,
+            version: rawOpts.version,
+            overwrite: rawOpts.overwrite,
+            dryRun: rawOpts.dryRun,
+        });
+    }));
+}

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

@@ -69,8 +69,12 @@ async function handleAppInit(opts) {
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
     // 先建 logs/,防止 user 跑 dev 之前 AI/工具 redirect 到 logs/*.log 因为父目录不存在直接挂
-    // (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)
-    (0, logs_dir_1.ensureLogsDir)(targetDir);
+    // (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)。
+    // 仅本地开发需要：沙箱环境由平台 supervisor 拉起 dev,无 init 前的 shell redirect 场景,
+    // 不预建 logs/ 以免在沙箱工作区留空目录。
+    if (!(0, env_1.isSandboxEnv)()) {
+        (0, logs_dir_1.ensureLogsDir)(targetDir);
+    }
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
     // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
     // 按运行环境（isSandboxEnv：MIAODA_DEP_CACHE_DIR 非空）分流 outputLayout，不绑 stack:

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

@@ -135,32 +135,6 @@ async function handleAppMigrate(opts) {
         installError = err instanceof Error ? err.message : String(err);
         (0, logger_1.log)('migrate', `⚠ npm install failed (continuing): ${installError}`);
     }
-    // 重启 dev process 前清 vite cache —— migrate 改了 package.json + lockfile,
-    // 老 vite 进程的 .vite/deps cache 的 lockfileHash 跟新 lockfile 不一致。
-    // 不清的话 supervisor 拉起的新 vite cold start 会立即 "Re-optimizing because
-    // lockfile has changed", re-optimize 期间 ModuleGraph transform cache 跟
-    // deps middleware metadata 短暂不同步, 浏览器请求老 hash 触发
-    // ERR_OUTDATED_OPTIMIZED_DEP → 504 死锁(详见 fullstack-plugin#1143 的 504
-    // ignoreOutdatedRequests fix 注释)。直接 rm -rf 让新 vite 从干净状态 cold
-    // optimize, 一次写到位 lockfile 一致的 metadata, 不再触发中途 re-optimize。
-    //
-    //   - 只在 SANDBOX_ID 非空时做(本地一般不会撞这条链路)
-    //   - 只在 install 成功时做(install 挂了 node_modules 状态不对, 清 cache 也救不回来)
-    //   - 软失败:.vite 不存在 / 删失败都不阻断
-    if (installError === undefined &&
-        process.env.SANDBOX_ID !== undefined &&
-        process.env.SANDBOX_ID !== '') {
-        const viteCacheDir = node_path_1.default.join(targetDir, 'node_modules', '.vite');
-        if (node_fs_1.default.existsSync(viteCacheDir)) {
-            (0, logger_1.log)('migrate', '清理 node_modules/.vite (vite cache 跟新 lockfile 错位会 504)...');
-            try {
-                node_fs_1.default.rmSync(viteCacheDir, { recursive: true, force: true });
-            }
-            catch (err) {
-                (0, logger_1.log)('migrate', `⚠ 清 .vite 失败 (continuing): ${err instanceof Error ? err.message : String(err)}`);
-            }
-        }
-    }
     // 沙箱环境下重启 dev process —— scripts/dev.js 被 fullstack 版本覆盖了,但当前正在
     // 跑的 node 进程仍按老逻辑工作(只起 vite,没起 nest),整体没切到 fullstack 模式。
     // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,

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/cli/handlers/registry/add.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRegistryAdd = handleRegistryAdd;
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/registry/index");
+const shared_1 = require("./shared");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const logger_1 = require("../../../utils/logger");
+/**
+ * miaoda registry add <name...> [--overwrite] [--dry-run] [--dir <path>] [--version <ver>]
+ *
+ * 解析 USAGE 块 Depends 传递闭包，把每个条目对应的 SDK 文件从 registry 包根的 <relPath>
+ * **保留相对路径**拷到项目根（--dir 指定目录的根）。
+ * skip-by-disk：目标已存在默认跳过，--overwrite 才覆盖。不写任何安装记账文件。
+ */
+async function handleRegistryAdd(opts) {
+    await Promise.resolve();
+    if (opts.names.length === 0) {
+        throw new error_1.AppError('ARGS_INVALID', 'registry add 至少需要一个条目名');
+    }
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const stack = (0, shared_1.resolveRegistryStack)(targetDir);
+    const reg = (0, index_1.loadRegistry)({ stack, version: opts.version });
+    try {
+        const plan = (0, index_1.planAdd)({
+            entries: reg.entries,
+            targetDir,
+            names: opts.names,
+        });
+        const result = (0, index_1.applyAdd)(plan.files, {
+            overwrite: opts.overwrite === true,
+            dryRun: opts.dryRun === true,
+        });
+        const verb = opts.dryRun === true ? 'Would add' : 'Added';
+        (0, logger_1.log)('registry', `${verb} ${String(result.added.length)} file(s), skipped ${String(result.skipped.length)} (registry@${reg.version})`);
+        (0, output_1.emit)({
+            data: {
+                registryVersion: reg.version,
+                requested: opts.names,
+                resolved: plan.entries.map((e) => e.relPath),
+                added: result.added,
+                skipped: result.skipped,
+                dryRun: opts.dryRun === true,
+            },
+        });
+    }
+    finally {
+        reg.cleanup();
+    }
+}

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRegistryAdd = exports.handleRegistryList = void 0;
+var list_1 = require("./list");
+Object.defineProperty(exports, "handleRegistryList", { enumerable: true, get: function () { return list_1.handleRegistryList; } });
+var add_1 = require("./add");
+Object.defineProperty(exports, "handleRegistryAdd", { enumerable: true, get: function () { return add_1.handleRegistryAdd; } });

package/dist/cli/handlers/registry/list.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRegistryList = handleRegistryList;
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/registry/index");
+const shared_1 = require("./shared");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda registry list [--dir <path>] [--version <ver>]
+ *
+ * 从 .spark/meta.json 读 stack → runtime → 包名，拉对应 registry 包，从包根递归扫含 USAGE 块的 SDK 文件。
+ *
+ * - 默认（pretty）：输出各条目 USAGE 块原文，带文件名分隔，给 Agent 直接读注释。
+ * - --json：输出 [{name, file, usage(原文字符串), dependsOn[]}]，usage 保持原文不解析成字段。
+ *   file 是相对包根的路径（如 scripts/deck-stage.js），即 add 后的落地相对路径。
+ */
+async function handleRegistryList(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const stack = (0, shared_1.resolveRegistryStack)(targetDir);
+    const reg = (0, index_1.loadRegistry)({ stack, version: opts.version });
+    try {
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emit)({
+                data: reg.entries.map((e) => ({
+                    name: e.name,
+                    file: e.relPath,
+                    usage: e.usage,
+                    dependsOn: e.dependsOn,
+                })),
+            });
+            return;
+        }
+        // pretty：各条目 USAGE 块原文拼接，带文件路径分隔（让 Agent 直接读注释）
+        if (reg.entries.length === 0) {
+            (0, output_1.emit)('(no registry entries)');
+            return;
+        }
+        const blocks = reg.entries.map((e) => `# ${e.relPath}\n${e.usage}`);
+        (0, output_1.emit)(blocks.join('\n\n'));
+    }
+    finally {
+        reg.cleanup();
+    }
+}

package/dist/cli/handlers/registry/shared.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRegistryStack = resolveRegistryStack;
+const spark_meta_1 = require("../../../utils/spark-meta");
+const index_1 = require("../../../services/registry/index");
+const error_1 = require("../../../utils/error");
+/**
+ * 从 <targetDir>/.spark/meta.json 读 stack，校验该 stack 有组件 registry。
+ * 缺 stack → 提示先 init；stack 无 registry（无对应 runtime / runtime 无 registry 包）→ 提示支持哪些 stack。
+ *
+ * 这里只做「stack 是否在支持列表」的早校验给用户友好提示；包名的两跳解析
+ * （stack → runtime → 包）由 loadRegistry/resolveRegistryPackage 负责。
+ */
+function resolveRegistryStack(targetDir) {
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    if (meta.stack === undefined || meta.stack === '') {
+        throw new error_1.AppError('REGISTRY_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
+    }
+    if (!index_1.REGISTRY_SUPPORTED_STACKS.includes(meta.stack)) {
+        throw new error_1.AppError('REGISTRY_STACK_UNSUPPORTED', `stack "${meta.stack}" 没有组件 registry`, {
+            next_actions: [`支持 registry 的 stack：${index_1.REGISTRY_SUPPORTED_STACKS.join(', ') || '(none)'}`],
+        });
+    }
+    return meta.stack;
+}

package/dist/main.js

@@ -30,9 +30,6 @@ program
     .argParser((0, shared_1.caseInsensitiveChoice)(['pretty', 'json']))
     .default('pretty'))
     .option('--verbose', 'debug 日志到 stderr')
-    // 全局接受 -y/--yes：作为 root 全局 option 下发到所有子命令解析（同 --json/--verbose），
-    // 让任意命令带 --yes 都不报 unknown option。对有确认门的破坏性命令生效，其余命令忽略。
-    .option('-y, --yes', '跳过确认提示（对有确认门的命令生效，其余命令忽略）')
     .helpOption('-h, --help', '显示帮助信息')
     .hook('preAction', (_thisCmd, actionCmd) => {
     (0, log_id_1.generateLogId)();

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}`);
+    }
+}