@lark-apaas/miaoda-cli 0.1.21-alpha.90df4a0 → 0.1.21

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

@@ -5,13 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadArtifacts = uploadArtifacts;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
 const index_1 = require("../../../../api/deploy/index");
 const error_1 = require("../../../../utils/error");
 const logger_1 = require("../../../../utils/logger");
 const constants_1 = require("../constants");
 const protocol_1 = require("../protocol");
-const tosutil_1 = require("./tosutil");
 const UPLOAD_PLAN = [
     {
         kind: 'tos',
@@ -31,6 +32,28 @@ const UPLOAD_PLAN = [
         dataKey: protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL,
     },
 ];
+function resolveTosutilPath() {
+    try {
+        const resolved = (0, node_child_process_1.execFileSync)('which', ['tosutil'], { encoding: 'utf-8' }).trim();
+        if (resolved)
+            return resolved;
+    }
+    catch {
+        /* fallthrough */
+    }
+    throw new error_1.AppError('DEPLOY_TOSUTIL_MISSING', 'tosutil is not installed or not in PATH. modern deploy requires sandbox preinstalled tosutil.');
+}
+function tosutilUploadFromTos(cred) {
+    return {
+        accessKeyID: cred.accessKeyID,
+        secretAccessKey: cred.secretAccessKey,
+        sessionToken: cred.sessionToken,
+        endpoint: cred.endpoint,
+        region: cred.region,
+        bucket: cred.bucket,
+        prefix: cred.prefix,
+    };
+}
 function tosutilUploadFromPaasStorage(cred, dataKey) {
     const { bucket, prefix } = (0, protocol_1.parseTosUploadPrefix)(cred.uploadPrefix, dataKey);
     return {
@@ -43,6 +66,106 @@ function tosutilUploadFromPaasStorage(cred, dataKey) {
         prefix,
     };
 }
+/**
+ * 写一个 tosutil 临时 config 文件，注入 STS 凭证 + endpoint + region。
+ * 返回 config 路径，调用方负责清理。
+ */
+function writeTosutilConfig(tosutilPath, cred, label) {
+    const confPath = node_path_1.default.join(node_os_1.default.tmpdir(), `.tosutilconfig-miaoda-${label}-${String(process.pid)}-${String(Date.now())}`);
+    node_fs_1.default.writeFileSync(confPath, '');
+    (0, node_child_process_1.execFileSync)(tosutilPath, [
+        'config',
+        '-conf',
+        confPath,
+        '-e',
+        cred.endpoint,
+        '-i',
+        cred.accessKeyID,
+        '-k',
+        cred.secretAccessKey,
+        '-t',
+        cred.sessionToken,
+        '-re',
+        cred.region,
+    ], { stdio: 'pipe' });
+    return confPath;
+}
+/** 把 tosutil 进程的输出按行回放到 stderr，便于线上排查（沙箱里无法 attach 进程）。 */
+function streamTosutilOutput(output) {
+    if (!output)
+        return;
+    for (const line of output.split('\n')) {
+        if (line.length === 0)
+            continue;
+        process.stderr.write(`[tosutil] ${line}\n`);
+    }
+}
+function normalizeTosDest(bucket, prefix) {
+    const bucketPart = bucket.startsWith('tos://') ? bucket : `tos://${bucket}`;
+    const normalized = prefix.replace(/^\/+/, '');
+    return `${bucketPart.replace(/\/+$/, '')}/${normalized}`;
+}
+/**
+ * 用 tosutil 把目录批量上传到 tos://bucket/prefix（STS 凭证从 config 文件读取）。
+ */
+function uploadDirWithCredential(tosutilPath, sourceDir, cred, label) {
+    const entries = node_fs_1.default.readdirSync(sourceDir);
+    if (entries.length === 0) {
+        (0, logger_1.debug)(`upload: skip empty dir ${sourceDir}`);
+        return;
+    }
+    const dest = normalizeTosDest(cred.bucket, cred.prefix);
+    (0, logger_1.debug)(`upload: ${sourceDir} -> ${dest} (${String(entries.length)} entries)`);
+    const confPath = writeTosutilConfig(tosutilPath, cred, label);
+    let output;
+    try {
+        output = (0, node_child_process_1.execFileSync)(tosutilPath, [
+            'cp',
+            sourceDir,
+            dest,
+            '-r',
+            '-flat',
+            '-j',
+            '5',
+            '-p',
+            '3',
+            '-ps',
+            '10485760',
+            '-f',
+            '-conf',
+            confPath,
+        ], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        streamTosutilOutput(output);
+    }
+    catch (err) {
+        const e = err;
+        const stderr = (e.stderr ?? '').trim();
+        const stdout = (e.stdout ?? '').trim();
+        streamTosutilOutput(stdout);
+        streamTosutilOutput(stderr);
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `tosutil cp exited with status ${String(e.status ?? -1)} for ${sourceDir}\n` +
+            `  stderr: ${stderr || '(empty)'}\n` +
+            `  stdout: ${stdout.slice(0, 500) || '(empty)'}`);
+    }
+    finally {
+        try {
+            node_fs_1.default.unlinkSync(confPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    const succeedMatch = /Succeed count is:\s*(\d+)/.exec(output);
+    const failedMatch = /Failed count is:\s*(\d+)/.exec(output);
+    const succeedCount = succeedMatch ? Number.parseInt(succeedMatch[1], 10) : 0;
+    const failedCount = failedMatch ? Number.parseInt(failedMatch[1], 10) : 0;
+    if (failedCount > 0) {
+        throw new error_1.AppError('DEPLOY_UPLOAD_FAILED', `Upload failed: ${String(failedCount)} files failed, ${String(succeedCount)} succeeded. source=${sourceDir}`);
+    }
+    if (succeedCount === 0) {
+        throw new error_1.AppError('DEPLOY_UPLOAD_EMPTY', `Upload failed: 0 files uploaded. source=${sourceDir}. Check tosutil credentials and bucket permissions.`);
+    }
+}
 function uploadTosTarget(tosutilPath, target, localPath, data) {
     const credRaw = target.required
         ? (0, protocol_1.requireDataKey)(data, target.dataKey)
@@ -53,7 +176,7 @@ function uploadTosTarget(tosutilPath, target, localPath, data) {
     }
     const cred = (0, protocol_1.parseTosUploadCredential)(credRaw, target.dataKey);
     (0, logger_1.log)('deploy', `Uploading ${target.dir}...`);
-    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, localPath, (0, tosutil_1.tosutilUploadFromTos)(cred), target.dir);
+    uploadDirWithCredential(tosutilPath, localPath, tosutilUploadFromTos(cred), target.dir);
     return true;
 }
 function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
@@ -65,7 +188,7 @@ function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
     }
     const cred = (0, protocol_1.parsePaasStorageCredential)((0, protocol_1.requireDataKey)(data, target.dataKey), target.dataKey);
     (0, logger_1.log)('deploy', `Uploading ${target.dir}...`);
-    (0, tosutil_1.uploadDirWithCredential)(tosutilPath, localPath, tosutilUploadFromPaasStorage(cred, target.dataKey), target.dir);
+    uploadDirWithCredential(tosutilPath, localPath, tosutilUploadFromPaasStorage(cred, target.dataKey), target.dir);
     return cred;
 }
 /**
@@ -79,7 +202,7 @@ function uploadPaasStorageTarget(tosutilPath, target, localPath, data) {
  * 目录不存在的可选项跳过；output 不存在或凭证缺失抛错。
  */
 async function uploadArtifacts(opts) {
-    const tosutilPath = (0, tosutil_1.resolveTosutilPath)();
+    const tosutilPath = resolveTosutilPath();
     const distDir = node_path_1.default.join(opts.projectDir, constants_1.DIST_DIR);
     const outcome = { uploaded: 0 };
     for (const target of UPLOAD_PLAN) {

package/dist/services/deploy/modern/check.js

@@ -7,20 +7,16 @@ exports.runDeployChecks = runDeployChecks;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const error_1 = require("../../../utils/error");
-const template_key_map_1 = require("./template-key-map");
 /**
  * 项目级 deploy 前置检查：node_modules / .spark/meta.json / package.json.scripts.build。
  * 任一 error 级别失败抛 AppError，附错误码 DEPLOY_PROJECT_CHECK_FAILED。
- *
- * design buildless 链路（design_local_deploy，如 design-html）的 build 直接拷源码 + 生成
- * routes.json（见 atoms/design-build.ts），不跑 `npm run build`、不读 package.json、不依赖
- * node_modules，因此对其跳过 node_modules / package.json / build 脚本三项检查，只保留
- * meta.json + stack 校验。
  */
 function runDeployChecks(projectDir) {
     const issues = [];
-    // 先读 stack 判断是否 design buildless 链路，决定后续是否豁免 node_modules / build 检查。
-    let stack;
+    const nodeModules = node_path_1.default.join(projectDir, 'node_modules');
+    if (!node_fs_1.default.existsSync(nodeModules)) {
+        issues.push('node_modules not found. Run `npm install` (or equivalent) first.');
+    }
     const metaPath = node_path_1.default.join(projectDir, '.spark', 'meta.json');
     if (!node_fs_1.default.existsSync(metaPath)) {
         issues.push('.spark/meta.json not found. Run `miaoda app init` first.');
@@ -28,7 +24,6 @@ function runDeployChecks(projectDir) {
     else {
         try {
             const meta = JSON.parse(node_fs_1.default.readFileSync(metaPath, 'utf-8'));
-            stack = meta.stack;
             if (!meta.stack) {
                 issues.push('.spark/meta.json missing fields: stack');
             }
@@ -37,27 +32,20 @@ function runDeployChecks(projectDir) {
             issues.push('.spark/meta.json is not valid JSON.');
         }
     }
-    const isDesign = stack !== undefined && (0, template_key_map_1.resolveTemplateKey)(stack) === template_key_map_1.DESIGN_LOCAL_DEPLOY;
-    if (!isDesign) {
-        const nodeModules = node_path_1.default.join(projectDir, 'node_modules');
-        if (!node_fs_1.default.existsSync(nodeModules)) {
-            issues.push('node_modules not found. Run `npm install` (or equivalent) first.');
-        }
-        const pkgPath = node_path_1.default.join(projectDir, 'package.json');
-        if (!node_fs_1.default.existsSync(pkgPath)) {
-            issues.push('package.json not found.');
-        }
-        else {
-            try {
-                const pkg = JSON.parse(node_fs_1.default.readFileSync(pkgPath, 'utf-8'));
-                if (!pkg.scripts?.build) {
-                    issues.push('package.json missing "build" script.');
-                }
-            }
-            catch {
-                issues.push('package.json is not valid JSON.');
+    const pkgPath = node_path_1.default.join(projectDir, 'package.json');
+    if (!node_fs_1.default.existsSync(pkgPath)) {
+        issues.push('package.json not found.');
+    }
+    else {
+        try {
+            const pkg = JSON.parse(node_fs_1.default.readFileSync(pkgPath, 'utf-8'));
+            if (!pkg.scripts?.build) {
+                issues.push('package.json missing "build" script.');
             }
         }
+        catch {
+            issues.push('package.json is not valid JSON.');
+        }
     }
     if (issues.length > 0) {
         throw new error_1.AppError('DEPLOY_PROJECT_CHECK_FAILED', `Project check failed:\n${issues.map((i) => `  - ${i}`).join('\n')}`);

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

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.designLocalPublishPipeline = exports.localBuildLocalPublishPipeline = void 0;
+exports.localBuildLocalPublishPipeline = void 0;
 var local_1 = require("./local");
 Object.defineProperty(exports, "localBuildLocalPublishPipeline", { enumerable: true, get: function () { return local_1.localBuildLocalPublishPipeline; } });
-var design_local_1 = require("./design-local");
-Object.defineProperty(exports, "designLocalPublishPipeline", { enumerable: true, get: function () { return design_local_1.designLocalPublishPipeline; } });

package/dist/services/deploy/modern/protocol.js

@@ -33,13 +33,6 @@ exports.DataKey = {
     // downloadURLPrefix 替代原 static_cdn_prefix 注入 build env。
     /** dist/output_static 上传凭证（仅当目录存在时使用） */
     OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL: 'output_static_paas_storage_credential',
-    // ── design 部署专用（design_local_deploy） ──
-    /** 覆盖整个 {app_id} 文件夹的上传凭证（形态同 TosUploadCredential） */
-    OUTPUT_ALL_TOS_UPLOAD_CREDENTIAL: 'output_all_tos_upload_credential',
-    /** version/备份份真实路径（后端已替换 {app_id}/{version}） */
-    OUTPUT_BACKUP_PATH: 'output_backup_path',
-    /** latest 份真实路径（后端已替换 {app_id}/latest） */
-    OUTPUT_LATEST_PATH: 'output_latest_path',
 };
 /** 取必传 key，缺失抛 AppError（带 key 名，便于后端 tcc 配置排查） */
 function requireDataKey(data, key) {

package/dist/services/deploy/modern/run.js

@@ -1,19 +1,13 @@
 "use strict";
 // modern deploy 主入口（dispatch 层）。
 //
-// 按 templateKey 选 pipeline：design_local_deploy → design pipeline，其余 → client pipeline。
-// 仅为路由轻量解析 templateKey（读 meta.stack + 映射），不跑前置检查——前置检查在各
-// pipeline 内部的 prepareDeployContext 里做。client 分支与原行为完全一致。
-// pipeline 之间彼此独立、不共享中间状态。
+// 当前阶段（Scope A）只接入"本地构建 + 本地部署"一条 pipeline；
+// 后续接入"本地构建 + 远端部署 / 远端构建 + 远端部署"时，在此处按 template_key
+// 或显式 flag 选不同 pipeline。pipeline 之间彼此独立、不共享中间状态。
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runModernDeploy = runModernDeploy;
-const spark_meta_1 = require("../../../utils/spark-meta");
-const template_key_map_1 = require("./template-key-map");
 const index_1 = require("./pipelines/index");
 async function runModernDeploy(opts) {
-    const stack = (0, spark_meta_1.readSparkMeta)(opts.projectDir).stack ?? '';
-    if ((0, template_key_map_1.resolveTemplateKey)(stack) === template_key_map_1.DESIGN_LOCAL_DEPLOY) {
-        return (0, index_1.designLocalPublishPipeline)(opts);
-    }
+    // 暂只支持本地构建 + 本地部署
     return (0, index_1.localBuildLocalPublishPipeline)(opts);
 }

package/dist/services/deploy/modern/template-key-map.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DESIGN_LOCAL_DEPLOY = void 0;
 exports.resolveTemplateKey = resolveTemplateKey;
 /**
  * 本地 stack 短名 → 后端发布模板 key 的映射。
@@ -11,12 +10,9 @@ exports.resolveTemplateKey = resolveTemplateKey;
  * 未来出现需要走别的 templateKey 的 stack，再在表里加一行覆盖默认。
  */
 const DEFAULT_TEMPLATE_KEY = 'client_local_deploy';
-/** design 部署 templateKey（run.ts 据此分流到 design pipeline） */
-exports.DESIGN_LOCAL_DEPLOY = 'design_local_deploy';
 const TEMPLATE_KEY_MAP = {
     'vite-react': DEFAULT_TEMPLATE_KEY,
     html: DEFAULT_TEMPLATE_KEY,
-    'design-html': exports.DESIGN_LOCAL_DEPLOY,
 };
 /**
  * 把本地 stack 短名映射到后端 templateKey；未配置的 stack 走默认 client_local_deploy。

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_ccm';
+const DEFAULT_CANARY_HEADER = 'boe_miaoda_doubao';
 /**
  * 注入 x-tt-env 小流量头：env 显式设值 > DEFAULT_CANARY_HEADER。
  *

package/package.json

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

package/dist/api/comment/api.js

@@ -1,24 +0,0 @@
-"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

@@ -1,6 +0,0 @@
-"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

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

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

@@ -1,55 +0,0 @@
-"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/registry/index.js

@@ -1,114 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerRegistryCommands = registerRegistryCommands;
-const shared_1 = require("../../../cli/commands/shared");
-const index_1 = require("../../../cli/handlers/registry/index");
-/**
- * miaoda registry：design-html 技术栈的「组件 registry」（shadcn 式 copy-in）。
- *
- * registry 是独立 npm 包，按 runtime 命名分发（buildless runtime → @lark-apaas/coding-registry-buildless）。
- * SDK 文件放在包根的 components/ · scripts/ · stylesheets/ 三个目录下（这三个顶层目录里的代码文件
- * 才算条目）；文件可带 USAGE 注释块（可选，声明描述 / 用法 / Depends）。CLI 抓 tarball、按
- * .spark/meta.json.stack → runtime → 包名 选包，把 SDK 文件**拍平**copy-in 到用户项目根。
- * 不写安装记账文件——项目文件树即状态（skip-by-disk）。
- */
-function registerRegistryCommands(program) {
-    const registryCmd = program
-        .command('registry')
-        .description('组件 registry：列出 / copy-in design-html SDK 文件')
-        .usage('<command> [flags]');
-    registryCmd.action(() => {
-        registryCmd.outputHelp();
-    });
-    registryCmd.addHelpText('after', `
-概念
-  - registry 包：独立 npm 包（按 runtime 命名）
-  - 条目 (entry)：包根 components/ · scripts/ · stylesheets/ 顶层目录（任意深度）下的代码文件；
-    name = 文件名去扩展名（不要求唯一）。包根直放文件、其它目录、非代码文件都不算条目
-  - 寻址：add / Depends 的 token 可写三种形式——name（foo）/ 完整文件名（foo.css）/ relPath（stylesheets/foo.css）
-  - 多匹配全拉：token 命中多个同名条目时全部 copy-in（不报歧义）；想只要其一就写完整文件名 / relPath
-  - USAGE 块：可选元数据，声明描述 / Exports / Usage / Depends；无 USAGE 也是条目（空描述、无依赖）
-  - Depends：从 USAGE 块解析的跨条目依赖，add 时传递解析、一并 copy-in
-  - add 落地：拍平到项目根（包根 scripts/x.js → 项目 x.js）；同名 basename 撞车时后者覆盖前者
-
-前置
-  当前目录（或 --dir）已走过 'miaoda app init'（.spark/meta.json 含 stack=design-html）
-`);
-    registerRegistryList(registryCmd);
-    registerRegistryAdd(registryCmd);
-}
-function registerRegistryList(parent) {
-    const cmd = parent
-        .command('list')
-        .description('列出 registry 可用 SDK 条目，输出各文件的 USAGE 块原文')
-        .option('--dir <path>', '项目目录，默认当前目录', '.')
-        .option('--version <ver>', 'registry 包版本或 dist-tag，缺省 latest')
-        .addHelpText('after', `
-输出
-  默认（pretty）：各条目 USAGE 块原文拼接，带文件名分隔，给 Agent 直接读注释
-
-JSON 输出
-  {"data": [{"name": "...", "file": "...", "usage": "<原文>", "dependsOn": [...]}, ...]}
-  （usage 保持 USAGE 块原文，不解析成结构化字段）
-
-示例
-  $ miaoda registry list
-  $ miaoda registry list --json
-`);
-    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        await (0, index_1.handleRegistryList)({
-            dir: rawOpts.dir,
-            version: rawOpts.version,
-        });
-    }));
-}
-function registerRegistryAdd(parent) {
-    const cmd = parent
-        .command('add')
-        .description('把一个或多个 SDK 文件 copy-in 到当前项目（拍平到项目根，含 Depends 闭包）')
-        .argument('<token...>', 'name / 完整文件名 / relPath，可传多个；同名多匹配全拉，Depends 自动传递解析')
-        .option('--dir <path>', '项目目录，默认当前目录', '.')
-        .option('--version <ver>', 'registry 包版本或 dist-tag，缺省 latest')
-        .option('--overwrite', '目标文件已存在时覆盖（默认跳过以保护用户改动）', false)
-        .option('--dry-run', '只报告将写 / 将跳哪些文件，不落盘', false)
-        .addHelpText('after', `
-行为
-  - token 寻址：name（foo）/ 完整文件名（foo.css）/ relPath（stylesheets/foo.css）任一形式
-  - 多匹配全拉：token 命中多个同名条目时全部 copy-in；想只要其一就写完整文件名 / relPath
-  - 解析 USAGE 块 Depends 传递闭包，把 SDK 文件**拍平**拷到项目根
-    （包根 scripts/deck-stage.js → 项目 deck-stage.js；同名 basename 撞车时后者覆盖前者）
-  - skip-by-disk：目标文件已存在默认跳过；--overwrite 才覆盖
-  - 不写任何安装记账文件（项目文件树即状态）
-
-输出（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
-  $ miaoda registry add deck-slide theme --dry-run
-  $ miaoda registry add deck-slide --overwrite --json
-`);
-    cmd.action((0, shared_1.withHelp)(cmd, async (names, rawOpts) => {
-        await (0, index_1.handleRegistryAdd)({
-            names,
-            dir: rawOpts.dir,
-            version: rawOpts.version,
-            overwrite: rawOpts.overwrite,
-            dryRun: rawOpts.dryRun,
-        });
-    }));
-}

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

@@ -1,7 +0,0 @@
-"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; } });