@lark-apaas/miaoda-cli 0.1.0 → 0.1.1

package/dist/cli/help.js

@@ -0,0 +1,188 @@
+"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 → Commands → Flags → Global Flags
+ *      → Notes（addHelpText） → Examples（addHelpText）
+ *      （父命令不带 Examples，由 formatHelp 末尾自动追加 "Use ... --help" 提示）
+ *   5. Root 命令的 local options 视作 Global Flags（root 无 command-specific flag）
+ *   6. 子命令隐藏 -v / --version（仅 root 暴露）和自动生成的 `help` 子命令
+ *
+ * Notes / Examples 段由各命令通过 addHelpText('after', ...) 自行追加，
+ * 本类不直接生成 —— 框架与文案分层。
+ */
+class MiaodaHelp extends commander_1.Help {
+    // 全局默认开启：所有子命令 --help 都展示 Global Flags 段
+    showGlobalOptions = true;
+    /**
+     * 父级 --help 的 Commands 列表里展示子命令调用形态。spec 要求只展示
+     * `name <args>` 不带 `[flags]` 尾巴：
+     *
+     *   - 子命令是分组（含下级 subcommand）→ 只显示 name
+     *   - 子命令是 leaf 且配置了 usage()  → "name <args>"（usage 末尾的 [flags] 去掉）
+     *   - leaf 没配置 usage              → 退回 commander 默认行为
+     */
+    subcommandTerm(cmd) {
+        if (cmd.commands.length > 0) {
+            return cmd.name();
+        }
+        const usage = cmd.usage();
+        if (usage) {
+            // 去掉末尾的 [flags] / [options]，对齐 spec 的 "name <args>" 形态
+            const argsOnly = usage.replace(/\s*\[(?:flags|options)\]\s*$/i, "").trim();
+            return argsOnly ? `${cmd.name()} ${argsOnly}` : cmd.name();
+        }
+        return super.subcommandTerm(cmd);
+    }
+    /**
+     * 父命令的 Commands 列表里：
+     *   - 优先用子命令的 .summary()（短摘要，对齐 spec 父级列表用的简短描述）
+     *   - 否则取 description 首行，避免多行 description 把列表撑乱
+     * 叶子命令自身 --help 仍展示完整 description。
+     */
+    subcommandDescription(cmd) {
+        const summary = cmd.summary();
+        if (summary)
+            return summary;
+        const desc = super.subcommandDescription(cmd);
+        const idx = desc.indexOf("\n");
+        return idx === -1 ? desc : desc.slice(0, idx);
+    }
+    /**
+     * Flags 段里去掉那些已经在父命令注册过的选项（避免在 Flags 与 Global Flags
+     * 里重复展示，例如 --env 在 db 父级注册后，leaf 即使本地也注册一份也只在
+     * Global Flags 里出现一次）。
+     */
+    visibleOptions(cmd) {
+        const opts = super.visibleOptions(cmd);
+        if (!cmd.parent)
+            return opts;
+        const parentLongs = new Set();
+        let p = cmd.parent;
+        while (p) {
+            for (const o of p.options) {
+                if (o.long)
+                    parentLongs.add(o.long);
+            }
+            p = p.parent;
+        }
+        return opts.filter((o) => !o.long || !parentLongs.has(o.long));
+    }
+    /**
+     * 子命令 --help 默认会从父级继承 -v, --version；spec 只在 root 列这条。
+     * 非 root 命令把 --version 从 Global Flags 列表里过滤掉。
+     */
+    visibleGlobalOptions(cmd) {
+        const opts = super.visibleGlobalOptions(cmd);
+        if (cmd.parent) {
+            return opts.filter((o) => o.long !== "--version" && o.short !== "-v");
+        }
+        return opts;
+    }
+    /**
+     * Root 命令默认会列 commander 自动生成的 `help [command]` 子命令；
+     * spec 不展示这一条，过滤掉。
+     */
+    visibleCommands(cmd) {
+        return super.visibleCommands(cmd).filter((c) => c.name() !== "help");
+    }
+    formatHelp(cmd, helper) {
+        const isRoot = cmd.parent == null;
+        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. Commands（仅父级命令组有，spec 要求 Commands 在 Flags 前）
+        //    spec 不展示 Arguments 段，参数说明放在 description 文本里
+        const subs = helper.visibleCommands(cmd).map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
+        if (subs.length) {
+            out.push("Commands:", formatList(subs), "");
+        }
+        // 5. Flags（叶子命令专属 options）
+        //    - Root / 父命令组：local options 都视作"会被子命令继承的 globals"，渲染到 Global Flags 段
+        //    - 叶子命令（无子命令）：local options 渲染到 Flags 段（如 db data export 的 --format）
+        //    - `-h, --help` 永远不放 Flags 段，统一放 Global Flags（spec 约定）
+        const isParent = subs.length > 0;
+        if (!isRoot && !isParent) {
+            const opts = helper.visibleOptions(cmd)
+                .filter((o) => !isHelpOption(o))
+                .map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
+            if (opts.length) {
+                out.push("Flags:", formatList(opts), "");
+            }
+        }
+        // 6. Global Flags
+        //    - Root：local options 当 globals 渲染（root 自己就是 global 来源）
+        //    - 父命令组：继承自祖先的 globals + 自己的 local options（也会被子命令继承）
+        //    - 叶子命令：继承自祖先的 globals + 当前的 -h, --help
+        //    - 末尾确保 -h, --help 一条
+        const localOpts = helper.visibleOptions(cmd);
+        let globals = [];
+        if (isRoot) {
+            globals = localOpts;
+        }
+        else if (isParent) {
+            const inherited = helper.visibleGlobalOptions(cmd);
+            const localNonHelp = localOpts.filter((o) => !isHelpOption(o));
+            const helpOpt = localOpts.find(isHelpOption);
+            globals = [...inherited, ...localNonHelp];
+            if (helpOpt && !globals.includes(helpOpt))
+                globals.push(helpOpt);
+        }
+        else if (this.showGlobalOptions) {
+            const inherited = helper.visibleGlobalOptions(cmd);
+            const helpOpt = localOpts.find(isHelpOption);
+            globals = [...inherited];
+            if (helpOpt && !globals.includes(helpOpt))
+                globals.push(helpOpt);
+        }
+        if (globals.length) {
+            const lines = globals.map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
+            out.push("Global Flags:", formatList(lines), "");
+        }
+        // 7. 父命令底部追加 "Use <cmd> <subcommand> --help" 提示，对齐 spec
+        if (subs.length > 0) {
+            const path = cmd.name() === "miaoda" ? "miaoda" : commandPath(cmd);
+            out.push(`Use "${path} <command> --help" for more information about a command.`, "");
+        }
+        // 保留末尾换行：commander 用 join('\n') 拼 addHelpText('after') 段，
+        // 这里多留一个 \n，让 Notes / Examples 段与上面段落之间空一行。
+        return out.join("\n").replace(/\n+$/, "\n");
+    }
+}
+exports.MiaodaHelp = MiaodaHelp;
+/** 判断是否为 -h / --help 选项。 */
+function isHelpOption(o) {
+    return o.long === "--help" || o.short === "-h";
+}
+/** 拼接命令完整路径，例如 db schema -> "miaoda db schema"。 */
+function commandPath(cmd) {
+    const names = [];
+    let cur = cmd;
+    while (cur) {
+        names.unshift(cur.name());
+        cur = cur.parent;
+    }
+    return names.join(" ");
+}

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("妙搭平台命令行工具")
+    .description("妙搭平台 CLI，提供数据服务、文件存储、插件管理等命令行操作。")
+    .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

@@ -1,30 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getHttpClient = getHttpClient;
+exports.getRuntimeHttpClient = getRuntimeHttpClient;
 exports.resetHttpClient = resetHttpClient;
 exports.setHttpClient = setHttpClient;
+exports.setRuntimeHttpClient = setRuntimeHttpClient;
 exports.applyCanaryHeader = applyCanaryHeader;
 const http_client_1 = require("@lark-apaas/http-client");
-let client;
-/** 获取单例 HttpClient，首次调用时初始化 */
+let adminClient;
+let runtimeClient;
+/**
+ * 获取单例 HttpClient（默认：管理端 innerapi）。
+ *
+ * 管理端链路仅适用于妙搭开发态——baseURL 从 `MIAODA_DEV_INNER_DOMAIN_WITH_PREFIX` 读取，
+ * 每次请求自动从 `MIAODA_AUTHN_CODE` 读取用户凭证并注入 `X-Miaoda-Client-Token`。
+ * AK/SK 的 `Authorization` / `x-api-key` 照旧叠加。
+ *
+ * 访问运行端 innerapi（`/api/v1/studio/innerapi/...`）请使用 {@link getRuntimeHttpClient}。
+ */
 function getHttpClient() {
-    client ??= createClient();
-    return client;
+    adminClient ??= createClient({ adminInnerApi: true });
+    return adminClient;
 }
-/** 重建客户端 */
+/** 运行端 innerapi 单例。baseURL 来自 `FORCE_AUTHN_INNERAPI_DOMAIN`。 */
+function getRuntimeHttpClient() {
+    runtimeClient ??= createClient({ adminInnerApi: false });
+    return runtimeClient;
+}
+/** 重建管理端与运行端客户端（测试/配置变更后调用）。 */
 function resetHttpClient() {
-    client = undefined;
+    adminClient = undefined;
+    runtimeClient = undefined;
 }
-/** 替换为自定义 HttpClient 实例（用于测试 mock） */
+/** 替换管理端 HttpClient 实例（用于测试 mock）。 */
 function setHttpClient(custom) {
-    client = custom;
+    adminClient = custom;
+}
+/** 替换运行端 HttpClient 实例（用于测试 mock）。 */
+function setRuntimeHttpClient(custom) {
+    runtimeClient = custom;
 }
-function createClient() {
+function createClient(opts) {
     const config = {
         timeout: 30_000,
         platform: {
             enabled: true,
-            tokenProvider: { type: "file" },
+            adminInnerApi: opts.adminInnerApi,
         },
         security: {
             strictMode: true,

package/dist/utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setHttpClient = exports.resetHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.isJsonMode = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
+exports.setRuntimeHttpClient = exports.setHttpClient = exports.resetHttpClient = exports.getRuntimeHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.isJsonMode = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
 var error_1 = require("./error");
 Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return error_1.AppError; } });
 Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return error_1.HttpError; } });
@@ -21,5 +21,7 @@ Object.defineProperty(exports, "debug", { enumerable: true, get: function () { r
 Object.defineProperty(exports, "log", { enumerable: true, get: function () { return logger_1.log; } });
 var http_1 = require("./http");
 Object.defineProperty(exports, "getHttpClient", { enumerable: true, get: function () { return http_1.getHttpClient; } });
+Object.defineProperty(exports, "getRuntimeHttpClient", { enumerable: true, get: function () { return http_1.getRuntimeHttpClient; } });
 Object.defineProperty(exports, "resetHttpClient", { enumerable: true, get: function () { return http_1.resetHttpClient; } });
 Object.defineProperty(exports, "setHttpClient", { enumerable: true, get: function () { return http_1.setHttpClient; } });
+Object.defineProperty(exports, "setRuntimeHttpClient", { enumerable: true, get: function () { return http_1.setRuntimeHttpClient; } });

package/dist/utils/output.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isJsonMode = isJsonMode;
 exports.emit = emit;
 exports.emitError = emitError;
+exports.emitOk = emitOk;
+exports.emitPaged = emitPaged;
 const config_1 = require("./config");
 const error_1 = require("./error");
 function isJsonMode() {
@@ -30,19 +32,22 @@ function emit(data) {
 /**
  * 输出错误（写入 stderr）
  * - pretty 模式：Error: message\n  hint: ...
- * - json 模式：{"error_code": "...", "message": "...", "hint": "..."}
+ * - json 模式：PRD 约定 envelope 为 `{error: {code, message, hint?}}`
  */
 function emitError(err) {
     const info = toErrorInfo(err);
     if (isJsonMode()) {
-        const jsonErr = {
-            error_code: info.code,
+        const errObj = {
+            code: info.code,
             message: info.message,
         };
         if (info.next_actions && info.next_actions.length > 0) {
-            jsonErr.hint = info.next_actions.join(" ");
+            errObj.hint = info.next_actions.join(" ");
         }
-        process.stderr.write(JSON.stringify(jsonErr) + "\n");
+        if (typeof info.statement_index === "number") {
+            errObj.statement_index = info.statement_index;
+        }
+        process.stderr.write(JSON.stringify({ error: errObj }) + "\n");
     }
     else {
         process.stderr.write(`Error: ${info.message}\n`);
@@ -51,6 +56,14 @@ function emitError(err) {
         }
     }
 }
+/** 发送成功 JSON envelope（非分页）：`{ data }`。 */
+function emitOk(data) {
+    emit({ data });
+}
+/** 发送成功 JSON envelope（分页信封：`{ data, next_cursor, has_more }`）。 */
+function emitPaged(items, nextCursor, hasMore) {
+    emit({ data: items, next_cursor: nextCursor, has_more: hasMore });
+}
 function toErrorInfo(err) {
     if (err instanceof error_1.AppError)
         return err.toJSON();

package/dist/utils/render.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * CLI 渲染 / 解析工具：跨域共用的格式化、表格渲染、字符串解析。
+ *
+ * 按 AGENTS.md §2.2，跨域共享逻辑统一下沉到 `src/utils/*`。
+ * 这里聚合 db / file 域 handler 共用的纯函数：
+ *   - 格式化：formatSize / formatTime
+ *   - 表格渲染：renderAlignedTable / renderTsv / renderKeyValue
+ *   - 终端探测：isStdoutTty
+ *   - 字符串解析：parseDuration / parseSize
+ *
+ * JSON envelope 输出（emit / emitOk / emitPaged / emitError）见 ./output.ts。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSize = formatSize;
+exports.formatTime = formatTime;
+exports.visibleWidth = visibleWidth;
+exports.renderAlignedTable = renderAlignedTable;
+exports.renderTsv = renderTsv;
+exports.renderKeyValue = renderKeyValue;
+exports.isStdoutTty = isStdoutTty;
+exports.parseDuration = parseDuration;
+exports.parseSize = parseSize;
+/** 将字节数格式化为人类可读（`24 KB` / `2.1 MB` / `1.5 GB`）。 */
+function formatSize(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return "—";
+    if (bytes >= 1 << 30)
+        return `${(bytes / (1 << 30)).toFixed(1)} GB`;
+    if (bytes >= 1 << 20)
+        return `${(bytes / (1 << 20)).toFixed(1)} MB`;
+    if (bytes >= 1 << 10)
+        return `${(bytes / (1 << 10)).toFixed(0)} KB`;
+    return `${String(bytes)} bytes`;
+}
+/** 将 ISO 时间转为 TTY 下更友好的相对时间；non-TTY 保持 ISO 原值。 */
+function formatTime(iso, isTty) {
+    if (!iso)
+        return "—";
+    if (!isTty)
+        return iso;
+    const ts = Date.parse(iso);
+    if (Number.isNaN(ts))
+        return iso;
+    const diff = Date.now() - ts;
+    const minute = 60_000;
+    const hour = 60 * minute;
+    const day = 24 * hour;
+    if (diff < hour) {
+        const m = Math.max(1, Math.round(diff / minute));
+        return `${String(m)}m ago`;
+    }
+    if (diff < day) {
+        const h = Math.round(diff / hour);
+        return `${String(h)}h ago`;
+    }
+    if (diff < 7 * day) {
+        const d = Math.round(diff / day);
+        return `${String(d)}d ago`;
+    }
+    // 超过 7 天，用 YYYY-MM-DD
+    const date = new Date(ts);
+    const y = String(date.getFullYear());
+    const mo = String(date.getMonth() + 1).padStart(2, "0");
+    const da = String(date.getDate()).padStart(2, "0");
+    return `${y}-${mo}-${da}`;
+}
+/**
+ * SGR (Select Graphic Rendition) ANSI 转义匹配：`ESC[<digits;...>m`。
+ * 用于在列宽计算时剥离不显示的控制字符——否则带 ANSI 颜色的 cell 会按 .length
+ * 算进列宽（比如 dim "NULL" 实际占 4 字符但 .length=11），导致表格对齐错位。
+ */
+const ANSI_SGR_RE = /\[[0-9;]*m/g;
+/**
+ * 单字符的终端列宽：CJK 全角字符（汉字/假名/全角符号等）占 2 列，其它占 1 列。
+ * 对齐 Unicode East Asian Width 的 W/F 类，等价于 wcwidth 简化版。
+ * 不实现合字 / 零宽字符（ZWJ / 变体选择符）等极端情况，CLI 表格场景够用。
+ */
+function charWidth(cp) {
+    if ((cp >= 0x1100 && cp <= 0x115F) || // Hangul Jamo
+        cp === 0x2329 || cp === 0x232A ||
+        (cp >= 0x2E80 && cp <= 0x303E) || // CJK Radicals / Punctuation
+        (cp >= 0x3041 && cp <= 0x33FF) || // Hiragana / Katakana / CJK Symbols
+        (cp >= 0x3400 && cp <= 0x4DBF) || // CJK Ext A
+        (cp >= 0x4E00 && cp <= 0x9FFF) || // CJK Unified
+        (cp >= 0xA000 && cp <= 0xA4CF) || // Yi
+        (cp >= 0xAC00 && cp <= 0xD7A3) || // Hangul Syllables
+        (cp >= 0xF900 && cp <= 0xFAFF) || // CJK Compat Ideographs
+        (cp >= 0xFE30 && cp <= 0xFE4F) || // CJK Compat Forms
+        (cp >= 0xFF00 && cp <= 0xFF60) || // Fullwidth Forms
+        (cp >= 0xFFE0 && cp <= 0xFFE6) ||
+        (cp >= 0x20000 && cp <= 0x2FFFD) || // CJK Ext B-F
+        (cp >= 0x30000 && cp <= 0x3FFFD) // CJK Ext G-H
+    ) {
+        return 2;
+    }
+    return 1;
+}
+/** cell 可见字符宽度：剥离 ANSI 转义后按终端列宽逐字符累加（CJK 算 2 列）。 */
+function visibleWidth(s) {
+    const stripped = s.replace(ANSI_SGR_RE, "");
+    let w = 0;
+    for (const c of stripped) {
+        w += charWidth(c.codePointAt(0) ?? 0);
+    }
+    return w;
+}
+function padVisibleEnd(s, targetWidth) {
+    const w = visibleWidth(s);
+    return w >= targetWidth ? s : s + " ".repeat(targetWidth - w);
+}
+/** 渲染 TTY 对齐表格（多行，列宽按最长内容；ANSI 转义不计入列宽）。 */
+function renderAlignedTable(headers, rows) {
+    const colWidths = headers.map((h, i) => {
+        let w = visibleWidth(h);
+        for (const row of rows) {
+            const cw = visibleWidth(row[i] || "");
+            if (cw > w)
+                w = cw;
+        }
+        return w;
+    });
+    const lines = [];
+    lines.push(headers.map((h, i) => padVisibleEnd(h, colWidths[i])).join("  ").trimEnd());
+    for (const row of rows) {
+        lines.push(row.map((cell, i) => padVisibleEnd(cell || "", colWidths[i])).join("  ").trimEnd());
+    }
+    return lines.join("\n");
+}
+/** 渲染 non-TTY tab 分隔（字段原值，ISO 时间）。 */
+function renderTsv(headers, rows) {
+    const lines = [];
+    lines.push(headers.join("\t"));
+    for (const row of rows) {
+        lines.push(row.join("\t"));
+    }
+    return lines.join("\n");
+}
+/** 渲染 key-value 多行（用于 stat 等单条详情）。key 右对齐。 */
+function renderKeyValue(pairs, isTty) {
+    if (pairs.length === 0)
+        return "";
+    if (!isTty) {
+        return pairs.map(([k, v]) => `${k}\t${v}`).join("\n");
+    }
+    const keyWidth = Math.max(...pairs.map(([k]) => k.length));
+    return pairs
+        .map(([k, v]) => `${k.padStart(keyWidth)}:  ${v}`)
+        .join("\n");
+}
+/** 通用 isTTY 判定（stdout 是否交互终端）。Node 运行时 isTTY 为 true 或 undefined；TS 类型上 tty.WriteStream 定义为固定 true，绕开做运行时判断。 */
+function isStdoutTty() {
+    const isTTY = process.stdout.isTTY;
+    return isTTY === true;
+}
+/** 解析时长字符串 `7d` / `24h` / `30m` → 秒。无后缀按秒。 */
+function parseDuration(input) {
+    const m = /^(\d+)([smhd]?)$/.exec(input.trim());
+    if (!m) {
+        throw new Error(`Invalid duration: ${input}`);
+    }
+    const n = Number(m[1]);
+    const unit = m[2] || "s";
+    switch (unit) {
+        case "s": return n;
+        case "m": return n * 60;
+        case "h": return n * 3600;
+        case "d": return n * 86400;
+        default: return n;
+    }
+}
+/** 解析 size 字符串 `1MB` / `500KB` / `1GB` → 字节。 */
+function parseSize(input) {
+    const m = /^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)?$/i.exec(input.trim());
+    if (!m) {
+        throw new Error(`Invalid size: ${input}`);
+    }
+    const n = Number(m[1]);
+    const unit = (m[2] || "B").toUpperCase();
+    switch (unit) {
+        case "B": return Math.round(n);
+        case "KB": return Math.round(n * 1024);
+        case "MB": return Math.round(n * 1024 * 1024);
+        case "GB": return Math.round(n * 1024 * 1024 * 1024);
+        default: return Math.round(n);
+    }
+}

package/package.json

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