@lark-apaas/miaoda-cli 0.1.21 → 0.1.22-beta.ad5773e

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

@@ -0,0 +1,132 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCommentList = handleCommentList;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const fmtTime = output_1.fmt.sec();
+/** 去掉飞书内联 `<at ...>@某人</at>` 标签，保留内部 @文本。 */
+function stripAtTags(s) {
+    return s.replace(/<at\b[^>]*>/g, '').replace(/<\/at>/g, '');
+}
+/** 单个内联元素渲染成文本：text_run 出文本、docs_link 出链接、person 出 @user。 */
+function renderElement(el) {
+    if (el.text_run?.text)
+        return stripAtTags(el.text_run.text);
+    if (el.docs_link?.url)
+        return el.docs_link.url;
+    if (el.person?.user_id)
+        return `@${el.person.user_id}`;
+    return '';
+}
+/** 一条 reply 的正文文本（各 element 拼接、去 at 标签）。 */
+function replyText(r) {
+    return (r.content?.elements ?? []).map(renderElement).join('').trim();
+}
+/**
+ * 评论级 extra 里的 content_anchor_id（评论锚定的页面元素定位）。
+ * extra 后端返回 JSON 字符串（也兼容已是对象的情况），解析失败返回 undefined。
+ */
+function commentAnchor(c) {
+    const { extra } = c;
+    let obj = extra;
+    if (typeof extra === 'string') {
+        try {
+            obj = JSON.parse(extra);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        const anchor = obj.content_anchor_id;
+        if (typeof anchor === 'string' && anchor.length > 0)
+            return anchor;
+    }
+    return undefined;
+}
+/** 一条 reply 的附加标注：图片数量、reaction。 */
+function replyAnnotations(r) {
+    const ann = [];
+    const images = r.extra?.image_list;
+    if (Array.isArray(images) && images.length > 0)
+        ann.push(`[图片×${String(images.length)}]`);
+    for (const rc of r.reactions ?? []) {
+        if (rc.reaction_key)
+            ann.push(`[${rc.reaction_key}×${String(rc.count ?? 0)}]`);
+    }
+    return ann;
+}
+/**
+ * 渲染一条评论为多行块（信息全保留，靠结构化标签 + 列对齐提升可读性）：
+ *   ● [未解决] <comment_id>  ·  N 条回复
+ *     引用  <quote>
+ *     锚点  <content_anchor_id 全量>
+ *     <user 对齐>  <time>  <正文 + 标注>
+ * userWidth 为所有回复 user_id 的最大宽度，用于跨评论列对齐。
+ */
+function renderComment(c, userWidth) {
+    const replies = c.reply_list?.replies ?? [];
+    const lines = [
+        `● ${c.is_solved ? '[已解决]' : '[未解决]'} ${c.comment_id}  ·  ${String(replies.length)} 条回复`,
+    ];
+    if (typeof c.quote === 'string' && c.quote.length > 0)
+        lines.push(`  引用  ${c.quote}`);
+    const anchor = commentAnchor(c);
+    if (anchor !== undefined)
+        lines.push(`  锚点  ${anchor}`);
+    for (const r of replies) {
+        const body = [replyText(r), ...replyAnnotations(r)].filter((p) => p.length > 0).join(' ');
+        lines.push(`  ${(r.user_id ?? '-').padEnd(userWidth)}  ${fmtTime(r.create_time)}  ${body}`);
+    }
+    return lines.join('\n');
+}
+async function handleCommentList(opts) {
+    const appId = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const comments = await api.comment.getComments(appId, opts.onlyUnresolved ?? false);
+    // JSON 模式：原样透传完整评论结构（含 reply_list / replies / reactions …），与 openapi 一致。
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: comments });
+        return;
+    }
+    // pretty 模式：信息密集的分块形态，一条评论一块、每条回复一行（含人 / 时间 / 正文 / 标注）。
+    // 跨评论对齐 user 列：取所有回复 user_id 的最大宽度。
+    const userWidth = Math.max(0, ...comments.flatMap((c) => c.reply_list?.replies ?? []).map((r) => (r.user_id ?? '-').length));
+    const body = comments.length === 0
+        ? '（无评论）'
+        : comments.map((c) => renderComment(c, userWidth)).join('\n\n');
+    process.stdout.write(body + '\n');
+}

package/dist/cli/handlers/comment/resolve.js

@@ -0,0 +1,44 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCommentResolve = handleCommentResolve;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+async function handleCommentResolve(commentId, opts) {
+    const appId = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    await api.comment.resolveComment(appId, commentId);
+    (0, output_1.emitOk)({ comment_id: commentId, resolved: true });
+}

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,17 @@
+"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,
+        sessionId: opts.sessionId,
+    });
+    (0, output_1.emit)({ data: result });
+}

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

@@ -0,0 +1,97 @@
+"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");
+/**
+ * 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,
+        });
+        // entries：**只列用户请求的条目**（opts.names 命中的），给它们的 usage / dependsOn，
+        // 让 Agent add 完直接拿到用法、无需再 `registry list`。被 Depends 传递拉进来的依赖是
+        // "管道"（照常在 added/skipped 里落地），不占 usage 位。请求的条目即使已存在被 skip
+        // 也回带 usage（status=skipped，Agent 借此判断磁盘上是 registry 版还是自己改过的旧版）。
+        const requestedRelPaths = new Set();
+        for (const token of opts.names) {
+            for (const e of plan.entries) {
+                if ((0, index_1.tokenMatches)(e, token))
+                    requestedRelPaths.add(e.relPath);
+            }
+        }
+        // relPath → 落地的 PlannedFile（拿 dest / 落地状态）
+        const fileByRelPath = new Map(plan.files.map((f) => [f.srcRelPath, f]));
+        const addedSet = new Set(result.added);
+        const skippedSet = new Set(result.skipped);
+        const entries = plan.entries
+            .filter((e) => requestedRelPaths.has(e.relPath))
+            .map((e) => {
+            const f = fileByRelPath.get(e.relPath);
+            const dest = f?.dest ?? e.relPath.split('/').pop() ?? e.relPath;
+            const status = skippedSet.has(dest) && !addedSet.has(dest) ? 'skipped' : 'added';
+            return {
+                name: e.name,
+                file: e.relPath,
+                dest,
+                status,
+                usage: e.usage,
+                dependsOn: e.dependsOn,
+            };
+        });
+        // 只透出对 add 完的 Agent 可操作的字段：项目里实际多了什么(added)、什么没动(skipped)、
+        // 请求条目怎么用(entries)。requested（纯回显）、resolved（包内诊断路径）不透出。
+        const data = {
+            registryVersion: reg.version,
+            added: result.added,
+            skipped: result.skipped,
+            dryRun: opts.dryRun === true,
+            entries,
+        };
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emit)({ data });
+            return;
+        }
+        // pretty 是 Agent 不加 --json 时的默认载荷，也要对 AI 友好：信息量与 JSON 对齐，
+        // 但换成稳定 label + 逗号列表（无 JSON 数组、无 TTY 截断、空/默认值不打印），
+        // summary 在前、各请求条目的 USAGE 块原文在后。整体走一次纯字符串 emit（不进 key-value 渲染）。
+        const summaryLines = [`registry@${reg.version}`];
+        if (opts.dryRun === true)
+            summaryLines.push('dry-run: true (no files written)');
+        if (result.added.length > 0)
+            summaryLines.push(`added: ${result.added.join(', ')}`);
+        if (result.skipped.length > 0)
+            summaryLines.push(`skipped: ${result.skipped.join(', ')}`);
+        const blocks = entries.filter((e) => e.usage !== '').map((e) => `# ${e.dest}\n${e.usage}`);
+        const parts = [summaryLines.join('\n'), ...blocks];
+        (0, output_1.emit)(parts.join('\n\n'));
+    }
+    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/cli/handlers/skills/sync.js

@@ -15,8 +15,13 @@ const output_1 = require("../../../utils/output");
  * 从 .spark/meta.json 读 stack，把 coding-steering 包内对应 stack 的 skills + tech.md
  * 同步到 <dir>/.agent/steering/。需要先跑过 `miaoda app init`。
  *
- * 版本来源：CLI `--version` flag 或默认 `latest`。**不读 meta.json**——steering 版本
- * 不在 meta 里钉，每次 sync 都跟随 `--version` 显式传或退回 @latest。
+ * 版本来源优先级（从高到低）：
+ *   1. CLI `--version` flag（显式指定）
+ *   2. `FORCE_FRAMEWORK_ENVIRONMENT=boe` → dist-tag `dev`（BOE 测试灰度，跟随
+ *      publish-alpha.sh 在 develop 分支打的 dev tag，便于在 BOE 沙箱里验证预发 steering）
+ *   3. 默认 `latest`
+ *
+ * **不读 meta.json**——steering 版本不在 meta 里钉。
  */
 async function handleSkillsSync(opts) {
     await Promise.resolve();
@@ -25,17 +30,20 @@ async function handleSkillsSync(opts) {
     if (meta.stack === undefined || meta.stack === '') {
         throw new error_1.AppError('SKILLS_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
     }
+    const isBoe = process.env.FORCE_FRAMEWORK_ENVIRONMENT === 'boe';
+    const effectiveVersion = opts.version ?? (isBoe ? 'dev' : undefined);
+    const versionSource = opts.version !== undefined ? 'cli-arg' : isBoe ? 'boe-default-dev' : 'default-latest';
     const result = (0, coding_steering_1.syncCodingSteering)({
         stack: meta.stack,
         targetDir,
-        version: opts.version,
+        version: effectiveVersion,
         outputLayout: opts.local === true ? 'flat' : 'nested',
     });
     (0, output_1.emit)({
         data: {
             stack: meta.stack,
             version: result.version,
-            versionSource: opts.version !== undefined ? 'cli-arg' : 'default-latest',
+            versionSource,
             syncedSkills: result.syncedSkills,
             techSynced: result.techSynced,
             ...(result.claudeSkillsLink !== undefined

package/dist/services/app/init/import-source.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = void 0;
+exports.importSourceSrc = importSourceSrc;
+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");
+/** 导入时跳过的目录名（任意层级命中即整目录跳过）。 */
+exports.IMPORT_SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build']);
+/** 导入时跳过的精确文件名。`.env.*`（如 .env.local）另由前缀规则处理。 */
+exports.IMPORT_SKIP_FILES = new Set([
+    '.env',
+    '.DS_Store',
+    '.npmrc',
+    'package.json',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+]);
+function isSkippedFile(name) {
+    if (exports.IMPORT_SKIP_FILES.has(name))
+        return true;
+    // .env.local / .env.production 等一律跳过
+    if (name.startsWith('.env.'))
+        return true;
+    return false;
+}
+/**
+ * 把整个 sourcePath 递归拷进 targetDir/src/（叠加，同名覆盖，不删目标已有文件），
+ * 按 IMPORT_SKIP_DIRS / IMPORT_SKIP_FILES 过滤。
+ * sourcePath 不存在或非目录 → 抛 ARGS_INVALID。
+ */
+function importSourceSrc(opts) {
+    const sourcePath = node_path_1.default.resolve(opts.sourcePath);
+    if (!node_fs_1.default.existsSync(sourcePath) || !node_fs_1.default.statSync(sourcePath).isDirectory()) {
+        throw new error_1.AppError('ARGS_INVALID', `--source-path 不存在或不是目录: ${opts.sourcePath}`);
+    }
+    const destSrc = node_path_1.default.join(opts.targetDir, 'src');
+    node_fs_1.default.mkdirSync(destSrc, { recursive: true });
+    let count = 0;
+    const walk = (relDir) => {
+        const absDir = node_path_1.default.join(sourcePath, relDir);
+        for (const entry of node_fs_1.default.readdirSync(absDir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                if (exports.IMPORT_SKIP_DIRS.has(entry.name))
+                    continue;
+                walk(node_path_1.default.join(relDir, entry.name));
+            }
+            else if (entry.isFile()) {
+                if (isSkippedFile(entry.name))
+                    continue;
+                const rel = node_path_1.default.join(relDir, entry.name);
+                const dest = node_path_1.default.join(destSrc, rel);
+                node_fs_1.default.mkdirSync(node_path_1.default.dirname(dest), { recursive: true });
+                node_fs_1.default.copyFileSync(node_path_1.default.join(sourcePath, rel), dest);
+                count += 1;
+            }
+        }
+    };
+    walk('.');
+    (0, logger_1.log)('init', `Imported ${String(count)} file(s) from ${sourcePath} → src/`);
+    return { importedFileCount: count };
+}

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

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.SUPPORTED_STACKS = exports.resolveStack = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
+Object.defineProperty(exports, "resolveStack", { enumerable: true, get: function () { return template_1.resolveStack; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
+Object.defineProperty(exports, "APP_TYPES", { enumerable: true, get: function () { return template_1.APP_TYPES; } });
+Object.defineProperty(exports, "STACK_BY_APP_TYPE", { enumerable: true, get: function () { return template_1.STACK_BY_APP_TYPE; } });
 Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });
+var import_source_1 = require("./import-source");
+Object.defineProperty(exports, "importSourceSrc", { enumerable: true, get: function () { return import_source_1.importSourceSrc; } });
+Object.defineProperty(exports, "IMPORT_SKIP_DIRS", { enumerable: true, get: function () { return import_source_1.IMPORT_SKIP_DIRS; } });
+Object.defineProperty(exports, "IMPORT_SKIP_FILES", { enumerable: true, get: function () { return import_source_1.IMPORT_SKIP_FILES; } });
 var spark_meta_1 = require("../../../utils/spark-meta");
 Object.defineProperty(exports, "readSparkMeta", { enumerable: true, get: function () { return spark_meta_1.readSparkMeta; } });
 Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: function () { return spark_meta_1.writeSparkMeta; } });

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

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
+exports.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
+exports.resolveStack = resolveStack;
 exports.renderTemplate = renderTemplate;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -15,6 +16,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。
@@ -25,6 +27,51 @@ exports.TEMPLATE_PACKAGE_BY_STACK = {
  */
 exports.TEMPLATE_PINNED_VERSION_BY_STACK = {};
 exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
+/**
+ * app_type（业务类型）→ stack 短名映射。仅在调用方未显式传 --template 时用于解析 stack。
+ * 与 src/api/app/types.ts 的 AppType 枚举无关，是独立的业务类型概念。
+ */
+exports.STACK_BY_APP_TYPE = {
+    html: 'html',
+    modern_html: 'html',
+    jspage: 'vite-react',
+    full_stack: 'nestjs-react-fullstack',
+};
+exports.APP_TYPES = Object.keys(exports.STACK_BY_APP_TYPE);
+/**
+ * 解析要用的 stack（template-first）：
+ *   1. template 传了 → 直接用（SUPPORTED_STACKS 校验）
+ *   2. 否则 appType 传了 → 按 STACK_BY_APP_TYPE 查表
+ *   3. 都没传 → ARGS_INVALID
+ * 非法 template / 非法 appType 均抛 ARGS_INVALID。
+ */
+function resolveStack(opts) {
+    const { template, appType } = opts;
+    // 用真值判断（非 undefined/null/空串）：空串视为未传，回落到 appType。
+    if (template) {
+        if (!exports.SUPPORTED_STACKS.includes(template)) {
+            throw new error_1.AppError('ARGS_INVALID', `不支持的 template: ${template}`, {
+                next_actions: [`可用 stack：${exports.SUPPORTED_STACKS.join(', ')}`],
+            });
+        }
+        return template;
+    }
+    if (appType) {
+        const stack = exports.STACK_BY_APP_TYPE[appType];
+        if (!stack) {
+            throw new error_1.AppError('ARGS_INVALID', `不支持的 app_type: ${appType}`, {
+                next_actions: [`可用 app_type：${exports.APP_TYPES.join(', ')}`],
+            });
+        }
+        return stack;
+    }
+    throw new error_1.AppError('ARGS_INVALID', '缺少 --template 或 --app-type', {
+        next_actions: [
+            `可用 stack：${exports.SUPPORTED_STACKS.join(', ')}`,
+            `可用 app_type：${exports.APP_TYPES.join(', ')}`,
+        ],
+    });
+}
 // template/ 内以下划线开头的占位文件名在渲染时改名。
 // 原因：
 //   1. npm pack 强制剥的：.npmrc（防 auth token 泄露）

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

@@ -0,0 +1,49 @@
+"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;
+exports.cleanDesignDist = cleanDesignDist;
+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}`);
+    }
+}
+/**
+ * 删除 <projectDir>/dist（本地构建产物）。幂等：不存在也不报错（force）。
+ * design 部署收尾调用，部署动作结束后不在用户项目里留产物。
+ */
+function cleanDesignDist(projectDir) {
+    node_fs_1.default.rmSync(node_path_1.default.join(projectDir, constants_1.DIST_DIR), { recursive: true, force: true });
+}