@lark-apaas/miaoda-cli 0.1.0-alpha.ca2912e → 0.1.0-alpha.ec1a658

package/dist/api/db/api.js

@@ -24,7 +24,9 @@ async function execSql(opts) {
     const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/sql", {
         dbBranch: opts.dbBranch,
     });
+    const start = Date.now();
     const response = await client.post(url, { sql: opts.sql });
+    (0, client_1.traceHttp)("POST", url, start, response);
     if (!response.ok) {
         // 4xx / 5xx：尝试解析 body 取 status_code 映射业务错误
         let body = null;
@@ -57,7 +59,9 @@ async function getSchema(opts) {
         includeStats: opts.includeStats ? "true" : undefined,
         dbBranch: opts.dbBranch,
     });
+    const start = Date.now();
     const response = await client.get(url);
+    (0, client_1.traceHttp)("GET", url, start, response);
     if (!response.ok) {
         let body = null;
         try {
@@ -73,28 +77,32 @@ async function getSchema(opts) {
     const body = (await response.json());
     return (0, client_1.extractData)(body);
 }
-// ── db data import → InnerImportData ──
+// ── db data import → InnerAdminImportData ──
 /**
  * 导入文件。
- * 后端：POST /v1/dataloom/app/{appId}/data/import?tableName=...&format=csv|json&dbBranch=main
+ * 后端：POST /v1/dataloom/app/{appId}/data/import
  *
- * Body 为原始文件字节（不走 JSON envelope）。
+ * 全字段走 JSON body envelope（idl-larkgw 36125a2f）：
+ *   {tableName, format, records, dbBranch?}
+ *
+ * `records` 字段携带 CSV / JSON 文本内容（utf8 字符串），与 dataloom 上
+ * Import/ExportAdminRecords 命名风格对齐。CLI 端把 Buffer 解码成 utf8
+ * 字符串后塞进 envelope 即可。
  */
 async function importData(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/data/import", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/data/import");
+    const reqBody = {
         tableName: opts.tableName,
         format: opts.format,
-        dbBranch: opts.dbBranch,
-    });
-    const contentType = opts.format === "csv" ? "text/csv" : "application/json";
-    const ab = opts.body.buffer.slice(opts.body.byteOffset, opts.body.byteOffset + opts.body.byteLength);
-    const response = await client.request({
-        method: "POST",
-        url,
-        headers: { "Content-Type": contentType },
-        body: ab,
-    });
+        records: opts.body.toString("utf8"),
+    };
+    if (opts.dbBranch !== undefined && opts.dbBranch !== "") {
+        reqBody.dbBranch = opts.dbBranch;
+    }
+    const start = Date.now();
+    const response = await client.post(url, reqBody);
+    (0, client_1.traceHttp)("POST", url, start, response);
     if (!response.ok) {
         let body = null;
         try {
@@ -107,31 +115,37 @@ async function importData(opts) {
             (0, client_1.extractData)(body);
         throw new error_1.HttpError(response.status, url, `Failed to import data: ${String(response.status)} ${response.statusText}`);
     }
-    // 后端 InnerImportData 响应里 data 直接返 {tableName, rows, durationMs}
+    // 后端 InnerAdminImportData 响应里 data 直接返 {tableName, recordCount, durationMs}
     const body = (await response.json());
     const data = (0, client_1.extractData)(body);
     return {
         tableName: data.tableName ?? opts.tableName,
-        rows: data.rows ?? 0,
+        recordCount: data.recordCount ?? 0,
         durationMs: data.durationMs ?? 0,
     };
 }
-// ── db data export → InnerExportData ──
+// ── db data export → InnerAdminExportData ──
 /**
  * 导出数据。
- * 后端：POST /v1/dataloom/app/{appId}/data/export?tableName=...&format=csv|json&dbBranch=main
+ * 后端：POST /v1/dataloom/app/{appId}/data/export?tableName=...&format=csv|json&limit=5000&dbBranch=main
  *
- * 响应 body 为原始 CSV/JSON 字节（不走 envelope）。错误仍通过 HTTP 4xx/5xx + BaseResp 传达。
+ * 所有参数（含 limit）均按 IDL `api.query` 走 query string；HTTP 方法是 POST（对齐
+ * inner_api 网关插件路由约定，与 InnerAdminExecuteSQL 同 method）。请求体为空。
+ * 响应 body 为原始 CSV/JSON 字节，RecordCount 通过响应头 `X-Miaoda-Record-Count`
+ * 回传，错误仍走 HTTP 4xx/5xx + envelope。
  */
 async function exportData(opts) {
     const client = (0, http_1.getHttpClient)();
     const url = (0, client_1.buildInnerUrl)(opts.appId, "/data/export", {
         tableName: opts.tableName,
         format: opts.format,
+        limit: String(opts.limit ?? 5000),
         dbBranch: opts.dbBranch,
     });
-    const reqBody = { limit: opts.limit ?? 5000 };
-    const response = await client.post(url, reqBody);
+    // POST + 空 body：所有业务参数都在 query 里
+    const start = Date.now();
+    const response = await client.request({ method: "POST", url });
+    (0, client_1.traceHttp)("POST", url, start, response);
     if (!response.ok) {
         // 错误路径：body 是 JSON envelope
         let body = null;
@@ -145,7 +159,8 @@ async function exportData(opts) {
             (0, client_1.extractData)(body);
         throw new error_1.HttpError(response.status, url, `Failed to export data: ${String(response.status)} ${response.statusText}`);
     }
-    // 成功路径：响应 body 是原始 CSV/JSON 字节
+    // 成功路径：响应 body 通常是原始 CSV/JSON 字节，但部分错误场景下网关会返
+    // HTTP 200 + JSON envelope（status_code != "0"），需要在这里嗅探兜底。
     const contentType = response.headers.get("Content-Type") ??
         (opts.format === "csv" ? "text/csv" : "application/json");
     const ab = await response.arrayBuffer();
@@ -153,10 +168,33 @@ async function exportData(opts) {
     if (buf.length === 0) {
         throw new error_1.AppError("INTERNAL_DB_ERROR", "Empty export response body");
     }
+    // Envelope sniff：HTTP 200 + Content-Type 为 application/json + body 解析得到
+    // InnerEnvelope 且 status_code 非 "0" 时，按业务错误抛出。
+    // 仅 CSV 格式做 sniff —— JSON 格式正常成功响应也是 application/json，会误判。
+    if (opts.format === "csv" && /application\/json/i.test(contentType)) {
+        try {
+            const parsed = JSON.parse(buf.toString("utf8"));
+            if (parsed.status_code != null && parsed.status_code !== "0") {
+                // 复用 extractData 的错误映射逻辑（throw AppError）
+                (0, client_1.extractData)(parsed);
+            }
+        }
+        catch (err) {
+            // 已经被 extractData 抛成 AppError → 透传；否则 JSON.parse 失败说明 body
+            // 真的是 CSV 文本，继续按成功流程走
+            if (err instanceof error_1.AppError)
+                throw err;
+        }
+    }
+    // 后端通过响应头回传记录数（避免污染 body）；header 缺失或解析失败 → undefined
+    const recordCountHeader = response.headers.get("X-Miaoda-Record-Count");
+    const parsedCount = recordCountHeader != null ? Number(recordCountHeader) : NaN;
+    const recordCount = Number.isFinite(parsedCount) && parsedCount >= 0 ? parsedCount : undefined;
     return {
         tableName: opts.tableName,
         format: opts.format,
         contentType,
         body: buf,
+        recordCount,
     };
 }

package/dist/api/db/client.js

@@ -1,10 +1,45 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SQLSTATE_MAP = void 0;
+exports.traceHttp = traceHttp;
 exports.ensureInnerSuccess = ensureInnerSuccess;
 exports.extractData = extractData;
 exports.buildInnerUrl = buildInnerUrl;
 const error_1 = require("../../utils/error");
+const logger_1 = require("../../utils/logger");
+/**
+ * 输出一条 HTTP 调试日志（仅 --verbose 模式生效）。
+ *
+ * 主要用于把后端返回的 `x-tt-logid` 透出给用户，方便拿这个 id 去 server / 网关日志里
+ * 直接定位本次请求的 `[MiaodaCLI.metric]` 行与上下游 trace。
+ *
+ * 使用约定：
+ *   const start = Date.now();
+ *   const response = await client.post(url, body);
+ *   traceHttp("POST", url, start, response);
+ *   // 或错误路径：traceHttp("POST", url, start, err.response, err)
+ */
+function traceHttp(method, url, start, response, err) {
+    // debug() 内部已判断 verbose 开关，这里不重复判断；保持调用点轻量
+    try {
+        const cost = Date.now() - start;
+        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);
+            (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid} err=${errMsg}`);
+            return;
+        }
+        (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid}`);
+    }
+    catch {
+        // debug 失败不应影响业务，吞掉
+    }
+}
 /**
  * 校验 dataloom InnerAPI 响应的 envelope。
  *
@@ -20,11 +55,15 @@ function ensureInnerSuccess(body) {
     if (code === "0" || code === "")
         return;
     const message = stripPgPrefix(body.error_msg ?? body.ErrorMessage ?? `dataloom API error [${code}]`);
+    // PRD 多语句失败：后端在 envelope 顶层透出 errorStatementIndex（从 0 起计），
+    // 单语句 / 单元执行不会带这个字段。下面的 AppError 都把它带上，让最终
+    // CLI JSON envelope 写到 error.statement_index。
+    const stmtIdx = typeof body.errorStatementIndex === "number" ? body.errorStatementIndex : undefined;
     // k_dl_1300002 是 PG 执行透传错误；error_msg 里常带 SQLSTATE，优先按 SQLSTATE 映射
     if (code === "k_dl_1300002") {
         const sqlstate = extractSqlstate(message);
         if (sqlstate && exports.SQLSTATE_MAP[sqlstate]) {
-            throw new error_1.AppError(exports.SQLSTATE_MAP[sqlstate], message);
+            throw new error_1.AppError(exports.SQLSTATE_MAP[sqlstate], message, { statement_index: stmtIdx });
         }
     }
     // k_dl_1600000 是 dataloom 通用参数错误，不能整体映射；
@@ -35,7 +74,7 @@ function ensureInnerSuccess(body) {
     if (code === "k_dl_1600000" && message.startsWith("Invalid DB Branch")) {
         throw new error_1.AppError("MULTI_ENV_NOT_INITIALIZED", "--env is not available (multi-env not initialized)", {
             next_actions: [
-                "Verify the --env value matches an existing dbBranch, or run `miaoda db migration init` to set up multi-env for this app.",
+                "Verify the --env value matches an existing dbBranch.",
             ],
         });
     }
@@ -44,10 +83,11 @@ function ensureInnerSuccess(body) {
     if (mapped) {
         throw new error_1.AppError(mapped.code, mapped.message ?? message, {
             next_actions: mapped.hint ? [mapped.hint] : undefined,
+            statement_index: stmtIdx,
         });
     }
     // 兜底：dataloom 未映射的 code 原样透传
-    throw new error_1.AppError(`DB_API_${code}`, message);
+    throw new error_1.AppError(`DB_API_${code}`, message, { statement_index: stmtIdx });
 }
 /**
  * 剥掉 PG 透传错误的 "ERROR:" 前缀：CLI 输出本身就会前缀 "Error:"，

package/dist/api/db/parsers.js

@@ -27,16 +27,23 @@ function parseSqlResult(r) {
             recordCount: r.recordCount ?? rows.length,
         };
     }
-    if (r.sqlType === "INSERT" || r.sqlType === "UPDATE" || r.sqlType === "DELETE" || r.sqlType === "DML") {
+    if (r.sqlType === "INSERT" ||
+        r.sqlType === "UPDATE" ||
+        r.sqlType === "DELETE" ||
+        r.sqlType === "MERGE" ||
+        r.sqlType === "DML") {
         const affected = r.affectedRows ?? extractRowCount(r.data);
         return {
             kind: "dml",
+            // 上面已 narrow，这里 cast 是为了 SqlType 联合里的 (string & {}) 让 TS 无法
+            // 自动收窄到字面量集合，不影响运行时安全
             sqlType: r.sqlType,
             affectedRows: affected,
         };
     }
-    // DDL or unknown
-    return { kind: "ddl" };
+    // DDL or unknown — sqlType 透传后端给的细粒度（CREATE_TABLE / DROP_TABLE / ...
+    //  / 笼统 "DDL"），CLI JSON 输出直接当 command 用
+    return { kind: "ddl", sqlType: r.sqlType };
 }
 /** DML 的 data 通常是 `[{"rowCount": N}]`；兜底从这里读影响行数。 */
 function extractRowCount(data) {
@@ -82,7 +89,6 @@ function toSummary(t, stats) {
         columns: (t.fields ?? []).length,
         estimated_row_count: typeof stats?.estimatedRowCount === "number" ? stats.estimatedRowCount : null,
         size_bytes: typeof stats?.sizeBytes === "number" ? stats.sizeBytes : null,
-        updated_at: t.updatedAt,
     };
 }
 /**
@@ -118,8 +124,6 @@ function toDetail(t, stats) {
         indexes: rawIndexes.map(toIndex),
         estimated_row_count: typeof stats?.estimatedRowCount === "number" ? stats.estimatedRowCount : null,
         size_bytes: typeof stats?.sizeBytes === "number" ? stats.sizeBytes : null,
-        created_at: t.createdAt,
-        updated_at: t.updatedAt,
     };
 }
 function toColumn(f) {

package/dist/api/file/api.js

@@ -214,7 +214,7 @@ async function resolveByName(appId, input) {
             error: {
                 code: "FILE_NOT_FOUND",
                 message: `File '${input}' does not exist`,
-                hint: "Run `miaoda file ls` to verify file_name.",
+                hint: "Run `miaoda file ls` to see available files.",
             },
         };
     }
@@ -225,7 +225,7 @@ async function resolveByName(appId, input) {
             error: {
                 code: "AMBIGUOUS_FILE_NAME",
                 message: `Multiple files match name '${input}' (${String(matches.length)} found)`,
-                hint: `Use absolute /path instead. Run \`miaoda file ls --name ${input}\` to see candidates.`,
+                hint: `Use path instead. Run \`miaoda file ls --name ${input}\` to see candidates.`,
             },
         };
     }
@@ -280,6 +280,7 @@ async function uploadFile(opts) {
         // Node 20+ 内置 fetch 运行时接受 Buffer，但 TS 的 BodyInit 要求更严格的类型；
         // 这里复制到独立 ArrayBuffer 以满足 lib.dom.d.ts 的 BodyInit 约束
         const ab = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
+        const uploadStart = Date.now();
         const res = await fetch(pre.uploadURL, {
             method: "PUT",
             headers: {
@@ -288,6 +289,7 @@ async function uploadFile(opts) {
             },
             body: ab,
         });
+        (0, logger_1.debug)(`http PUT <upload-cdn> ${String(res.status)} cost=${String(Date.now() - uploadStart)}ms size=${String(opts.fileSize)}`);
         if (!res.ok) {
             throw new error_1.AppError("FILE_UPLOAD_FAILED", `Upload PUT failed with status ${String(res.status)}`);
         }
@@ -364,12 +366,15 @@ async function signDownload(opts) {
  */
 async function downloadFile(opts) {
     let res;
+    const downloadStart = Date.now();
     try {
         res = await fetch(opts.signedURL);
     }
     catch (err) {
+        (0, logger_1.debug)(`http GET <download-cdn> 0 cost=${String(Date.now() - downloadStart)}ms err=${err instanceof Error ? err.message : String(err)}`);
         throw new error_1.AppError("FILE_DOWNLOAD_FAILED", `Download GET failed: ${err instanceof Error ? err.message : String(err)}`);
     }
+    (0, logger_1.debug)(`http GET <download-cdn> ${String(res.status)} cost=${String(Date.now() - downloadStart)}ms`);
     if (!res.ok) {
         throw new error_1.AppError("FILE_DOWNLOAD_FAILED", `Download failed with status ${String(res.status)}`);
     }

package/dist/api/file/client.js

@@ -8,7 +8,34 @@ exports.doPost = doPost;
 exports.doRequest = doRequest;
 const http_1 = require("../../utils/http");
 const error_1 = require("../../utils/error");
+const logger_1 = require("../../utils/logger");
 const http_client_1 = require("@lark-apaas/http-client");
+/**
+ * 输出一条 HTTP 调试日志（仅 --verbose 模式生效）。
+ *
+ * 主要用于把后端返回的 `x-tt-logid` 透出给用户，方便拿这个 id 去 server / 网关日志里
+ * 直接定位本次请求的 `[MiaodaCLI.metric]` 行与上下游 trace。
+ */
+function traceHttp(method, url, start, response, err) {
+    try {
+        const cost = Date.now() - start;
+        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);
+            (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid} err=${errMsg}`);
+            return;
+        }
+        (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid}`);
+    }
+    catch {
+        // debug 失败不应影响业务，吞掉
+    }
+}
 /** 进程内 bucket 缓存：{appId: bucketId}。不跨进程。 */
 const bucketCache = new Map();
 /**
@@ -130,33 +157,42 @@ async function mapHttpError(err, opts) {
  * 通过第三个参数显式传入 getRuntimeHttpClient() 切换。
  */
 async function doGet(url, opts = {}, client = (0, http_1.getHttpClient)()) {
+    const start = Date.now();
     try {
         const response = await client.get(url);
+        traceHttp("GET", url, start, response);
         return (await response.json());
     }
     catch (err) {
+        traceHttp("GET", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
         await mapHttpError(err, opts);
         throw err; // 不可达，mapHttpError 必定 throw
     }
 }
 /** 包一层 client.post + HttpError 统一映射。默认 admin innerapi，可显式切 runtime。 */
 async function doPost(url, body, opts = {}, client = (0, http_1.getHttpClient)()) {
+    const start = Date.now();
     try {
         const response = await client.post(url, body);
+        traceHttp("POST", url, start, response);
         return (await response.json());
     }
     catch (err) {
+        traceHttp("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
         await mapHttpError(err, opts);
         throw err;
     }
 }
 /** 包一层 client.request + HttpError 统一映射（DELETE 带 body 的场景）。 */
 async function doRequest(cfg, opts = {}, client = (0, http_1.getHttpClient)()) {
+    const start = Date.now();
     try {
         const response = await client.request(cfg);
+        traceHttp(cfg.method, cfg.url, start, response);
         return (await response.json());
     }
     catch (err) {
+        traceHttp(cfg.method, cfg.url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
         await mapHttpError(err, opts);
         throw err;
     }

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

@@ -2,73 +2,67 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDbCommands = registerDbCommands;
 const index_1 = require("../../../cli/handlers/db/index");
-const shared_1 = require("../../../cli/commands/shared");
 function registerDbCommands(program) {
     const dbCmd = program
         .command("db")
-        .description("数据操作：SQL 执行、表结构查询、数据导入导出");
+        .description("数据库操作：执行 SQL、查看表结构、导入导出数据");
     dbCmd.action(() => {
         dbCmd.outputHelp();
     });
     dbCmd
         .command("sql")
-        .description("执行任意 SQL（SELECT / DML / DDL / TCL / EXPLAIN）；query 省略时读 stdin")
-        .argument("[query]", "要执行的 SQL 语句；省略时从 stdin 读取")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--env <env>", "目标环境（main / dev）；不传由后端按多环境状态兜底")
+        .description("执行 SQL 语句")
+        .argument("[query]", "要执行的 SQL 语句")
+        .option("--env <env>", "目标环境（main / dev）")
         .action(async (query, opts) => {
         await (0, index_1.handleDbSql)(query, opts);
     });
     // schema 二级资源分组
     const schemaCmd = dbCmd
         .command("schema")
-        .description("表结构查询");
+        .description("查看表结构");
     schemaCmd.action(() => {
         schemaCmd.outputHelp();
     });
     schemaCmd
         .command("list")
-        .description("列出应用所有表（rows / size / columns / updated_at）")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--env <env>", "目标环境（main / dev）；不传由后端按多环境状态兜底")
+        .description("列出当前应用的所有表（含行数估算、占用大小、列数）")
+        .option("--env <env>", "目标环境（main / dev）")
         .action(async (opts) => {
         await (0, index_1.handleDbSchemaList)(opts);
     });
     schemaCmd
         .command("get")
-        .description("查看单表结构（字段 / 索引 / DDL）")
+        .description("查看单张表的字段、索引与建表语句")
         .argument("<table>", "表名")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--ddl", "TTY 下强制输出完整 DDL 而非结构化概览")
-        .option("--env <env>", "目标环境（main / dev）；不传由后端按多环境状态兜底")
+        .option("--ddl", "输出完整建表语句而非概要")
+        .option("--env <env>", "目标环境（main / dev）")
         .action(async (table, opts) => {
         await (0, index_1.handleDbSchemaGet)(table, opts);
     });
     // data 二级资源分组
     const dataCmd = dbCmd
         .command("data")
-        .description("数据导入 / 导出");
+        .description("批量导入与导出数据");
     dataCmd.action(() => {
         dataCmd.outputHelp();
     });
     dataCmd
         .command("import")
-        .description("从 CSV / JSON 文件导入数据（P0：≤ 1 MB / ≤ 5000 行，单事务原子）")
+        .description("把本地 CSV / JSON 文件导入到表（单次最多 5000 行 / 1 MB，全部成功或全部回滚）")
         .argument("<file>", "本地文件路径")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--table <name>", "目标表名；省略时按文件名推断")
-        .option("--format <fmt>", "csv | json；省略时按文件扩展名推断")
+        .option("--table <name>", "目标表名（缺省按文件名推断）")
+        .option("--format <fmt>", "文件格式 csv / json（缺省按扩展名推断）")
         .action(async (file, opts) => {
         await (0, index_1.handleDbDataImport)(file, opts);
     });
     dataCmd
         .command("export")
-        .description("导出整表到 CSV / JSON（P0：≤ 1 MB / ≤ 5000 行）")
+        .description("把整张表导出为 CSV / JSON 文件（单次最多 5000 行 / 1 MB）")
         .argument("<table>", "表名")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--format <fmt>", "csv | json；默认 csv")
-        .option("-f, --file <path>", "输出文件路径；默认 <table>.<format>")
-        .option("--limit <n>", "最多导出行数（≤ 5000）")
+        .option("--format <fmt>", "导出格式 csv / json（默认 csv）")
+        .option("-f, --file <path>", "输出文件路径（默认 <table>.<format>）")
+        .option("--limit <n>", "最多导出行数（不超过 5000）")
         .action(async (table, opts) => {
         await (0, index_1.handleDbDataExport)(table, opts);
     });

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

@@ -2,65 +2,73 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerFileCommands = registerFileCommands;
 const index_1 = require("../../../cli/handlers/file/index");
-const shared_1 = require("../../../cli/commands/shared");
+const error_1 = require("../../../utils/error");
+/**
+ * commander option 校验器：把 --limit <n> 解析成正整数（≥1）。
+ * 默认值（如 "50"）会先经过这里被规范化成 number。
+ * 非整数 / 负数 / 0 抛 AppError("ARGS_INVALID")，由 main.ts 的全局 catch
+ * 走 emitError，同时 process.exitCode 由 commander 自然为 1。
+ */
+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 registerFileCommands(program) {
     const fileCmd = program
         .command("file")
-        .description("文件操作：上传、下载、删除、查询");
+        .description("文件操作:上传、下载、删除、查询");
     fileCmd.action(() => {
         fileCmd.outputHelp();
     });
     fileCmd
         .command("ls")
         .description("列出应用下的文件")
-        .argument("[query]", "可选筛选值：形似 /path、包含 / 或 16+位 fileKey 时按 path 精确匹配；否则按 file_name 精确匹配")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--path <path>", "按 path 精确匹配（跳过自动识别）")
-        .option("--name <name>", "按 file_name 精确匹配（跳过自动识别）")
-        .option("--type <mime>", "按 MIME 类型过滤（精确匹配）")
-        .option("--size-gt <size>", "大小大于，支持 B/KB/MB/GB")
-        .option("--size-lt <size>", "大小小于")
-        .option("--uploaded-since <time>", "上传时间晚于（ISO 8601）")
-        .option("--limit <n>", "返回条数上限", "50")
-        .option("--cursor <token>", "分页游标")
-        .option("--all", "自动翻页聚合全部结果")
+        .argument("[query]", "可选筛选值：以 / 开头视为路径（精确匹配），否则按文件名匹配")
+        .option("--path <path>", "按路径精确匹配")
+        .option("--name <name>", "按文件名精确匹配")
+        .option("--type <mime>", "按 MIME 类型筛选（如 image/png）")
+        .option("--size-gt <size>", "文件大小下限（支持 B/KB/MB/GB）")
+        .option("--size-lt <size>", "文件大小上限（支持 B/KB/MB/GB）")
+        .option("--uploaded-since <time>", "上传时间下限（ISO 8601）")
+        .option("--limit <n>", "单次返回上限（正整数，默认 50）", parsePositiveInt, 50)
+        .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
+        .option("--all", "自动翻页返回全部结果")
         .action(async (query, opts) => {
         await (0, index_1.handleFileLs)({ ...opts, query });
     });
     fileCmd
         .command("stat")
-        .description("查看指定文件的元数据")
-        .argument("<file>", "path 或 file_name：自动识别（见 ls 命令说明）")
-        .addOption((0, shared_1.appIdOption)())
+        .description("查看文件的元数据（不含下载链接，需要链接请用 sign）")
+        .argument("<file>", "文件的路径或文件名")
         .action(async (file, opts) => {
         await (0, index_1.handleFileStat)(file, opts);
     });
     fileCmd
         .command("cp")
-        .description("上传或下载文件（方向由 src/dst 自动判断）")
-        .argument("<src>", "源：本地路径 或 远程 /path / file_name")
+        .description("上传或下载文件（按 src/dst 自动判断方向）")
+        .argument("<src>", "源：本地文件路径 或 远程文件路径/名")
         .argument("<dst>", "目标：本地路径 或 远程路径")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--rename <name>", "上传后使用的新文件名")
+        .option("--rename <name>", "上传后在远端使用的新文件名")
         .action(async (src, dst, opts) => {
         await (0, index_1.handleFileCp)(src, dst, opts);
     });
     fileCmd
         .command("rm")
-        .description("删除一个或多个文件（best-effort）")
-        .argument("[paths...]", "path 或 file_name：形似 /path、含 / 或 16+位 fileKey 时按 path 精确删除，其余按 file_name 查找后删除")
-        .addOption((0, shared_1.appIdOption)())
-        .option("-n, --name <name>", "强制按 file_name 查找后删除（跳过自动识别）；可重复指定；多匹配报 AMBIGUOUS_FILE_NAME", (value, prev) => [...(prev ?? []), value])
-        .option("-y, --yes", "跳过交互确认")
+        .description("批量删除文件（单次最多 100 个，部分失败不影响其他）")
+        .argument("[paths...]", "要删除的文件，每项可填路径或文件名（自动识别）")
+        .option("-n, --name <name>", "按文件名删除（可多次指定）", (value, prev) => [...(prev ?? []), value])
+        .option("-y, --yes", "跳过交互确认（脚本 / agent 调用必加）")
         .action(async (paths, opts) => {
         await (0, index_1.handleFileRm)(paths, opts);
     });
     fileCmd
         .command("sign")
-        .description("生成文件临时下载链接")
-        .argument("<file>", "path 或 file_name：自动识别（见 ls 命令说明）")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--expires <duration>", "过期时长（默认 7d，最长 30d）")
+        .description("生成可分享的临时下载链接")
+        .argument("<file>", "文件的路径或文件名")
+        .option("--expires <duration>", "链接有效期，支持 30m / 24h / 7d 单位（默认 7d，最长 30d）")
         .action(async (file, opts) => {
         await (0, index_1.handleFileSign)(file, opts);
     });

package/dist/cli/commands/shared.js

@@ -1,18 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.appIdOption = appIdOption;
 exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
 exports.failArgs = failArgs;
 const commander_1 = require("commander");
 const error_1 = require("../../utils/error");
-/** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption())。
- * Commander 的 .env() 只接受单个变量名，第二个兜底 `app_id` 在 resolveAppId 里手动检查。
- */
-function appIdOption() {
-    return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
-}
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
  */
@@ -20,15 +13,16 @@ function softRequiredOption(name, desc) {
     return new commander_1.Option(name, desc);
 }
 /**
- * 解析 appId，优先级：CLI flag > MIAODA_APP_ID > app_id > 抛错。
- * app_id 是部分外部沙箱环境注入应用 ID 的别名，作为兜底兼容（小写下划线形态）。
+ * 解析 appId，从环境变量 MIAODA_APP_ID 或 app_id（小写下划线，部分外部沙箱注入）读取。
+ * 缺失时抛 APP_ID_MISSING，由全局 catch 处理。
+ *
+ * opts 里仍保留 appId（可选），用于测试 / 高级场景显式注入；正常 CLI 不暴露此 flag。
  */
 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: [
-                "传入 --app-id <id>",
                 "设置 export MIAODA_APP_ID=<id>",
             ],
         });

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

@@ -82,15 +82,15 @@ async function handleDbDataImport(file, opts) {
             data: {
                 file,
                 table: result.tableName,
-                rows: result.rows,
+                rows: result.recordCount,
             },
         });
         return;
     }
     const tty = (0, render_1.isStdoutTty)();
     (0, output_1.emit)(tty
-        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.rows)} rows)`
-        : `OK Imported ${file} -> table '${result.tableName}' (${String(result.rows)} rows)`);
+        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.recordCount)} rows)`
+        : `OK Imported ${file} -> table '${result.tableName}' (${String(result.recordCount)} rows)`);
 }
 async function handleDbDataExport(table, opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
@@ -110,7 +110,8 @@ async function handleDbDataExport(table, opts) {
         throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, { next_actions: [`Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`] });
     }
     await fs.writeFile(outputPath, result.body);
