bfi-cli 0.1.72 → 0.1.73

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.73",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {