@lark-apaas/miaoda-cli 0.1.24 → 0.1.25

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

@@ -96,6 +96,9 @@ function registerAppSync(parent) {
      action-plugin postinstall 在 npm install 时缺平台 env 的卡点（需要时再
      FORCE_AUTHN_INNERAPI_DOMAIN=... npm install 手动跑一次）。
 
+  stack 未纳入 sync 范围（无 SyncConfig 且无 upgrade/templates/<stack>/，如 design-html
+  buildless 静态 HTML）→ 跳过同步（no-op, skipped=true），退出码 0，不阻断 dev/启动链路。
+
 JSON 输出
   {"data": {"stack": "...",
             "appliedRules": [{"type": "...", "action": "...", "path": "...", "detail": "..."}],
@@ -103,6 +106,7 @@ JSON 输出
             "mergedJsonFiles": [{"path": "...", "keys": [...]}],
             "patchedScripts": [...],
             "upgradedPackages": [{"name": "...", "from": "...", "to": "...", "section": "..."}]}}
+  跳过时：{"data": {"stack": "...", "skipped": true, "reason": "stack_not_in_sync_scope", ...空数组}}
 
 示例
   $ miaoda app sync
@@ -183,8 +187,8 @@ function registerAppInit(parent) {
   env 未设置时回退到 meta.json.app_id。
 
 技术栈解析（--template / --app-type）
-  --template 传了      → 直接用（vite-react / html / nestjs-react-fullstack）
-  否则 --app-type 传了 → 查表：html→html, modern_html→html, jspage→vite-react, full_stack→nestjs-react-fullstack
+  --template 传了      → 直接用（vite-react / html / design-html / nestjs-react-fullstack）
+  否则 --app-type 传了 → 查表：html→design-html, modern_html→html, jspage→vite-react, full_stack→nestjs-react-fullstack
   两者都没传          → 报错 ARGS_INVALID
 
 源码导入（--source-path）
@@ -193,11 +197,11 @@ function registerAppInit(parent) {
   source-path 不存在 → 报错；非 modern_html 传了 source-path → 警告并忽略，继续正常 init。
   app_type 不写入 .spark/meta.json。
 
-平台同步（upgrade/templates）
-  init 内嵌一次 upgrade/templates 同步（跟 app upgrade 共用同一份 util）：
-  从 miaoda-cli 自带的 upgrade/templates/<stack>/ 同步 files/（覆盖）+ patches/
-  （JSON deep merge，含 scripts.dev:local 等）。目标 stack 未纳入 upgrade/templates/
-  时跳过（不报错）。后续要把 @lark-apaas/* 平台包统一指 latest，跑 'miaoda app upgrade'。
+平台同步（不在 init 内做）
+  init 不跑 'miaoda app sync' 的任何子动作（SyncRule 应用 / 平台脚本覆盖 / patches /
+  升 @lark-apaas/* 到 latest）。渲染出的 scripts/ 等是 template 包发版时的版本，
+  package.json 与 template 完全一致。首次同步交给 'miaoda app sync'：本地 dev.sh 入口
+  起服务前会先跑一次，沙箱 pod 启动阶段平台侧也会做，init 不重复。
 
 依赖安装
   默认：npm install --no-audit --no-fund

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

@@ -54,7 +54,8 @@ const MANAGED_PLATFORM_PACKAGES = {
  * 执行流：
  *   1. SyncRule[] 全量 apply —— 来自 src/config/sync-configs/<stack>.ts。每个 stack
  *      自带模板资源在 upgrade/templates/<stack>/templates/。表里没有该 stack 时回退到
- *      旧 platform-sync 兜底（兼容尚未迁移的 stack）。
+ *      旧 platform-sync 兜底（兼容尚未迁移的 stack）；两者都识别不了（无 SyncConfig 且无
+ *      upgrade/templates/<stack>/）→ 跳过同步（no-op, skipped=true），不报错。
  *   2. 平台 deps 指 latest —— user app 已装的 @lark-apaas/* 按 MANAGED_PLATFORM_PACKAGES
  *      白名单改写为 "latest"（紧急止血时表里可填具体版本）。
  *   3. activateGitHooks —— 设置 core.hooksPath（template 自带 .githooks/pre-commit）。
@@ -71,14 +72,31 @@ async function handleAppSync(opts) {
     if (meta.stack === undefined || meta.stack === '') {
         throw new error_1.AppError('SYNC_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
     }
-    // 1. apply SyncRule[]，stack 没注册时回退到旧 platform-sync 兜底；都不识别就报错
+    // 1. apply SyncRule[]，stack 没注册时回退到旧 platform-sync 兜底
     const syncResults = runStackSync(meta.stack, targetDir, 'sync');
+    // stack 未纳入 sync 范围（既无 SyncConfig 也无 upgrade/templates/<stack>/）：跳过同步（no-op），
+    // 不报错。sync 会在 dev.sh 本地入口 / 沙箱 pod 启动阶段被调用，对不需要 cli 侧 sync 的 stack
+    // （如 design-html buildless 静态 HTML）不该阻断启动链路。
     if (!syncResults.stackFound) {
-        throw new error_1.AppError('SYNC_STACK_NOT_SUPPORTED', `stack '${meta.stack}' has no SyncConfig and no upgrade/templates/${meta.stack}/ — 该 stack 暂未纳入 sync 范围`, {
-            next_actions: [
-                `src/config/sync-configs/${meta.stack}.ts 加 SyncConfig 并在 STACK_REGISTRY 注册`,
-            ],
+        (0, logger_1.log)('sync', `stack '${meta.stack}' 未纳入 sync 范围，跳过同步 (no-op)`);
+        if (!(0, output_1.isJsonMode)()) {
+            process.stdout.write(`⚠ stack '${meta.stack}' 未纳入 sync 范围，已跳过同步\n`);
+        }
+        (0, output_1.emit)({
+            data: {
+                stack: meta.stack,
+                skipped: true,
+                reason: 'stack_not_in_sync_scope',
+                appliedRules: [],
+                syncedFiles: [],
+                mergedJsonFiles: [],
+                patchedScripts: [],
+                upgradedPackages: [],
+                gitHooks: 'skipped',
+                installError: undefined,
+            },
         });
+        return;
     }
     // 2. activate git hooks（template 自带 .githooks/pre-commit，core.hooksPath 一次性设置）
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
@@ -138,8 +156,8 @@ exports.handleAppUpgrade = handleAppSync;
  * stack 在 STACK_REGISTRY 注册时走新 SyncRule 机制，否则回落到旧 platform-sync。
  *
  * stack 完全不识别（既不在 STACK_REGISTRY 也无 upgrade/templates/<stack>/ 目录）时返回
- * `stackFound: false` 而非抛错 —— 让调用方按场景决定：sync handler 抛 AppError，init handler
- * 允许（fresh init 时 stack 还在加注册的过渡期）。
+ * `stackFound: false` 而非抛错 —— 让调用方按场景决定：sync handler 跳过同步（no-op），init handler
+ * 也允许（fresh init 时 stack 还在加注册的过渡期）。
  */
 function runStackSync(stack, targetDir, logPrefix) {
     const config = (0, sync_configs_1.getSyncConfig)(stack);

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

@@ -32,7 +32,7 @@ exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
  * 与 src/api/app/types.ts 的 AppType 枚举无关，是独立的业务类型概念。
  */
 exports.STACK_BY_APP_TYPE = {
-    html: 'html',
+    html: 'design-html',
     modern_html: 'html',
     jspage: 'vite-react',
     full_stack: 'nestjs-react-fullstack',

package/package.json

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