@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.2e37617

package/dist/cli/handlers/db/sql.js

@@ -44,7 +44,10 @@ const config_1 = require("../../../utils/config");
 const logger_1 = require("../../../utils/logger");
 const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
+const colors_1 = require("../../../utils/colors");
+const fuzzy_match_1 = require("../../../utils/fuzzy-match");
 const index_1 = require("../../../api/db/index");
+const sql_keywords_1 = require("../../../api/db/sql-keywords");
 const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
@@ -64,7 +67,20 @@ async function handleDbSql(query, opts) {
     if (!sql.trim()) {
         throw new error_1.AppError("ARGS_INVALID", "Empty SQL (no inline query and stdin is empty)");
     }
-    const results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    let results;
+    try {
+        results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    }
+    catch (err) {
+        // 错误抛出前富化 next_actions：识别"语法错误"/"表不存在"/"列不存在"
+        // 三类常见 PG 错误，做 fuzzy match 给 did-you-mean 提示。
+        // 富化失败任何环节都静默吞掉，不破坏原始错误信息。
+        await enrichSqlError(err, { appId, env: opts.env, sql });
+        // PRD 多语句失败：把服务端给的 partial_results 转成 `completed`，推断 `rolled_back`，
+        // 并把 pretty 模式的 `Statement N: ✓ ... / Statement K: ✗ ...` 立即打到 stderr。
+        enrichMultiStatementError(err, sql);
+        throw err;
+    }
     if (results.length === 0) {
         // 后端未返回任何结果，通常不会发生
         if ((0, output_1.isJsonMode)()) {
@@ -225,19 +241,19 @@ function renderSingle(raw) {
             return;
         }
         const cols = collectColumns(parsed.rows);
-        const rows = parsed.rows.map((r) => cols.map((c) => formatCell(r[c], tty)));
+        const rows = parsed.rows.map((r) => cols.map((col) => formatCell(r[col], tty)));
         (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(cols, rows) : (0, render_1.renderTsv)(cols, rows));
         return;
     }
     if (parsed.kind === "dml") {
         const verb = dmlVerb(parsed.sqlType);
         (0, output_1.emit)(tty
-            ? `✓ ${String(parsed.affectedRows)} row${parsed.affectedRows === 1 ? "" : "s"} ${verb}`
+            ? colors_1.c.success(`✓ ${String(parsed.affectedRows)} row${parsed.affectedRows === 1 ? "" : "s"} ${verb}`)
             : `OK ${String(parsed.affectedRows)} rows ${verb}`);
         return;
     }
     // DDL
-    (0, output_1.emit)(tty ? "✓ DDL executed" : "OK DDL executed");
+    (0, output_1.emit)(tty ? colors_1.c.success("✓ DDL executed") : "OK DDL executed");
 }
 function toJson(parsed) {
     if (parsed.kind === "select") {
@@ -293,7 +309,10 @@ function parseJsonFields() {
     const v = (0, config_1.getConfig)().json;
     if (typeof v !== "string" || v === "")
         return null;
-    return v.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    return v
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
 }
 /** 多语句 pretty：逐条 `Statement N: ...` + 末尾 `✓ N statements executed`。 */
 function renderMultiPretty(results) {
@@ -307,7 +326,7 @@ function renderMultiPretty(results) {
             lines.push(`Statement ${String(idx)}: SELECT (${String(n)} row${n === 1 ? "" : "s"})`);
             if (n > 0) {
                 const cols = collectColumns(parsed.rows);
-                const tbl = parsed.rows.map((r) => cols.map((c) => formatCell(r[c], tty)));
+                const tbl = parsed.rows.map((r) => cols.map((col) => formatCell(r[col], tty)));
                 lines.push(tty ? (0, render_1.renderAlignedTable)(cols, tbl) : (0, render_1.renderTsv)(cols, tbl));
             }
             // 块间空行（最后一条不留）
@@ -318,25 +337,31 @@ function renderMultiPretty(results) {
         if (parsed.kind === "dml") {
             const verb = dmlVerb(parsed.sqlType);
             const n = parsed.affectedRows;
-            lines.push(`Statement ${String(idx)}: ${tty ? "✓ " : ""}${String(n)} row${n === 1 ? "" : "s"} ${verb}`);
+            const body = `${String(n)} row${n === 1 ? "" : "s"} ${verb}`;
+            lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success("✓ " + body) : body}`);
             continue;
         }
         // DDL
-        lines.push(`Statement ${String(idx)}: ${tty ? "✓ " : ""}DDL executed`);
+        lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success("✓ DDL executed") : "DDL executed"}`);
     }
     // 汇总行：所有 statement 都跑完了
     lines.push(tty
-        ? `✓ ${String(results.length)} statements executed`
+        ? colors_1.c.success(`✓ ${String(results.length)} statements executed`)
         : `OK ${String(results.length)} statements executed`);
     (0, output_1.emit)(lines.join("\n"));
 }
 function dmlVerb(type) {
     switch (type) {
-        case "INSERT": return "inserted";
-        case "UPDATE": return "updated";
-        case "DELETE": return "deleted";
-        case "MERGE": return "merged";
-        case "DML": return "affected"; // 未识别子类的兜底
+        case "INSERT":
+            return "inserted";
+        case "UPDATE":
+            return "updated";
+        case "DELETE":
+            return "deleted";
+        case "MERGE":
+            return "merged";
+        case "DML":
+            return "affected"; // 未识别子类的兜底
     }
 }
 /** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */
@@ -356,12 +381,275 @@ function collectColumns(rows) {
  */
 function formatCell(v, tty) {
     if (v === null || v === undefined) {
-        return tty ? "\u001b[2;90mNULL\u001b[0m" : "NULL";
+        return tty ? colors_1.c.muted("NULL") : "NULL";
     }
-    if (typeof v === "string")
+    if (typeof v === "string") {
+        // TTY 下检测到 ISO 8601 时间字符串 → 转成相对时间（"3h ago" / "2d ago" /
+        // "2026-03-15"），方便 _created_at / _updated_at 等列直观可读
+        if (tty && ISO_TIMESTAMP_RE.test(v) && !Number.isNaN(Date.parse(v))) {
+            return (0, render_1.formatTime)(v, tty);
+        }
         return v;
+    }
     if (typeof v === "number" || typeof v === "boolean")
         return String(v);
     // object / array → JSON
     return JSON.stringify(v);
 }
+/**
+ * 匹配 PG / ISO 8601 形态的日期时间字符串：
+ *   2026-04-29
+ *   2026-04-29 19:07:43           （PG 默认 timestamp 形态）
+ *   2026-04-29T19:07:43
+ *   2026-04-29T19:07:43.882+08:00
+ *   2026-04-29T19:07:43.882Z
+ * 时间部分 / 毫秒 / 时区可选。
+ */
+const ISO_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+// ──────────────────────────────────────────────────────────────────────
+// db sql 错误富化：识别 PG 常见报错形态 → fuzzy match → 加 did-you-mean hint
+// ──────────────────────────────────────────────────────────────────────
+const SYNTAX_RE = /syntax error at or near "([^"]+)"/i;
+const RELATION_RE = /relation "([^"]+)" does not exist/i;
+const COLUMN_RE = /column "([^"]+)"(?: of relation "([^"]+)")? does not exist/i;
+/**
+ * 在错误抛出前富化 next_actions（最多 1 条 hint），按 PG 报错形态分发：
+ *
+ *   表 / 列不存在路径：
+ *     - `column "X" of relation "Y" does not exist`     → 在 Y 表的列里 fuzzy
+ *     - `column "X" does not exist`（未指定表）         → 跨表所有列合集 fuzzy
+ *     - `relation "X" does not exist`                   → 在所有表名里 fuzzy
+ *
+ *   语法错误路径（`syntax error at or near "X"`）三条互斥子路径：
+ *     a. X 字面就是保留字（用户拿 keyword 当标识符，如 `FROM order`，
+ *        但 `order` 是 PG 保留字）→ 当作"想引用的表名"，远程 schema fuzzy。
+ *        **不要建议 keyword 自己**，那只是把用户输入大写返还，毫无价值。
+ *     b. X 接近某 keyword（典型拼写错误，如 SELCT）→ suggest keyword
+ *     c. X 是数字 / 标点（如 `LIMITT 1` 报错点到 `1`）→ fallback 扫整段
+ *        SQL 找看似拼错的 keyword token
+ *
+ * 任一环节失败（pattern 不匹配 / 远程拉表失败 / 没 fuzzy 候选）都静默吞掉，
+ * 不破坏原始错误信息——原则："只在我们高置信能帮上忙时才插嘴"。
+ */
+async function enrichSqlError(err, ctx) {
+    if (!(err instanceof error_1.AppError))
+        return;
+    const msg = err.message;
+    // ── 表 / 列不存在路径 ──
+    // 注意：列报错 'column "X" of relation "Y"' 也含 'relation "Y"' 子串，
+    // 会同时命中 RELATION_RE。先 colMatch（更精确），命中后不再走 relation 分支。
+    const colMatch = COLUMN_RE.exec(msg);
+    const relMatch = colMatch ? null : RELATION_RE.exec(msg);
+    if (relMatch || colMatch) {
+        const tableMap = await loadTableMap(ctx);
+        if (!tableMap)
+            return;
+        if (relMatch) {
+            enrichRelationNotExist(err, relMatch[1], tableMap);
+        }
+        else if (colMatch) {
+            enrichColumnNotExist(err, colMatch, tableMap);
+        }
+        return;
+    }
+    // ── 语法错误路径 ──
+    const kwMatch = SYNTAX_RE.exec(msg);
+    if (!kwMatch)
+        return;
+    const token = kwMatch[1];
+    const upper = token.toUpperCase();
+    // 子路径 a：token 字面就是 keyword → 用户拿保留字当标识符
+    if (sql_keywords_1.SQL_KEYWORDS.includes(upper)) {
+        const tableMap = await loadTableMap(ctx);
+        if (!tableMap)
+            return;
+        const guess = (0, fuzzy_match_1.suggest)(token, Object.keys(tableMap));
+        if (guess) {
+            err.next_actions.push(`Did you mean table '${guess}'? '${token}' is a reserved keyword; ` +
+                `quote it as "${token}" if you really mean a table named '${token}'.`);
+        }
+        return;
+    }
+    // 子路径 b：token 接近 keyword（拼写错误）
+    const guess = (0, fuzzy_match_1.suggest)(upper, sql_keywords_1.SQL_KEYWORDS);
+    if (guess && guess !== upper) {
+        err.next_actions.push(`Check SQL keyword spelling. Did you mean "${guess}"?`);
+        return;
+    }
+    // 子路径 c：PG 错误位置点到了下一个 token（如 `LIMITT 1` → 报错指向 "1"），
+    //          扫整段 SQL 找看似拼错的 keyword
+    const typo = findKeywordTypo(ctx.sql);
+    if (typo) {
+        err.next_actions.push(`Check SQL keyword spelling. '${typo.input}' looks like '${typo.suggest}'.`);
+    }
+}
+/** 远程拉一次 schema 并扁平化为 `tableName → fieldName[]`。失败返 null（调用方静默不加 hint）。 */
+async function loadTableMap(ctx) {
+    try {
+        const resp = await api.db.getSchema({
+            appId: ctx.appId,
+            format: "schema",
+            dbBranch: ctx.env,
+        });
+        return extractTableFieldMap(resp.schema);
+    }
+    catch {
+        return null;
+    }
+}
+function enrichRelationNotExist(err, relation, tableMap) {
+    const guess = (0, fuzzy_match_1.suggest)(relation, Object.keys(tableMap));
+    err.next_actions.push(guess
+        ? `Did you mean '${guess}'? Run \`miaoda db schema list\` to see all tables.`
+        : "Run `miaoda db schema list` to see all tables.");
+}
+function enrichColumnNotExist(err, colMatch, tableMap) {
+    const colName = colMatch[1];
+    // TS RegExpMatchArray 数字索引类型 = string，但 optional capture group `(...)?`
+    // 没匹配时运行时返 undefined；as cast 把这个事实告诉类型系统。
+    const relation = colMatch[2];
+    const relationCols = relation !== undefined ? tableMap[relation] : undefined;
+    if (relation !== undefined && relationCols !== undefined) {
+        // 指定了表 → 在该表的列里找
+        const guess = (0, fuzzy_match_1.suggest)(colName, relationCols);
+        err.next_actions.push(guess
+            ? `Did you mean column '${guess}' in table '${relation}'?`
+            : `Run \`miaoda db schema get ${relation}\` to see all columns.`);
+        return;
+    }
+    // 没指定表（CTE / 别名 / 子查询 / 单表 SELECT 但 PG 报错没带 relation 等场景）
+    // → 跨表所有列合集 fuzzy；没命中也给一句通用 hint，让用户知道下一步去哪查。
+    const allCols = Array.from(new Set(Object.values(tableMap).flat()));
+    const guess = (0, fuzzy_match_1.suggest)(colName, allCols);
+    err.next_actions.push(guess
+        ? `Did you mean '${guess}'? Run \`miaoda db schema get <table>\` to see columns.`
+        : "Run `miaoda db schema get <table>` to see all columns.");
+}
+/**
+ * 扫整段 SQL 找一个看似"拼错的关键字"token：纯字母 + 长度 ≥ 3 + 不是已知 keyword
+ * + fuzzy 命中某个 keyword（且距离 > 0）。返第一个命中的 token。
+ *
+ * 用于 `syntax error at or near "<X>"` 的 X 是数字 / 标点的兜底场景——例如
+ * `... LIMITT 1` 报错点到 `1`，但用户真正的拼写错误在 LIMITT。
+ *
+ * 阈值复用 suggest()，候选词越短匹配越严，避免把 `userid` / `usrname` 这种
+ * 用户标识符误抓为关键字 typo。
+ */
+function findKeywordTypo(sql) {
+    const tokens = sql.split(/[\s,;()'"`*=<>+\-./]+/).filter((t) => /^[A-Za-z_]{3,}$/.test(t));
+    for (const tok of tokens) {
+        const upper = tok.toUpperCase();
+        if (sql_keywords_1.SQL_KEYWORDS.includes(upper))
+            continue; // 写对的关键字
+        const guess = (0, fuzzy_match_1.suggest)(upper, sql_keywords_1.SQL_KEYWORDS);
+        if (guess && guess !== upper) {
+            return { input: tok, suggest: guess };
+        }
+    }
+    return null;
+}
+/** 从 InnerSchemaRespVO 提取 `tableName → fieldName[]` 映射，扁平化 tables/views/mvs 三池。 */
+function extractTableFieldMap(s) {
+    const out = {};
+    if (!s)
+        return out;
+    const pools = [s.tables?.data, s.views?.data, s.materializedViews?.data];
+    for (const pool of pools) {
+        if (!pool)
+            continue;
+        for (const t of pool) {
+            out[t.tableName] = (t.fields ?? []).map((f) => f.fieldName);
+        }
+    }
+    return out;
+}
+/**
+ * 多语句 SQL 失败时把服务端透传的 partial_results 包装成 PRD 期望形态：
+ *   - 用现有 toMultiElement 把每条 SQLExecuteResult 转成 `{command, ...}` 元素，
+ *     与正常 multi-statement 成功路径的 data[] 结构完全一致
+ *   - 推断 rolled_back：扫 completed 数组里 BEGIN/COMMIT/ROLLBACK 计数；失败时
+ *     还在 user tx 内 ⇒ 服务端 closeUserTxIfOpen 已发 ROLLBACK，标 true
+ *   - rolled_back=true 时给 next_actions 追加一句 spec 文案
+ *   - pretty 模式（非 JSON）把 `Statement N: ✓ ... / K: ✗ ...` 立即打到 stderr，
+ *     与 emitError 的 Error/hint 行连成一段 PRD 期望的 multi-statement 报告
+ */
+function enrichMultiStatementError(err, sql) {
+    if (!(err instanceof error_1.AppError))
+        return;
+    // 用 SQL 文本判断是否多语句，而不是 partial.length——第一条就失败时
+    // partial_results=[]，但仍需输出统一的多语句 envelope 字段保持格式一致。
+    const total = countStatements(sql);
+    if (total <= 1)
+        return;
+    const partial = Array.isArray(err.partial_results)
+        ? err.partial_results
+        : [];
+    const completed = partial.map((r) => toMultiElement((0, index_1.parseSqlResult)(r)));
+    err.completed = completed;
+    err.rolled_back = inferRolledBack(completed);
+    err.total_statements = total;
+    // pretty 模式（非 JSON）打 per-statement breakdown 到 stderr
+    if (!(0, output_1.isJsonMode)()) {
+        writeMultiStatementBreakdown(err, completed);
+    }
+    // rolled_back=true 时追加 spec hint："Transaction rolled back; no changes persisted."
+    if (err.rolled_back) {
+        err.next_actions.push("Transaction rolled back; no changes persisted.");
+    }
+}
+/**
+ * 推断本次多语句执行最终是否处于"事务被回滚"状态：
+ *   遍历 completed[] 数组，BEGIN +1 / COMMIT|ROLLBACK -1；
+ *   失败时 depth > 0 → 用户事务还开着 → 服务端 closeUserTxIfOpen 发了 ROLLBACK
+ *   失败时 depth = 0 → 失败语句在 autocommit 模式 → 已成功的 statement 真实落库
+ */
+function inferRolledBack(completed) {
+    let depth = 0;
+    for (const e of completed) {
+        if (e.command === "BEGIN")
+            depth++;
+        else if (e.command === "COMMIT" || e.command === "ROLLBACK")
+            depth--;
+    }
+    return depth > 0;
+}
+/**
+ * 数 SQL 里有几条独立语句：先去掉单 / 双引号字面量（防止 'a;b' 里的分号被算成
+ * 分隔符），再按分号 split，过滤空条。CLI 用户场景几乎都是简单 SQL，不处理
+ * dollar-quoted（$$..$$）等高级形态——估错 ±1 不影响 hint 可读性。
+ */
+function countStatements(sql) {
+    const stripped = sql.replace(/'(?:''|[^'])*'/g, "''").replace(/"(?:""|[^"])*"/g, '""');
+    return stripped.split(/;+/).filter((s) => s.trim().length > 0).length;
+}
+/**
+ * 写 `Statement N: ✓ ... / Statement K: ✗ ...` 到 stderr，对齐 PRD spec 的
+ * 多语句失败 pretty 输出形态。
+ */
+function writeMultiStatementBreakdown(err, completed) {
+    const tty = (0, render_1.isStdoutTty)();
+    const lines = [];
+    for (let i = 0; i < completed.length; i++) {
+        const e = completed[i];
+        const verb = e.command === "BEGIN" || e.command === "COMMIT" || e.command === "ROLLBACK"
+            ? e.command
+            : describeCompleted(e);
+        lines.push(`Statement ${String(i + 1)}: ${tty ? colors_1.c.success("✓ ") : "✓ "}${verb}`);
+    }
+    // 失败那条
+    const failedIdx = err.statement_index ?? completed.length;
+    lines.push(`Statement ${String(failedIdx + 1)}: ${tty ? colors_1.c.fail("✗ ") : "✗ "}${err.message}`);
+    process.stderr.write(lines.join("\n") + "\n\n");
+}
+/** completed 单条结果的人类可读描述（用于 stderr breakdown 行尾）。 */
+function describeCompleted(e) {
+    const r = e;
+    if (r.command === "SELECT" && Array.isArray(r.rows)) {
+        return `SELECT (${String(r.rows.length)} row${r.rows.length === 1 ? "" : "s"})`;
+    }
+    if (typeof r.rows_affected === "number") {
+        const verb = dmlVerb(r.command);
+        return `${String(r.rows_affected)} row${r.rows_affected === 1 ? "" : "s"} ${verb}`;
+    }
+    return `${r.command} executed`;
+}

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/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; } });

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/quota.js

@@ -0,0 +1,66 @@
+"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.handleFileQuota = handleFileQuota;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+async function handleFileQuota(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const data = await api.file.getStorageQuota({ appId });
+    if ((0, output_1.isJsonMode)()) {
+        // 配额未对接（storageQuotaBytes=0）时，quota / usage_percent 字段都不输出
+        const out = {
+            storageUsedBytes: data.storageUsedBytes,
+            files: data.files,
+        };
+        if (data.storageQuotaBytes > 0) {
+            out.storageQuotaBytes = data.storageQuotaBytes;
+            out.usagePercent = data.usagePercent;
+        }
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(out));
+        return;
+    }
+    // PRD：单行 "Storage: 150 MB / 1 GB (15%)"；配额未对接时只显示 used
+    const tty = (0, render_1.isStdoutTty)();
+    const storageLine = data.storageQuotaBytes > 0
+        ? `${(0, render_1.formatSize)(data.storageUsedBytes)} / ${(0, render_1.formatSize)(data.storageQuotaBytes)} (${data.usagePercent.toFixed(1)}%)`
+        : (0, render_1.formatSize)(data.storageUsedBytes);
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ["Storage", storageLine],
+        ["Files", String(data.files)],
+    ], tty));
+}

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`);