@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.08ca9fb

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 shared_1 = require("../../../cli/commands/shared");
+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, shared_1.failArgs)("<deploy-id> 必填");
+    const appID = (0, shared_1.resolveAppId)({ 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 shared_1 = require("../../../cli/commands/shared");
+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, shared_1.failArgs)("<deploy-id> 必填");
+    const appID = (0, shared_1.resolveAppId)({ 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 shared_1 = require("../../../cli/commands/shared");
+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, shared_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, shared_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, shared_1.failArgs)(`<deploy-id> 必须是数字 ID，收到 '${text}'`);
+    }
+    return n;
+}

package/dist/cli/handlers/deploy/history.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.handleDeployHistory = handleDeployHistory;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const shared_1 = require("../../../cli/commands/shared");
+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 = (0, shared_1.resolveAppId)({ 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

@@ -45,15 +45,23 @@ 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;
 /**
- * 判断 src 是本地文件还是远程引用：
- * - src 本地 fs 可访问 → upload（dst 当 remote）
- * - 其他 → download（src 是 /path 或 file_name，由 resolveRemotePath 解析）
- *
- * `cp` 语义要求 src 必须存在；本地不存在就认为用户指向远程。不需要给 dst 猜方向。
+ * 判断 src 是本地路径还是远程引用——按 PRD `miaoda file cp` 规则的优先级：
+ *   1. `./` / `../` / `~/` 开头 + 裸文件名（不含 `/`）→ 本地路径（即使不存在）
+ *      给 handleUpload 把"不存在"准确抛成 FILE_SRC_NOT_FOUND，
+ *      避免回退到远程 download 输出 `FILE_NOT_FOUND` + "Run miaoda file ls"
+ *      这种与用户意图（上传）背离的引导。
+ *   2. `/` 开头：fs.existsSync 兜底——存在即本地（绝对路径上传），
+ *      不存在即远程 path（download，由 resolveRemotePath 处理）。
  */
 function isLocalSrc(src) {
+    if (src.startsWith("./") || src.startsWith("../") || src.startsWith("~/"))
+        return true;
+    if (!src.includes("/"))
+        return true;
+    // `/` 开头：可能是本地绝对路径，也可能是远程 path；交给 fs 探测。
     const expanded = expandHome(src);
     try {
         return node_fs_1.default.existsSync(expanded);
@@ -104,23 +112,37 @@ 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."],
+        });
     }
     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.",
-            ],
+            next_actions: ["Split the file, or use the web console for large uploads."],
         });
     }
-    const fileName = rename ?? node_path_1.default.basename(localPath);
-    let remotePath = remoteRaw;
-    if (remoteRaw.endsWith("/")) {
-        remotePath = remoteRaw + fileName;
+    // PRD：path 末段**始终**由平台生成 16 位 ID 确保唯一，不受 dst 形态或
+    // --rename 影响；用户指定的 file_name 仅作为显示名（同目录下允许重名）。
+    // 因此 CLI 端把 dst 拆成"目录前缀 + file_name"两段：
+    //   - dst 以 / 结尾或为空  → 整段当目录前缀，file_name 用 --rename 或本地 basename
+    //                          例：cp ./logo.png /imgs/        → path=/imgs/<GID>.png, file_name=logo.png
+    //   - dst 不以 / 结尾      → 末段当 file_name，前段（含尾 /）当目录前缀
+    //                          例：cp ./1.jpg /post-covers/cover.jpg → path=/post-covers/<GID>.jpg, file_name=cover.jpg
+    // 这样无论用户怎么写 dst，都走服务端目录前缀模式（PreUpload `filePath`
+    // 末尾带 /），保证 path 全局唯一性，不会因用户指定了完整路径而退化成
+    // 完整对象 key 模式。--rename 始终覆盖 file_name 推断结果（PRD 优先级）。
+    let fileName;
+    let remotePath;
+    if (remoteRaw === "" || remoteRaw.endsWith("/")) {
+        fileName = rename ?? node_path_1.default.basename(localPath);
+        remotePath = remoteRaw;
     }
-    else if (remoteRaw === "/") {
-        remotePath = "/" + fileName;
+    else {
+        const lastSlash = remoteRaw.lastIndexOf("/");
+        fileName = rename ?? remoteRaw.slice(lastSlash + 1);
+        remotePath = remoteRaw.slice(0, lastSlash + 1);
     }
     const contentType = detectMime(localPath);
     const result = await api.file.uploadFile({
@@ -147,7 +169,7 @@ async function handleUpload(appId, localRaw, remoteRaw, rename) {
     const tty = (0, render_1.isStdoutTty)();
     const lines = [];
     if (tty) {
-        lines.push(`✓ Uploaded ${node_path_1.default.basename(localPath)} → ${result.path}`);
+        lines.push(colors_1.c.success(`✓ Uploaded ${node_path_1.default.basename(localPath)} → ${result.path}`));
         lines.push(`   file_name:     ${result.file_name}`);
         lines.push(`   path:          ${result.path}`);
         lines.push(`   size:          ${(0, render_1.formatSize)(result.size)} (${String(result.size)} bytes)`);
@@ -204,7 +226,7 @@ async function handleDownload(appId, remoteRaw, localRaw) {
     }
     const tty = (0, render_1.isStdoutTty)();
     if (tty) {
-        (0, output_1.emit)(`✓ Downloaded ${baseName} → ${localTarget} (${(0, render_1.formatSize)(writtenBytes)})`);
+        (0, output_1.emit)(colors_1.c.success(`✓ Downloaded ${baseName} → ${localTarget} (${(0, render_1.formatSize)(writtenBytes)})`));
     }
     else {
         (0, output_1.emit)(`OK Downloaded ${baseName} -> ${localTarget} (${String(writtenBytes)} bytes)`);

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

@@ -101,9 +101,7 @@ async function handleFileLs(opts) {
         info.type,
         (0, render_1.formatTime)(info.uploaded_at, tty),
     ]);
-    const table = tty
-        ? (0, render_1.renderAlignedTable)(headers, rows)
-        : (0, render_1.renderTsv)(headers, rows);
+    const table = tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows);
     const hint = result.has_more && result.next_cursor
         ? `\n— ${String(result.items.length)} results. Next: --cursor ${result.next_cursor}`
         : "";

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

@@ -43,6 +43,7 @@ const error_1 = require("../../../utils/error");
 const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 const render_1 = require("../../../utils/render");
+const colors_1 = require("../../../utils/colors");
 const node_readline_1 = __importDefault(require("node:readline"));
 const MAX_BATCH = 100;
 /**
@@ -169,7 +170,7 @@ async function handleFileRm(paths, opts) {
             results.push({
                 status: "ok",
                 input: entry?.input ?? p,
-                file_name: entry?.file_name ?? (p.split("/").pop() ?? p),
+                file_name: entry?.file_name ?? p.split("/").pop() ?? p,
                 path: p,
             });
         }
@@ -228,9 +229,9 @@ async function handleFileRm(paths, opts) {
         const lines = [];
         for (const r of results) {
             if (r.status === "ok")
-                lines.push(`✓ Deleted ${r.input}`);
+                lines.push(colors_1.c.success(`✓ Deleted ${r.input}`));
             else
-                lines.push(`✗ ${r.input}: ${r.error.message}`);
+                lines.push(colors_1.c.fail(`✗ ${r.input}: ${r.error.message}`));
         }
         if (failCount === 0) {
             lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files`);