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

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

@@ -32,14 +32,22 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 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 logger_1 = require("../../../utils/logger");
 const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
 const index_1 = require("../../../api/db/index");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
 /**
  * miaoda db sql <query> — 执行任意 SQL。
  *
@@ -47,7 +55,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 +74,124 @@ 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]);
+        await maybeSyncAgentSchema(results);
+        return;
+    }
+    // 多语句：每条 statement 独立结果
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: results.map((r) => toMultiElement((0, index_1.parseSqlResult)(r))) });
+    }
+    else {
+        renderMultiPretty(results);
+    }
+    await maybeSyncAgentSchema(results);
+}
+/**
+ * 当本次 SQL 包含成功执行的 DDL 时，触发 `npm run gen:db-schema`（实质执行
+ * fullstack-cli gen-db-schema → drizzle-kit introspect）同步 agent 项目的
+ * schema.ts。**弱依赖**：失败不阻塞主流程退出码。
+ *
+ * 行为细节：
+ *   - 仅当 cwd/package.json 定义了 gen:db-schema 脚本时才尝试运行；非 agent
+ *     项目静默跳过
+ *   - 默认静默捕获子进程 stdout/stderr，成功只打一行 "Agent schema synced"，
+ *     失败时把捕获的输出回放给用户排查；--verbose 实时透传方便看进度
+ *   - 加 60s 兜底超时：drizzle-kit introspect 通常 < 30s，超时直接 SIGKILL，
+ *     避免 DB 慢或网络抖动时把 CLI 挂死
+ *   - 子进程的 stdout / stderr 都不会进入当前 CLI 的 stdout，--json 输出干净
+ *
+ * 调用时机：在 SQL 主输出 emit 完成之后；execSql 已经返回意味着所有
+ * statement 都执行成功，无需再校验逐条状态。
+ */
+/** agent runtime 中固定的项目根目录；放在此处便于以后调整。 */
+const AGENT_PROJECT_ROOT = "/home/gem/workspace/code";
+/** drain 子进程 pipe stream：默认静默模式下消费 chunk 防止缓冲区反压。 */
+function drainChunk(_chunk) {
+    // 显式接 chunk 参数让 ESLint 不再当成 empty function；不做任何处理
+}
+async function maybeSyncAgentSchema(results) {
+    if (!hasDdl(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");
         return;
     }
-    // 其他场景：展示最后一条
-    const last = results[results.length - 1];
-    renderSingle(last);
+    const verbose = (0, config_1.getConfig)().verbose;
+    // drizzle-kit introspect 通常 < 30s；60s 兜底，超过即认为卡住
+    const TIMEOUT_MS = 60_000;
+    (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"],
+                cwd: projectRoot,
+            });
+            // --verbose：实时透传到 stderr 看进度；默认完全静默丢弃。
+            // 任何路径下子进程输出都不会进入当前 CLI 的 stdout，--json 模式安全。
+            // 注：默认路径必须 attach 监听器，否则 pipe 缓冲区写满会反压子进程。
+            if (verbose) {
+                proc.stdout.pipe(process.stderr);
+                proc.stderr.pipe(process.stderr);
+            }
+            else {
+                proc.stdout.on("data", drainChunk);
+                proc.stderr.on("data", drainChunk);
+            }
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                proc.kill("SIGKILL");
+            }, TIMEOUT_MS);
+            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`);
+                }
+                else if (code !== 0 && code !== null) {
+                    (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");
+                }
+                resolve();
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timer);
+                (0, logger_1.debug)(`[db sql] gen:db-schema spawn error: ${err.message}`);
+                resolve();
+            });
+        });
+    }
+    catch (err) {
+        (0, logger_1.debug)(`[db sql] gen:db-schema unexpected error: ${String(err)}`);
+    }
+}
+/**
+ * 校验 AGENT_PROJECT_ROOT 是否是一个有效的 agent 项目（package.json 含
+ * `gen:db-schema` 脚本）。命中返回路径；缺失任一条件返 null，让调用方静默跳过。
+ *
+ * 这里不再从 process.cwd() 向上查找：agent runtime 里项目根是固定路径，
+ * 在 CLI 之外（本地手动跑 miaoda db sql）也不应触发同步。
+ */
+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 pkg = JSON.parse(raw);
+        if (pkg.scripts?.["gen:db-schema"])
+            return AGENT_PROJECT_ROOT;
+    }
+    catch {
+        // 路径不存在 / 不可读 / 不是 agent 项目 → 静默跳过
+    }
+    return null;
+}
+/** 是否有任意一条 statement 是 DDL（CREATE / ALTER / DROP / GRANT / TRUNCATE / COMMENT 等）。 */
+function hasDdl(results) {
+    return results.some((r) => (0, index_1.parseSqlResult)(r).kind === "ddl");
 }
 /** 读取 stdin 并返回完整 SQL 文本（stdin 不是 TTY 即认为被 pipe）。 */
 async function readSql(inline) {
@@ -130,10 +241,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 +253,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);
@@ -81,6 +82,7 @@ async function handleFileLs(opts) {
         sizeGt,
         sizeLt,
         uploadedSince: opts.uploadedSince,
+        uploadedUntil: opts.uploadedUntil,
     });
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emitPaged)(result.items, result.next_cursor, result.has_more);

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/cli/help.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiaodaHelp = void 0;
+const commander_1 = require("commander");
+/**
+ * MiaodaHelp 重写 commander 默认的 --help 输出，使之对齐 CLI 文档规范：
+ *
+ *   1. 描述放在最前（commander 默认是 Usage 在前、描述在后）
+ *   2. "Options:" 重命名为 "Flags:"，"Global Options:" 重命名为 "Global Flags:"
+ *   3. Usage 段独占一行 Heading + 缩进展示 usage 行
+ *   4. 段落顺序：描述 → Usage → Arguments → Flags → Global Flags → Commands → addHelpText('after')
+ *
+ * Notes / Examples 段由各命令通过 addHelpText('after', ...) 自行追加，
+ * 本类不直接生成 —— 框架与文案分层。
+ */
+class MiaodaHelp extends commander_1.Help {
+    // 全局默认开启：所有子命令 --help 都展示 Global Flags 段
+    showGlobalOptions = true;
+    /**
+     * 父级 --help 的 Commands 列表里展示子命令调用形态。规范要求 "<args> [flags]"
+     * 顺序，但 commander 默认 subcommandTerm 是 "name [options] <args>"。
+     *
+     *   - 子命令是分组（含下级 subcommand）→ 只显示 name，不带 args/flags
+     *   - 子命令是 leaf 且配置了 usage()  → "name <usage>"，对齐 args 在前 / flags 在后
+     *   - leaf 没配置 usage              → 退回 commander 默认行为
+     */
+    subcommandTerm(cmd) {
+        if (cmd.commands.length > 0) {
+            return cmd.name();
+        }
+        const usage = cmd.usage();
+        if (usage) {
+            return `${cmd.name()} ${usage}`.trim();
+        }
+        return super.subcommandTerm(cmd);
+    }
+    formatHelp(cmd, helper) {
+        const termWidth = helper.padWidth(cmd, helper);
+        const helpWidth = helper.helpWidth ?? 80;
+        const formatItem = (term, description) => {
+            if (description) {
+                const padding = " ".repeat(Math.max(termWidth - term.length, 0) + 2);
+                return `${term}${padding}${description}`;
+            }
+            return term;
+        };
+        const formatList = (lines) => lines.map((l) => "  " + l).join("\n");
+        void helpWidth; // 保留以备后续按宽度自动 wrap，当前直接透传 description
+        const out = [];
+        // 1. 描述
+        const desc = helper.commandDescription(cmd);
+        if (desc) {
+            out.push(desc, "");
+        }
+        // 2. Usage：独立 heading + 缩进
+        out.push("Usage:", `  ${helper.commandUsage(cmd)}`, "");
+        // 3. Arguments
+        const args = helper.visibleArguments(cmd).map((a) => formatItem(helper.argumentTerm(a), helper.argumentDescription(a)));
+        if (args.length) {
+            out.push("Arguments:", formatList(args), "");
+        }
+        // 4. Flags（原 Options）
+        const opts = helper.visibleOptions(cmd).map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
+        if (opts.length) {
+            out.push("Flags:", formatList(opts), "");
+        }
+        // 5. Global Flags（原 Global Options，showGlobalOptions=true 时启用）
+        if (this.showGlobalOptions) {
+            const globals = helper.visibleGlobalOptions(cmd).map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
+            if (globals.length) {
+                out.push("Global Flags:", formatList(globals), "");
+            }
+        }
+        // 6. Commands（仅父级命令组有）
+        const subs = helper.visibleCommands(cmd).map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
+        if (subs.length) {
+            out.push("Commands:", formatList(subs), "");
+        }
+        // 保留末尾换行：commander 用 join('\n') 拼 addHelpText('after') 段，
+        // 这里多留一个 \n，让 Notes / Examples 段与 Flags / Global Flags 段之间空一行。
+        return out.join("\n").replace(/\n+$/, "\n");
+    }
+}
+exports.MiaodaHelp = MiaodaHelp;

package/dist/main.js

@@ -5,15 +5,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const index_1 = require("./cli/commands/index");
+const help_1 = require("./cli/help");
 const config_1 = require("./utils/config");
 const log_id_1 = require("./utils/log_id");
 const output_1 = require("./utils/output");
 const package_json_1 = __importDefault(require("../package.json"));
+// MiaodaHelp 对齐 CLI 规范（描述置顶 / Flags / Global Flags / 段顺序）：
+// 在 Command.prototype 上 patch createHelp，让所有命令实例（含动态注册的
+// 子命令）统一走 MiaodaHelp 渲染，避免在每个子命令上重复 configureHelp。
+commander_1.Command.prototype.createHelp = function () {
+    return Object.assign(new help_1.MiaodaHelp(), this.configureHelp());
+};
 const program = new commander_1.Command();
 const { version } = package_json_1.default;
 program
     .name("miaoda")
     .description("妙搭平台命令行工具")
+    .usage("<command> [flags]")
     .version(version, "-v, --version", "显示版本号")
     .option("--json [fields]", "JSON 输出，可选字段级选择")
     .option("--output <format>", "输出格式（pretty|json）", "pretty")

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.d98ea14",
   "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": {