@lark-apaas/miaoda-cli 0.1.19-alpha.834fd32 → 0.1.19-alpha.e4d5797

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