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

package/README.md

@@ -11,12 +11,17 @@ pnpm add -g @lark-apaas/miaoda-cli
 ## 使用
 
 ```bash
-# 设置默认应用（需要应用上下文的命令可用 --app-id 覆盖）
+# 设置默认应用（需要应用上下文的命令从 MIAODA_APP_ID 读取）
 export MIAODA_APP_ID=app_demo_xxx
 
 # 文件操作
 miaoda file ls
 miaoda file upload ./local/path
+
+# 评论操作
+miaoda comment list --json
+miaoda comment list --only-unresolved --json
+miaoda comment resolve 1703677660120110076 --json
 ```
 
 JSON 结构化输出（Agent 推荐）：
@@ -41,6 +46,7 @@ miaoda file ls --output json
 | `miaoda file ...`          | 文件操作：上传、下载、元数据、签名下载、批量删除     |
 | `miaoda db ...`            | 数据操作：SQL 执行、表结构查询、数据导入导出         |
 | `miaoda observability ...` | 线上日志、链路、前端源码堆栈反查、监控指标、运营指标 |
+| `miaoda comment ...`       | 应用评论：查看评论列表、解决评论                     |
 | `miaoda registry ...`      | 组件 registry：列出 / copy-in design-html SDK 文件（本地执行）     |
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
@@ -69,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>` 指定项目目录（缺省当前目录）。
 
 ## 全局参数
@@ -82,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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getComments = getComments;
+exports.resolveComment = resolveComment;
+const http_1 = require("../../utils/http");
+/**
+ * 评论接口走管理端 inner-api（getHttpClient + 小写 status_code 信封），与 app / deploy /
+ * observability 等域一致：统一的 verbose 请求/响应日志、错误映射、信封解析，不再域内自实现。
+ */
+/** GET /api/v1/studio/innerapi/apps/:appID/comments — 获取应用评论列表 */
+async function getComments(appID, onlyUnresolved = false) {
+    let url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/comments`;
+    if (onlyUnresolved)
+        url += '?onlyUnresolved=true';
+    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 url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/comments/${encodeURIComponent(commentID)}/resolve`;
+    await (0, http_1.postInnerApi)(url, undefined, { errPrefix: 'Failed to resolve comment' });
+}

package/dist/api/comment/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveComment = exports.getComments = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "getComments", { enumerable: true, get: function () { return api_1.getComments; } });
+Object.defineProperty(exports, "resolveComment", { enumerable: true, get: function () { return api_1.resolveComment; } });

package/dist/api/comment/types.js

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

package/dist/api/index.js

@@ -33,16 +33,18 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
+exports.comment = exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
 const _plugin = __importStar(require("../api/plugin/index"));
 const _file = __importStar(require("../api/file/index"));
 const _db = __importStar(require("../api/db/index"));
 const _observability = __importStar(require("../api/observability/index"));
 const _app = __importStar(require("../api/app/index"));
 const _deploy = __importStar(require("../api/deploy/index"));
+const _comment = __importStar(require("../api/comment/index"));
 exports.plugin = { ..._plugin };
 exports.file = { ..._file };
 exports.db = { ..._db };
 exports.observability = { ..._observability };
 exports.app = { ..._app };
 exports.deploy = { ..._deploy };
+exports.comment = { ..._comment };

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

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommentCommands = registerCommentCommands;
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/comment/index");
+function registerCommentCommands(program) {
+    const commentCmd = program
+        .command('comment')
+        .description('应用评论：查看评论列表、解决评论')
+        .usage('<command> [flags]');
+    commentCmd.action(() => {
+        commentCmd.outputHelp();
+    });
+    commentCmd.addHelpText('after', `
+作用范围
+  操作当前应用的评论。应用上下文：--app-id <id> 或环境变量 MIAODA_APP_ID。
+`);
+    const listCmd = commentCmd
+        .command('list')
+        .description('查看应用评论列表')
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option('--only-unresolved', '仅返回未解决的评论', false)
+        .addHelpText('after', `
+JSON 输出
+  {"data": [{"comment_id": "...", "content": "...", "user_id": "...",
+             "finish": 0, "resolved": false, "create_time": 1700000000}]}
+
+示例
+  $ miaoda comment list --json
+  $ miaoda comment list --only-unresolved --json
+`);
+    listCmd.action((0, shared_1.withHelp)(listCmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(listCmd, 'appId');
+        await (0, index_1.handleCommentList)({
+            appId: rawOpts.appId,
+            onlyUnresolved: rawOpts.onlyUnresolved,
+        });
+    }));
+    const resolveCmd = commentCmd
+        .command('resolve')
+        .description('把一条评论标记为已解决')
+        .argument('<commentID>', '待解决的评论 ID')
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addHelpText('after', `
+JSON 输出
+  {"data": {"comment_id": "...", "resolved": true}}
+
+示例
+  $ miaoda comment resolve 1703677660120110076 --json
+`);
+    resolveCmd.action((0, shared_1.withHelp)(resolveCmd, async (commentId, rawOpts) => {
+        (0, shared_1.rejectCliOverride)(resolveCmd, 'appId');
+        await (0, index_1.handleCommentResolve)(commentId, { appId: rawOpts.appId });
+    }));
+}

package/dist/cli/commands/index.js

@@ -9,7 +9,8 @@ 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");
+const index_7 = require("../../cli/commands/comment/index");
+const index_8 = require("../../cli/commands/registry/index");
 // scene 跟 dispatcher(MIAODA_APP_TYPE)同语义层级 —— app 业务类型维度,
 // 对齐后端 devops app_common.AppType 枚举:
 //   3 = AppType_APPLICATION(全栈应用,当前仅 nestjs-react-fullstack 一个 stack)
@@ -41,11 +42,13 @@ const SCENE_REGISTRARS = {
         (0, index_1.registerFileCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
+        (0, index_7.registerCommentCommands)(p);
     },
     modern: (p) => {
         (0, index_4.registerAppCommands)(p, { includeInit: true });
         (0, modern_1.registerDeployCommandsModern)(p);
         (0, index_6.registerSkillsCommands)(p);
+        (0, index_7.registerCommentCommands)(p);
     },
     // application scene(AppType_APPLICATION=3):
     // 在 default 命令集基础上加 skills(按 meta.json.stack 拉对应 stack 技能)
@@ -57,6 +60,7 @@ const SCENE_REGISTRARS = {
         (0, index_1.registerFileCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
+        (0, index_7.registerCommentCommands)(p);
     },
     // design scene(AppType_DESIGN=4):design-stack 仅 SSR 渲染、无后端业务逻辑、
     // 无数据库、无 UGC 文件。命令集裁掉 db / file,保留 deploy / observability / app(init) / skills。
@@ -65,6 +69,7 @@ const SCENE_REGISTRARS = {
         (0, index_5.registerDeployCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
+        (0, index_7.registerCommentCommands)(p);
     },
     // design-html scene(AppType_DESIGN_HTML=8):buildless 静态 HTML,
     // 命令集与 modern 一致(app init/sync + modern 拆分版 deploy + skills),不挂 db/file/observability。
@@ -73,7 +78,8 @@ const SCENE_REGISTRARS = {
         (0, index_4.registerAppCommands)(p, { includeInit: true });
         (0, modern_1.registerDeployCommandsModern)(p);
         (0, index_6.registerSkillsCommands)(p);
-        (0, index_7.registerRegistryCommands)(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/index.js

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

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

@@ -0,0 +1,92 @@
+"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");
+/** 单个内联元素渲染成文本：text_run 出文本、docs_link 出链接、person 出 @user。 */
+function renderElement(el) {
+    if (el.text_run?.text)
+        return 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 拼接）+ extra 图片数量标注（extra.image_list）。 */
+function renderReply(r) {
+    const body = (r.content?.elements ?? []).map(renderElement).join('').trim();
+    const images = r.extra?.image_list;
+    const imageCount = Array.isArray(images) ? images.length : 0;
+    const parts = [body, imageCount > 0 ? `[图片×${String(imageCount)}]` : ''].filter((p) => p.length > 0);
+    return parts.join(' ');
+}
+/**
+ * pretty 的 content 列：把所有 reply 渲染后用 " | " 拼接。含 @人 / 云文档链接 / 图片标注等
+ * extra 信息。仅用于 pretty 概览；JSON 模式原样透传完整 reply_list。
+ */
+function commentText(c) {
+    return (c.reply_list?.replies ?? [])
+        .map(renderReply)
+        .filter((t) => t.length > 0)
+        .join(' | ');
+}
+/**
+ * pretty 概览列；JSON 模式忽略 schema，原样输出完整评论结构（与 openapi file.comment 一致）。
+ * strict：pretty 只渲染这些列，不把 reply_list / quote 等嵌套字段追加成额外列。
+ */
+const listSchema = {
+    strict: true,
+    columns: [
+        { key: 'comment_id', label: 'id' },
+        { key: 'is_solved', label: 'solved' },
+        { key: 'user_id', label: 'user' },
+        { key: 'create_time', label: 'time', format: output_1.fmt.sec() },
+        {
+            key: 'content',
+            label: 'content',
+            derive: (row) => commentText(row),
+            format: output_1.fmt.truncate(80),
+        },
+    ],
+};
+async function handleCommentList(opts) {
+    const appId = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const comments = await api.comment.getComments(appId, opts.onlyUnresolved ?? false);
+    // data 原样透传完整评论结构（含 reply_list / replies / reactions …），与 openapi 保持一致。
+    (0, output_1.emit)({ data: comments }, listSchema);
+}

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/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/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/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.7f0b693",
+  "version": "0.1.19-alpha.c3da59d",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {