bfi-cli 0.1.109 → 0.1.110

package/dist/cli.mjs

@@ -8992,7 +8992,8 @@ const ALLOWED_FLAGS = {
 		"--app",
 		"--no-profiler",
 		"--page",
-		"--page-size"
+		"--page-size",
+		"--timeout"
 	],
 	slowcall: [
 		...F_ENV,
@@ -9003,7 +9004,8 @@ const ALLOWED_FLAGS = {
 		"--profiler",
 		"--min-cost",
 		"--page",
-		"--page-size"
+		"--page-size",
+		"--timeout"
 	],
 	exceptions: [
 		...F_ENV,
@@ -9144,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）");
@@ -9354,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;
@@ -9388,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;
@@ -9753,27 +9802,33 @@ const HELP = {
   ⚠️ 关键词按「整值」匹配：类名/全限定异常名必须整串加引号
      （"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.109",
+  "version": "0.1.110",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {