bfi-cli 0.1.73 → 0.1.74

package/dist/cli.mjs

@@ -8058,6 +8058,7 @@ var YmcApi = class {
 			if (Object.keys(body).length > 0) console.log(JSON.stringify(body, null, 2));
 			process.exit(0);
 		}
+		if (!this.token) throw new Error("未配置 API token：请 `bfi auth login --token <token>` 或 export BFI_TOKEN");
 		const url = `${this.baseUrl}/${path.replace(/^\//, "")}`;
 		const payload = JSON.stringify(body);
 		const mod = url.startsWith("https://") ? https : http;
@@ -8159,27 +8160,58 @@ function emit(result, jsonMode, summarize) {
 function raw0(text) {
 	return text || "{}";
 }
-const ENV_DOC = "环境: test/daily/pre/core1-4/commldev";
+const ENV_DOC = "环境: test/daily/pre/core1/core2/core3/core4/commldev";
+const VALID_ENVS = [
+	"test",
+	"daily",
+	"pre",
+	"core1",
+	"core2",
+	"core3",
+	"core4",
+	"commldev"
+];
+const TIME_RE = /^\d+(m|h|d|w)$/;
+function envError(env) {
+	if (!env || !env.trim()) return `缺少环境参数：-e <${ENV_DOC}>`;
+	if (!VALID_ENVS.includes(env.toLowerCase())) return `环境参数无效：收到 '${env}'\n合法值：${VALID_ENVS.join(" | ")}（若为新环境请升级 bfi CLI）\n例：bfi ymc slowsql -t 1d --app yonbip-scm-scmmp -e core3`;
+	return null;
+}
+function timeError(t) {
+	if (!t || !t.trim()) return `缺少时间参数：-t <简写>（如 1h/3d/10m/4w，表示过去 N 单位到现在）\n精确窗口：--start-time "yyyy-MM-dd HH:mm:ss" --end-time 同格式（北京时间）`;
+	if (!TIME_RE.test(t)) return `时间简写无效：收到 '${t}'\n合法格式：<N><单位>，单位 m(分)/h(时)/d(天)/w(周)，如 10m/2h/3d/4w\n精确窗口：--start-time "yyyy-MM-dd HH:mm:ss" --end-time 同格式（北京时间）`;
+	return null;
+}
 function requireEnv(args) {
 	const env = opt(args, "-e", "--env", "--env-name");
-	if (!env) {
-		console.error(`缺少环境参数：-e <${ENV_DOC}>`);
+	const err = envError(env);
+	if (err) {
+		console.error(err);
 		process.exit(1);
 	}
 	return { env_name: env };
 }
 function timeOf(args, required = true) {
 	const t = opt(args, "-t", "--time");
-	if (!t && required) {
-		console.error("缺少时间参数：-t <简写>（如 1h/3d/10m/4w，表示过去 N 单位到现在）");
+	const err = timeError(t);
+	if (err && required) {
+		console.error(err);
 		process.exit(1);
 	}
+	if (t && !err) validateTime(t);
 	return t ? { time: t } : {};
 }
 function timeOpts(args) {
 	const out = {};
 	const t = opt(args, "-t", "--time");
-	if (t) out.time = t;
+	if (t) {
+		const err = timeError(t);
+		if (err) {
+			console.error(err);
+			process.exit(1);
+		}
+		out.time = t;
+	}
 	const st = opt(args, "--start-time");
 	if (st) out.start_time = st;
 	const et = opt(args, "--end-time");
@@ -8725,6 +8757,27 @@ async function runYmc(args, globalOpts) {
 			}
 			break;
 		}
+		case "tool-download": {
+			const uploadFileName = positionals(rest)[0];
+			if (!uploadFileName) {
+				console.error("用法：bfi ymc tool-download <uploadFileName> -e <env> [-o 输出文件]");
+				console.error("例：bfi ymc tool-download monitor/17ff7937-xxx.html -e pre -o ~/flame.html");
+				console.error("uploadFileName 来源：bfi ymc call tool/list（uploadPath 字段）或 bfi ymc dump-list（uploadPath）");
+				process.exit(1);
+			}
+			const out = opt(rest, "-o", "--out") || uploadFileName.split("/").pop() || "download.bin";
+			try {
+				const n = await api.download("ymc/tool/download", {
+					...requireEnv(rest),
+					uploadFileName
+				}, out);
+				console.log(`✓ 已下载 ${n} 字节 → ${out}`);
+			} catch (e) {
+				console.error(`✗ ${e.message}`);
+				process.exit(1);
+			}
+			break;
+		}
 		case "call": {
 			const route = positionals(rest)[0];
 			const dataStr = opt(rest, "--data") || "{}";
@@ -8866,6 +8919,10 @@ const HELP = {
 	"bpr-download": `bfi ymc bpr-download <pk> -e <env> [-o <输出文件>]
   BPR 报告 HTML 下载（文件流写盘）。pk 来源：bfi ymc call bpr/list --data '{"page":1,"pageSize":10}' -e <env>。
   输出默认 bpr_<pk前16>.html。`,
+	"tool-download": `bfi ymc tool-download <uploadFileName> -e <env> [-o <输出文件>]
+  诊断文件内容下载（CPU 火焰图/堆 dump/BPR HTML 等文件流写盘）。
+  uploadFileName 来源：bfi ymc call tool/list（uploadPath）或 bfi ymc dump-list（uploadPath）。
+  输出默认取文件名部分（monitor/xx.html → xx.html）。`,
 	call: `bfi ymc call <route> -e <env> [--data '<json>'] [-t <time> | --start-time <s> --end-time <e>] [--timeout <秒>] [--json]
   通用透传：覆盖全部注册表端点（warningCall/warningSql/exceptionHistory/bpr/list/alert/detail/tool/list/app/history/environment/uba/query ...）。
   完整清单与参数声明：curl http://172.20.35.178:8901/openapi.json 或 /docs（Swagger UI）。
@@ -8887,6 +8944,8 @@ function printHelp() {
 	console.log(`
 bfi ymc — 观测查询（v2 API：YMC/Kibana/SLS/trace）
 
+详细帮助/示例：bfi ymc help <命令>（首次使用必看——含参数默认值与易错点）
+
 命令：
   status                      登录会话状态（dev/prod）
   trace <trace_id> -e <env>   三源合一（SLS+链路+ingress）
@@ -8902,6 +8961,12 @@ bfi ymc — 观测查询（v2 API：YMC/Kibana/SLS/trace）
   url-stats </uri> -t <time> -e <env> [--app <service_name>]
   ingress --trace-id <id> | --uri </path> [-t <time>] -e <env> [--exact] [--app <service_name>]
   dump-list [-t <time>] -e <env> [--app] [--type profiler]
+  tool-download <uploadPath> -e <env> [-o <文件>]  诊断文件内容下载
+  log-url <...>               SLS 直链（日志中心页面直达）
+  events / sample-list        集群事件 / 采样数据列表
+  callstat / sqlstat          慢调用/慢SQL 统计版聚合
+  rca <...>                   官方智能诊断 RCA（长耗时）
+  bpr-download <pk>           BPR 报告下载
   cases <search|show|upload|index>  案例库（KEDB）
   wiki search "<kw>" [--source] [--titles]  知识库统一检索（wiki/jira/文库）
   wiki show <id> [--source]         知识条目全文

package/package.json

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