bfi-cli 0.1.108 → 0.1.110

package/dist/cli.mjs

@@ -8714,6 +8714,31 @@ async function runInstall(args, globalOpts) {
 	console.log();
 }
 const YMC_DEFAULT_BASE = process.env.BFI_YMC_BASE || "https://bfi.yyuap.com/bfi-api/bficli/api/v2";
+function messageOf(parsed) {
+	const raw = parsed.msg ?? parsed.message;
+	if (typeof raw === "string") return raw;
+	if (raw === void 0 || raw === null) return "";
+	try {
+		return JSON.stringify(raw);
+	} catch {
+		return String(raw);
+	}
+}
+function describeApiError(parsed, status, raw = "") {
+	const prefix = status >= 400 ? `HTTP ${status} ` : "";
+	const detail = parsed.detail;
+	if (Array.isArray(detail) && detail.length > 0) return `${prefix}${detail.map((item) => {
+		if (!item || typeof item !== "object") return String(item);
+		const o = item;
+		const loc = Array.isArray(o.loc) ? o.loc.map(String).join(".") : "";
+		const msg = o.msg ?? o.message ?? o.type ?? "参数错误";
+		return loc ? `${loc}: ${String(msg)}` : String(msg);
+	}).join("; ")}`;
+	if (detail !== void 0 && detail !== null) return `${prefix}${typeof detail === "string" ? detail : JSON.stringify(detail)}`;
+	const msg = messageOf(parsed);
+	if (msg.trim()) return `${prefix}${msg}`;
+	return `${prefix}${raw.trim().slice(0, 200) || "服务端未返回错误信息"}`;
+}
 var YmcApi = class {
 	baseUrl;
 	token;
@@ -8732,12 +8757,12 @@ var YmcApi = class {
 		if (body !== void 0 && Object.keys(body).length > 0) console.log(JSON.stringify(body, null, 2));
 		process.exit(0);
 	}
-	async call(path, body = {}, timeoutMs = 9e4) {
+	async call(path, body = {}, timeoutMs = 12e4) {
 		if (this.dryRun) this._dryRunExit("POST", path, body);
 		const url = `${this.baseUrl}/${path.replace(/^\//, "")}`;
 		const payload = JSON.stringify(body);
 		const mod = url.startsWith("https://") ? https : http;
-		const raw = await new Promise((resolve, reject) => {
+		const { status, text: raw } = await new Promise((resolve, reject) => {
 			const req = mod.request(url, {
 				method: "POST",
 				headers: {
@@ -8750,7 +8775,10 @@ var YmcApi = class {
 			}, (res) => {
 				const chunks = [];
 				res.on("data", (c) => chunks.push(c));
-				res.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+				res.on("end", () => resolve({
+					status: res.statusCode ?? 0,
+					text: Buffer.concat(chunks).toString("utf-8")
+				}));
 			});
 			req.on("timeout", () => {
 				req.destroy(/* @__PURE__ */ new Error(`请求超时（${timeoutMs}ms）`));
@@ -8763,12 +8791,13 @@ var YmcApi = class {
 		try {
 			parsed = JSON.parse(raw);
 		} catch {
-			throw new Error(`非 JSON 响应（HTTP）：${raw.slice(0, 200)}`);
+			throw new Error(`HTTP ${status} 非 JSON 响应：${raw.slice(0, 200)}`);
 		}
-		if (parsed.detail && parsed.code === void 0) throw new Error(String(parsed.detail));
+		if (parsed.detail !== void 0 && parsed.code === void 0) throw new Error(describeApiError(parsed, status, raw));
+		if (status >= 400 && parsed.code === void 0 && parsed.msg === void 0) throw new Error(describeApiError(parsed, status, raw));
 		return {
 			code: typeof parsed.code === "number" ? parsed.code : -1,
-			msg: String(parsed.msg ?? ""),
+			msg: messageOf(parsed),
 			data: parsed.data ?? null,
 			raw: parsed
 		};
@@ -8816,7 +8845,7 @@ var YmcApi = class {
 		if (this.dryRun) this._dryRunExit("GET", path);
 		const url = `${this.baseUrl}/${path.replace(/^\//, "")}`;
 		const mod = url.startsWith("https://") ? https : http;
-		const raw = await new Promise((resolve, reject) => {
+		const { status, text: raw } = await new Promise((resolve, reject) => {
 			const req = mod.request(url, {
 				method: "GET",
 				headers: {
@@ -8827,7 +8856,10 @@ var YmcApi = class {
 			}, (res) => {
 				const chunks = [];
 				res.on("data", (c) => chunks.push(c));
-				res.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+				res.on("end", () => resolve({
+					status: res.statusCode ?? 0,
+					text: Buffer.concat(chunks).toString("utf-8")
+				}));
 			});
 			req.on("timeout", () => {
 				req.destroy(/* @__PURE__ */ new Error(`请求超时（${timeoutMs}ms）`));
@@ -8835,11 +8867,16 @@ var YmcApi = class {
 			req.on("error", reject);
 			req.end();
 		});
-		const parsed = JSON.parse(raw);
-		if (parsed.detail && parsed.code === void 0) throw new Error(String(parsed.detail));
+		let parsed;
+		try {
+			parsed = JSON.parse(raw);
+		} catch {
+			throw new Error(`HTTP ${status} 非 JSON 响应：${raw.slice(0, 200)}`);
+		}
+		if (parsed.detail !== void 0 && parsed.code === void 0) throw new Error(describeApiError(parsed, status, raw));
 		return {
 			code: typeof parsed.code === "number" ? parsed.code : -1,
-			msg: String(parsed.msg ?? ""),
+			msg: messageOf(parsed),
 			data: parsed.data ?? null,
 			raw: parsed
 		};
@@ -8921,7 +8958,6 @@ const F_ENV = [
 	"--env",
 	"--env-name"
 ];
-const F_TIME = ["-t", "--time"];
 const F_RANGE = [
 	"-t",
 	"--time",
@@ -8941,7 +8977,7 @@ const ALLOWED_FLAGS = {
 	],
 	"sls-grep": [
 		...F_ENV,
-		...F_TIME,
+		...F_RANGE,
 		"--group-by",
 		"--line",
 		"--app"
@@ -8956,7 +8992,8 @@ const ALLOWED_FLAGS = {
 		"--app",
 		"--no-profiler",
 		"--page",
-		"--page-size"
+		"--page-size",
+		"--timeout"
 	],
 	slowcall: [
 		...F_ENV,
@@ -8967,7 +9004,8 @@ const ALLOWED_FLAGS = {
 		"--profiler",
 		"--min-cost",
 		"--page",
-		"--page-size"
+		"--page-size",
+		"--timeout"
 	],
 	exceptions: [
 		...F_ENV,
@@ -9091,15 +9129,6 @@ function requireEnv(args) {
 	}
 	return { env_name: env };
 }
-function timeOf(args, required = true) {
-	const t = opt(args, "-t", "--time");
-	const err = timeError(t);
-	if (err && required) {
-		console.error(err);
-		process.exit(1);
-	}
-	return t ? { time: t } : {};
-}
 function timeOpts(args) {
 	const out = {};
 	const t = opt(args, "-t", "--time");
@@ -9117,6 +9146,43 @@ function timeOpts(args) {
 	if (et) out.end_time = et;
 	return out;
 }
+function slowQueryTimeoutMs(args) {
+	const raw = opt(args, "--timeout");
+	if (raw === void 0) return 15e4;
+	const sec = Number(raw);
+	if (!Number.isFinite(sec) || sec <= 0) {
+		console.error(`--timeout 非法：${raw}（应为正数秒，如 180）`);
+		process.exit(1);
+	}
+	return sec * 1e3;
+}
+function windowDays(args) {
+	const t = opt(args, "-t", "--time");
+	if (t) {
+		const m = /^(\d+)([mhdw])$/.exec(t);
+		if (!m) return 0;
+		const n = Number(m[1]);
+		const unit = m[2];
+		if (unit === "w") return n * 7;
+		if (unit === "d") return n;
+		if (unit === "h") return n / 24;
+		return n / 1440;
+	}
+	const st = opt(args, "--start-time");
+	const et = opt(args, "--end-time");
+	if (st && et) {
+		const ms = Date.parse(et.replace(" ", "T")) - Date.parse(st.replace(" ", "T"));
+		return Number.isFinite(ms) ? ms / 864e5 : 0;
+	}
+	return 0;
+}
+function warnWideQuery(label, args, pageSize, narrowFlags) {
+	if (narrowFlags.some((f) => opt(args, f))) return;
+	const days = windowDays(args);
+	if (days < 1 && pageSize <= 200) return;
+	const win = days ? `窗口 ${days.toFixed(1)} 天` : "窗口未识别";
+	console.error(`⚠️ ${label} ${win} / pageSize ${pageSize} 且未限定服务：上游模糊匹配 + 全服务扫描，易触发 120s 超时；建议加 --app <appCode> 或缩短 -t（≤6h）`);
+}
 function requireToken(api) {
 	if (!api.token) {
 		console.error("未认证。先运行：bfi auth login --token <sk-token>（或传 --token）");
@@ -9192,7 +9258,7 @@ async function runYmc(args, globalOpts) {
 				trace_id: id,
 				...requireEnv(rest),
 				...opt(rest, "--ts") ? { ts: Number(opt(rest, "--ts")) } : {}
-			}), jsonMode, (data) => {
+			}, 18e4), jsonMode, (data) => {
 				const d = data;
 				const lines = [];
 				const wc = d.warning_chain;
@@ -9277,7 +9343,7 @@ async function runYmc(args, globalOpts) {
 		case "sls-grep": {
 			const kw = positionals(rest)[0];
 			if (!kw) {
-				console.error("用法：bfi ymc sls-grep \"<关键词>\" -e <env> [-t time] [--app <appCode>] [--group-by applicationName|message|requestURL]");
+				console.error("用法：bfi ymc sls-grep \"<关键词>\" -e <env> [-t <time> | --start-time <s> --end-time <e>] [--app <appCode>] [--group-by applicationName|message|requestURL]");
 				console.error("例：bfi ymc sls-grep \"ClassCastException\" -e daily -t 3d");
 				console.error("⚠️ 关键词按「整值」匹配：类名/全限定异常名必须整串加引号");
 				console.error("   （\"java.lang.OutOfMemoryError\" 命中；简写 \"OutOfMemoryError\" 恒 0 且不报错）——sls-discipline §3");
@@ -9292,7 +9358,7 @@ async function runYmc(args, globalOpts) {
 			emit(await api.call("sls/raw", {
 				query,
 				...requireEnv(rest),
-				...timeOf(rest, false),
+				...timeOpts(rest),
 				line: Number(opt(rest, "--line") || 50)
 			}), jsonMode, aggSummary(`SLS 全文检索 "${kw}"`));
 			break;
@@ -9327,7 +9393,12 @@ async function runYmc(args, globalOpts) {
 				const v = opt(rest, name);
 				if (v) body[k] = v;
 			}
-			emit(await api.call("ymc/warningSql", body), jsonMode, (data) => {
+			warnWideQuery("慢 SQL", rest, Number(body.pageSize), [
+				"--app",
+				"--trace-id",
+				"--md5"
+			]);
+			emit(await api.call("ymc/warningSql", body, slowQueryTimeoutMs(rest)), jsonMode, (data) => {
 				const d = data;
 				const rows = Array.isArray(d) ? d : d.rows ?? d.data ?? [];
 				const n = rows.length;
@@ -9361,7 +9432,12 @@ async function runYmc(args, globalOpts) {
 			const cost = opt(rest, "--min-cost");
 			if (cost) body.costTime = [Number(cost), 999999];
 			if (flag(rest, "--profiler")) console.error("⚠️ --profiler 是上游采样过滤器，实测常返回空集——常规取证请去掉（CPU 热点走 dump-list）");
-			emit(await api.call("ymc/warningCall", body), jsonMode, (data) => {
+			warnWideQuery("慢调用", rest, Number(body.pageSize), [
+				"--app",
+				"--trace-id",
+				"--method"
+			]);
+			emit(await api.call("ymc/warningCall", body, slowQueryTimeoutMs(rest)), jsonMode, (data) => {
 				const d = data;
 				const rows = Array.isArray(d) ? d : d.rows ?? d.data ?? [];
 				const n = rows.length;
@@ -9404,7 +9480,7 @@ async function runYmc(args, globalOpts) {
 			};
 			const app = opt(rest, "--app");
 			if (app) body.filters = { service_name: app };
-			emit(await api.call("kibana/stats", body), jsonMode, (data) => {
+			emit(await api.call("kibana/stats", body, 18e4), jsonMode, (data) => {
 				const d = data;
 				const a = d.aggs;
 				return `✓ URL 统计${app ? ` [${app}]` : "（⚠️ 未限定服务，共享路径为全平台混合）"}: QPS=${a.qps} avg=${a.avg_rt?.value ?? "-"} 慢请求Top=${Array.isArray(d.slow_top) ? d.slow_top.length : 0}`;
@@ -9429,7 +9505,7 @@ async function runYmc(args, globalOpts) {
 				console.error("用法：bfi ymc ingress --trace-id <id> | --uri </path> [-app <service_name>] -e <env> [-t time]");
 				process.exit(1);
 			}
-			emit(await api.call("kibana/search", body), jsonMode, rowsSummary("ingress 日志"));
+			emit(await api.call("kibana/search", body, 18e4), jsonMode, rowsSummary("ingress 日志"));
 			break;
 		}
 		case "dump-list": {
@@ -9721,32 +9797,38 @@ const HELP = {
     bfi ymc sls-raw 'applicationname: yonbip-scm-scmmp AND "unaudit" | SELECT traceid, time LIMIT 10' -e core3 -t 1d
   注意：业务关键词检索必须 applicationname: 限定目标服务（共享路径 URL 全平台都有）；
   traceid/spanid 检索例外（全局唯一）。非索引字段（logger/requesturl）不能进检索语法，只能在 SELECT 里引用。`,
-	"sls-grep": `bfi ymc sls-grep "<关键词>" -e <env> -t <time> [--app <appCode>] [--group-by <字段>] [--json]
+	"sls-grep": `bfi ymc sls-grep "<关键词>" -e <env> [-t <time> | --start-time <s> --end-time <e>] [--app <appCode>] [--group-by <字段>] [--json]
   SLS 全文检索聚合（每组计数精确不封顶；组数上限 500——实测 2026-09-17：计数不受限，仅组数受 SLS 默认 LIMIT 约束，服务端已放宽）。
   ⚠️ 关键词按「整值」匹配：类名/全限定异常名必须整串加引号
      （"java.lang.OutOfMemoryError" 命中；简写 "OutOfMemoryError" 恒 0 命中且不报错）——sls-discipline §3
   --app <appCode>  裸微服务名，前置 applicationname 限定（不限服务的检索会命中不相干服务）`,
-	slowsql: `bfi ymc slowsql -t <time> -e <env> [--sql-str <表名或片段>] [--md5 <指纹>] [--trace-id <id>] [--app <appCode>] [--no-profiler] [--page N] [--page-size N] [--json]
+	slowsql: `bfi ymc slowsql -t <time> -e <env> [--sql-str <表名或片段>] [--md5 <指纹>] [--trace-id <id>] [--app <appCode>] [--no-profiler] [--page N] [--page-size N] [--timeout <秒>] [--json]
   慢 SQL 告警明细（耗时降序；摘要含 服务/耗时/行数/SQL 前段/指纹/调用栈首帧）。
   参数：
     -t <time>             时间窗（必填语义，服务端强校验）
-    --sql-str             按 SQL 片段过滤（表名/语句片段）
-    --md5                 按 SQL MD5 指纹精确过滤（同类 SQL 归类）
+    --sql-str             按 SQL 片段过滤（表名/语句片段；模糊匹配，开销大，见下方警示）
+    --md5                 按 SQL MD5 指纹精确过滤（同类 SQL 归类；有指纹时优先用，毫秒级）
     --trace-id            按链路过滤。⚠️ 按 trace 查询时不带 --app（traceId 已唯一限定，
                           --app 会截断其他服务的告警行——慢 SQL 归属哪个服务事先未知）
     --app                 服务维度过滤（无 traceId 时必带，裸 appCode）
+    --page-size N         每页条数（服务端上限 200，超限直接报错并提示分页）
+    --timeout <秒>        客户端超时（默认 150s；服务端上游超时 120s，留余量先拿服务端消息）
     --no-profiler         显式关闭 enableProfiler（默认自动带 'true'——不带该字段上游 500，
-                          带了才返回 sqlStack 调用栈）
+                          带了才返回 sqlStack 调用栈；不需要调用栈时关闭约省 40% 耗时）
+  ⚠️ --sql-str 是模糊匹配：大窗口（≥1d）必须配 --app，否则上游全服务扫描极易 120s 超时
+     （实测 10d 无 --app 必超时；同条件加 --app 后 ~105s 成功）。窗口优先 ≤6h。
   示例：
     bfi ymc slowsql -t 1d --app yonbip-scm-scmmp -e core3          # 服务维度（SQL 画像）
     bfi ymc slowsql -t 1d --trace-id abc -e core3                  # 链路维度（勿带 --app）`,
-	slowcall: `bfi ymc slowcall -t <time> -e <env> [--trace-id <id>] [--app <appCode>] [--method <方法>] [--min-cost <ms>] [--page N] [--page-size N] [--json]
+	slowcall: `bfi ymc slowcall -t <time> -e <env> [--trace-id <id>] [--app <appCode>] [--method <方法>] [--min-cost <ms>] [--page N] [--page-size N] [--timeout <秒>] [--json]
   慢调用告警明细（耗时降序；摘要含 服务/耗时/sql/rpc/redis 分解/方法/pod）。
   参数：
     --trace-id            按链路过滤。⚠️ 不带 --app（同 slowsql，--app 会截断下游服务告警行）
     --app                 服务维度过滤（裸 appCode）
     --method              按调用方法过滤
     --min-cost <ms>       最小耗时过滤（body.costTime=[ms, 999999]）
+    --page-size N         每页条数（服务端上限 200，超限直接报错并提示分页）
+    --timeout <秒>        客户端超时（默认 150s）
     --profiler            透传上游 enableProfiler（仅返回有 CPU 采样记录的调用）；
                           该过滤器常返回空集，常规取证勿带，CPU 热点走 dump-list。
   示例：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bfi-cli",
-  "version": "0.1.108",
+  "version": "0.1.110",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {