bfi-cli 0.1.93 → 0.1.95

package/dist/cli.mjs

@@ -7162,6 +7162,7 @@ async function handleInstall(args, api, globalOpts) {
 		console.error(`${RED$1}获取包信息失败：${error.message}${RESET$3}`);
 		process.exit(1);
 	}
+	if (pkgInfo.kind === "PLUGIN") throw new Error("这是完整插件，不是技能组合；请使用 --as plugin --agent <目标Agent> 安装，插件可能包含 MCP 和 Hooks。");
 	const skills = pkgInfo.skills || [];
 	if (skills.length === 0) {
 		console.log(`${YELLOW$1}包中没有可独立安装的技能。${RESET$3}`);
@@ -7484,7 +7485,9 @@ async function handleUpdate(args, api, globalOpts) {
 	console.log(`${DIM$3}正在更新 ${packagesToUpdate.length} 个包...${RESET$3}`);
 	for (const pkg of packagesToUpdate) try {
 		const pkgInfo = await api.getPackage(pkg.namespace, pkg.slug);
-		const skills = (pkgInfo.data || pkgInfo).skills || [];
+		const info = pkgInfo.data || pkgInfo;
+		if (info.kind === "PLUGIN") throw new Error("这是完整插件，请使用 --as plugin --agent <目标Agent> 更新；不会按技能组合安装。");
+		const skills = info.skills || [];
 		console.log(`  ${DIM$3}更新 @${pkg.namespace}/${pkg.slug}（${skills.length} 个技能）...${RESET$3}`);
 		for (const skill of skills) {
 			const skillRef = skill.namespace ? `@${skill.namespace}/${skill.slug}` : skill.slug;
@@ -8134,12 +8137,14 @@ const ALLOWED_FLAGS = {
 	callstat: [
 		...F_ENV,
 		...F_RANGE,
+		"--app",
 		"--page",
 		"--page-size"
 	],
 	sqlstat: [
 		...F_ENV,
 		...F_RANGE,
+		"--app",
 		"--page",
 		"--page-size"
 	],
@@ -8184,6 +8189,16 @@ const ALLOWED_FLAGS = {
 		"--timeout"
 	]
 };
+const SUBCOMMAND_HINTS = {
+	"db-tenant-locate": "租户定位在 db 命令组：bfi db tenant-locate <租户编码>",
+	"tenant-locate": "租户定位在 db 命令组：bfi db tenant-locate <租户编码>",
+	"tool-start": "call 透传路由：bfi ymc call action/tool/start --data '{\"type\":1,...}'",
+	"eventHistograms": "call 透传路由：bfi ymc call eventHistograms ...（无同名子命令）",
+	"exceptionDetail": "call 透传路由：bfi ymc call exceptionDetail ...（无同名子命令）",
+	"app-list": "该端点无查询参数且不支持按服务过滤（列表型导航端点）；appId 用推导式 <env>-<appCode>",
+	"warningSqlstat": "用子命令：bfi ymc sqlstat",
+	"warningCallstat": "用子命令：bfi ymc callstat"
+};
 function assertKnownFlags(sub, rest) {
 	const allowed = /* @__PURE__ */ new Set([...COMMON_FLAGS, ...ALLOWED_FLAGS[sub] ?? []]);
 	for (const a of rest) {
@@ -8244,6 +8259,21 @@ function rowsSummary(label) {
 		return `✓ ${label}: ${Array.isArray(rows) ? rows.length : 0} 条`;
 	};
 }
+function aggSummary(label) {
+	return (data) => {
+		const d = data;
+		const rows = d.rows ?? d;
+		if (!Array.isArray(rows) || !rows.length) return `✓ ${label}: 0 组`;
+		const countCol = [
+			"count",
+			"cnt",
+			"COUNT(*)",
+			"c"
+		].find((k) => rows.every((r) => r[k] !== void 0));
+		const total = countCol ? rows.reduce((acc, r) => acc + (Number(r[countCol]) || 0), 0) : NaN;
+		return Number.isFinite(total) ? `✓ ${label}: ${rows.length} 组 / 总计 ${total} 条` : `✓ ${label}: ${rows.length} 组`;
+	};
+}
 async function runYmc(args, globalOpts) {
 	const sub = args[0];
 	const rest = args.slice(1);
@@ -8393,7 +8423,7 @@ async function runYmc(args, globalOpts) {
 				...requireEnv(rest),
 				...timeOf(rest, false),
 				line: Number(opt(rest, "--line") || 50)
-			}), jsonMode, rowsSummary(`SLS 全文检索 "${kw}"`));
+			}), jsonMode, aggSummary(`SLS 全文检索 "${kw}"`));
 			break;
 		}
 		case "sls-logs": {
@@ -8713,6 +8743,7 @@ async function runYmc(args, globalOpts) {
 			emit(await api.call("ymc/warningCallstat", {
 				...requireEnv(rest),
 				...timeOpts(rest),
+				curAppCode: opt(rest, "--app") || "",
 				page: Number(opt(rest, "--page") || 1),
 				pageSize: Number(opt(rest, "--page-size") || 20)
 			}), jsonMode, rowsSummary("慢调用统计"));
@@ -8721,6 +8752,7 @@ async function runYmc(args, globalOpts) {
 			emit(await api.call("ymc/warningSqlstat", {
 				...requireEnv(rest),
 				...timeOpts(rest),
+				curAppCode: opt(rest, "--app") || "",
 				page: Number(opt(rest, "--page") || 1),
 				pageSize: Number(opt(rest, "--page-size") || 20)
 			}), jsonMode, rowsSummary("慢 SQL 统计"));
@@ -8836,10 +8868,13 @@ async function runYmc(args, globalOpts) {
 			}, timeoutMs), jsonMode);
 			break;
 		}
-		default:
+		default: {
 			console.error(`未知子命令：${sub}`);
+			const hint = SUBCOMMAND_HINTS[sub];
+			if (hint) console.error(`提示：${hint}`);
 			printHelp$3();
 			process.exit(1);
+		}
 	}
 }
 const HELP = {
@@ -8859,7 +8894,9 @@ const HELP = {
 	chain: `bfi ymc chain <trace_id> -e <env> [--ts <毫秒>] [--json]
   原子源：warningChain 全量 Span 链路（耗时分解/调用树）。trace 三源合一的链路通道单独调用。`,
 	"sls-logs": `bfi ymc sls-logs <trace_id> -e <env> [--ts <毫秒>] [--json]
-  原子源：SLS 业务日志（异常全文/堆栈）。按 traceid 索引检索。`,
+  原子源：SLS 业务日志（异常全文/堆栈）。按 traceid 索引检索。
+  --json 结构：data 为对象（非数组）——日志行在 data.rows，计数在 data.count。
+  直接把 data 当数组迭代会得到 0 条（2026-10-16 实战教训）。`,
 	"sls-raw": `bfi ymc sls-raw "<查询>" -e <env> [-t <time> | --start-time <s> --end-time <e> | --days N] [--line N] [--json]
   SLS 原始查询（阿里云 SLS 完整语法透传：索引检索 + | SELECT 分析语句）。
   参数：
@@ -9054,6 +9091,9 @@ function printHelp$2() {
   bfi event stat <dc> <date> [metric_type] [--page N] [--size N]
     date: yyyy-MM-dd 单日；metric_type: enter|fail|response_time_4s_|response_time_2s_4s|body_size_512k_1m|body_size_1m_
   bfi event record <dc> <date> --source-id S --event-type ET --node-code N --ds-code DS [--record-status fail] [--record-id ID] [--tenant-code T] [--size ≤20]
+  bfi event dc-scan <date> [--event-type ET] [--node-code N]
+    全 DC 矩阵扫描：C1-C4 逐数据中心查 fail 统计，本事件命中高亮。
+    ⚠️ monitor fail（不带 DC）存在数据中心盲区（实测漏 C3）——失败现场定位必须用本命令
   bfi event content <dc> <date> --event-id E --ds-code DS --tenant-code T
   bfi event dclist <dc>
   bfi event analyze-alert <dc> <date> --event-type ET --node-code N [--source-id S] [--tenant-code T]
@@ -9117,6 +9157,74 @@ async function runEvent(args, globalOpts) {
 		});
 		return;
 	}
+	if (sub === "dc-scan") {
+		const date = reqs[0] ?? missing("<date>");
+		const eventType = str("--event-type") ?? "";
+		const nodeCode = str("--node-code") ?? "";
+		const dcs = [
+			"core1",
+			"core2",
+			"core3",
+			"core4"
+		];
+		const statOnce = async (dc) => {
+			return (await api.call("event/stat", {
+				dc,
+				date,
+				metric_type: "fail",
+				page: 0,
+				size: 1e3
+			}))?.data?.data?.content ?? [];
+		};
+		const results = await Promise.all(dcs.map(async (dc) => {
+			try {
+				let content = await statOnce(dc);
+				if (!content.length) content = await statOnce(dc);
+				const hit = eventType ? content.filter((x) => x.eventType === eventType && (!nodeCode || x.nodeCode === nodeCode)) : content;
+				return {
+					dc,
+					rows: hit,
+					failNum: hit.reduce((acc, x) => acc + Number(x.num ?? 0), 0),
+					total: content.length
+				};
+			} catch (e) {
+				return {
+					dc,
+					rows: [],
+					failNum: 0,
+					total: 0,
+					error: e instanceof Error ? e.message : String(e)
+				};
+			}
+		}));
+		if (jsonMode) {
+			console.log(JSON.stringify({
+				code: 0,
+				msg: "success",
+				data: {
+					date,
+					event_type: eventType,
+					node_code: nodeCode,
+					results
+				}
+			}, null, 2));
+			return;
+		}
+		const lines = [`全 DC fail 矩阵（${date}${eventType ? ` · ${eventType}${nodeCode ? ` / ${nodeCode}` : ""}` : ""}）：`, "DC       失败数   失败率      判定"];
+		for (const r of results) {
+			if (r.error) {
+				lines.push(`${r.dc.padEnd(8)} 通道错误：${r.error}`);
+				continue;
+			}
+			const rate = r.rows.length ? String(r.rows[0].failRate ?? "-") : "-";
+			const verdict = r.total === 0 ? "✓ 无记录（排除证据）" : r.failNum === 0 ? "✓ 有流量零失败" : `🔴 失败现场（${r.rows.length} 个监听行）`;
+			lines.push(`${r.dc.padEnd(8)} ${String(r.failNum).padEnd(8)} ${rate.padEnd(11)} ${verdict}`);
+		}
+		const hot = results.filter((r) => r.failNum > 0).map((r) => r.dc);
+		lines.push(hot.length ? `→ 失败现场：${hot.join(" / ")}（对命中 DC 逐一 event analyze-alert；零命中 DC 是报告的排除证据）` : "→ 全 DC 无失败记录");
+		console.log(lines.join("\n"));
+		return;
+	}
 	if (sub === "monitor") {
 		const metric = reqs[0];
 		if (!metric || !METRICS.includes(metric)) {

package/package.json

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