bfi-cli 0.1.94 → 0.1.96

package/bin/bfi-weknora-mcp.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import module from 'node:module';
+
+if (module.enableCompileCache && !process.env.NODE_DISABLE_COMPILE_CACHE) {
+  try {
+    module.enableCompileCache();
+  } catch {
+    // Ignore errors
+  }
+}
+
+await import('../dist/mcp-weknora/main.mjs');

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;
@@ -8115,17 +8118,6 @@ const ALLOWED_FLAGS = {
 		"--app",
 		"--type"
 	],
-	cases: [
-		"--type",
-		"--finger",
-		"--service",
-		"--kw",
-		"--limit",
-		"--file",
-		"--env",
-		"--confidence",
-		"--title"
-	],
 	wiki: [
 		"--limit",
 		"--source",
@@ -8568,68 +8560,6 @@ async function runYmc(args, globalOpts) {
 			emit(await api.call("ymc/tool/list", body), jsonMode, rowsSummary("诊断文件"));
 			break;
 		}
-		case "cases": {
-			const sub2 = rest[0] || "search";
-			const rest2 = rest.slice(1);
-			if (sub2 === "search") {
-				const body = {};
-				for (const [k, name] of [
-					["type", "--type"],
-					["fingerprint", "--finger"],
-					["service", "--service"],
-					["keyword", "--kw"]
-				]) {
-					const v = opt(rest2, name);
-					if (v) body[k] = v;
-				}
-				if (opt(rest2, "--limit")) body.limit = Number(opt(rest2, "--limit"));
-				emit(await api.call("cases/search", body), jsonMode, (data) => {
-					const d = data;
-					const list = d.cases || [];
-					if (!list.length) return "（无命中案例）";
-					return `✓ 命中 ${d.count} 条：\n` + list.map((x) => `  [${x.case_id}] (${x.type}/${x.confidence}) ${x.title}\n      指纹: ${JSON.stringify(x.fingerprint)}  ${x.env || ""} ${x.service || ""}  by ${x.author}`).join("\n");
-				});
-			} else if (sub2 === "show") {
-				const id = positionals(rest2)[0];
-				if (!id) {
-					console.error("用法：bfi ymc cases show <case_id>");
-					process.exit(1);
-				}
-				emit(await api.get(`cases/${id}`), jsonMode);
-			} else if (sub2 === "upload") {
-				const file = opt(rest2, "--file");
-				if (!file) {
-					console.error("用法：bfi ymc cases upload --file <case.md> [--type] [--finger \"a,b\"] [--env] [--service]");
-					process.exit(1);
-				}
-				const { readFileSync } = await import("node:fs");
-				const body = {
-					type: opt(rest2, "--type") || "review",
-					fingerprint: (opt(rest2, "--finger") || "").split(",").map((s) => s.trim()).filter(Boolean),
-					content: readFileSync(file, "utf-8")
-				};
-				for (const [k, name] of [
-					["env", "--env"],
-					["service", "--service"],
-					["confidence", "--confidence"],
-					["title", "--title"]
-				]) {
-					const v = opt(rest2, name);
-					if (v) body[k] = v;
-				}
-				emit(await api.call("cases", body), jsonMode, (data) => `✓ 案例已上传: ${data.case_id}`);
-			} else if (sub2 === "index") emit(await api.get("cases/index/overview"), jsonMode, (data) => {
-				const d = data;
-				const byType = Object.entries(d.by_type || {}).map(([k, v]) => `${k}=${v}`).join(", ");
-				const fps = (d.top_fingerprints || []).map((x) => `${x.fingerprint}(${x.count})`).join(", ");
-				return `✓ 案例总数: ${d.total}\n  类型分布: ${byType}\n  高频指纹: ${fps}`;
-			});
-			else {
-				console.error("用法：bfi ymc cases <search|show|upload|index>");
-				process.exit(1);
-			}
-			break;
-		}
 		case "wiki": {
 			const sub2 = rest[0] || "search";
 			const rest2 = rest.slice(1);
@@ -8866,6 +8796,7 @@ async function runYmc(args, globalOpts) {
 			break;
 		}
 		default: {
+			if (sub === "cases" || sub.startsWith("cases")) console.error("案例库已迁移 WeKnora：检索/归档改用 weknora-bfi MCP 工具（kb_search / kb_archive_case）。");
 			console.error(`未知子命令：${sub}`);
 			const hint = SUBCOMMAND_HINTS[sub];
 			if (hint) console.error(`提示：${hint}`);
@@ -8891,7 +8822,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 分析语句）。
   参数：
@@ -9086,6 +9019,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]
@@ -9149,6 +9085,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/dist/mcp-weknora/main.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/mcp-weknora/main.mjs

@@ -0,0 +1,308 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, CallToolResultSchema, ListToolsRequestSchema, ListToolsResultSchema } from "@modelcontextprotocol/sdk/types.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const DEFAULT_WEKNORA_URL = process.env.WEKNORA_MCP_URL || "https://bfi.yyuap.com/weknora/mcp/e8e50146-81f6-4aca-b5cf-cce711bd2b99";
+const CASE_KB_NAME = "案例库";
+var WeknoraError = class extends Error {
+	errorKind;
+	constructor(errorKind, message) {
+		super(message);
+		this.errorKind = errorKind;
+	}
+};
+var WeknoraRemote = class {
+	url;
+	token;
+	client = null;
+	constructor(url, token) {
+		this.url = url;
+		this.token = token;
+	}
+	async listTools() {
+		const client = await this.ensure();
+		try {
+			return (await client.request({ method: "tools/list" }, ListToolsResultSchema)).tools;
+		} catch (e) {
+			this.handleFailure(e);
+		}
+	}
+	async callTool(name, args) {
+		if (!this.token()) throw new WeknoraError("unauthorized", this.loginHint());
+		const client = await this.ensure();
+		try {
+			return await client.request({
+				method: "tools/call",
+				params: {
+					name,
+					arguments: args ?? {}
+				}
+			}, CallToolResultSchema);
+		} catch (e) {
+			this.handleFailure(e);
+		}
+	}
+	async ensure() {
+		if (this.client) return this.client;
+		const token = this.token();
+		if (!token) throw new WeknoraError("unauthorized", this.loginHint());
+		const client = new Client({
+			name: "bfi-weknora-mcp",
+			version: "0.1.0"
+		});
+		const transport = new StreamableHTTPClientTransport(new URL(this.url), { requestInit: { headers: { Authorization: `Bearer ${token}` } } });
+		try {
+			await client.connect(transport);
+		} catch (e) {
+			throw new WeknoraError("weknora_unreachable", `WeKnora 服务不可达（${this.url}）: ${e instanceof Error ? e.message : String(e)}`);
+		}
+		this.client = client;
+		return client;
+	}
+	handleFailure(e) {
+		this.client = null;
+		const message = e instanceof Error ? e.message : String(e);
+		if (/401|unauthorized|Unauthorized/i.test(message)) throw new WeknoraError("unauthorized", `WeKnora token 无效或过期。${this.loginHint()}`);
+		throw new WeknoraError("weknora_error", `WeKnora 远端调用失败: ${message}`);
+	}
+	loginHint() {
+		return "未找到 bfi token：请先执行 `bfi auth login --token <sk-token>`（token 获取地址 https://bfi.yyuap.com/user/profile），或设置 BFI_TOKEN 环境变量";
+	}
+};
+const GLOBAL_CONFIG_DIR = path.join(os.homedir(), ".bfi");
+const GLOBAL_CONFIG_FILE = path.join(GLOBAL_CONFIG_DIR, "config.json");
+path.join(".bfi", "lock.json");
+function loadGlobalConfig() {
+	try {
+		if (fs.existsSync(GLOBAL_CONFIG_FILE)) {
+			const content = fs.readFileSync(GLOBAL_CONFIG_FILE, "utf8");
+			return JSON.parse(content);
+		}
+	} catch (error) {
+		console.warn(`Warning: Failed to load global config: ${error.message}`);
+	}
+	return null;
+}
+function resolveToken() {
+	if (process.env.BFI_TOKEN) return process.env.BFI_TOKEN;
+	return loadGlobalConfig()?.token ?? null;
+}
+function textResult(payload, isError = false) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify(payload, null, 2)
+		}],
+		isError
+	};
+}
+const TOOLS = [
+	{
+		name: "kb_search",
+		description: "跨库语义检索 BFI 知识库（案例库/wiki/jira-支持案例/供应链/领域知识全部覆盖）——诊断先验的主通道：查历史同类问题、已解决方案、领域知识。返回最相关文段（hybrid）。",
+		inputSchema: {
+			type: "object",
+			properties: {
+				query: {
+					type: "string",
+					description: "检索问题（症状/组件/错误关键词组合均可）"
+				},
+				top_k: {
+					type: "number",
+					description: "返回条数（默认 5）"
+				}
+			},
+			required: ["query"]
+		}
+	},
+	{
+		name: "kb_ask",
+		description: "向知识库提问，返回合成答案与引用来源——需要结论而非文段列表时用。",
+		inputSchema: {
+			type: "object",
+			properties: { question: {
+				type: "string",
+				description: "问题"
+			} },
+			required: ["question"]
+		}
+	},
+	{
+		name: "kb_grep",
+		description: "按正则/关键词精确搜索知识库文本块（大小写不敏感）——已知确切关键词时用。",
+		inputSchema: {
+			type: "object",
+			properties: {
+				pattern: {
+					type: "string",
+					description: "正则或关键词"
+				},
+				kb: {
+					type: "string",
+					description: "知识库名或 id（可选，默认全部在 scope 库）"
+				}
+			},
+			required: ["pattern"]
+		}
+	},
+	{
+		name: "kb_archive_case",
+		description: `把诊断结论归档到「${CASE_KB_NAME}」知识库（唯一写通道）。content_md 建议结构：# 标题 / ## 现象 / ## 根因链 / ## 修复 / ## 证据与复现 / 指纹一行（供先验检索）。归档后先验检索即可命中，避免同类问题重复排查。`,
+		inputSchema: {
+			type: "object",
+			properties: {
+				title: {
+					type: "string",
+					description: "案例标题（症状+组件，如「OOM OCR 切图重复解码」）"
+				},
+				content_md: {
+					type: "string",
+					description: "案例正文（Markdown）"
+				}
+			},
+			required: ["title", "content_md"]
+		}
+	},
+	{
+		name: "kb_list",
+		description: "列出全部可访问知识库（id/名称/描述）。",
+		inputSchema: {
+			type: "object",
+			properties: {}
+		}
+	},
+	{
+		name: "kb_docs",
+		description: "列出一个知识库内的文档（分页）。",
+		inputSchema: {
+			type: "object",
+			properties: { kb: {
+				type: "string",
+				description: "知识库名或 id"
+			} },
+			required: ["kb"]
+		}
+	},
+	{
+		name: "kb_read",
+		description: "读一篇知识文档的元数据与正文分块。",
+		inputSchema: {
+			type: "object",
+			properties: {
+				doc_id: {
+					type: "string",
+					description: "文档 id"
+				},
+				kb: {
+					type: "string",
+					description: "知识库名或 id"
+				}
+			},
+			required: ["doc_id"]
+		}
+	}
+];
+async function callSemantic(remote, name, args) {
+	const a = args ?? {};
+	switch (name) {
+		case "kb_search": return {
+			tool: "search_knowledge",
+			arguments: {
+				query: a.query,
+				match_count: Number(a.top_k ?? 5)
+			}
+		};
+		case "kb_ask": return {
+			tool: "ask",
+			arguments: { question: a.question }
+		};
+		case "kb_grep": return {
+			tool: "grep_chunks",
+			arguments: {
+				pattern: a.pattern,
+				...a.kb ? { kb_id: a.kb } : {}
+			}
+		};
+		case "kb_list": return {
+			tool: "list_knowledge_bases",
+			arguments: {}
+		};
+		case "kb_docs": return {
+			tool: "list_documents",
+			arguments: { kb_id: a.kb }
+		};
+		case "kb_read": return {
+			tool: "read_document",
+			arguments: {
+				knowledge_id: a.doc_id,
+				...a.kb ? { kb_id: a.kb } : {}
+			}
+		};
+		default: return null;
+	}
+}
+function buildServer(remote) {
+	const weknora = remote ?? new WeknoraRemote(process.env.WEKNORA_MCP_URL || DEFAULT_WEKNORA_URL, resolveToken);
+	const server = new Server({
+		name: "bfi-weknora-mcp",
+		version: "0.1.0"
+	}, {
+		capabilities: { tools: {} },
+		instructions: [
+			`BFI 知识库/案例库通道（bfi cli 登录态鉴权，零配置）。知识库在 scope：`,
+			`案例库（诊断案例归档，唯一写目标）+ wiki×4 + jira-支持案例 + 供应链/领域知识。`,
+			`· 先验查询：kb_search（跨库语义检索，诊断前必查——历史同类问题/已解决方案）`,
+			`  kb_ask（要结论不要文段时）/ kb_grep（确切关键词）`,
+			`· 归档：kb_archive_case（诊断完成后把根因链+修复写回案例库，供下次先验命中）`,
+			`· 阅读：kb_list/kb_docs/kb_read + wiki_*（生成 wiki 浏览）`
+		].join("\n")
+	});
+	server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+	server.setRequestHandler(CallToolRequestSchema, async (request) => {
+		const { name, arguments: args } = request.params;
+		try {
+			if (name === "kb_archive_case") {
+				const title = String(args?.title ?? "").trim();
+				const content = String(args?.content_md ?? "").trim();
+				if (!title || !content) return textResult({
+					ok: false,
+					error_kind: "invalid_params",
+					message: "title 与 content_md 必填"
+				}, true);
+				const md = `# ${title}\n\n${content}\n`;
+				return await weknora.callTool("add_document", {
+					kb_id: CASE_KB_NAME,
+					title,
+					content: md
+				});
+			}
+			if (name === "wiki_index" || name === "wiki_read_page" || name === "wiki_search") return await weknora.callTool(name, args ?? {});
+			const mapped = await callSemantic(weknora, name, args);
+			if (!mapped) return textResult({
+				ok: false,
+				error_kind: "unknown_tool",
+				message: `未知工具：${name}`
+			}, true);
+			return await weknora.callTool(mapped.tool, mapped.arguments);
+		} catch (e) {
+			return textResult({
+				ok: false,
+				error_kind: e instanceof WeknoraError ? e.errorKind : "internal_error",
+				message: e instanceof Error ? e.message : String(e)
+			}, true);
+		}
+	});
+	return server;
+}
+async function main() {
+	await buildServer().connect(new StdioServerTransport());
+}
+main().catch((e) => {
+	console.error("[bfi-weknora-mcp] 启动失败:", e);
+	process.exit(1);
+});
+export {};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "bfi-cli",
-  "version": "0.1.94",
+  "version": "0.1.96",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {
     "bfi": "bin/bfi.js",
     "bfi-db-mcp": "bin/bfi-db-mcp.js",
-    "bfi-codesearch-mcp": "bin/bfi-codesearch-mcp.js"
+    "bfi-codesearch-mcp": "bin/bfi-codesearch-mcp.js",
+    "bfi-weknora-mcp": "bin/bfi-weknora-mcp.js"
   },
   "files": [
     "dist",