@lark-apaas/miaoda-cli 0.1.3 → 0.1.4

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

@@ -17,13 +17,13 @@ const COMMON_TIME_HELP = `
 function registerDeployCommands(program) {
     // PRD：`miaoda deploy` 自身即为触发发布；get / history / error-log 是子命令
     const deployCmd = program
-        .command("deploy")
-        .description("触发发布；支持 --wait 阻塞到终态。子命令：get / history / error-log")
+        .command('deploy')
+        .description('触发发布；支持 --wait 阻塞到终态。子命令：get / history / error-log')
         .addOption((0, shared_1.appIdOption)().hideHelp())
         .addOption((0, shared_1.branchOption)().hideHelp())
-        .option("--wait", "阻塞直到流水线终态", false)
-        .option("--timeout <sec>", "--wait 最长等待秒数（默认 300）", parseTimeout, 300)
-        .addHelpText("after", `
+        .option('--wait', '阻塞直到流水线终态', false)
+        .option('--timeout <sec>', '--wait 最长等待秒数（默认 300）', parseTimeout, 300)
+        .addHelpText('after', `
 不要用异步模式或后台模式调用 deploy（例如 &、nohup、后台 task、detached run，或任何会让命令提前返回的包装方式），否则调用可能提前结束，Agent 会误判发布已完成。
 部署前置检查（Agent 必须执行）
   miaoda deploy 跑的是当前分支的远端 HEAD——本地未 commit / 未 push 的代码不会进发布产物。
@@ -49,7 +49,7 @@ JSON 输出
   $ miaoda deploy history --status failed
 `);
     deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
-        (0, shared_1.rejectCliOverride)(deployCmd, "appId", "branch");
+        (0, shared_1.rejectCliOverride)(deployCmd, 'appId', 'branch');
         await (0, index_1.handleDeploy)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             branch: rawOpts.branch,
@@ -63,11 +63,11 @@ JSON 输出
 }
 function registerDeployGet(parent) {
     const cmd = parent
-        .command("get")
-        .description("查看指定发布单的详情")
-        .argument("<deploy-id>", "发布单 ID")
+        .command('get')
+        .description('查看指定发布单的详情')
+        .argument('<deploy-id>', '发布单 ID')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .addHelpText("after", `
+        .addHelpText('after', `
 JSON 输出
   {"data": {"ID": ..., "status": ..., "creator": "...", "createdAt": ..., "updatedAt": ..., ...}, "next_cursor": null, "has_more": false}
   ID 即 deploy-id（== pipelineTaskID）
@@ -77,7 +77,7 @@ JSON 输出
   $ miaoda deploy get 12345
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (deployId, rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleDeployGet)({
             deployId,
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
@@ -86,17 +86,17 @@ JSON 输出
 }
 function registerDeployHistory(parent) {
     const cmd = parent
-        .command("history")
-        .description("查询发布历史（按时间倒序，分页）")
+        .command('history')
+        .description('查询发布历史（按时间倒序，分页）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .addOption(new commander_1.Option("--status <status>", "状态过滤（pipeline 节点状态，大小写不敏感）")
-        .choices(["todo", "running", "success", "failed", "canceled", "hold_on"])
-        .argParser((0, shared_1.caseInsensitiveChoice)(["todo", "running", "success", "failed", "canceled", "hold_on"])))
-        .option("--since <time>", "起始时间")
-        .option("--until <time>", "截止时间")
-        .option("--limit <n>", "返回条数上限（1~100）", parseLimit, 50)
-        .option("--cursor <token>", "下一页游标")
-        .addHelpText("after", `${COMMON_TIME_HELP}
+        .addOption(new commander_1.Option('--status <status>', '状态过滤（pipeline 节点状态，大小写不敏感）')
+        .choices(['todo', 'running', 'success', 'failed', 'canceled', 'hold_on'])
+        .argParser((0, shared_1.caseInsensitiveChoice)(['todo', 'running', 'success', 'failed', 'canceled', 'hold_on'])))
+        .option('--since <time>', '起始时间')
+        .option('--until <time>', '截止时间')
+        .option('--limit <n>', '返回条数上限（1~100）', parseLimit, 50)
+        .option('--cursor <token>', '下一页游标')
+        .addHelpText('after', `${COMMON_TIME_HELP}
 JSON 输出
   {"data": [...], "next_cursor": "...", "has_more": true|false}
   data[].status 为可读字符串；data[].status_code 为 BAM 原始数字枚举。
@@ -106,8 +106,8 @@ JSON 输出
   $ miaoda deploy history --since 7d
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleDeployHistory)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             status: rawOpts.status,
@@ -120,11 +120,11 @@ JSON 输出
 }
 function registerDeployErrorLog(parent) {
     const cmd = parent
-        .command("error-log")
-        .description("查询指定发布的错误日志")
-        .argument("<deploy-id>", "发布单 ID")
+        .command('error-log')
+        .description('查询指定发布的错误日志')
+        .argument('<deploy-id>', '发布单 ID')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .addHelpText("after", `
+        .addHelpText('after', `
 JSON 输出
   {"data": [{"jobID": ..., "componentName": ..., "errorMsg": ...}], "next_cursor": null, "has_more": false}
 
@@ -132,7 +132,7 @@ JSON 输出
   $ miaoda deploy error-log 12345 --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (deployId, rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleDeployErrorLog)({
             deployId,
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),

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

@@ -13,40 +13,40 @@ const shared_1 = require("../../../cli/commands/shared");
 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}')`);
+        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("应用文件存储（TOS）的命令行操作集合。操作对象是 UGC 资源（用户上传的文件、应用运行时\n" +
-        "生成的报表 / 导出文件等），不涉及代码仓库里的本地文件。")
-        .usage("<command> [flags]");
+        .command('file')
+        .description('应用文件存储（TOS）的命令行操作集合。操作对象是 UGC 资源（用户上传的文件、应用运行时\n' +
+        '生成的报表 / 导出文件等），不涉及代码仓库里的本地文件。')
+        .usage('<command> [flags]');
     fileCmd.action(() => {
         fileCmd.outputHelp();
     });
     fileCmd
-        .command("ls")
-        .summary("列出 / 筛选文件")
-        .description("列出当前应用存储里的文件，支持按文件名、大小、上传时间筛选，以及游标分页。\n" +
-        "默认 pretty 输出省略 download_url（列宽限制），需获取请用 --json。")
-        .usage("[query] [flags]")
-        .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>", "上传时间下限（晚于该时间），支持：相对时间 1h / 2d / 1w；日期 YYYY-MM-DD；ISO 8601 如 2026-04-01T10:00:00Z")
-        .option("--uploaded-until <time>", "上传时间上限（早于该时间），支持：相对时间 1h / 2d / 1w；日期 YYYY-MM-DD；ISO 8601 如 2026-04-01T10:00:00Z")
-        .option("--limit <n>", "单次返回上限（正整数,默认 50）", parsePositiveInt, 50)
-        .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
-        .option("--all", "自动翻页返回全部结果")
+        .command('ls')
+        .summary('列出 / 筛选文件')
+        .description('列出当前应用存储里的文件，支持按文件名、大小、上传时间筛选，以及游标分页。\n' +
+        '默认 pretty 输出省略 download_url（列宽限制），需获取请用 --json。')
+        .usage('[query] [flags]')
+        .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>', '上传时间下限（晚于该时间）')
+        .option('--uploaded-until <time>', '上传时间上限（早于该时间）')
+        .option('--limit <n>', '单次返回上限（正整数,默认 50）', parsePositiveInt, 50)
+        .option('--cursor <token>', '分页游标，从上次响应的 next_cursor 取值')
+        .option('--all', '自动翻页返回全部结果')
         .action(async (query, opts) => {
         await (0, index_1.handleFileLs)({ ...opts, appId: (0, shared_1.resolveAppId)({}), query });
     })
-        .addHelpText("after", `
+        .addHelpText('after', `
 Examples:
   $ miaoda file ls
   file_name    path                                size      type              uploaded_at
@@ -62,16 +62,16 @@ Examples:
   ...
 `);
     fileCmd
-        .command("stat")
-        .summary("查看单文件元数据")
-        .description("查看单文件完整元数据，含 download_url（应用内消费）。\n" +
-        "需要公网可访问的临时链接请用 `file sign` 生成 signed_url。")
-        .usage("<file> [flags]")
-        .argument("<file>", "文件的路径或文件名（自动识别）")
+        .command('stat')
+        .summary('查看单文件元数据')
+        .description('查看单文件完整元数据，含 download_url（应用内消费）。\n' +
+        '需要公网可访问的临时链接请用 `file sign` 生成 signed_url。')
+        .usage('<file> [flags]')
+        .argument('<file>', '文件的路径或文件名（自动识别）')
         .action(async (file, opts) => {
         await (0, index_1.handleFileStat)(file, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
-        .addHelpText("after", `
+        .addHelpText('after', `
 Notes:
   - <file> 可传 path（推荐，全局唯一）或 file_name。
   - file_name 重名时报 AMBIGUOUS_FILE_NAME，需先 \`ls --name\` 拿到 path 再调用。
@@ -92,19 +92,19 @@ Examples:
     hint: Use path instead. Run \`miaoda file ls --name logo.png\` to see candidates.
 `);
     fileCmd
-        .command("cp")
-        .summary("上传或下载文件（方向由路径前缀自动判断）")
-        .description("上传或下载文件，方向由 src/dst 路径前缀自动判断：\n" +
-        "  / 开头           → 远程 TOS 路径\n" +
-        "  ./、~/、裸文件名  → 本地路径")
-        .usage("<src> <dst> [flags]")
-        .argument("<src>", "源：本地文件路径或远程文件路径 / 文件名")
-        .argument("<dst>", "目标：本地路径或远程路径")
-        .option("--rename <name>", "上传后在远端使用的新文件名")
+        .command('cp')
+        .summary('上传或下载文件（方向由路径前缀自动判断）')
+        .description('上传或下载文件，方向由 src/dst 路径前缀自动判断：\n' +
+        '  / 开头           → 远程 TOS 路径\n' +
+        '  ./、~/、裸文件名  → 本地路径')
+        .usage('<src> <dst> [flags]')
+        .argument('<src>', '源：本地文件路径或远程文件路径 / 文件名')
+        .argument('<dst>', '目标：本地路径或远程路径')
+        .option('--rename <name>', '上传后在远端使用的新文件名')
         .action(async (src, dst, opts) => {
         await (0, index_1.handleFileCp)(src, dst, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
-        .addHelpText("after", `
+        .addHelpText('after', `
 Notes:
   - 单文件上限 100 MB，超过请拆分或用 web console 上传。
   - 同目录下允许同 file_name 并存（每次上传生成新的 path），不会因重名失败。
@@ -139,18 +139,18 @@ Examples:
     hint: Split the file, or use the web console for large uploads.
 `);
     fileCmd
-        .command("rm")
-        .summary("删除一个或多个文件")
-        .description("删除一个或多个文件。<file> 可传 path（推荐）或 file_name，可混用。\n" +
-        "操作不可撤销（不进回收站），TTY 下默认会要求二次确认。")
-        .usage("[paths...] [flags]")
-        .argument("[paths...]", "要删除的文件，每项可填路径或文件名（自动识别）")
-        .option("-n, --name <name>", "按文件名删除（可重复指定）", (value, prev) => [...(prev ?? []), value])
-        .option("-y, --yes", "跳过交互确认；非交互场景必加")
+        .command('rm')
+        .summary('删除一个或多个文件')
+        .description('删除一个或多个文件。<file> 可传 path（推荐）或 file_name，可混用。\n' +
+        '操作不可撤销（不进回收站），TTY 下默认会要求二次确认。')
+        .usage('[paths...] [flags]')
+        .argument('[paths...]', '要删除的文件，每项可填路径或文件名（自动识别）')
+        .option('-n, --name <name>', '按文件名删除（可重复指定）', (value, prev) => [...(prev ?? []), value])
+        .option('-y, --yes', '跳过交互确认；非交互场景必加')
         .action(async (paths, opts) => {
         await (0, index_1.handleFileRm)(paths, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
-        .addHelpText("after", `
+        .addHelpText('after', `
 Notes:
   - 删除不可撤销，没有回收站。
   - 批量场景下失败项不影响其他项；全部成功退出码 0，任意一项失败退出码 1。
@@ -159,7 +159,7 @@ Notes:
 Examples:
   # 单文件删除（TTY 下需确认）
   $ miaoda file rm /images/brand/1858537546760216.png
-  ? Delete '/images/brand/1858537546760216.png'? (y/N) y
+  ? Are you sure you want to permanently delete '/images/brand/1858537546760216.png'? (y/N) y
   ✓ Deleted /images/brand/1858537546760216.png
 
   # 批量删除（混用 path 与 file_name）
@@ -182,18 +182,18 @@ Examples:
     hint: Use path instead. Run \`miaoda file ls --name logo.png\` to see candidates.
 `);
     fileCmd
-        .command("sign")
-        .summary("生成公网可访问的临时下载链接")
-        .description("生成 signed_url——公网可直接访问的临时下载链接，带过期时间。\n" +
-        "仅在需要浏览器打开 / 公网分享时使用；应用代码内引用文件请用 download_url\n" +
-        "（来自 cp 或 stat），无需 sign。")
-        .usage("<file> [flags]")
-        .argument("<file>", "文件的路径或文件名")
-        .option("--expires <duration>", "链接有效期，支持 30m / 24h / 7d 等单位（默认 1d，最长 30d）")
+        .command('sign')
+        .summary('生成公网可访问的临时下载链接')
+        .description('生成 signed_url——公网可直接访问的临时下载链接，带过期时间。\n' +
+        '仅在需要浏览器打开 / 公网分享时使用；应用代码内引用文件请用 download_url\n' +
+        '（来自 cp 或 stat），无需 sign。')
+        .usage('<file> [flags]')
+        .argument('<file>', '文件的路径或文件名')
+        .option('--expires <duration>', '链接有效期，支持 30m / 24h / 7d 等单位（默认 1d，最长 30d）')
         .action(async (file, opts) => {
         await (0, index_1.handleFileSign)(file, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
-        .addHelpText("after", `
+        .addHelpText('after', `
 Notes:
   - <file> 可传 path（推荐）或 file_name；重名报 AMBIGUOUS_FILE_NAME。
   - signed_url 会过期，不要持久化到数据库。永久引用请用 download_url。
@@ -209,5 +209,32 @@ Examples:
   $ miaoda file sign /images/brand/1858537546760216.png --expires 60d
   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('查看文件存储的用量与配额')
+        .description('查看文件存储的用量与配额。')
+        .usage('[flags]')
+        .action(async function () {
+        await (0, index_1.handleFileQuota)(this.optsWithGlobals());
+    })
+        .addHelpText('after', `
+Examples:
+  $ miaoda file quota
+   Storage:  150 MB / 1 GB (15%)
+     Files:  42
+
+  # --json
+  $ miaoda file quota --json
+  {
+    "data": {
+      "storage_used_bytes": 157286400,
+      "storage_quota_bytes": 1073741824,
+      "usage_percent": 15,
+      "files": 42
+    },
+    "next_cursor": null,
+    "has_more": false
+  }
 `);
 }

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

@@ -16,12 +16,12 @@ const COMMON_TIME_HELP = `
 `;
 function registerObservabilityCommands(program) {
     const obCmd = program
-        .command("observability")
-        .description("可观测性：查询线上日志、链路、监控指标、运营指标");
+        .command('observability')
+        .description('可观测性：查询线上日志、链路、监控指标、运营指标');
     obCmd.action(() => {
         obCmd.outputHelp();
     });
-    obCmd.addHelpText("after", `
+    obCmd.addHelpText('after', `
 作用范围
   仅供 Agent 在妙搭沙箱内调用，查询当前应用的线上观测数据。所有命令为只读。
   应用上下文：--app-id <id> 或环境变量 MIAODA_APP_ID。
@@ -37,26 +37,26 @@ function registerObservabilityCommands(program) {
 // ── log ──
 function registerLog(parent) {
     const cmd = parent
-        .command("log")
-        .description("查询线上运行日志（按时间倒序，分页）")
+        .command('log')
+        .description('查询线上运行日志（按时间倒序，分页）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .addOption(new commander_1.Option("--level <level>", "日志级别（大小写不敏感）")
-        .choices(["DEBUG", "INFO", "WARN", "ERROR"])
-        .argParser((0, shared_1.caseInsensitiveChoice)(["DEBUG", "INFO", "WARN", "ERROR"])))
-        .option("--since <time>", "开始时间")
-        .option("--until <time>", "截止时间")
-        .option("--log-id <id>", "按请求 logid 过滤（attributes.ob_data_id）")
-        .option("--trace-id <id>", "按 trace ID 过滤")
-        .option("--grep <pattern>", "按关键字模糊搜索 body")
-        .option("--module <name>", "按模块名过滤")
-        .option("--user-id <user-id>", "按触发用户 ID 过滤")
-        .option("--page <path>", "按页面路径过滤")
-        .option("--api <path>", "按接口路径过滤")
-        .option("--min-duration <ms>", "最小耗时过滤（毫秒）")
-        .option("--max-duration <ms>", "最大耗时过滤（毫秒）")
-        .option("--limit <n>", "返回条数上限（1~100）", parseLimit, 50)
-        .option("--cursor <token>", "下一页游标，从上一次返回的 next_cursor 取值")
-        .addHelpText("after", `${COMMON_TIME_HELP}
+        .addOption(new commander_1.Option('--level <level>', '日志级别（大小写不敏感）')
+        .choices(['DEBUG', 'INFO', 'WARN', 'ERROR'])
+        .argParser((0, shared_1.caseInsensitiveChoice)(['DEBUG', 'INFO', 'WARN', 'ERROR'])))
+        .option('--since <time>', '开始时间')
+        .option('--until <time>', '截止时间')
+        .option('--log-id <id>', '按请求 logid 过滤（attributes.ob_data_id）')
+        .option('--trace-id <id>', '按 trace ID 过滤')
+        .option('--grep <pattern>', '按关键字模糊搜索 body')
+        .option('--module <name>', '按模块名过滤')
+        .option('--user-id <user-id>', '按触发用户 ID 过滤')
+        .option('--page <path>', '按页面路径过滤')
+        .option('--api <path>', '按接口路径过滤')
+        .option('--min-duration <ms>', '最小耗时过滤（毫秒）')
+        .option('--max-duration <ms>', '最大耗时过滤（毫秒）')
+        .option('--limit <n>', '返回条数上限（1~100）', parseLimit, 50)
+        .option('--cursor <token>', '下一页游标，从上一次返回的 next_cursor 取值')
+        .addHelpText('after', `${COMMON_TIME_HELP}
 JSON 输出
   {"data": [...], "next_cursor": "...", "has_more": true|false}
 
@@ -67,8 +67,8 @@ JSON 输出
   $ miaoda observability log --api /api/orders --min-duration 200 --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleObservabilityLog)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             level: rawOpts.level,
@@ -90,22 +90,22 @@ JSON 输出
 }
 // ── trace ──
 function registerTrace(parent) {
-    const traceCmd = parent.command("trace").description("链路追踪：列表 / 详情");
+    const traceCmd = parent.command('trace').description('链路追踪：列表 / 详情');
     traceCmd.action(() => {
         traceCmd.outputHelp();
     });
     const listCmd = traceCmd
-        .command("list")
-        .description("查询线上链路列表（按链路时间倒序，分页）")
+        .command('list')
+        .description('查询线上链路列表（按链路时间倒序，分页）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .option("--since <time>", "开始时间")
-        .option("--until <time>", "截止时间")
-        .option("--trace-id <id>", "按 trace ID 过滤")
-        .option("--root-span <span-name>", "按入口节点关键词过滤")
-        .option("--user-id <user-id>", "按触发用户 ID 过滤")
-        .option("--limit <n>", "返回条数上限（1~100）", parseLimit, 50)
-        .option("--cursor <token>", "下一页游标")
-        .addHelpText("after", `${COMMON_TIME_HELP}
+        .option('--since <time>', '开始时间')
+        .option('--until <time>', '截止时间')
+        .option('--trace-id <id>', '按 trace ID 过滤')
+        .option('--root-span <span-name>', '按入口节点关键词过滤')
+        .option('--user-id <user-id>', '按触发用户 ID 过滤')
+        .option('--limit <n>', '返回条数上限（1~100）', parseLimit, 50)
+        .option('--cursor <token>', '下一页游标')
+        .addHelpText('after', `${COMMON_TIME_HELP}
 JSON 输出
   {"data": [...], "next_cursor": "...", "has_more": true|false}
 
@@ -114,8 +114,8 @@ JSON 输出
   $ miaoda observability trace list --root-span api-gateway --limit 20 --json
 `);
     listCmd.action((0, shared_1.withHelp)(listCmd, async (rawOpts) => {
-        (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
-        (0, shared_1.rejectCliOverride)(listCmd, "appId");
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(listCmd, 'appId');
         await (0, index_1.handleObservabilityTraceList)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             since: rawOpts.since,
@@ -128,12 +128,12 @@ JSON 输出
         });
     }));
     const getCmd = traceCmd
-        .command("get")
-        .description("查询指定链路的完整详情")
-        .argument("<trace-id>", "链路 ID")
+        .command('get')
+        .description('查询指定链路的完整详情')
+        .argument('<trace-id>', '链路 ID')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .option("--with-log-severity-count", "返回每个 Span 各日志级别的数量", false)
-        .addHelpText("after", `
+        .option('--with-log-severity-count', '返回每个 Span 各日志级别的数量', false)
+        .addHelpText('after', `
 JSON 输出
   {"data": {"spans": [...], "isBreak": false}}
 
@@ -146,7 +146,7 @@ JSON 输出
     hint: 检查 trace-id 是否正确，或链路已超出保留时长
 `);
     getCmd.action((0, shared_1.withHelp)(getCmd, async (traceId, rawOpts) => {
-        (0, shared_1.rejectCliOverride)(getCmd, "appId");
+        (0, shared_1.rejectCliOverride)(getCmd, 'appId');
         await (0, index_1.handleObservabilityTraceGet)({
             traceId,
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
@@ -157,20 +157,20 @@ JSON 输出
 // ── metric ──
 function registerMetric(parent) {
     const cmd = parent
-        .command("metric")
-        .description("查询监控指标：requests / latency / cpu / memory")
-        .argument("<metric-name>", "指标名：requests | latency | cpu | memory")
+        .command('metric')
+        .description('查询监控指标：requests / latency / cpu / memory')
+        .argument('<metric-name>', '指标名：requests | latency | cpu | memory')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .option("--page <path>", "按页面路径过滤（仅对 requests/latency 生效）")
-        .option("--api <path>", "按接口路径过滤（仅对 requests/latency 生效）")
-        .option("--series <name>", "过滤图表中的某条线：latency 取 p50/p99；requests 取 total/error；缺省返回所有相关线")
-        .option("--since <time>", "开始时间")
-        .option("--until <time>", "截止时间")
-        .addOption(new commander_1.Option("--down-sample <duration>", "降采样粒度（1m=1分钟 / 1h=1小时 / 1d=1天，大小写不敏感）")
-        .choices(["1m", "1h", "1d"])
-        .argParser((0, shared_1.caseInsensitiveChoice)(["1m", "1h", "1d"]))
-        .default("1m"))
-        .addHelpText("after", `${COMMON_TIME_HELP}
+        .option('--page <path>', '按页面路径过滤（仅对 requests/latency 生效）')
+        .option('--api <path>', '按接口路径过滤（仅对 requests/latency 生效）')
+        .option('--series <name>', '过滤图表中的某条线：latency 取 p50/p99；requests 取 total/error；缺省返回所有相关线')
+        .option('--since <time>', '开始时间')
+        .option('--until <time>', '截止时间')
+        .addOption(new commander_1.Option('--down-sample <duration>', '降采样粒度（1m=1分钟 / 1h=1小时 / 1d=1天，大小写不敏感）')
+        .choices(['1m', '1h', '1d'])
+        .argParser((0, shared_1.caseInsensitiveChoice)(['1m', '1h', '1d']))
+        .default('1m'))
+        .addHelpText('after', `${COMMON_TIME_HELP}
 JSON 输出
   {"data": [{"metricName": "...", "dimensions": {...}, "dataPoints": [...]}], "next_cursor": null, "has_more": false}
 
@@ -181,8 +181,8 @@ JSON 输出
   $ miaoda observability metric cpu --since 1d --down-sample 1d --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (metricName, rawOpts) => {
-        (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleObservabilityMetric)({
             metricName,
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
@@ -198,16 +198,16 @@ JSON 输出
 // ── analytics ──
 function registerAnalytics(parent) {
     const cmd = parent
-        .command("analytics")
-        .description("查询运营指标：users（用户数）/ page-view（页面访问）")
-        .argument("<analytics-name>", "指标名：users | page-view")
+        .command('analytics')
+        .description('查询运营指标：users（用户数）/ page-view（页面访问）')
+        .argument('<analytics-name>', '指标名：users | page-view')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .option("--page <path>", "按页面路径过滤（仅对 page-view 生效）")
-        .option("--series <name>", "过滤图表中的某条线：users 取 active/new/total（兼容 active-users/new-users/total-users）；page-view 取 all/desktop/mobile（兼容 all-view/desktop-view/mobile-view）")
-        .option("--since <time>", "开始时间")
-        .option("--until <time>", "截止时间")
-        .option("--granularity <duration>", "时间粒度：day | week | month", "day")
-        .addHelpText("after", `${COMMON_TIME_HELP}
+        .option('--page <path>', '按页面路径过滤（仅对 page-view 生效）')
+        .option('--series <name>', '过滤图表中的某条线：users 取 active/new/total（兼容 active-users/new-users/total-users）；page-view 取 all/desktop/mobile（兼容 all-view/desktop-view/mobile-view）')
+        .option('--since <time>', '开始时间')
+        .option('--until <time>', '截止时间')
+        .option('--granularity <duration>', '时间粒度：day | week | month', 'day')
+        .addHelpText('after', `${COMMON_TIME_HELP}
 JSON 输出
   {"data": [{"metricType": "...", "points": [{"timestampNs": "...", "value": ..., "dimensions": {...}}]}], "next_cursor": null, "has_more": false}
 
@@ -217,8 +217,8 @@ JSON 输出
   $ miaoda observability analytics page-view --granularity week --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (analyticsName, rawOpts) => {
-        (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleObservabilityAnalytics)({
             analyticsName,
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),