-    const rows = countRows(result.body, format);
+    // 优先信任后端 X-Miaoda-Record-Count header；header 缺失时再用 body 行数兜底
+    const rows = result.recordCount ?? countRows(result.body, format);
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emit)({
             data: {

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

@@ -55,14 +55,14 @@ async function handleDbSchemaList(opts) {
         return;
     }
     const tty = (0, render_1.isStdoutTty)();
-    // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）
+    // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）。
+    // updated_at 暂时不展示——PG pg_catalog 不存真实表时间，详见 renderDetail 注释。
     const headers = [
         "name",
         "description",
         "estimated_row_count",
         tty ? "size" : "size_bytes",
         "columns",
-        "updated_at",
     ];
     const rows = tables.map((t) => [
         t.name,
@@ -70,7 +70,6 @@ async function handleDbSchemaList(opts) {
         t.estimated_row_count === null ? "—" : String(t.estimated_row_count),
         t.size_bytes === null ? "—" : (tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes)),
         String(t.columns),
-        (0, render_1.formatTime)(t.updated_at, tty),
     ]);
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
 }
@@ -123,7 +122,10 @@ async function handleDbSchemaGet(table, opts) {
 function renderDetail(d, tty) {
     const systemFields = d.columns.filter((c) => c.name.startsWith("_"));
     const userFields = d.columns.filter((c) => !c.name.startsWith("_"));
-    // PRD 的 header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size / Created / Updated
+    // header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size。
+    // 不展示 Created / Updated：PG pg_catalog 不存表创建时间，dataloom 用 OID
+    // 构造的伪时间戳（baseTime=2020-01-01 + OID 秒偏移），仅保排序意义、绝对值
+    // 误导性强，先去掉。后续如果接 ddl_change_log 取真实时间再加回。
     const header = [
         ["Name", d.name],
         ["Description", d.description ?? "—"],
@@ -135,8 +137,6 @@ function renderDetail(d, tty) {
         ],
         ["Estimated Rows", d.estimated_row_count === null ? "—" : String(d.estimated_row_count)],
         ["Size", d.size_bytes === null ? "—" : (0, render_1.formatSize)(d.size_bytes)],
-        ["Created", (0, render_1.formatTime)(d.created_at, tty)],
-        ["Updated", (0, render_1.formatTime)(d.updated_at, tty)],
     ];
     const colHeaders = ["column", "type", "nullable", "default", "comment"];
     const colRows = userFields.map((c) => [

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

@@ -37,6 +37,7 @@ exports.handleDbSql = handleDbSql;
 const api = __importStar(require("../../../api/index"));
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
+const config_1 = require("../../../utils/config");
 const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
 const index_1 = require("../../../api/db/index");
@@ -47,7 +48,8 @@ const index_1 = require("../../../api/db/index");
  * - --env 透传给后端 admin-inner（dbBranch 参数），不传时由后端按 workspace
  *   多环境状态兜底（多环境 → dev / 单环境 → main）；后端检测到环境不存在
  *   会返 k_dl_1600000 + "Invalid DB Branch:..."，CLI 侧映射为 MULTI_ENV_NOT_INITIALIZED
- * - 多条语句时只展示最后一条的结果（与 PRD 对齐）；所有为 DDL 时展示批量摘要
+ * - 多语句行为对齐 PRD：每条 statement 一个独立结果元素，pretty 逐条 +
+ *   末尾汇总，--json 输出 data 数组。
  */
 async function handleDbSql(query, opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
@@ -65,22 +67,16 @@ async function handleDbSql(query, opts) {
         (0, output_1.emit)("✓ No results");
         return;
     }
-    // 全部 DDL 的批量场景：展示统计摘要（对齐 PRD `✓ 3 statements executed`）
-    const allDdl = results.every((r) => r.sqlType === "DDL");
-    if (allDdl && results.length > 1) {
-        if ((0, output_1.isJsonMode)()) {
-            (0, output_1.emit)({ data: { statements: results.length } });
-            return;
-        }
-        const tty = (0, render_1.isStdoutTty)();
-        (0, output_1.emit)(tty
-            ? `✓ ${String(results.length)} statements executed`
-            : `OK ${String(results.length)} statements executed`);
+    if (results.length === 1) {
+        renderSingle(results[0]);
+        return;
+    }
+    // 多语句：每条 statement 独立结果
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: results.map((r) => toMultiElement((0, index_1.parseSqlResult)(r))) });
         return;
     }
-    // 其他场景：展示最后一条
-    const last = results[results.length - 1];
-    renderSingle(last);
+    renderMultiPretty(results);
 }
 /** 读取 stdin 并返回完整 SQL 文本（stdin 不是 TTY 即认为被 pipe）。 */
 async function readSql(inline) {
@@ -130,10 +126,11 @@ function renderSingle(raw) {
 }
 function toJson(parsed) {
     if (parsed.kind === "select") {
-        return { data: parsed.rows };
+        // PRD 单 SELECT：data 直接是行数组（按 --json 字段投影裁剪）
+        return { data: projectRows(parsed.rows) };
     }
     if (parsed.kind === "dml") {
-        // PRD：DML 时 data = {command: "UPDATE", rows_affected: 3}
+        // PRD 单 DML：data = {command, rows_affected}
         return {
             data: {
                 command: parsed.sqlType,
@@ -141,14 +138,90 @@ function toJson(parsed) {
             },
         };
     }
-    return { data: { command: "DDL" } };
+    // PRD 单 DDL：data = {command, target?}。command 直接用后端给的细粒度
+    // （CREATE_TABLE / DROP_TABLE / ...），target 待后端给对象名后再加。
+    return { data: { command: parsed.sqlType } };
+}
+/**
+ * 多语句 --json 元素：与单 DDL/DML 形状一致，但 SELECT 包成
+ * {command:"SELECT", rows:[...]}（PRD 约定，避免数组里嵌套数组造成歧义）。
+ */
+function toMultiElement(parsed) {
+    if (parsed.kind === "select") {
+        return { command: "SELECT", rows: projectRows(parsed.rows) };
+    }
+    if (parsed.kind === "dml") {
+        return { command: parsed.sqlType, rows_affected: parsed.affectedRows };
+    }
+    // DDL：用后端给的细粒度 command
+    return { command: parsed.sqlType };
+}
+/**
+ * PRD：`--json id,name` 字段投影。--json 不带值（boolean true）等价于不裁剪。
+ * 字段不存在时按 undefined 处理（JSON.stringify 会忽略 undefined value 的 key），
+ * 这样 Agent 拿到的 row 永远只含请求过的列。
+ */
+function projectRows(rows) {
+    const fields = parseJsonFields();
+    if (!fields)
+        return rows;
+    return rows.map((r) => {
+        const out = {};
+        for (const f of fields) {
+            out[f] = r[f];
+        }
+        return out;
+    });
+}
+/** 读取 --json [fields]：返回字段列表；boolean true 或 undefined 返回 null（不裁剪）。 */
+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);
+}
+/** 多语句 pretty：逐条 `Statement N: ...` + 末尾 `✓ N statements executed`。 */
+function renderMultiPretty(results) {
+    const tty = (0, render_1.isStdoutTty)();
+    const lines = [];
+    for (let i = 0; i < results.length; i++) {
+        const parsed = (0, index_1.parseSqlResult)(results[i]);
+        const idx = i + 1;
+        if (parsed.kind === "select") {
+            const n = parsed.rows.length;
+            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)));
+                lines.push(tty ? (0, render_1.renderAlignedTable)(cols, tbl) : (0, render_1.renderTsv)(cols, tbl));
+            }
+            // 块间空行（最后一条不留）
+            if (i < results.length - 1)
+                lines.push("");
+            continue;
+        }
+        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}`);
+            continue;
+        }
+        // DDL
+        lines.push(`Statement ${String(idx)}: ${tty ? "✓ " : ""}DDL executed`);
+    }
+    // 汇总行：所有 statement 都跑完了
+    lines.push(tty
+        ? `✓ ${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 "DML": return "affected"; // MERGE / 未识别子类的兜底
+        case "MERGE": return "merged";
+        case "DML": return "affected"; // 未识别子类的兜底
     }
 }
 /** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */

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

@@ -66,7 +66,8 @@ function resolveQueryRouting(opts) {
 }
 async function handleFileLs(opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
-    const limit = opts.limit ? Number(opts.limit) : undefined;
+    // commander 已经把 --limit 解析为 number；保留 ?? undefined 兼容老调用
+    const limit = opts.limit;
     const sizeGt = opts.sizeGt ? (0, render_1.parseSize)(opts.sizeGt) : undefined;
     const sizeLt = opts.sizeLt ? (0, render_1.parseSize)(opts.sizeLt) : undefined;
     const { path, name } = resolveQueryRouting(opts);

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

@@ -44,7 +44,7 @@ const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 const render_1 = require("../../../utils/render");
 const node_readline_1 = __importDefault(require("node:readline"));
-const MAX_BATCH = 1000;
+const MAX_BATCH = 100;
 /**
  * 解析位置参数（自动识别 path / file_name）与 `--name`（强制 file_name）两类输入。
  *
@@ -103,13 +103,20 @@ async function resolveDeleteInputs(appId, paths, names) {
     }
     return { resolved, errors };
 }
-async function confirm(count) {
+/**
+ * 删除前 TTY 二次确认。
+ * PRD 单文件场景下提示带具体路径：`? Delete '/path'? (y/N)`，
+ * 多文件场景汇总条数：`? Delete N files? (y/N)`。
+ * `firstInput` 是用户传入的第一个值（可能是 path 或 file_name），
+ * 单文件时直接展示给用户，方便核对目标。
+ */
+async function confirm(count, firstInput) {
     const rl = node_readline_1.default.createInterface({
         input: process.stdin,
         output: process.stderr,
     });
     return new Promise((resolve) => {
-        const prompt = count === 1 ? `? Delete 1 file? (y/N) ` : `? Delete ${String(count)} files? (y/N) `;
+        const prompt = count === 1 ? `? Delete '${firstInput}'? (y/N) ` : `? Delete ${String(count)} files? (y/N) `;
         rl.question(prompt, (answer) => {
             rl.close();
             resolve(answer.trim().toLowerCase() === "y");
@@ -123,13 +130,16 @@ async function handleFileRm(paths, opts) {
         throw new error_1.AppError("ARGS_INVALID", "No file specified (give a /path or --name <name>)");
     }
     if (totalCount > MAX_BATCH) {
-        throw new error_1.AppError("FILE_BATCH_TOO_MANY", `Batch size ${String(totalCount)} exceeds the 1000 limit`);
+        throw new error_1.AppError("FILE_BATCH_TOO_MANY", `Batch size ${String(totalCount)} exceeds the 100 limit`);
     }
     const appId = (0, shared_1.resolveAppId)(opts);
     // destructive guardrail
     const tty = (0, render_1.isStdoutTty)();
     if (tty && !opts.yes) {
-        const ok = await confirm(totalCount);
+        // 单文件提示带具体目标方便用户核对；多文件传第一个 input 占位（实际只显示 N files）
+        // 上面已校验 totalCount > 0，paths/names 至少有一个非空
+        const firstInput = paths.length > 0 ? paths[0] : names[0];
+        const ok = await confirm(totalCount, firstInput);
         if (!ok) {
             throw new error_1.AppError("DESTRUCTIVE_CANCELLED", "Cancelled by user");
         }
@@ -173,6 +183,7 @@ async function handleFileRm(paths, opts) {
                     input,
                     code: "INTERNAL_ERROR",
                     message: "Delete request returned success but file still exists (server-side issue)",
+                    hint: undefined,
                 };
             }
             catch (err) {
@@ -181,12 +192,14 @@ async function handleFileRm(paths, opts) {
                         input,
                         code: "FILE_NOT_FOUND",
                         message: `File '${input}' does not exist at delete time`,
+                        hint: "Run `miaoda file ls` to see available files.",
                     };
                 }
                 return {
                     input,
                     code: "INTERNAL_ERROR",
                     message: err instanceof Error ? err.message : "verification failed",
+                    hint: undefined,
                 };
             }
         }));
@@ -194,7 +207,9 @@ async function handleFileRm(paths, opts) {
             results.push({
                 status: "error",
                 input: c.input,
-                error: { code: c.code, message: c.message },
+                error: c.hint
+                    ? { code: c.code, message: c.message, hint: c.hint }
+                    : { code: c.code, message: c.message },
             });
         }
     }
@@ -233,7 +248,12 @@ async function handleFileRm(paths, opts) {
             else
                 lines.push(`FAIL\t${r.input}\t${r.error.message}`);
         }
-        lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files`);
+        if (failCount === 0) {
+            lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files`);
+        }
+        else {
+            lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files (${String(failCount)} failed)`);
+        }
         (0, output_1.emit)(lines.join("\n"));
     }
     // 退出码：任一失败 → 1；全成功 → 0

package/dist/utils/error.js

@@ -5,12 +5,14 @@ class AppError extends Error {
     code;
     retryable;
     next_actions;
+    statement_index;
     constructor(code, message, opts) {
         super(message);
         this.name = "AppError";
         this.code = code;
         this.retryable = opts?.retryable ?? false;
         this.next_actions = opts?.next_actions ?? [];
+        this.statement_index = opts?.statement_index;
     }
     toJSON() {
         return {
@@ -18,6 +20,7 @@ class AppError extends Error {
             message: this.message,
             retryable: this.retryable,
             next_actions: this.next_actions,
+            statement_index: this.statement_index,
         };
     }
 }

package/dist/utils/http.js

@@ -12,7 +12,7 @@ let runtimeClient;
 /**
  * 获取单例 HttpClient（默认：管理端 innerapi）。
  *
- * 管理端链路仅适用于妙搭开发态——baseURL 从 `MIAODA_DEV_INNER_DOMAIN` 读取，
+ * 管理端链路仅适用于妙搭开发态——baseURL 从 `MIAODA_DEV_INNER_DOMAIN_WITH_PREFIX` 读取，
  * 每次请求自动从 `MIAODA_AUTHN_CODE` 读取用户凭证并注入 `X-Miaoda-Client-Token`。
  * AK/SK 的 `Authorization` / `x-api-key` 照旧叠加。
  *

package/dist/utils/output.js

@@ -44,6 +44,9 @@ function emitError(err) {
         if (info.next_actions && info.next_actions.length > 0) {
             errObj.hint = info.next_actions.join(" ");
         }
+        if (typeof info.statement_index === "number") {
+            errObj.statement_index = info.statement_index;
+        }
         process.stderr.write(JSON.stringify({ error: errObj }) + "\n");
     }
     else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.0-alpha.ca2912e",
+  "version": "0.1.0-alpha.ec1a658",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -25,7 +25,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@lark-apaas/http-client": "^0.1.4",
+    "@lark-apaas/http-client": "^0.1.5",
     "commander": "^13.1.0"
   },
   "devDependencies": {