@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.2a09432

package/dist/cli/handlers/deploy/error-log.js

@@ -0,0 +1,60 @@
+"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.handleDeployErrorLog = handleDeployErrorLog;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const index_1 = require("../../../api/deploy/index");
+const helpers_1 = require("./helpers");
+/** miaoda deploy error-log <deploy-id> */
+async function handleDeployErrorLog(opts) {
+    if (!opts.deployId)
+        (0, args_1.failArgs)('<deploy-id> 必填');
+    const appID = opts.appId;
+    (0, helpers_1.parseDeployId)(opts.deployId); // 仅校验数字形式；URL 直接用原字符串
+    const instanceID = opts.deployId;
+    const resp = await api.deploy.getErrorLog({ appID, instanceID });
+    (0, output_1.emit)({
+        data: resp.errorJobs,
+        next_cursor: null,
+        has_more: false,
+    }, index_1.errorJobSchema);
+    // pretty 模式额外打一行整体状态。
+    if (!process.stdout.isTTY)
+        return;
+    const statusText = (0, index_1.nodeStatusText)(resp.status) ?? String(resp.status);
+    process.stdout.write(`\n— pipeline status: ${statusText}\n`);
+}

package/dist/cli/handlers/deploy/format.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatStatusMetadata = formatStatusMetadata;
+exports.formatSimpleInstance = formatSimpleInstance;
+exports.formatPipelineInstance = formatPipelineInstance;
+const index_1 = require("../../../api/deploy/index");
+function formatStatusMetadata(statusCode) {
+    return {
+        status: (0, index_1.nodeStatusText)(statusCode) ?? `unknown(${String(statusCode)})`,
+        status_code: statusCode,
+    };
+}
+function formatSimpleInstance(instance) {
+    if (instance.status === undefined)
+        return { ...instance };
+    return {
+        ...instance,
+        ...formatStatusMetadata(instance.status),
+    };
+}
+function formatPipelineInstance(detail) {
+    const stages = Array.isArray(detail.stages) ? detail.stages : [];
+    return {
+        ...detail,
+        ...formatStatusMetadata(detail.status),
+        stages: stages.map((stage) => ({
+            ...stage,
+            ...formatStatusMetadata(stage.status),
+            jobs: stage.jobs.map((group) => group.map((job) => ({
+                ...job,
+                ...formatStatusMetadata(job.status),
+                steps: job.steps?.map((step) => ({
+                    ...step,
+                    ...formatStatusMetadata(step.status),
+                })),
+            }))),
+        })),
+    };
+}

package/dist/cli/handlers/deploy/get.js

@@ -0,0 +1,71 @@
+"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.handleDeployGet = handleDeployGet;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const error_1 = require("../../../utils/error");
+const index_1 = require("../../../api/deploy/index");
+const helpers_1 = require("./helpers");
+const format_1 = require("./format");
+/**
+ * 单页拉取上限：BAM listPipelineInstances 限制 1~500，取 500 让 deploy get
+ * 在最近 500 条记录里按 ID 命中。
+ */
+const DEPLOY_GET_LOOKUP_LIMIT = 500;
+/**
+ * miaoda deploy get <deploy-id>
+ *
+ * BAM 没有 by-ID 的查询接口，复用 listPipelineInstances 在最近窗口里按 ID 筛一条。
+ * 命中失败时抛 DEPLOY_NOT_FOUND，提示用户用 history 查窗口。
+ */
+async function handleDeployGet(opts) {
+    if (!opts.deployId)
+        (0, args_1.failArgs)('<deploy-id> 必填');
+    const appID = opts.appId;
+    const deployId = (0, helpers_1.parseDeployId)(opts.deployId);
+    const resp = await api.deploy.listPipelineInstances({
+        appID,
+        limit: DEPLOY_GET_LOOKUP_LIMIT,
+    });
+    const instance = resp.instances?.find((it) => Number(it.ID) === deployId);
+    if (!instance) {
+        throw new error_1.AppError('DEPLOY_NOT_FOUND', `未在最近 ${String(DEPLOY_GET_LOOKUP_LIMIT)} 条记录中找到 deploy-id=${opts.deployId}`, {
+            next_actions: ['运行 `miaoda deploy history` 确认 deploy-id 是否在最近窗口内'],
+        });
+    }
+    (0, output_1.emit)({ data: (0, format_1.formatSimpleInstance)(instance), next_cursor: null, has_more: false }, index_1.deployGetSchema);
+}

