@lark-apaas/miaoda-cli 0.1.3 → 0.1.4

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

@@ -64,7 +64,7 @@ async function handleDbSql(query, opts) {
     const appId = opts.appId;
     const sql = await readSql(query);
     if (!sql.trim()) {
-        throw new error_1.AppError("ARGS_INVALID", "Empty SQL (no inline query and stdin is empty)");
+        throw new error_1.AppError('ARGS_INVALID', 'Empty SQL (no inline query and stdin is empty)');
     }
     let results;
     try {
@@ -86,7 +86,7 @@ async function handleDbSql(query, opts) {
             (0, output_1.emit)({ data: [] });
             return;
         }
-        (0, output_1.emit)("✓ No results");
+        (0, output_1.emit)((0, render_1.isStdoutTty)() ? colors_1.c.success('✓ No results') : 'OK No results');
         return;
     }
     if (results.length === 1) {
@@ -121,7 +121,7 @@ async function handleDbSql(query, opts) {
  * statement 都执行成功，无需再校验逐条状态。
  */
 /** agent runtime 中固定的项目根目录；放在此处便于以后调整。 */
-const AGENT_PROJECT_ROOT = "/home/gem/workspace/code";
+const AGENT_PROJECT_ROOT = '/home/gem/workspace/code';
 /** drain 子进程 pipe stream：默认静默模式下消费 chunk 防止缓冲区反压。 */
 function drainChunk(_chunk) {
     // 显式接 chunk 参数让 ESLint 不再当成 empty function；不做任何处理
@@ -131,7 +131,7 @@ async function maybeSyncAgentSchema(results) {
         return;
     const projectRoot = await resolveAgentProjectRoot();
     if (!projectRoot) {
-        (0, logger_1.debug)("[db sql] agent project root not found or missing gen:db-schema script, skip schema sync");
+        (0, logger_1.debug)('[db sql] agent project root not found or missing gen:db-schema script, skip schema sync');
         return;
     }
     const verbose = (0, config_1.getConfig)().verbose;
@@ -140,8 +140,8 @@ async function maybeSyncAgentSchema(results) {
     (0, logger_1.debug)(`[db sql] DDL detected, running \`npm run gen:db-schema\` in ${projectRoot}`);
     try {
         await new Promise((resolve) => {
-            const proc = (0, node_child_process_1.spawn)("npm", ["run", "gen:db-schema"], {
-                stdio: ["ignore", "pipe", "pipe"],
+            const proc = (0, node_child_process_1.spawn)('npm', ['run', 'gen:db-schema'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
                 cwd: projectRoot,
             });
             // --verbose：实时透传到 stderr 看进度；默认完全静默丢弃。
@@ -152,15 +152,15 @@ async function maybeSyncAgentSchema(results) {
                 proc.stderr.pipe(process.stderr);
             }
             else {
-                proc.stdout.on("data", drainChunk);
-                proc.stderr.on("data", drainChunk);
+                proc.stdout.on('data', drainChunk);
+                proc.stderr.on('data', drainChunk);
             }
             let timedOut = false;
             const timer = setTimeout(() => {
                 timedOut = true;
-                proc.kill("SIGKILL");
+                proc.kill('SIGKILL');
             }, TIMEOUT_MS);
-            proc.on("close", (code) => {
+            proc.on('close', (code) => {
                 clearTimeout(timer);
                 if (timedOut) {
                     (0, logger_1.debug)(`[db sql] gen:db-schema timed out after ${String(TIMEOUT_MS / 1000)}s, killed`);
@@ -169,11 +169,11 @@ async function maybeSyncAgentSchema(results) {
                     (0, logger_1.debug)(`[db sql] gen:db-schema exited with code ${String(code)}`);
                 }
                 else {
-                    (0, logger_1.debug)("[db sql] gen:db-schema completed");
+                    (0, logger_1.debug)('[db sql] gen:db-schema completed');
                 }
                 resolve();
             });
-            proc.on("error", (err) => {
+            proc.on('error', (err) => {
                 clearTimeout(timer);
                 (0, logger_1.debug)(`[db sql] gen:db-schema spawn error: ${err.message}`);
                 resolve();
@@ -193,10 +193,10 @@ async function maybeSyncAgentSchema(results) {
  */
 async function resolveAgentProjectRoot() {
     try {
-        const pkgPath = node_path_1.default.join(AGENT_PROJECT_ROOT, "package.json");
-        const raw = await node_fs_1.promises.readFile(pkgPath, "utf8");
+        const pkgPath = node_path_1.default.join(AGENT_PROJECT_ROOT, 'package.json');
+        const raw = await node_fs_1.promises.readFile(pkgPath, 'utf8');
         const pkg = JSON.parse(raw);
-        if (pkg.scripts?.["gen:db-schema"])
+        if (pkg.scripts?.['gen:db-schema'])
             return AGENT_PROJECT_ROOT;
     }
     catch {
@@ -206,7 +206,7 @@ async function resolveAgentProjectRoot() {
 }
 /** 是否有任意一条 statement 是 DDL（CREATE / ALTER / DROP / GRANT / TRUNCATE / COMMENT 等）。 */
 function hasDdl(results) {
-    return results.some((r) => (0, index_1.parseSqlResult)(r).kind === "ddl");
+    return results.some((r) => (0, index_1.parseSqlResult)(r).kind === 'ddl');
 }
 /** 读取 stdin 并返回完整 SQL 文本（stdin 不是 TTY 即认为被 pipe）。 */
 async function readSql(inline) {
@@ -214,17 +214,17 @@ async function readSql(inline) {
         return inline;
     const stdin = process.stdin;
     if (stdin.isTTY)
-        return "";
+        return '';
     return new Promise((resolve, reject) => {
-        let data = "";
-        process.stdin.setEncoding("utf8");
-        process.stdin.on("data", (chunk) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
             data += chunk;
         });
-        process.stdin.on("end", () => {
+        process.stdin.on('end', () => {
             resolve(data);
         });
-        process.stdin.on("error", reject);
+        process.stdin.on('error', reject);
     });
 }
 function renderSingle(raw) {
@@ -234,9 +234,9 @@ function renderSingle(raw) {
         (0, output_1.emit)(toJson(parsed));
         return;
     }
-    if (parsed.kind === "select") {
+    if (parsed.kind === 'select') {
         if (parsed.rows.length === 0) {
-            (0, output_1.emit)("(0 rows)");
+            (0, output_1.emit)('(0 rows)');
             return;
         }
         const cols = collectColumns(parsed.rows);
@@ -244,22 +244,22 @@ function renderSingle(raw) {
         (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(cols, rows) : (0, render_1.renderTsv)(cols, rows));
         return;
     }
-    if (parsed.kind === "dml") {
+    if (parsed.kind === 'dml') {
         const verb = dmlVerb(parsed.sqlType);
         (0, output_1.emit)(tty
-            ? colors_1.c.success(`✓ ${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 ? colors_1.c.success("✓ 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") {
+    if (parsed.kind === 'select') {
         // PRD 单 SELECT：data 直接是行数组（按 --json 字段投影裁剪）
         return { data: projectRows(parsed.rows) };
     }
-    if (parsed.kind === "dml") {
+    if (parsed.kind === 'dml') {
         // PRD 单 DML：data = {command, rows_affected}
         return {
             data: {
@@ -277,10 +277,10 @@ function toJson(parsed) {
  * {command:"SELECT", rows:[...]}（PRD 约定，避免数组里嵌套数组造成歧义）。
  */
 function toMultiElement(parsed) {
-    if (parsed.kind === "select") {
-        return { command: "SELECT", rows: projectRows(parsed.rows) };
+    if (parsed.kind === 'select') {
+        return { command: 'SELECT', rows: projectRows(parsed.rows) };
     }
-    if (parsed.kind === "dml") {
+    if (parsed.kind === 'dml') {
         return { command: parsed.sqlType, rows_affected: parsed.affectedRows };
     }
     // DDL：用后端给的细粒度 command
@@ -306,10 +306,10 @@ function projectRows(rows) {
 /** 读取 --json [fields]：返回字段列表；boolean true 或 undefined 返回 null（不裁剪）。 */
 function parseJsonFields() {
     const v = (0, config_1.getConfig)().json;
-    if (typeof v !== "string" || v === "")
+    if (typeof v !== 'string' || v === '')
         return null;
     return v
-        .split(",")
+        .split(',')
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
@@ -320,9 +320,9 @@ function renderMultiPretty(results) {
     for (let i = 0; i < results.length; i++) {
         const parsed = (0, index_1.parseSqlResult)(results[i]);
         const idx = i + 1;
-        if (parsed.kind === "select") {
+        if (parsed.kind === 'select') {
             const n = parsed.rows.length;
-            lines.push(`Statement ${String(idx)}: SELECT (${String(n)} row${n === 1 ? "" : "s"})`);
+            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((col) => formatCell(r[col], tty)));
@@ -330,37 +330,37 @@ function renderMultiPretty(results) {
             }
             // 块间空行（最后一条不留）
             if (i < results.length - 1)
-                lines.push("");
+                lines.push('');
             continue;
         }
-        if (parsed.kind === "dml") {
+        if (parsed.kind === 'dml') {
             const verb = dmlVerb(parsed.sqlType);
             const n = parsed.affectedRows;
-            const body = `${String(n)} row${n === 1 ? "" : "s"} ${verb}`;
-            lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success("✓ " + body) : body}`);
+            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 ? colors_1.c.success("✓ DDL executed") : "DDL executed"}`);
+        lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success('✓ DDL executed') : 'DDL executed'}`);
     }
     // 汇总行：所有 statement 都跑完了
     lines.push(tty
         ? colors_1.c.success(`✓ ${String(results.length)} statements executed`)
         : `OK ${String(results.length)} statements executed`);
-    (0, output_1.emit)(lines.join("\n"));
+    (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'; // 未识别子类的兜底
     }
 }
 /** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */
@@ -380,9 +380,9 @@ function collectColumns(rows) {
  */
 function formatCell(v, tty) {
     if (v === null || v === undefined) {
-        return tty ? colors_1.c.muted("NULL") : "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))) {
@@ -390,7 +390,7 @@ function formatCell(v, tty) {
         }
         return v;
     }
-    if (typeof v === "number" || typeof v === "boolean")
+    if (typeof v === 'number' || typeof v === 'boolean')
         return String(v);
     // object / array → JSON
     return JSON.stringify(v);
@@ -487,7 +487,7 @@ async function loadTableMap(ctx) {
     try {
         const resp = await api.db.getSchema({
             appId: ctx.appId,
-            format: "schema",
+            format: 'schema',
             dbBranch: ctx.env,
         });
         return extractTableFieldMap(resp.schema);
@@ -500,7 +500,7 @@ 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.");
+        : 'Run `miaoda db schema list` to see all tables.');
 }
 function enrichColumnNotExist(err, colMatch, tableMap) {
     const colName = colMatch[1];
@@ -522,7 +522,7 @@ function enrichColumnNotExist(err, colMatch, tableMap) {
     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.");
+        : 'Run `miaoda db schema get <table>` to see all columns.');
 }
 /**
  * 扫整段 SQL 找一个看似"拼错的关键字"token：纯字母 + 长度 ≥ 3 + 不是已知 keyword
@@ -593,7 +593,7 @@ function enrichMultiStatementError(err, sql) {
     }
     // 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.");
+        err.next_actions.push('Transaction rolled back; no changes persisted.');
     }
 }
 /**
@@ -605,9 +605,9 @@ function enrichMultiStatementError(err, sql) {
 function inferRolledBack(completed) {
     let depth = 0;
     for (const e of completed) {
-        if (e.command === "BEGIN")
+        if (e.command === 'BEGIN')
             depth++;
-        else if (e.command === "COMMIT" || e.command === "ROLLBACK")
+        else if (e.command === 'COMMIT' || e.command === 'ROLLBACK')
             depth--;
     }
     return depth > 0;
@@ -630,25 +630,25 @@ function writeMultiStatementBreakdown(err, completed) {
     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"
+        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}`);
+        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");
+    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 (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") {
+    if (typeof r.rows_affected === 'number') {
         const verb = dmlVerb(r.command);
-        return `${String(r.rows_affected)} row${r.rows_affected === 1 ? "" : "s"} ${verb}`;
+        return `${String(r.rows_affected)} row${r.rows_affected === 1 ? '' : 's'} ${verb}`;
     }
     return `${r.command} executed`;
 }

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

@@ -43,7 +43,7 @@ const format_1 = require("./format");
 async function handleDeploy(opts) {
     const appID = opts.appId;
     const resp = await api.deploy.createRelease({ appID, branch: opts.branch });
-    const pipelineTaskID = resp.pipelineTaskID ?? "";
+    const pipelineTaskID = resp.pipelineTaskID ?? '';
     if (!opts.wait) {
         if (!(0, output_1.isJsonMode)()) {
             process.stdout.write(`✓ Deployment triggered. (deploy-id: ${pipelineTaskID})\n`);
@@ -66,14 +66,14 @@ async function handleDeploy(opts) {
     });
     if (!(0, output_1.isJsonMode)()) {
         if (detail.status === index_1.NodeStatus.SUCCESS) {
-            process.stdout.write("✓ 发布成功\n");
+            process.stdout.write('✓ 发布成功\n');
         }
         else if (detail.status === index_1.NodeStatus.FAILED) {
-            process.stdout.write("✗ 发布失败\n");
+            process.stdout.write('✗ 发布失败\n');
             process.stdout.write(`  hint: Run \`miaoda deploy error-log ${pipelineTaskID}\` to view error logs\n`);
         }
         else {
-            process.stdout.write("• 发布已取消\n");
+            process.stdout.write('• 发布已取消\n');
         }
     }
     (0, output_1.emit)({

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

@@ -42,7 +42,7 @@ const helpers_1 = require("./helpers");
 /** miaoda deploy error-log <deploy-id> */
 async function handleDeployErrorLog(opts) {
     if (!opts.deployId)
-        (0, args_1.failArgs)("<deploy-id> 必填");
+        (0, args_1.failArgs)('<deploy-id> 必填');
     const appID = opts.appId;
     (0, helpers_1.parseDeployId)(opts.deployId); // 仅校验数字形式；URL 直接用原字符串
     const instanceID = opts.deployId;

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

@@ -54,7 +54,7 @@ const DEPLOY_GET_LOOKUP_LIMIT = 500;
  */
 async function handleDeployGet(opts) {
     if (!opts.deployId)
-        (0, args_1.failArgs)("<deploy-id> 必填");
+        (0, args_1.failArgs)('<deploy-id> 必填');
     const appID = opts.appId;
     const deployId = (0, helpers_1.parseDeployId)(opts.deployId);
     const resp = await api.deploy.listPipelineInstances({
@@ -63,8 +63,8 @@ async function handleDeployGet(opts) {
     });
     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 是否在最近窗口内"],
+        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/polling.js

@@ -74,7 +74,7 @@ async function waitForPipeline(opts) {
     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()
+        ? (0, ora_1.default)({ text: '等待调度', spinner: 'dots', stream: process.stdout }).start()
         : null;
     try {
         for (;;) {
@@ -89,7 +89,7 @@ async function waitForPipeline(opts) {
                 return detail;
             }
             if (now() - start >= timeoutMs) {
-                throw new error_1.AppError("DEPLOY_TIMEOUT", `轮询发布状态超时（${String(opts.timeoutSec)}s）`, {
+                throw new error_1.AppError('DEPLOY_TIMEOUT', `轮询发布状态超时（${String(opts.timeoutSec)}s）`, {
                     retryable: true,
                     next_actions: [
                         `Run \`miaoda deploy get <deploy-id>\` 查看最新状态`,
@@ -122,7 +122,7 @@ function advanceProgress(detail, printed, spinner) {
         printed.add(stage.id);
     }
     const running = stages.find((s) => s.status === index_1.NodeStatus.RUNNING);
-    const text = running ? `${running.name} 执行中` : "等待调度";
+    const text = running ? `${running.name} 执行中` : '等待调度';
     if (spinner.isSpinning) {
         spinner.text = text;
     }
@@ -131,13 +131,13 @@ function advanceProgress(detail, printed, spinner) {
     }
 }
 function normalizePipelineInstance(resp) {
-    const keyedDetail = readPipelineDetail(resp, "pipelineInstanceDetail") ?? readPipelineDetail(resp, "detail");
+    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，并联系平台排查响应结构"],
+    throw new error_1.AppError('DEPLOY_RESPONSE_INVALID', '发布状态响应缺少 pipeline detail', {
+        next_actions: ['使用 --verbose 重试以查看请求 logid，并联系平台排查响应结构'],
     });
 }
 function readPipelineDetail(resp, key) {
@@ -147,16 +147,16 @@ function readPipelineDetail(resp, key) {
     return isPipelineInstance(detail) ? detail : undefined;
 }
 function isPipelineInstance(value) {
-    if (typeof value !== "object" || value === null)
+    if (typeof value !== 'object' || value === null)
         return false;
     const item = value;
-    return typeof item.status === "number";
+    return typeof item.status === 'number';
 }
 function stageSymbol(stage) {
-    return stage.status === index_1.NodeStatus.SUCCESS ? "✓" : stage.status === index_1.NodeStatus.FAILED ? "✗" : "•";
+    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 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();
+    return `${stage.name}${cost ? ` ${cost}` : ''} ${status}`.trim();
 }

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

@@ -56,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);
@@ -70,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,
         });
@@ -111,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 形态或
@@ -134,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);
     }
@@ -187,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);
@@ -198,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()) {

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