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

package/dist/api/db/sql-keywords.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQL_KEYWORDS = void 0;
+/**
+ * 常见 PG SQL 关键字白名单，用于 db sql 拼写错误的 did-you-mean 提示。
+ *
+ * # 选词原则
+ *
+ * PG 的关键字总数 700+（见 [pg_keyword 系统视图]），但 CLI 用户实际打错的几乎
+ * 都集中在核心动词 / 子句 / 类型 / 事务关键字。这里**少而精**，约 70 个：
+ *
+ *   - DML 动词：SELECT / INSERT / UPDATE / DELETE / MERGE
+ *   - 子句：FROM / WHERE / JOIN / GROUP / ORDER / HAVING / LIMIT / ...
+ *   - 操作符词：AND / OR / NOT / IN / IS / NULL / LIKE / ...
+ *   - DDL：CREATE / ALTER / DROP / TABLE / INDEX / VIEW / ...
+ *   - 约束：PRIMARY / UNIQUE / FOREIGN / REFERENCES / CHECK / DEFAULT / ...
+ *   - 事务：BEGIN / COMMIT / ROLLBACK / SAVEPOINT / TRANSACTION
+ *   - 控制：IF / EXISTS / CASE / WHEN / THEN / ELSE / END / WITH / ...
+ *
+ * **不要往里加冷僻关键字**——候选集越大，短词越容易 false-positive 错配。
+ */
+exports.SQL_KEYWORDS = [
+    // DML 动词
+    "SELECT",
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "MERGE",
+    // FROM / JOIN 系列
+    "FROM",
+    "WHERE",
+    "JOIN",
+    "LEFT",
+    "RIGHT",
+    "INNER",
+    "OUTER",
+    "FULL",
+    "CROSS",
+    "USING",
+    // 聚合 / 排序 / 分页
+    "GROUP",
+    "ORDER",
+    "BY",
+    "HAVING",
+    "LIMIT",
+    "OFFSET",
+    "FETCH",
+    // 集合操作
+    "UNION",
+    "INTERSECT",
+    "EXCEPT",
+    "DISTINCT",
+    "ALL",
+    // 别名 / 关联
+    "AS",
+    "ON",
+    // 操作符词
+    "AND",
+    "OR",
+    "NOT",
+    "IN",
+    "IS",
+    "NULL",
+    "TRUE",
+    "FALSE",
+    "BETWEEN",
+    "LIKE",
+    "ILIKE",
+    "SIMILAR",
+    // DDL
+    "CREATE",
+    "ALTER",
+    "DROP",
+    "TRUNCATE",
+    "RENAME",
+    "TABLE",
+    "INDEX",
+    "VIEW",
+    "DATABASE",
+    "SCHEMA",
+    "COLUMN",
+    "CONSTRAINT",
+    "SEQUENCE",
+    // 约束
+    "PRIMARY",
+    "KEY",
+    "FOREIGN",
+    "REFERENCES",
+    "UNIQUE",
+    "CHECK",
+    "DEFAULT",
+    // 写入
+    "VALUES",
+    "SET",
+    "RETURNING",
+    "INTO",
+    // 事务
+    "BEGIN",
+    "COMMIT",
+    "ROLLBACK",
+    "SAVEPOINT",
+    "TRANSACTION",
+    // 控制流 / CTE
+    "IF",
+    "EXISTS",
+    "REPLACE",
+    "WITH",
+    "RECURSIVE",
+    "CASE",
+    "WHEN",
+    "THEN",
+    "ELSE",
+    "END",
+    // 类型转换 / 时间提取
+    "CAST",
+    "EXTRACT",
+    // 排序方向
+    "ASC",
+    "DESC",
+    "NULLS",
+    "FIRST",
+    "LAST",
+];

package/dist/api/file/api.js

@@ -8,6 +8,7 @@ exports.uploadFile = uploadFile;
 exports.signDownload = signDownload;
 exports.downloadFile = downloadFile;
 exports.deleteFiles = deleteFiles;
+exports.getStorageQuota = getStorageQuota;
 const error_1 = require("../../utils/error");
 const logger_1 = require("../../utils/logger");
 const client_1 = require("./client");
@@ -209,9 +210,7 @@ async function resolveInputs(opts) {
         return [];
     return Promise.all(opts.inputs.map((input) => {
         const kind = opts.forceAs ?? ((0, detect_1.looksLikePath)(input) ? "path" : "name");
-        return kind === "path"
-            ? resolveByPath(opts.appId, input)
-            : resolveByName(opts.appId, input);
+        return kind === "path" ? resolveByPath(opts.appId, input) : resolveByName(opts.appId, input);
     }));
 }
 /** path 输入：HEAD 判存在性，path 在 bucket 内 unique 无需反查。 */