package/dist/cli/handlers/deploy/helpers.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStatusFlag = parseStatusFlag;
+exports.validateLimit = validateLimit;
+exports.parseDeployId = parseDeployId;
+const args_1 = require("../../../utils/args");
+const index_1 = require("../../../api/deploy/index");
+/**
+ * 把 CLI --status 字符串映射成 BAM NodeStatus 数字；非法值抛 ARGS_INVALID。
+ *
+ * 历史接口（CliListPipelineInstances）返回 SimpleInstance，状态语义是 pipeline 节点状态，
+ * 取值 todo / running / success / failed / canceled / hold_on。
+ */
+function parseStatusFlag(text) {
+    const value = (0, index_1.nodeStatusFromText)(text);
+    if (value === undefined) {
+        (0, args_1.failArgs)(`--status 无效：'${text}'。可选值：todo | running | success | failed | canceled | hold_on`);
+    }
+    return value;
+}
+/** limit/pageSize 校验（API 限制 1~100） */
+function validateLimit(limit, defaultLimit = 50) {
+    const n = Number.isFinite(limit) ? limit : defaultLimit;
+    if (n <= 0 || n > 100) {
+        (0, args_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
+    }
+    return n;
+}
+/**
+ * 把 CLI <deploy-id> 字符串转成 i64 number。
+ *
+ * 语义上 deploy-id 即 pipelineTaskID（pipeline 实例 ID）；BAM CLIGetReleaseLogs
+ * IDL 历史命名为 releaseID，但传入的就是这同一个值。
+ */
+function parseDeployId(text) {
+    const n = Number(text);
+    if (!Number.isFinite(n) || !/^\d+$/.test(text)) {
+        (0, args_1.failArgs)(`<deploy-id> 必须是数字 ID，收到 '${text}'`);
+    }
+    return n;
+}

package/dist/cli/handlers/deploy/history.js

@@ -0,0 +1,70 @@
+"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.handleDeployHistory = handleDeployHistory;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const time_1 = require("../../../utils/time");
+const index_1 = require("../../../api/deploy/index");
+const helpers_1 = require("./helpers");
+const format_1 = require("./format");
+/** miaoda deploy history */
+async function handleDeployHistory(opts) {
+    const appID = opts.appId;
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    const req = {
+        appID,
+        limit,
+        pageToken: opts.cursor,
+    };
+    if (opts.status)
+        req.status = [(0, helpers_1.parseStatusFlag)(opts.status)];
+    // BAM startTimestamp / endTimestamp 单位是秒（IDL desc：单位：秒）
+    if (opts.since !== undefined)
+        req.startTimestamp = msToSec((0, time_1.parseToMs)(opts.since));
+    if (opts.until !== undefined)
+        req.endTimestamp = msToSec((0, time_1.parseToMs)(opts.until));
+    const resp = await api.deploy.listPipelineInstances(req);
+    (0, output_1.emit)({
+        data: (resp.instances ?? []).map(format_1.formatSimpleInstance),
+        next_cursor: resp.hasMore ? (resp.nextPageToken ?? null) : null,
+        has_more: resp.hasMore ?? false,
+    }, index_1.deployHistorySchema);
+}
+function msToSec(ms) {
+    if (ms === undefined)
+        return undefined;
+    return Math.floor(ms / 1000);
+}

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

@@ -0,0 +1,14 @@
+"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;
+var deploy_1 = require("./deploy");
+Object.defineProperty(exports, "handleDeploy", { enumerable: true, get: function () { return deploy_1.handleDeploy; } });
+var get_1 = require("./get");
+Object.defineProperty(exports, "handleDeployGet", { enumerable: true, get: function () { return get_1.handleDeployGet; } });
+var history_1 = require("./history");
+Object.defineProperty(exports, "handleDeployHistory", { enumerable: true, get: function () { return history_1.handleDeployHistory; } });
+var error_log_1 = require("./error-log");
+Object.defineProperty(exports, "handleDeployErrorLog", { enumerable: true, get: function () { return error_log_1.handleDeployErrorLog; } });
+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; } });

package/dist/cli/handlers/deploy/polling.js

@@ -0,0 +1,162 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_POLL_INTERVAL_MS = void 0;
+exports.waitForPipeline = waitForPipeline;
+const ora_1 = __importDefault(require("ora"));
+const api = __importStar(require("../../../api/index"));
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../api/deploy/index");
+/** 默认轮询间隔（毫秒） */
+exports.DEFAULT_POLL_INTERVAL_MS = 2_000;
+const TERMINAL_STATUSES = [
+    index_1.NodeStatus.SUCCESS,
+    index_1.NodeStatus.FAILED,
+    index_1.NodeStatus.CANCELED,
+];
+function defaultSleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+/**
+ * 轮询 pipeline 状态直到终态或超时。
+ *
+ * - JSON 模式：轮询期间静默；终态后由 caller 输出最终信封。
+ * - Pretty 非 TTY：同 JSON。
+ * - Pretty TTY：底部行用 braille spinner 显示当前正在跑的 stage（每 80ms 跳一帧），
+ *   stage 转终态时把 ✓ stage(12.3s) 打到 spinner 上方然后清掉 spinner 行。
+ *
+ * 终态返回最终 PipelineInstance，调用方再决定怎么 emit。
+ */
+async function waitForPipeline(opts) {
+    const interval = opts.intervalMs ?? exports.DEFAULT_POLL_INTERVAL_MS;
+    const timeoutMs = opts.timeoutSec * 1000;
+    const sleep = opts.sleep ?? defaultSleep;
+    const now = opts.now ?? Date.now;
+    const start = now();
+    // ora 自身在非 TTY 下会降级为不动画，但我们额外加 isJsonMode 闸门：JSON / 字段选择
+    // 模式下完全静默。
+    const showProgress = !(0, output_1.isJsonMode)() && process.stdout.isTTY;
+    const printedStages = new Set();
+    const spinner = showProgress
+        ? (0, ora_1.default)({ text: '等待调度', spinner: 'dots', stream: process.stdout }).start()
+        : null;
+    try {
+        for (;;) {
+            const resp = await api.deploy.queryPipelineInstance({
+                appID: opts.appID,
+                instanceID: opts.pipelineTaskID,
+            });
+            const detail = normalizePipelineInstance(resp);
+            if (spinner)
+                advanceProgress(detail, printedStages, spinner);
+            if (TERMINAL_STATUSES.includes(detail.status)) {
+                return detail;
+            }
+            if (now() - start >= timeoutMs) {
+                throw new error_1.AppError('DEPLOY_TIMEOUT', `轮询发布状态超时（${String(opts.timeoutSec)}s）`, {
+                    retryable: true,
+                    next_actions: [
+                        `Run \`miaoda deploy get <deploy-id>\` 查看最新状态`,
+                        `加大 --timeout 后重试`,
+                    ],
+                });
+            }
+            await sleep(interval);
+        }
+    }
+    finally {
+        spinner?.stop();
+    }
+}
+/**
+ * 每轮 poll 的进度推进：刚转终态的 stage 用 stopAndPersist 落定为永久行，
+ * 再把 spinner 文本切到当前 running stage；没有 running 时显示"等待调度"。
+ */
+function advanceProgress(detail, printed, spinner) {
+    const stages = Array.isArray(detail.stages) ? detail.stages : [];
+    for (const stage of stages) {
+        if (printed.has(stage.id))
+            continue;
+        if (!TERMINAL_STATUSES.includes(stage.status))
+            continue;
+        spinner.stopAndPersist({
+            symbol: stageSymbol(stage),
+            text: formatStageBody(stage),
+        });
+        printed.add(stage.id);
+    }
+    const running = stages.find((s) => s.status === index_1.NodeStatus.RUNNING);
+    const text = running ? `${running.name} 执行中` : '等待调度';
+    if (spinner.isSpinning) {
+        spinner.text = text;
+    }
+    else {
+        spinner.start(text);
+    }
+}
+function normalizePipelineInstance(resp) {
+    const keyedDetail = readPipelineDetail(resp, 'pipelineInstanceDetail') ?? readPipelineDetail(resp, 'detail');
+    if (keyedDetail)
+        return keyedDetail;
+    if (isPipelineInstance(resp))
+        return resp;
+    throw new error_1.AppError('DEPLOY_RESPONSE_INVALID', '发布状态响应缺少 pipeline detail', {
+        next_actions: ['使用 --verbose 重试以查看请求 logid，并联系平台排查响应结构'],
+    });
+}
+function readPipelineDetail(resp, key) {
+    if (!(key in resp))
+        return undefined;
+    const detail = resp[key];
+    return isPipelineInstance(detail) ? detail : undefined;
+}
+function isPipelineInstance(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const item = value;
+    return typeof item.status === 'number';
+}
+function stageSymbol(stage) {
+    return stage.status === index_1.NodeStatus.SUCCESS ? '✓' : stage.status === index_1.NodeStatus.FAILED ? '✗' : '•';
+}
+function formatStageBody(stage) {
+    const cost = stage.costTime >= 0 ? `(${(stage.costTime / 1000).toFixed(1)}s)` : '';
+    const status = (0, index_1.nodeStatusText)(stage.status) ?? String(stage.status);
+    return `${stage.name}${cost ? ` ${cost}` : ''} ${status}`.trim();
+}

