bfi-cli 0.1.72 → 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/dist/mcp-db/main.mjs

@@ -164,6 +164,10 @@ var RestError = class extends Error {
 		this.errorKind = errorKind;
 	}
 };
+function requireParam(name, value) {
+	if (!value || !value.trim()) throw new RestError("invalid_params", `${name} 不能为空：请从 db_list_envs 返回结果中原样复制（如 env_code=core1_3）`);
+	return value;
+}
 async function post(path, payload, fetchImpl = fetch) {
 	const token = resolveToken();
 	if (!token) throw new RestError("unauthorized", "未找到 bfi token：请先执行 `bfi auth login --token <sk-token>`（token 获取地址 https://bfi.yyuap.com/user/profile），或设置 BFI_TOKEN 环境变量");
@@ -185,24 +189,24 @@ async function post(path, payload, fetchImpl = fetch) {
 	if (body.code === 0) return body.data;
 	throw new RestError(body.data?.error_kind || "upstream_error", body.msg || "bfi-api 返回错误");
 }
-function listEnvs(keyword, envType, fetchImpl) {
+async function listEnvs(keyword, envType, fetchImpl) {
 	return post("/bficli/api/v2/db/envs", {
 		keyword,
 		env_type: envType,
 		enabled_only: true
 	}, fetchImpl);
 }
-function execSql(envCode, sql, maxRows, fetchImpl) {
+async function execSql(envCode, sql, maxRows, fetchImpl) {
 	return post("/bficli/api/v2/db/exec", {
-		env_code: envCode,
-		sql,
+		env_code: requireParam("env_code", envCode),
+		sql: requireParam("sql", sql),
 		max_rows: maxRows
 	}, fetchImpl);
 }
-function explainSql(envCode, sql, fetchImpl) {
+async function explainSql(envCode, sql, fetchImpl) {
 	return post("/bficli/api/v2/db/explain", {
-		env_code: envCode,
-		sql
+		env_code: requireParam("env_code", envCode),
+		sql: requireParam("sql", sql)
 	}, fetchImpl);
 }
 function textResult(payload, isError = false) {
@@ -234,7 +238,8 @@ function buildServer() {
 	}, { instructions: [
 		"数据库取证通道（只读）：查询环境列表 → EXPLAIN 执行计划（优先）→ 必要时小行数 SELECT 采样。",
 		"DDL/DML 默认被环境权限位拒绝；db_direct 为用户自备连接的本地直连，词法级闸门仅放行 SELECT/WITH/EXPLAIN，结果无审计，写报告须标注\"本地直连取证\"。",
-		"执行前先用 db_list_envs 锁定 env_code（对应诊断的 appCode 先行铁律）。"
+		"执行前先用 db_list_envs 锁定 env_code（对应诊断的 appCode 先行铁律）。",
+		"降级链：环境清单匹配不到目标环境（env_not_found），或选中环境连接不可达（connection_failed）时，向用户说明并**提示附上数据库连接串**（mysql://user:pwd@host:3306/db），改走 db_direct 本地直连兜底。"
 	].join("\n") });
 	server.registerTool("db_list_envs", {
 		description: "获取可查询的数据库环境列表（env_code/env_name/db_type/datacenter/权限位 allow_ddl·dml·query·explain）。不含密码。执行任何 SQL 前必须先用本工具锁定 env_code。",
@@ -250,23 +255,23 @@ function buildServer() {
 	server.registerTool("db_execute", {
 		description: "在指定环境执行单条 SQL（只读取证）。仅 SELECT/WITH/SHOW/DESC/EXPLAIN；DML/DDL 需环境显式授权位否则 permission_denied。行数上限默认 200。非 mysql 库自动翻译（mysql 语法输入即可）。诊断场景优先 db_explain。",
 		inputSchema: {
-			env_code: z.string().describe("环境编码，来自 db_list_envs"),
-			sql: z.string().describe("单条 SQL（mysql 语法）"),
+			env_code: z.string().min(1, "env_code 不能为空：请从 db_list_envs 返回的 env_code 字段原样复制（如 core1_3）").describe("环境编码，来自 db_list_envs 返回的 env_code 字段（如 core1_3）原样传入"),
+			sql: z.string().min(1, "sql 不能为空").describe("单条 SQL（mysql 语法）"),
 			max_rows: z.number().int().min(1).max(2e3).optional().describe("行数上限，默认 200")
 		}
 	}, wrap((args) => execSql(args.env_code, args.sql, args.max_rows)));
 	server.registerTool("db_explain", {
 		description: "获取执行计划（慢 SQL 实证首选）。目标语句必须为 SELECT/WITH；gscm 按 db_type 组装 EXPLAIN（oracle 两步 EXPLAIN PLAN + DBMS_XPLAN）。结果为计划行，EXPLAIN 结果进报告须附原始计划行。",
 		inputSchema: {
-			env_code: z.string().describe("环境编码，来自 db_list_envs"),
-			sql: z.string().describe("目标 SELECT/WITH 语句（mysql 语法）")
+			env_code: z.string().min(1, "env_code 不能为空：请从 db_list_envs 返回的 env_code 字段原样复制（如 core1_3）").describe("环境编码，来自 db_list_envs 返回的 env_code 字段（如 core1_3）原样传入"),
+			sql: z.string().min(1, "sql 不能为空").describe("目标 SELECT/WITH 语句（mysql 语法）")
 		}
 	}, wrap((args) => explainSql(args.env_code, args.sql)));
 	server.registerTool("db_direct", {
 		description: "用户自备连接串的本地直连（不经服务端，无审计）。词法级闸门仅放行单条 SELECT/WITH/EXPLAIN（EXPLAIN ANALYZE 拒绝），执行前连接预检。仅当用户明确提供连接串且环境通道不可达时使用；报告引用本工具结果必须标注\"本地直连取证\"。",
 		inputSchema: {
-			dsn: z.string().describe("连接串 mysql://user:pwd@host:3306/db（密码仅内存持有）"),
-			sql: z.string().describe("单条 SELECT/WITH/EXPLAIN"),
+			dsn: z.string().min(1, "dsn 不能为空").describe("连接串 mysql://user:pwd@host:3306/db（密码仅内存持有）"),
+			sql: z.string().min(1, "sql 不能为空").describe("单条 SELECT/WITH/EXPLAIN"),
 			max_rows: z.number().int().min(1).max(2e3).optional().describe("行数上限，默认 200")
 		}
 	}, wrap((args) => directExecute(args.dsn, args.sql, args.max_rows)));

package/package.json

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