@@ -297,14 +296,44 @@ async function preUpload(appId, req) {
     const body = await (0, client_1.doPost)(url, { bucketID: bucketId, appID: appId, ...req }, { errorContext: "pre-upload" });
     return extractEnvelope(body);
 }
+/**
+ * 调用 upload callback 拿到对象元数据。
+ *
+ * 网关 IDL 在 metadata 字段加了 api.response.converter = "decode"，正常路径下
+ * HTTP 响应里的 metadata 已经被网关从字符串解码成对象；这里两种形态都兼容：
+ *   - object → 直接当 CallbackObjectVO 用（网关解码场景）
+ *   - string → JSON.parse 出来用（后端原始形态 / 网关行为变化兜底）
+ *
+ * 解析失败 / metadata 缺失时返回空对象，由 uploadFile 用本地兜底字段填充。
+ */
 async function uploadCallback(appId, req) {
     const url = `/v1/storage/app/${encodeURIComponent(appId)}/object/callback`;
-    const body = await (0, client_1.doPost)(url, req, { errorContext: "upload callback" });
-    (0, client_1.ensureSuccess)(body);
+    const body = await (0, client_1.doPost)(url, req, {
+        errorContext: "upload callback",
+    });
+    const data = extractEnvelope(body);
+    const metadata = data.metadata;
+    if (!metadata) {
+        return {};
+    }
+    if (typeof metadata === "object") {
+        return metadata;
+    }
+    // string 形态兜底
+    try {
+        return JSON.parse(metadata);
+    }
+    catch (err) {
+        (0, logger_1.debug)(`upload callback metadata json parse failed: ${err instanceof Error ? err.message : String(err)}`);
+        return {};
+    }
 }
 /**
  * 上传文件（3 步：preUpload → PUT uploadURL → callback）。
  * PUT 步骤直接 fetch uploadURL（对象存储直传，绕开框架 HttpClient）。
+ *
+ * 注意：opts.remotePath 仅作为目录前缀传给服务端；最终对象 key 由服务端唯一生成
+ * （形如 "<前缀>/<16位ID>.<扩展名>"），从 preUpload 响应的 filePath 字段取回。
  */
 async function uploadFile(opts) {
     const pre = await preUpload(opts.appId, {
@@ -323,11 +352,15 @@ async function uploadFile(opts) {
         // 这里复制到独立 ArrayBuffer 以满足 lib.dom.d.ts 的 BodyInit 约束
         const ab = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
         const uploadStart = Date.now();
+        // Content-Disposition 用 attachment + filename 编码原始文件名。TOS 会把这个
+        // header 作为对象 metadata 存住，服务端 callback 阶段 HeadObject 读回并解析
+        // filename 写入 DB。我们要不传 header，服务端走兜底会把 storage key 当文件名。
         const res = await fetch(pre.uploadURL, {
             method: "PUT",
             headers: {
                 "Content-Type": opts.contentType,
                 "Content-Length": String(opts.fileSize),
+                "Content-Disposition": `attachment; filename="${sanitizeFileName(opts.fileName)}"`,
             },
             body: ab,
         });
@@ -345,34 +378,56 @@ async function uploadFile(opts) {
     if (!etag) {
         throw new error_1.AppError("FILE_UPLOAD_FAILED", "Upload PUT returned no ETag");
     }
-    // callback 失败仅 warning，文件已经上传到对象存储
+    // callback 返回服务端实际生成的对象元数据（filePath / file_name / download_url）。
+    // path 末段是平台生成的 16 位 GID，CLI 无法靠本地信息推断；callback 失败 /
+    // metadata.filePath 缺失时直接抛 FILE_UPLOAD_CALLBACK_INCOMPLETE：对象已落
+    // TOS（PUT 已成功 + ETag 拿到），但 CLI 拿不到真实 path。把 fileName 写到
+    // hint 里引导用户走 `file ls --name` 查实际 path，避免返一个假 path 让后续
+    // stat/download/rm 全部 FILE_NOT_FOUND。
+    let metadata;
     try {
-        await uploadCallback(opts.appId, { uploadID: pre.uploadID, eTag: etag });
+        metadata = await uploadCallback(opts.appId, { uploadID: pre.uploadID, eTag: etag });
     }
     catch (err) {
-        (0, logger_1.debug)(`upload callback failed: ${err instanceof Error ? err.message : String(err)}`);
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError("FILE_UPLOAD_CALLBACK_INCOMPLETE", `Upload callback failed: ${reason}; file may already exist in storage`, {
+            next_actions: [
+                `Run \`miaoda file ls --name ${opts.fileName}\` to locate the uploaded file.`,
+            ],
+        });
     }
-    const remotePath = opts.remotePath ?? `/${opts.fileName}`;
+    if (!metadata.filePath) {
+        throw new error_1.AppError("FILE_UPLOAD_CALLBACK_INCOMPLETE", "Upload callback returned no filePath; file may already exist in storage", {
+            next_actions: [
+                `Run \`miaoda file ls --name ${opts.fileName}\` to locate the uploaded file.`,
+            ],
+        });
+    }
+    const path = metadata.filePath.startsWith("/") ? metadata.filePath : "/" + metadata.filePath;
     const result = {
-        file_name: opts.fileName,
-        path: remotePath,
-        size: opts.fileSize,
-        type: opts.contentType,
+        // 优先取服务端 ObjectVO.name（来自 PUT 时带的 Content-Disposition），
+        // 与后续 file ls / file stat 返回的展示名保持一致；缺失时降级用本地 fileName。
+        file_name: metadata.name ?? opts.fileName,
+        path,
+        size: metadata.metadata?.contentLength ?? opts.fileSize,
+        type: metadata.metadata?.mimeType ?? opts.contentType,
     };
-    // 上传完成后补一次 stat，拿到后端返回的 download_url（preUpload/callback 都不返）
-    // 非关键路径：拿不到就降级，只是 JSON 输出里缺 download_url 字段
-    try {
-        const info = await statFile({ appId: opts.appId, filePath: remotePath });
-        if (info.download_url)
-            result.download_url = info.download_url;
-        if (info.file_name)
-            result.file_name = info.file_name;
-    }
-    catch (err) {
-        (0, logger_1.debug)(`post-upload stat failed: ${err instanceof Error ? err.message : String(err)}`);
+    if (metadata.downloadURL) {
+        result.download_url = metadata.downloadURL;
     }
     return result;
 }
+/**
+ * 把文件名清理成可安全放进 Content-Disposition `filename="..."` 的形态。
+ * 与 fullstack-plugin 的 sanitizeFileName 行为一致：
+ *   1. 去掉对 TOS / 文件系统不友好的字符 [: " \ / * ? < > | , ;]
+ *   2. encodeURIComponent 把非 ASCII（中文等）做百分号编码，保证 header 合法
+ *   3. 处理后为空时退回 "download_file" 兜底
+ */
+function sanitizeFileName(fileName) {
+    const illegalChars = /[:"\\/*?<>|,;]/g;
+    return encodeURIComponent(fileName.replace(illegalChars, "")) || "download_file";
+}
 // ── 预签下载 URL ──
 /**
  * 获取预签下载 URL。
@@ -465,3 +520,17 @@ async function deleteFiles(opts) {
     }
     return { deleted, failed };
 }
+// ── storage quota ──
+/**
+ * 后端：GET /v1/storage/app/{appId}/bucket/{bucketId}/quota
+ * 单 bucket 用量；StorageQuotaBytes 暂未对接，CLI 拿到 0 时按 "—" 渲染。
+ * bucketId 缺省时走默认 bucket（与 ls / stat / cp 等一致）。
+ */
+async function getStorageQuota(opts) {
+    const bucketId = opts.bucketId ?? (await (0, client_1.getDefaultBucketId)(opts.appId));
+    const url = `/v1/storage/app/${encodeURIComponent(opts.appId)}/bucket/${encodeURIComponent(bucketId)}/quota`;
+    const body = await (0, client_1.doGet)(url, {
+        errorContext: `fetch storage quota for app '${opts.appId}' bucket '${bucketId}'`,
+    });
+    return extractEnvelope(body);
+}

package/dist/api/file/client.js

@@ -22,11 +22,7 @@ function traceHttp(method, url, start, response, err) {
         const status = response?.status ?? 0;
         const logid = response?.headers?.get?.("x-tt-logid") ?? "-";
         if (err !== undefined) {
-            const errMsg = err instanceof Error
-                ? err.message
-                : typeof err === "string"
-                    ? err
-                    : JSON.stringify(err);
+            const errMsg = err instanceof Error ? err.message : typeof err === "string" ? err : JSON.stringify(err);
             (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid} err=${errMsg}`);
             return;
         }

package/dist/api/file/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
+exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.getStorageQuota = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "listFiles", { enumerable: true, get: function () { return api_1.listFiles; } });
 Object.defineProperty(exports, "statFile", { enumerable: true, get: function () { return api_1.statFile; } });
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function
 Object.defineProperty(exports, "deleteFiles", { enumerable: true, get: function () { return api_1.deleteFiles; } });
 Object.defineProperty(exports, "resolveInputs", { enumerable: true, get: function () { return api_1.resolveInputs; } });
 Object.defineProperty(exports, "parseTimeFilterMs", { enumerable: true, get: function () { return api_1.parseTimeFilterMs; } });
+Object.defineProperty(exports, "getStorageQuota", { enumerable: true, get: function () { return api_1.getStorageQuota; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "getDefaultBucketId", { enumerable: true, get: function () { return client_1.getDefaultBucketId; } });
 Object.defineProperty(exports, "resetBucketCache", { enumerable: true, get: function () { return client_1.resetBucketCache; } });

package/dist/api/file/parsers.js

@@ -16,11 +16,7 @@ function int(value) {
 function readSize(meta) {
     if (!meta)
         return 0;
-    const v = meta.size ??
-        meta.fileSize ??
-        meta.file_size ??
-        meta.contentLength ??
-        0;
+    const v = meta.size ?? meta.fileSize ?? meta.file_size ?? meta.contentLength ?? 0;
     return int(v);
 }
 /**

package/dist/api/plugin/api.js

@@ -38,7 +38,9 @@ async function getPluginVersion(pluginKey, requestedVersion) {
     const versions = await getPluginVersions([pluginKey], isLatest);
     const pluginVersions = versions[pluginKey];
     if (!pluginVersions || pluginVersions.length === 0) {
-        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, { next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"] });
+        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, {
+            next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"],
+        });
     }
     if (isLatest) {
         return pluginVersions[0];
@@ -53,7 +55,9 @@ async function getPluginVersion(pluginKey, requestedVersion) {
 function parsePluginKey(key) {
     const match = /^(@[^/]+)\/(.+)$/.exec(key);
     if (!match) {
-        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, { next_actions: ["插件 key 必须形如 @scope/name"] });
+        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, {
+            next_actions: ["插件 key 必须形如 @scope/name"],
+        });
     }
     return { scope: match[1], name: match[2] };
 }
@@ -91,7 +95,8 @@ async function withRetry(operation, description, maxRetries = MAX_RETRIES) {
             }
         }
     }
-    throw lastError ?? new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] });
+    throw (lastError ??
+        new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] }));
 }
 /** 插件缓存目录 */
 const PLUGIN_CACHE_DIR = "node_modules/.cache/miaoda-cli/plugins";

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

@@ -1,7 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDbCommands = registerDbCommands;
+const error_1 = require("../../../utils/error");
 const index_1 = require("../../../cli/handlers/db/index");
+function parsePositiveInt(raw) {
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 1) {
+        throw new error_1.AppError("ARGS_INVALID", `--limit must be a positive integer (got '${raw}')`);
+    }
+    return n;
+}
 function registerDbCommands(program) {
     const dbCmd = program
         .command("db")
@@ -179,6 +187,7 @@ Examples:
         .option("--format <fmt>", "导出格式 csv / json / sql，默认 csv（sql 输出 INSERT 语句，可用 db sql < file.sql 回放）")
         .option("-f, --file <path>", "输出文件路径，默认 <表名>.<格式>")
         .option("--limit <n>", "最多导出行数（不超过 5000）")
+        .option("--force", "输出文件已存在时覆盖（默认报错）")
         .action(async function (table) {
         await (0, index_1.handleDbDataExport)(table, this.optsWithGlobals());
     })
@@ -205,4 +214,133 @@ Examples:
   Error: Output file 'users.csv' already exists
     hint: Use -f to specify a different path, or --force to overwrite.
 `);
+    // ── changelog ──
+    dbCmd
+        .command("changelog")
+        .summary("查看 DDL 变更历史")
+        .description("列出 DDL 变更（CREATE / ALTER / DROP），支持按表、时间窗筛选与游标分页。")
+        .usage("[flags]")
+        .option("--table <name>", "只看某张表的 DDL 变更")
+        .option("--since <time>", "起始时间（含），相对 1h/2d / 日期 YYYY-MM-DD / ISO 8601")
+        .option("--until <time>", "结束时间（含），同 --since 格式")
+        .option("--limit <n>", "单次返回上限（默认 20）", parsePositiveInt, 20)
+        .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
+        .option("--all", "自动翻页直到取完所有记录")
+        .action(async function () {
+        await (0, index_1.handleDbChangelog)(this.optsWithGlobals());
+    });
+    // ── audit ──
+    const auditCmd = dbCmd
+        .command("audit")
+        .summary("表级数据审计开关与查询")
+        .description("配置表的数据审计 (enable/disable/retention)，查询审计状态与日志。")
+        .usage("<command> [flags]");
+    auditCmd.action(() => {
+        auditCmd.outputHelp();
+    });
+    auditCmd
+        .command("status")
+        .summary("查看审计开关状态（不传 table 返列表）")
+        .usage("[table] [flags]")
+        .argument("[table]", "表名；省略时返所有已配置审计的表")
+        .action(async function (table) {
+        await (0, index_1.handleDbAuditStatus)(table, this.optsWithGlobals());
+    });
+    auditCmd
+        .command("enable")
+        .summary("启用表审计")
+        .usage("<table> [flags]")
+        .argument("<table>", "目标表名")
+        .option("--retention <ttl>", "保留时长 7d / 30d / 180d / 360d / forever", "7d")
+        .action(async function (table) {
+        await (0, index_1.handleDbAuditEnable)(table, this.optsWithGlobals());
+    });
+    auditCmd
+        .command("disable")
+        .summary("关闭表审计")
+        .usage("<table> [flags]")
+        .argument("<table>", "目标表名")
+        .action(async function (table) {
+        await (0, index_1.handleDbAuditDisable)(table, this.optsWithGlobals());
+    });
+    auditCmd
+        .command("list")
+        .summary("查询审计日志")
+        .description("按表 + 时间窗查询审计日志（INSERT / UPDATE / DELETE）。")
+        .usage("<table...> [flags]")
+        .argument("<tables...>", "一个或多个表名（多表时空表会汇总到 stderr）")
+        .option("--since <time>", "起始时间")
+        .option("--until <time>", "结束时间")
+        .option("--limit <n>", "单次返回上限（默认 50）", parsePositiveInt, 50)
+        .option("--cursor <ts>", "分页游标，传上一页末条 event_time")
+        .action(async function (tables) {
+        await (0, index_1.handleDbAuditList)(tables, this.optsWithGlobals());
+    });
+    // ── migration ──
+    const migrationCmd = dbCmd
+        .command("migration")
+        .summary("多环境管理（dev / online，仅专家模式应用）")
+        .description("init 拆分双环境，diff 预览待发布变更，apply 把 dev 同步到 online。")
+        .usage("<command> [flags]");
+    migrationCmd.action(() => {
+        migrationCmd.outputHelp();
+    });
+    migrationCmd
+        .command("init")
+        .summary("初始化多环境（不可逆）")
+        .usage("[flags]")
+        .option("--sync-data", "同时把现有数据复制到 dev")
+        .option("--yes", "跳过 TTY 确认")
+        .action(async function () {
+        await (0, index_1.handleDbMigrationInit)(this.optsWithGlobals());
+    });
+    migrationCmd
+        .command("diff")
+        .summary("预览 dev → online 待发布变更")
+        .usage("[flags]")
+        .action(async function () {
+        await (0, index_1.handleDbMigrationDiff)(this.optsWithGlobals());
+    });
+    migrationCmd
+        .command("apply")
+        .summary("应用 dev 变更到 online（多 DDL 单事务原子）")
+        .usage("[flags]")
+        .option("--yes", "跳过 TTY 二次确认")
+        .action(async function () {
+        await (0, index_1.handleDbMigrationApply)(this.optsWithGlobals());
+    });
+    // ── recovery（PITR）──
+    const recoveryCmd = dbCmd
+        .command("recovery")
+        .summary("基于时间点恢复（PITR）")
+        .description("把数据库整体恢复到指定时间点，diff 预览影响范围，apply 不可逆覆盖。")
+        .usage("<command> [flags]");
+    recoveryCmd.action(() => {
+        recoveryCmd.outputHelp();
+    });
+    recoveryCmd
+        .command("diff")
+        .summary("预览恢复到指定时间点的影响范围")
+        .usage("<timestamp> [flags]")
+        .argument("<timestamp>", "目标时间，YYYY-MM-DD / YYYY-MM-DD HH:MM[:SS] / ISO 8601")
+        .action(async function (target) {
+        await (0, index_1.handleDbRecoveryDiff)(target, this.optsWithGlobals());
+    });
+    recoveryCmd
+        .command("apply")
+        .summary("触发恢复到指定时间点（不可逆覆盖）")
+        .usage("<timestamp> [flags]")
+        .argument("<timestamp>", "目标时间，YYYY-MM-DD / YYYY-MM-DD HH:MM[:SS] / ISO 8601")
+        .option("--yes", "跳过 TTY 二次确认")
+        .action(async function (target) {
+        await (0, index_1.handleDbRecoveryApply)(target, this.optsWithGlobals());
+    });
+    // ── quota ──
+    dbCmd
+        .command("quota")
+        .summary("查看数据库用量与限额")
+        .usage("[flags]")
+        .action(async function () {
+        await (0, index_1.handleDbQuota)(this.optsWithGlobals());
+    });
 }

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

@@ -209,4 +209,11 @@ Examples:
   Error: Expires duration '60d' exceeds the maximum of 30d
     hint: Maximum allowed value is 30d. Use \`--expires 30d\` for the longest link.
 `);
+    fileCmd
+        .command("quota")
+        .summary("查看文件存储用量与限额")
+        .usage("[flags]")
+        .action(async function () {
+        await (0, index_1.handleFileQuota)(this.optsWithGlobals());
+    });
 }

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

@@ -58,7 +58,9 @@ JSON 输出
   Error: Invalid plugin name format: bad-name. Expected: @scope/name or @scope/name@version
     hint: 示例：@demo/example-plugin 或 @demo/example-plugin@1.2.3
 `)
-        .action(async (names) => { await (0, index_1.handlePluginInstall)({ names }); });
+        .action(async (names) => {
+        await (0, index_1.handlePluginInstall)({ names });
+    });
     pluginCmd
         .command("update")
         .description("把已安装插件升级到 latest 版本")
@@ -91,7 +93,9 @@ JSON 输出
   $ miaoda plugin update @demo/not-installed --json
   {"updated":[],"skipped":[],"notInstalled":["@demo/not-installed"],"failed":[]}
 `)
-        .action(async (names) => { await (0, index_1.handlePluginUpdate)({ names }); });
+        .action(async (names) => {
+        await (0, index_1.handlePluginUpdate)({ names });
+    });
     pluginCmd
         .command("remove")
         .description("从当前项目移除一个已安装的插件")
@@ -115,7 +119,9 @@ JSON 输出
   Error: Plugin @demo/not-installed is not installed
     hint: 运行 miaoda plugin list-packages 查看已安装插件
 `)
-        .action((name) => { (0, index_1.handlePluginRemove)({ name }); });
+        .action((name) => {
+        (0, index_1.handlePluginRemove)({ name });
+    });
     pluginCmd
         .command("init")
         .description("按 package.json 的 actionPlugins 批量安装所有插件")
@@ -146,7 +152,9 @@ JSON 输出
   Error: package.json not found in current directory
     hint: 在应用项目根目录运行
 `)
-        .action(async () => { await (0, index_1.handlePluginInit)(); });
+        .action(async () => {
+        await (0, index_1.handlePluginInit)();
+    });
     pluginCmd
         .command("list")
         .description("列出当前项目的 capability 实例（./server/capabilities/*.json）")
@@ -178,7 +186,9 @@ JSON 输出
   Error: server/capabilities directory not found
     hint: 当前目录必须是含 server/capabilities/ 的应用项目
 `)
-        .action(async (opts) => { await (0, index_1.handlePluginList)(opts); });
+        .action(async (opts) => {
+        await (0, index_1.handlePluginList)(opts);
+    });
     pluginCmd
         .command("list-packages")
         .description("列出 package.json actionPlugins 里已声明的插件包")
@@ -201,5 +211,7 @@ JSON 输出
   Error: package.json not found in current directory
     hint: 在应用项目根目录运行
 `)
-        .action(() => { (0, index_1.handlePluginListPlugins)(); });
+        .action(() => {
+        (0, index_1.handlePluginListPlugins)();
+    });
 }

package/dist/cli/commands/shared.js

@@ -22,9 +22,7 @@ function resolveAppId(opts) {
     const id = opts.appId ?? process.env.MIAODA_APP_ID ?? process.env.app_id;
     if (!id) {
         throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
-            next_actions: [
-                "设置 export MIAODA_APP_ID=<id>",
-            ],
+            next_actions: ["设置 export MIAODA_APP_ID=<id>"],
         });
     }
     return id;