package/dist/cli/handlers/file/cp.js

@@ -44,7 +44,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const colors_1 = require("../../../utils/colors");
 const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
 /**
@@ -57,9 +56,9 @@ const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
  *      不存在即远程 path（download，由 resolveRemotePath 处理）。
  */
 function isLocalSrc(src) {
-    if (src.startsWith("./") || src.startsWith("../") || src.startsWith("~/"))
+    if (src.startsWith('./') || src.startsWith('../') || src.startsWith('~/'))
         return true;
-    if (!src.includes("/"))
+    if (!src.includes('/'))
         return true;
     // `/` 开头：可能是本地绝对路径，也可能是远程 path；交给 fs 探测。
     const expanded = expandHome(src);
@@ -71,38 +70,38 @@ function isLocalSrc(src) {
     }
 }
 function expandHome(p) {
-    if (p.startsWith("~/"))
+    if (p.startsWith('~/'))
         return node_path_1.default.join(node_os_1.default.homedir(), p.slice(2));
     return p;
 }
 function detectMime(filePath) {
     const ext = node_path_1.default.extname(filePath).toLowerCase();
     const map = {
-        ".png": "image/png",
-        ".jpg": "image/jpeg",
-        ".jpeg": "image/jpeg",
-        ".gif": "image/gif",
-        ".webp": "image/webp",
-        ".svg": "image/svg+xml",
-        ".pdf": "application/pdf",
-        ".json": "application/json",
-        ".csv": "text/csv",
-        ".txt": "text/plain",
-        ".html": "text/html",
-        ".zip": "application/zip",
-        ".tar": "application/x-tar",
-        ".gz": "application/gzip",
-        ".mp4": "video/mp4",
-        ".mp3": "audio/mpeg",
+        '.png': 'image/png',
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.gif': 'image/gif',
+        '.webp': 'image/webp',
+        '.svg': 'image/svg+xml',
+        '.pdf': 'application/pdf',
+        '.json': 'application/json',
+        '.csv': 'text/csv',
+        '.txt': 'text/plain',
+        '.html': 'text/html',
+        '.zip': 'application/zip',
+        '.tar': 'application/x-tar',
+        '.gz': 'application/gzip',
+        '.mp4': 'video/mp4',
+        '.mp3': 'audio/mpeg',
     };
-    return map[ext] ?? "application/octet-stream";
+    return map[ext] ?? 'application/octet-stream';
 }
 /** 把 src 的远程形式（`/path` / `file_name`）解析成后端 sign 可用的 remote path。 */
 async function resolveRemotePath(appId, input) {
-    if (input.startsWith("/"))
+    if (input.startsWith('/'))
         return input;
     const [resolved] = await api.file.resolveInputs({ appId, inputs: [input] });
-    if (resolved.status === "error") {
+    if (resolved.status === 'error') {
         throw new error_1.AppError(resolved.error.code, resolved.error.message, {
             next_actions: resolved.error.hint ? [resolved.error.hint] : undefined,
         });
@@ -112,15 +111,15 @@ async function resolveRemotePath(appId, input) {
 async function handleUpload(appId, localRaw, remoteRaw, rename) {
     const localPath = expandHome(localRaw);
     if (!node_fs_1.default.existsSync(localPath) || !node_fs_1.default.statSync(localPath).isFile()) {
-        throw new error_1.AppError("FILE_SRC_NOT_FOUND", `Local file '${localRaw}' does not exist`, {
+        throw new error_1.AppError('FILE_SRC_NOT_FOUND', `Local file '${localRaw}' does not exist`, {
             // 引导本地路径自检；远程下载请用 `/path` 形态，避免裸名/相对路径误入上传分支
-            next_actions: ["Check the local file path; use `/path` prefix for remote download."],
+            next_actions: ['Check the local file path; use `/path` prefix for remote download.'],
         });
     }
     const stat = node_fs_1.default.statSync(localPath);
     if (stat.size > MAX_UPLOAD_BYTES) {
-        throw new error_1.AppError("FILE_SIZE_EXCEEDED", `File size ${(0, render_1.formatSize)(stat.size)} exceeds the 100 MB upload limit`, {
-            next_actions: ["Split the file, or use the web console for large uploads."],
+        throw new error_1.AppError('FILE_SIZE_EXCEEDED', `File size ${(0, render_1.formatSize)(stat.size)} exceeds the 100 MB upload limit`, {
+            next_actions: ['Split the file, or use the web console for large uploads.'],
         });
     }
     // PRD：path 末段**始终**由平台生成 16 位 ID 确保唯一，不受 dst 形态或
@@ -135,12 +134,12 @@ async function handleUpload(appId, localRaw, remoteRaw, rename) {
     // 完整对象 key 模式。--rename 始终覆盖 file_name 推断结果（PRD 优先级）。
     let fileName;
     let remotePath;
-    if (remoteRaw === "" || remoteRaw.endsWith("/")) {
+    if (remoteRaw === '' || remoteRaw.endsWith('/')) {
         fileName = rename ?? node_path_1.default.basename(localPath);
         remotePath = remoteRaw;
     }
     else {
-        const lastSlash = remoteRaw.lastIndexOf("/");
+        const lastSlash = remoteRaw.lastIndexOf('/');
         fileName = rename ?? remoteRaw.slice(lastSlash + 1);
         remotePath = remoteRaw.slice(0, lastSlash + 1);
     }
@@ -188,7 +187,7 @@ async function handleUpload(appId, localRaw, remoteRaw, rename) {
             lines.push(`download_url\t${result.download_url}`);
         }
     }
-    (0, output_1.emit)(lines.join("\n"));
+    (0, output_1.emit)(lines.join('\n'));
 }
 async function handleDownload(appId, remoteRaw, localRaw) {
     const filePath = await resolveRemotePath(appId, remoteRaw);
@@ -199,7 +198,7 @@ async function handleDownload(appId, remoteRaw, localRaw) {
     });
     const baseName = node_path_1.default.basename(filePath);
     let localTarget = expandHome(localRaw);
-    if (localTarget === "./" || localTarget === "." || localTarget.endsWith("/")) {
+    if (localTarget === './' || localTarget === '.' || localTarget.endsWith('/')) {
         localTarget = node_path_1.default.join(localTarget, baseName);
     }
     else if (node_fs_1.default.existsSync(localTarget) && node_fs_1.default.statSync(localTarget).isDirectory()) {
@@ -233,7 +232,7 @@ async function handleDownload(appId, remoteRaw, localRaw) {
     }
 }
 async function handleFileCp(src, dst, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // src 本地存在 → upload；其他情况（file_ref / `/path` / 裸文件名）→ download
     if (isLocalSrc(src)) {
         return handleUpload(appId, src, dst, opts.rename);

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
+exports.handleFileQuota = exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
 var ls_1 = require("./ls");
 Object.defineProperty(exports, "handleFileLs", { enumerable: true, get: function () { return ls_1.handleFileLs; } });
 var stat_1 = require("./stat");
@@ -11,3 +11,5 @@ var rm_1 = require("./rm");
 Object.defineProperty(exports, "handleFileRm", { enumerable: true, get: function () { return rm_1.handleFileRm; } });
 var sign_1 = require("./sign");
 Object.defineProperty(exports, "handleFileSign", { enumerable: true, get: function () { return sign_1.handleFileSign; } });
+var quota_1 = require("./quota");
+Object.defineProperty(exports, "handleFileQuota", { enumerable: true, get: function () { return quota_1.handleFileQuota; } });