@lark-apaas/miaoda-cli 0.1.19-alpha.574dcb5 → 0.1.19-alpha.62c220f

package/README.md

@@ -75,6 +75,7 @@ miaoda registry add deck-slide --overwrite         # 目标已存在时覆盖（
 - **多匹配全拉**：token 命中多个同名条目时全部 copy-in（如 `add foo` 把 `foo.jsx` + `foo.css` 一起拉），想只要其一就用完整文件名或 relPath。
 - **拍平落地**：所有文件**拍平**到项目根（`scripts/deck-slide.js` → 项目 `deck-slide.js`，不保留子目录）；闭包内同名 basename 撞车时后者覆盖前者。
 - **skip-by-disk**：项目已有同名（拍平后的 basename）文件默认跳过，`--overwrite` 才覆盖；不写任何安装记账文件，项目文件树即状态。
+- **add 回执带 usage**：`add` 结果的 `entries` 只列**你请求的条目**（不含被 `Depends` 传递拉进来的依赖——依赖照常落地在 `added`/`skipped`，但那是"管道"），逐条给出 `usage`（USAGE 块原文）与 `dependsOn`，Agent `add` 完即可直接读用法，无需再 `registry list`。请求的条目即使已存在被跳过也回带 usage（`status` 标 `added`/`skipped`，据此判断磁盘上是 registry 版还是你改过的旧版）。`--json` 结构为 `{registryVersion, added, skipped, dryRun, entries}`；pretty（默认）输出 `registry@<ver>` + `added:`/`skipped:` 逗号列表 + 各请求条目的 USAGE 块，稳定 label、无 JSON 数组、无截断，对 Agent 与人同样可读。
 - `--version <ver>` 指定 registry 包版本或 dist-tag（缺省 `latest`），`--dir <path>` 指定项目目录（缺省当前目录）。
 
 ## 全局参数
@@ -88,7 +89,7 @@ miaoda registry add deck-slide --overwrite         # 目标已存在时覆盖（
 ## 环境变量
 
 - `MIAODA_APP_ID`：默认应用 ID，等价于 `--app-id`。
-- `MIAODA_CANARY_HEADER`：HTTP 请求的 `x-tt-env` 小流量头取值。未设置时默认 `boe_miaoda_doubao`；设为空字符串则不带该头（例：`export MIAODA_CANARY_HEADER=boe_xxx`）。值形如 `ppe_xxx` 时额外带上 `x-use-ppe: 1`。
+- `MIAODA_CANARY_HEADER`：HTTP 请求的 `x-tt-env` 小流量头取值。未设置时默认 `boe_miaoda_ccm`；设为空字符串则不带该头（例：`export MIAODA_CANARY_HEADER=boe_xxx`）。值形如 `ppe_xxx` 时额外带上 `x-use-ppe: 1`。
 
 ## 输出契约
 

package/dist/api/comment/api.js

@@ -3,40 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getComments = getComments;
 exports.resolveComment = resolveComment;
 const http_1 = require("../../utils/http");
-const error_1 = require("../../utils/error");
 /**
- * 解析 lark-gw BaseResp 平铺信封：
- * - HTTP 非 2xx → HttpError
- * - StatusCode !== 0 → AppError（业务/下游失败，HTTP 通常仍 200）
- * - 否则返回平铺响应体
- *
- * 注意：评论接口用大写 StatusCode/StatusMessage，与 utils/http.ts 的
- * getInnerApi（小写 status_code）信封不同，故域内自带解析。
+ * 评论接口走管理端 inner-api（getHttpClient + 小写 status_code 信封），与 app / deploy /
+ * observability 等域一致：统一的 verbose 请求/响应日志、错误映射、信封解析，不再域内自实现。
  */
-async function parseBaseResp(response, url, errPrefix) {
-    if (!response.ok) {
-        throw new error_1.HttpError(response.status, url, `${errPrefix}: ${String(response.status)} ${response.statusText}`.trim());
-    }
-    const body = (await response.json());
-    if (body.StatusCode !== 0) {
-        throw new error_1.AppError('INTERNAL_API_ERROR', `${errPrefix}: ${body.StatusMessage ?? 'unknown error'}`);
-    }
-    return body;
-}
 /** GET /api/v1/studio/innerapi/apps/:appID/comments — 获取应用评论列表 */
 async function getComments(appID, onlyUnresolved = false) {
-    const client = (0, http_1.getRuntimeHttpClient)();
     let url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/comments`;
     if (onlyUnresolved)
         url += '?onlyUnresolved=true';
-    const response = await client.get(url);
-    const body = await parseBaseResp(response, url, 'Failed to list comments');
-    return body.comments ?? [];
+    const body = await (0, http_1.getInnerApi)(url, {
+        errPrefix: 'Failed to list comments',
+    });
+    return body.items ?? [];
 }
 /** POST /api/v1/studio/innerapi/apps/:appID/comments/:commentID/resolve — 解决评论 */
 async function resolveComment(appID, commentID) {
-    const client = (0, http_1.getRuntimeHttpClient)();
     const url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/comments/${encodeURIComponent(commentID)}/resolve`;
-    const response = await client.post(url);
-    await parseBaseResp(response, url, 'Failed to resolve comment');
+    await (0, http_1.postInnerApi)(url, undefined, { errPrefix: 'Failed to resolve comment' });
 }

package/dist/api/comment/types.js

@@ -1,2 +1,6 @@
 "use strict";
+/**
+ * 评论相关类型，镜像 inner-api 返回的 data 结构（snake_case 原样，与 lark docs 评论体一致）。
+ * ID 为 int64 itoa 后的字符串；时间为秒级 epoch。
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cli/commands/deploy/modern.js

@@ -63,6 +63,7 @@ JSON 输出（stdout）
         .option('--create <relpath>', '新增文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--update <relpath>', '覆盖已有文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--delete <relpath>', '删除文件（可重复）', shared_1.collectRepeatedOption, [])
+        .option('--session-id <id>', '会话 ID，发布时透传给下游（可选）')
         .addHelpText('after', `
 --dir 为项目目录（与 deploy 同名参数，默认当前目录）。
 仅支持 design-html（design_local_deploy）。路径为工程根相对路径（= 服务端 latest 下 key），
@@ -86,6 +87,7 @@ JSON 输出
             creates: rawOpts.create,
             updates: rawOpts.update,
             deletes: rawOpts.delete,
+            sessionId: rawOpts.sessionId,
         });
     }));
 }

package/dist/cli/commands/index.js

@@ -79,6 +79,7 @@ const SCENE_REGISTRARS = {
         (0, modern_1.registerDeployCommandsModern)(p);
         (0, index_6.registerSkillsCommands)(p);
         (0, index_8.registerRegistryCommands)(p);
+        (0, index_7.registerCommentCommands)(p);
     },
 };
 function readEnv(name) {

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

@@ -80,10 +80,22 @@ function registerRegistryAdd(parent) {
   - skip-by-disk：目标文件已存在默认跳过；--overwrite 才覆盖
   - 不写任何安装记账文件（项目文件树即状态）
 
-JSON 输出
-  {"data": {"registryVersion": "...", "requested": [...], "resolved": [...],
-            "added": [...], "skipped": [...], "dryRun": false}}
-  （resolved 为来源 relPath；added / skipped 为拍平后的落地 basename，如 deck-stage.js）
+输出（pretty，默认）
+  registry@<ver>
+  added: <落地 basename 逗号列表>          # 含 Depends 闭包全部落地文件
+  skipped: <逗号列表>                       # 仅有跳过时出现
+  dry-run: true (no files written)          # 仅 --dry-run 时出现
+
+  # <请求条目落地 basename>
+  <该条目 USAGE 块原文>                     # 只列你请求的条目，依赖不占 usage 位
+
+JSON 输出（--json）
+  {"data": {"registryVersion": "...", "added": [...], "skipped": [...], "dryRun": false,
+            "entries": [{"name": "...", "file": "<来源 relPath>", "dest": "<落地 basename>",
+                         "status": "added|skipped", "usage": "<USAGE 块原文>", "dependsOn": [...]}, ...]}}
+  （added / skipped 覆盖依赖闭包全部落地文件；entries 只列**你请求的条目**
+   （不含被 Depends 传递拉入的依赖），逐条给 usage / dependsOn，add 完直接读用法。
+   请求的条目即使已存在被 skip 也回带 usage，status 标 added / skipped）
 
 示例
   $ miaoda registry add deck-slide

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

@@ -37,26 +37,96 @@ exports.handleCommentList = handleCommentList;
 const api = __importStar(require("../../../api/index"));
 const shared_1 = require("../../../cli/commands/shared");
 const output_1 = require("../../../utils/output");
-const listSchema = {
-    columns: [
-        { key: 'comment_id', label: 'id' },
-        { key: 'finish' },
-        { key: 'resolved' },
-        { key: 'user_id', label: 'user' },
-        { key: 'create_time', label: 'time', format: output_1.fmt.sec() },
-        { key: 'content', format: output_1.fmt.truncate(80) },
-    ],
-};
+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);
-    const rows = comments.map((c) => ({
-        comment_id: c.commentID,
-        content: c.content,
-        user_id: c.userID,
-        finish: c.finish,
-        resolved: c.finish === 1,
-        create_time: c.createTime,
-    }));
-    (0, output_1.emit)({ data: rows }, listSchema);
+    // 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/deploy/patch.js

@@ -11,6 +11,7 @@ async function handleDeployPatch(opts) {
         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

@@ -9,7 +9,6 @@ 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>]
  *
@@ -35,18 +34,62 @@ async function handleRegistryAdd(opts) {
             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,
-            },
+        // 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/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/deploy/modern/atoms/design-build.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (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");
@@ -39,3 +40,10 @@ function buildDesignOutput(opts) {
         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 });
+}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = exports.uploadDesignArtifacts = exports.buildDesignOutput = exports.runBuild = exports.preRelease = exports.prepareDeployContext = void 0;
+exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = exports.uploadDesignArtifacts = exports.cleanDesignDist = exports.buildDesignOutput = exports.runBuild = exports.preRelease = exports.prepareDeployContext = void 0;
 var context_1 = require("./context");
 Object.defineProperty(exports, "prepareDeployContext", { enumerable: true, get: function () { return context_1.prepareDeployContext; } });
 var pre_release_1 = require("./pre-release");
@@ -9,6 +9,7 @@ var build_1 = require("./build");
 Object.defineProperty(exports, "runBuild", { enumerable: true, get: function () { return build_1.runBuild; } });
 var design_build_1 = require("./design-build");
 Object.defineProperty(exports, "buildDesignOutput", { enumerable: true, get: function () { return design_build_1.buildDesignOutput; } });
+Object.defineProperty(exports, "cleanDesignDist", { enumerable: true, get: function () { return design_build_1.cleanDesignDist; } });
 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");

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

@@ -30,7 +30,12 @@ async function patchDesignDeploy(opts) {
     });
     const routesRegenerated = actions.some((a) => a.filePath === 'routes.json');
     (0, logger_1.log)('deploy', `Applying ${String(actions.length)} file action(s)...`);
-    const res = await (0, index_1.applyTosDiff)({ appID: opts.appId, templateKey, actions });
+    const res = await (0, index_1.applyTosDiff)({
+        appID: opts.appId,
+        templateKey,
+        actions,
+        sessionId: opts.sessionId,
+    });
     (0, logger_1.log)('deploy', `Patched: upsert=${String(res.upsertCount)} delete=${String(res.deleteCount)}`);
     return {
         upsertCount: res.upsertCount,

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

@@ -20,6 +20,8 @@ exports.EXCLUDES = new Set([
     '.gitignore',
     '.npmrc',
     '.agent',
+    '.agents',
+    'skills',
     '.env',
     '.env.local',
     'README.md',

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

@@ -20,28 +20,37 @@ async function designLocalPublishPipeline(opts) {
         throw new error_1.AppError('DEPLOY_PRE_RELEASE_DATA_MISSING', 'preRelease did not return a `data` map — backend tcc may not be configured for current template_key');
     }
     const data = pre.data;
-    if (!opts.skipBuild) {
-        (0, index_1.buildDesignOutput)({ projectDir: ctx.projectDir });
-    }
-    (0, logger_1.log)('deploy', 'Creating local release...');
-    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version);
+    // dist 是本地构建产物，部署动作结束（无论成败）都清掉，不在用户项目里留产物。
     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 (!opts.skipBuild) {
+            (0, index_1.buildDesignOutput)({ projectDir: ctx.projectDir });
+        }
+        (0, logger_1.log)('deploy', 'Creating local release...');
+        const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version, {
+            checkPointVersion: opts.checkPointVersion,
+            commitID: opts.commitID,
+        });
+        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,
+        };
     }
-    if (release.onlineUrl !== undefined && release.onlineUrl !== '') {
-        (0, spark_meta_1.writeSparkMeta)(ctx.projectDir, { appUrl: release.onlineUrl });
+    finally {
+        (0, index_1.cleanDesignDist)(ctx.projectDir);
     }
-    (0, logger_1.log)('deploy', 'Deployed successfully');
-    return {
-        appId: ctx.appId,
-        version: pre.version,
-        url: release.onlineUrl ?? '',
-        releaseID: release.releaseID,
-        preReleaseID: pre.preReleaseID,
-    };
 }

package/dist/utils/http.js

@@ -64,7 +64,7 @@ function createClient(opts) {
  * 默认灰度泳道。当前 miaoda CLI 接入的新接口（modern deploy 等）只在该泳道生效，
  * 缺省走这个。MIAODA_CANARY_HEADER 可显式覆盖；设为空字符串则去掉头。
  */
-const DEFAULT_CANARY_HEADER = 'boe_miaoda_doubao';
+const DEFAULT_CANARY_HEADER = 'boe_miaoda_ccm';
 /**
  * 注入 x-tt-env 小流量头：env 显式设值 > DEFAULT_CANARY_HEADER。
  *

package/package.json

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