@lark-apaas/miaoda-cli 0.1.4 → 0.1.5

package/README.md

@@ -36,10 +36,11 @@ miaoda file ls --output json
 
 命令以"域"作为第一级命名空间：
 
-| 域 | 用途 |
-|---|---|
-| `miaoda file ...` | 文件操作：上传、下载、元数据、签名下载、批量删除 |
-| `miaoda db ...` | 数据操作：SQL 执行、表结构查询、数据导入导出 |
+| 域                         | 用途                                                 |
+| -------------------------- | ---------------------------------------------------- |
+| `miaoda file ...`          | 文件操作：上传、下载、元数据、签名下载、批量删除     |
+| `miaoda db ...`            | 数据操作：SQL 执行、表结构查询、数据导入导出         |
+| `miaoda observability ...` | 线上日志、链路、前端源码堆栈反查、监控指标、运营指标 |
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
 

package/dist/api/observability/api.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.searchLogs = searchLogs;
 exports.searchTraces = searchTraces;
 exports.getTraces = getTraces;
+exports.resolveStackTrace = resolveStackTrace;
 exports.queryMetricsData = queryMetricsData;
 exports.queryAnalyticsData = queryAnalyticsData;
 const http_1 = require("../../utils/http");
@@ -30,6 +31,15 @@ async function getTraces(req) {
         defaultErrCode: DEFAULT_ERR_CODE,
     });
 }
+// ── 前端源码堆栈反解 ──
+async function resolveStackTrace(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/resolve_stack_trace`;
+    const { appID: _appID, ...body } = req;
+    return (0, http_1.postInnerApi)(url, body, {
+        errPrefix: 'Failed to resolve frontend source stack',
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
 // ── 监控指标 ──
 async function queryMetricsData(req) {
     const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/metrics/data/query`;

package/dist/api/observability/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StatusCode = exports.SpanKind = exports.WordOperator = exports.spanSchema = exports.logItemSchema = exports.queryAnalyticsData = exports.queryMetricsData = exports.getTraces = exports.searchTraces = exports.searchLogs = void 0;
+exports.StatusCode = exports.SpanKind = exports.WordOperator = exports.spanSchema = exports.logItemSchema = exports.queryAnalyticsData = exports.queryMetricsData = exports.resolveStackTrace = exports.getTraces = exports.searchTraces = exports.searchLogs = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "searchLogs", { enumerable: true, get: function () { return api_1.searchLogs; } });
 Object.defineProperty(exports, "searchTraces", { enumerable: true, get: function () { return api_1.searchTraces; } });
 Object.defineProperty(exports, "getTraces", { enumerable: true, get: function () { return api_1.getTraces; } });
+Object.defineProperty(exports, "resolveStackTrace", { enumerable: true, get: function () { return api_1.resolveStackTrace; } });
 Object.defineProperty(exports, "queryMetricsData", { enumerable: true, get: function () { return api_1.queryMetricsData; } });
 Object.defineProperty(exports, "queryAnalyticsData", { enumerable: true, get: function () { return api_1.queryAnalyticsData; } });
 var schemas_1 = require("./schemas");

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

@@ -14,6 +14,24 @@ const COMMON_TIME_HELP = `
     1) 不带时区的形式与 pretty 输出闭环（同机器复制粘贴稳定）；跨机器请带显式时区。
     2) 必须用 T 分隔日期与时间，禁止空格——shell 会把不带引号的 'YYYY-MM-DD HH:mm:ss' 拆成两个参数。
 `;
+function normalizeRepeatedOption(value) {
+    if (Array.isArray(value)) {
+        const items = value.filter((item) => typeof item === 'string' && item.length > 0);
+        return items.length === 1 ? items[0] : items;
+    }
+    return value;
+}
+function normalizeRepeatedArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === 'string' && item.length > 0);
+    }
+    return typeof value === 'string' && value ? [value] : [];
+}
+function compactRepeatedOption(values) {
+    if (values.length === 0)
+        return undefined;
+    return values.length === 1 ? values[0] : values;
+}
 function registerObservabilityCommands(program) {
     const obCmd = program
         .command('observability')
@@ -31,6 +49,7 @@ function registerObservabilityCommands(program) {
 `);
     registerLog(obCmd);
     registerTrace(obCmd);
+    registerSourceStack(obCmd);
     registerMetric(obCmd);
     registerAnalytics(obCmd);
 }
@@ -45,8 +64,8 @@ function registerLog(parent) {
         .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 过滤')
+        .addOption(new commander_1.Option('--log-id <id>', '按请求 logid 过滤（可重复传入）').argParser(shared_1.collectRepeatedOption))
+        .addOption(new commander_1.Option('--trace-id <id>', '按 trace ID 过滤（可重复传入）').argParser(shared_1.collectRepeatedOption))
         .option('--grep <pattern>', '按关键字模糊搜索 body')
         .option('--module <name>', '按模块名过滤')
         .option('--user-id <user-id>', '按触发用户 ID 过滤')
@@ -63,7 +82,9 @@ JSON 输出
 示例
   $ miaoda observability log --since 1h --level error --json
   $ miaoda observability log --log-id log_abc123 --json
+  $ miaoda observability log --log-id log_1 --log-id log_2 --json
   $ miaoda observability log --trace-id 140ebb5ac9b... --json
+  $ miaoda observability log --trace-id trace_1 --trace-id trace_2 --json
   $ miaoda observability log --api /api/orders --min-duration 200 --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
@@ -74,8 +95,8 @@ JSON 输出
             level: rawOpts.level,
             since: rawOpts.since,
             until: rawOpts.until,
-            logId: rawOpts.logId,
-            traceId: rawOpts.traceId,
+            logId: normalizeRepeatedOption(rawOpts.logId),
+            traceId: normalizeRepeatedOption(rawOpts.traceId),
             grep: rawOpts.grep,
             module: rawOpts.module,
             userId: rawOpts.userId,
@@ -100,7 +121,7 @@ function registerTrace(parent) {
         .addOption((0, shared_1.appIdOption)().hideHelp())
         .option('--since <time>', '开始时间')
         .option('--until <time>', '截止时间')
-        .option('--trace-id <id>', '按 trace ID 过滤')
+        .addOption(new commander_1.Option('--trace-id <id>', '按 trace ID 过滤（可重复传入）').argParser(shared_1.collectRepeatedOption))
         .option('--root-span <span-name>', '按入口节点关键词过滤')
         .option('--user-id <user-id>', '按触发用户 ID 过滤')
         .option('--limit <n>', '返回条数上限（1~100）', parseLimit, 50)
@@ -111,6 +132,7 @@ JSON 输出
 
 示例
   $ miaoda observability trace list --since 1h --json
+  $ miaoda observability trace list --trace-id trace_1 --trace-id trace_2 --json
   $ miaoda observability trace list --root-span api-gateway --limit 20 --json
 `);
     listCmd.action((0, shared_1.withHelp)(listCmd, async (rawOpts) => {
@@ -120,7 +142,7 @@ JSON 输出
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             since: rawOpts.since,
             until: rawOpts.until,
-            traceId: rawOpts.traceId,
+            traceId: normalizeRepeatedOption(rawOpts.traceId),
             rootSpan: rawOpts.rootSpan,
             userId: rawOpts.userId,
             limit: rawOpts.limit,
@@ -154,6 +176,40 @@ JSON 输出
         });
     }));
 }
+// ── source-stack ──
+function registerSourceStack(parent) {
+    const cmd = parent
+        .command('source-stack')
+        .description('反解前端错误堆栈到源码位置')
+        .argument('[log-ids...]', '前端错误请求 logid，可传多个')
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addOption(new commander_1.Option('--log-id <id>', '前端错误请求 logid（可重复传入）').argParser(shared_1.collectRepeatedOption))
+        .addOption(new commander_1.Option('--trace-id <id>', '包含前端错误的 trace ID（可重复传入）').argParser(shared_1.collectRepeatedOption))
+        .option('--since <time>', '开始时间')
+        .option('--until <time>', '截止时间')
+        .option('--limit <n>', '每类查询返回条数上限（1~100）', parseLimit, 50)
+        .addHelpText('after', `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [{"log_id": "...", "trace_id": "...", "status": "resolved", "error_message_stack": "Error: boom\\n  at src/App.tsx:42:7"}], "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda observability source-stack --log-id log_1 --log-id log_2 --json
+  $ miaoda observability source-stack --trace-id trace_1 --trace-id trace_2 --json
+  $ miaoda observability source-stack log_abc123 --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (logIds, rawOpts) => {
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
+        await (0, index_1.handleObservabilitySourceStack)({
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
+            logId: compactRepeatedOption([...logIds, ...normalizeRepeatedArray(rawOpts.logId)]),
+            traceId: normalizeRepeatedOption(rawOpts.traceId),
+            since: rawOpts.since,
+            until: rawOpts.until,
+            limit: rawOpts.limit,
+        });
+    }));
+}
 // ── metric ──
 function registerMetric(parent) {
     const cmd = parent

package/dist/cli/commands/shared.js

@@ -7,6 +7,7 @@ exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
 exports.caseInsensitiveChoice = caseInsensitiveChoice;
+exports.collectRepeatedOption = collectRepeatedOption;
 exports.validateTimeOptions = validateTimeOptions;
 exports.rejectCliOverride = rejectCliOverride;
 const commander_1 = require("commander");
@@ -86,6 +87,10 @@ function caseInsensitiveChoice(canonical) {
         return hit;
     };
 }
+/** Commander repeatable option parser：重复传入时收集为数组。 */
+function collectRepeatedOption(value, previous = []) {
+    return [...previous, value];
+}
 /**
  * --since / --until 等时间参数的 action 阶段校验。
  *

package/dist/cli/handlers/observability/helpers.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ceilMsToBucket = exports.floorMsToBucket = exports.msToSec = exports.msToNs = exports.parseToSec = exports.parseToNs = exports.parseToMs = exports.parseTimeToMs = void 0;
 exports.eqFilter = eqFilter;
+exports.inFilter = inFilter;
 exports.rangeFilter = rangeFilter;
 exports.fuzzyFilter = fuzzyFilter;
 exports.buildFieldFilters = buildFieldFilters;
@@ -27,6 +28,9 @@ function eqFilter(value, type = 'str') {
     const v = type !== 'str' ? Number(value) : value;
     return { [type]: { eq: v } };
 }
+function inFilter(strs) {
+    return { str: { in: strs } };
+}
 /** i64 数值范围过滤 → { i64: { gte, lte } }；输入接受 string（CLI flag）或 number */
 function rangeFilter(opts) {
     const i64 = {};

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

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilityTraceGet = exports.handleObservabilityTraceList = exports.handleObservabilityLog = void 0;
+exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilitySourceStack = exports.handleObservabilityTraceGet = exports.handleObservabilityTraceList = exports.handleObservabilityLog = void 0;
 var log_1 = require("./log");
 Object.defineProperty(exports, "handleObservabilityLog", { enumerable: true, get: function () { return log_1.handleObservabilityLog; } });
 var trace_1 = require("./trace");
 Object.defineProperty(exports, "handleObservabilityTraceList", { enumerable: true, get: function () { return trace_1.handleObservabilityTraceList; } });
 Object.defineProperty(exports, "handleObservabilityTraceGet", { enumerable: true, get: function () { return trace_1.handleObservabilityTraceGet; } });
+var source_stack_1 = require("./source-stack");
+Object.defineProperty(exports, "handleObservabilitySourceStack", { enumerable: true, get: function () { return source_stack_1.handleObservabilitySourceStack; } });
 var metric_1 = require("./metric");
 Object.defineProperty(exports, "handleObservabilityMetric", { enumerable: true, get: function () { return metric_1.handleObservabilityMetric; } });
 var analytics_1 = require("./analytics");

package/dist/cli/handlers/observability/log.js

@@ -38,6 +38,12 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
+function stringIdFilter(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0 ? (0, helpers_1.inFilter)(value) : undefined;
+    }
+    return value ? (0, helpers_1.eqFilter)(value) : undefined;
+}
 /** miaoda observability log */
 async function handleObservabilityLog(opts) {
     const appID = opts.appId;
@@ -50,8 +56,8 @@ async function handleObservabilityLog(opts) {
     //   - duration_ms 暂未在 BAM 描述里明确列出，留 TODO 等 e2e 验证
     const fieldFilters = (0, helpers_1.buildFieldFilters)([
         { key: 'severity_text', value: opts.level ? (0, helpers_1.eqFilter)(opts.level) : undefined },
-        { key: 'attributes.ob_data_id', value: opts.logId ? (0, helpers_1.eqFilter)(opts.logId) : undefined },
-        { key: 'trace_id', value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
+        { key: 'attributes.ob_data_id', value: stringIdFilter(opts.logId) },
+        { key: 'trace_id', value: stringIdFilter(opts.traceId) },
         { key: 'module', value: opts.module ? (0, helpers_1.eqFilter)(opts.module) : undefined },
         { key: 'user_id', value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, 'i64') : undefined },
         { key: 'page', value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },

package/dist/cli/handlers/observability/source-stack.js

@@ -0,0 +1,389 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleObservabilitySourceStack = handleObservabilitySourceStack;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const helpers_1 = require("./helpers");
+const SOURCE_MAP_FILE_PREFIX = 'client/assets/';
+/** miaoda observability source-stack */
+async function handleObservabilitySourceStack(opts) {
+    const logIds = normalizeValues(opts.logId);
+    const traceIds = normalizeValues(opts.traceId);
+    if (logIds.length === 0 && traceIds.length === 0) {
+        (0, args_1.failArgs)('至少传入线上环境日志 ID 或 trace ID');
+    }
+    const logs = await collectCandidateLogs(opts, { logIds, traceIds });
+    const results = await resolveCandidateLogs(opts.appId, logs);
+    (0, output_1.emit)({ data: results, next_cursor: null, has_more: false });
+}
+async function collectCandidateLogs(opts, params) {
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    const searches = [];
+    if (params.logIds.length > 0) {
+        searches.push(searchLogs(opts, {
+            limit,
+            fieldFilters: (0, helpers_1.buildFieldFilters)([
+                { key: 'attributes.ob_data_id', value: stringIdFilter(params.logIds) },
+            ]),
+        }));
+    }
+    if (params.traceIds.length > 0) {
+        searches.push(searchLogs(opts, {
+            limit,
+            fieldFilters: (0, helpers_1.buildFieldFilters)([
+                { key: 'trace_id', value: stringIdFilter(params.traceIds) },
+            ]),
+        }));
+    }
+    const allLogs = (await Promise.all(searches)).flat();
+    const deduped = new Map();
+    for (const log of allLogs) {
+        deduped.set(log.id, log);
+    }
+    return Array.from(deduped.values());
+}
+async function searchLogs(opts, params) {
+    const req = {
+        appID: opts.appId,
+        appEnv: 'runtime',
+        startTimestampNs: (0, helpers_1.parseToNs)(opts.since),
+        endTimestampNs: (0, helpers_1.parseToNs)(opts.until),
+        limit: params.limit,
+        fieldFilters: params.fieldFilters,
+    };
+    const resp = await api.observability.searchLogs(req);
+    return resp.logItems ?? [];
+}
+async function resolveCandidateLogs(appID, logs) {
+    const results = [];
+    for (const log of logs) {
+        const attrs = log.attributes ?? {};
+        const rawStack = pickAttr(attrs, ['stack', 'error_stack', 'errorStack']) ??
+            pickBodyStack(log.body) ??
+            log.body;
+        const frames = parseGeneratedFrames(rawStack);
+        const commitID = pickAttr(attrs, [
+            'release_commit_id',
+            'releaseCommitID',
+            'commit_id',
+            'commitID',
+        ]);
+        const message = pickErrorMessage(log, rawStack);
+        const base = {
+            log_id: log.id,
+            trace_id: log.traceID ?? attrs.trace_id,
+            commit_id: commitID,
+            source_map_files: sourceMapFilesForFrames(frames),
+        };
+        const reason = missingReason({ frames, commitID });
+        if (reason) {
+            results.push({
+                ...base,
+                status: 'unresolved',
+                reason,
+                error_message_stack: formatStack(message, frames),
+            });
+            continue;
+        }
+        const resolvedCommitID = commitID;
+        if (!resolvedCommitID)
+            continue;
+        let resolvedFrames;
+        try {
+            resolvedFrames = await resolveFramesBySourceMap(appID, resolvedCommitID, frames);
+        }
+        catch (err) {
+            results.push({
+                ...base,
+                status: 'unresolved',
+                reason: `调用 resolve_stack_trace 失败：${errorMessage(err)}`,
+                error_message_stack: formatStack(message, frames),
+            });
+            continue;
+        }
+        results.push({
+            ...base,
+            status: 'resolved',
+            error_message_stack: formatStack(message, resolvedFrames),
+        });
+    }
+    return results;
+}
+function normalizeValues(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => item.length > 0);
+    }
+    return value ? [value] : [];
+}
+function stringIdFilter(values) {
+    if (values.length === 0)
+        return undefined;
+    return values.length === 1 ? (0, helpers_1.eqFilter)(values[0]) : (0, helpers_1.inFilter)(values);
+}
+function pickAttr(attrs, keys) {
+    for (const key of keys) {
+        const value = attrs[key];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+async function resolveFramesBySourceMap(appID, commitID, frames) {
+    const resp = await api.observability.resolveStackTrace({
+        appID,
+        commitID,
+        sourceMapFilePrefix: SOURCE_MAP_FILE_PREFIX,
+        frames,
+    });
+    return resp.frames ?? frames;
+}
+function parseGeneratedFrames(stack) {
+    if (!stack)
+        return [];
+    const jsonFrames = parseJsonStackFrames(stack);
+    if (jsonFrames.length > 0)
+        return jsonFrames;
+    const frames = [];
+    const parenFramePattern = /\((.+):(\d+):(\d+)\)$/;
+    const plainFramePattern = /(?:at\s+)?(.+):(\d+):(\d+)$/;
+    for (const line of stack.split('\n')) {
+        const trimmed = line.trim();
+        const match = parenFramePattern.exec(trimmed) ?? plainFramePattern.exec(trimmed);
+        if (!match)
+            continue;
+        const [, fileName, lineNumber, columnNumber] = match;
+        if (!fileName || !lineNumber || !columnNumber)
+            continue;
+        frames.push({
+            fileName: normalizeFrameFileName(fileName),
+            line: Number(lineNumber),
+            column: Number(columnNumber),
+        });
+    }
+    return frames.slice(0, 2000);
+}
+function parseJsonStackFrames(stack) {
+    const trimmed = stack.trim();
+    if (!trimmed.startsWith('['))
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed
+        .map((item) => normalizeJsonFrame(item))
+        .filter((frame) => Boolean(frame))
+        .slice(0, 2000);
+}
+function normalizeJsonFrame(item) {
+    if (!isRecord(item))
+        return undefined;
+    const fileName = item.fileName;
+    const line = item.line;
+    const column = item.column;
+    if (typeof fileName !== 'string')
+        return undefined;
+    const lineNumber = toFiniteNumber(line);
+    const columnNumber = toFiniteNumber(column);
+    if (lineNumber === undefined || columnNumber === undefined)
+        return undefined;
+    return {
+        fileName: normalizeFrameFileName(fileName),
+        line: lineNumber,
+        column: columnNumber,
+    };
+}
+function pickErrorMessage(log, rawStack) {
+    return (pickBodyErrorMessage(log.body) ??
+        firstTextStackLine(rawStack) ??
+        pickAttr(log.attributes ?? {}, ['error_message', 'errorMessage', 'message']));
+}
+function pickBodyStack(body) {
+    const parsed = parseBodyRecord(body);
+    if (!parsed)
+        return undefined;
+    return (stringProp(parsed, 'stack') ??
+        nestedStringProp(parsed, ['error', 'stack']) ??
+        nestedStringProp(parsed, ['response', 'error', 'stack']) ??
+        pickConsoleArgsStack(parsed));
+}
+function pickBodyErrorMessage(body) {
+    const parsed = parseBodyRecord(body);
+    if (!parsed)
+        return undefined;
+    return (stringProp(parsed, 'error_message') ??
+        stringProp(parsed, 'message') ??
+        nestedStringProp(parsed, ['error', 'message']) ??
+        nestedStringProp(parsed, ['response', 'error', 'message']) ??
+        pickConsoleArgsMessage(parsed));
+}
+function pickConsoleArgsMessage(record) {
+    const parts = Object.entries(record)
+        .filter(([key]) => /^\d+$/.test(key))
+        .sort(([left], [right]) => Number(left) - Number(right))
+        .map(([, value]) => consoleArgMessage(value))
+        .filter((message) => Boolean(message));
+    if (parts.length === 0)
+        return undefined;
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
+}
+function pickConsoleArgsStack(record) {
+    return Object.entries(record)
+        .filter(([key]) => /^\d+$/.test(key))
+        .sort(([left], [right]) => Number(left) - Number(right))
+        .map(([, value]) => consoleArgStack(value))
+        .find((stack) => Boolean(stack));
+}
+function consoleArgStack(value) {
+    if (typeof value === 'string') {
+        const stack = value.trim();
+        return looksLikeTextStack(stack) ? stack : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    return (stringProp(value, 'stack') ??
+        nestedStringProp(value, ['error', 'stack']) ??
+        nestedStringProp(value, ['response', 'error', 'stack']));
+}
+function consoleArgMessage(value) {
+    if (typeof value === 'string') {
+        const message = value.trim();
+        return message.length > 0 ? message : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    return errorRecordMessage(value);
+}
+function errorRecordMessage(record) {
+    const stackTitle = firstTextStackLine(stringProp(record, 'stack'));
+    if (stackTitle)
+        return stackTitle;
+    const name = stringProp(record, 'name');
+    const message = stringProp(record, 'message') ??
+        nestedStringProp(record, ['error', 'message']) ??
+        nestedStringProp(record, ['response', 'error', 'message']);
+    if (name && message && !message.startsWith(`${name}:`)) {
+        return `${name}: ${message}`;
+    }
+    return message ?? name;
+}
+function parseBodyRecord(body) {
+    if (!body)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        return undefined;
+    }
+    return isRecord(parsed) ? parsed : undefined;
+}
+function firstTextStackLine(stack) {
+    const trimmed = stack?.trim();
+    if (!trimmed || trimmed.startsWith('['))
+        return undefined;
+    return trimmed
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.length > 0 && !line.startsWith('at '));
+}
+function looksLikeTextStack(value) {
+    return value.length > 0 && /:\d+:\d+(?:\)|$)/.test(value);
+}
+function missingReason(params) {
+    if (!params.commitID)
+        return '日志缺少 release_commit_id / commit_id，无法定位构建产物';
+    if (params.frames.length === 0)
+        return '日志中没有可解析的 generated stack frame';
+    return undefined;
+}
+function normalizeFrameFileName(fileName) {
+    return fileName.split(/[/?#]/).filter(Boolean).pop() ?? fileName;
+}
+function formatStack(message, frames) {
+    const stack = frames
+        .map((frame) => {
+        if (frame.sourceFileName) {
+            return `  at ${frame.sourceFileName}:${String(frame.sourceLine)}:${String(frame.sourceColumn)}`;
+        }
+        return `  at ${frame.fileName}:${String(frame.line)}:${String(frame.column)}`;
+    })
+        .join('\n');
+    if (message && stack)
+        return `${message}\n${stack}`;
+    return message ?? stack;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function toFiniteNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim()) {
+        const numberValue = Number(value);
+        return Number.isFinite(numberValue) ? numberValue : undefined;
+    }
+    return undefined;
+}
+function stringProp(record, key) {
+    const value = record[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function nestedStringProp(record, path) {
+    let current = record;
+    for (const key of path) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[key];
+    }
+    return typeof current === 'string' && current.length > 0 ? current : undefined;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function sourceMapFileForFrame(fileName) {
+    return `${SOURCE_MAP_FILE_PREFIX}${fileName}.map`;
+}
+function sourceMapFilesForFrames(frames) {
+    return Array.from(new Set(frames.map((frame) => sourceMapFileForFrame(frame.fileName))));
+}

package/dist/cli/handlers/observability/trace.js

@@ -40,6 +40,12 @@ const output_1 = require("../../../utils/output");
 const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
+function stringIdFilter(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0 ? (0, helpers_1.inFilter)(value) : undefined;
+    }
+    return value ? (0, helpers_1.eqFilter)(value) : undefined;
+}
 /** miaoda observability trace list */
 async function handleObservabilityTraceList(opts) {
     const appID = opts.appId;
@@ -51,7 +57,7 @@ async function handleObservabilityTraceList(opts) {
     //   - 入口 span：BAM 没有 entrySpanName fieldFilter，统一走 fuzzyFilter（trace endpoint
     //     默认作用于 span name），所以 --root-span 不进 fieldFilters
     const fieldFilters = (0, helpers_1.buildFieldFilters)([
-        { key: 'trace_id', value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
+        { key: 'trace_id', value: stringIdFilter(opts.traceId) },
         { key: 'user_id', value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, 'i64') : undefined },
     ]);
     const req = {

package/dist/utils/git.js

@@ -2,6 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentGitBranch = getCurrentGitBranch;
 const node_child_process_1 = require("node:child_process");
+const GIT_LOCAL_ENV_KEYS = new Set([
+    'GIT_ALTERNATE_OBJECT_DIRECTORIES',
+    'GIT_CONFIG',
+    'GIT_CONFIG_PARAMETERS',
+    'GIT_CONFIG_COUNT',
+    'GIT_OBJECT_DIRECTORY',
+    'GIT_DIR',
+    'GIT_WORK_TREE',
+    'GIT_IMPLICIT_WORK_TREE',
+    'GIT_GRAFT_FILE',
+    'GIT_INDEX_FILE',
+    'GIT_NO_REPLACE_OBJECTS',
+    'GIT_REPLACE_REF_BASE',
+    'GIT_PREFIX',
+    'GIT_INTERNAL_SUPER_PREFIX',
+    'GIT_SHALLOW_FILE',
+    'GIT_COMMON_DIR',
+]);
+function withoutGitLocalEnv() {
+    return Object.fromEntries(Object.entries(process.env).filter(([key]) => !GIT_LOCAL_ENV_KEYS.has(key)));
+}
 /**
  * 读取 cwd 所在仓库的当前分支名。
  *
@@ -13,6 +34,7 @@ function getCurrentGitBranch(cwd = process.cwd()) {
     try {
         result = (0, node_child_process_1.spawnSync)('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
             cwd,
+            env: withoutGitLocalEnv(),
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {