bfi-cli 0.1.74 → 0.1.75

package/dist/cli.mjs

@@ -6,6 +6,7 @@ import { require_picocolors } from "./_chunks/libs/picocolors.mjs";
 import { addSkillToLocalLock, addSkillToLock, computeSkillFolderHash, discoverSkills, dismissPrompt, filterSkills, getAllLockedSkills, getGitHubToken, getLastSelectedAgents, getSkillDisplayName, getSkillFromLock, isPromptDismissed, parseFrontmatter, parseSkillMd, readLocalLock, readSkillLock, removeSkillFromLock, sanitizeMetadata, saveSelectedAgents, stripTerminalEscapes } from "./_chunks/skills.mjs";
 import { esm_default } from "./_chunks/libs/simple-git.mjs";
 import { EVE_SUBAGENTS_DIR, agents, detectInstalledAgents, getEveSubagents, getNonUniversalAgents, getUniversalAgents, getVisibleUniversalAgents, isUniversalAgent } from "./_chunks/agents.mjs";
+import { createRequire } from "node:module";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
 import { basename, dirname, extname, isAbsolute, join, normalize, relative, resolve, sep } from "path";
 import { fileURLToPath } from "url";
@@ -8239,7 +8240,7 @@ async function runYmc(args, globalOpts) {
 	const token = globalOpts.token;
 	const api = new YmcApi(token ?? null, void 0, dryRun);
 	if (!sub || sub === "--help" || sub === "-h") {
-		printHelp();
+		printHelp$1();
 		return;
 	}
 	if (sub === "help") {
@@ -8805,7 +8806,7 @@ async function runYmc(args, globalOpts) {
 		}
 		default:
 			console.error(`未知子命令：${sub}`);
-			printHelp();
+			printHelp$1();
 			process.exit(1);
 	}
 }
@@ -8936,11 +8937,11 @@ function printCommandHelp(cmd) {
 	if (h) console.log(h);
 	else {
 		console.error(`未知子命令：${cmd}`);
-		printHelp();
+		printHelp$1();
 		process.exit(1);
 	}
 }
-function printHelp() {
+function printHelp$1() {
 	console.log(`
 bfi ymc — 观测查询（v2 API：YMC/Kibana/SLS/trace）
 
@@ -8984,6 +8985,298 @@ bfi ymc — 观测查询（v2 API：YMC/Kibana/SLS/trace）
 详细帮助：bfi ymc help <命令>（或 bfi ymc <命令> -h）——含参数说明/默认值/示例。
 `);
 }
+function loadSourceMapConsumer() {
+	return createRequire(import.meta.url)("source-map").SourceMapConsumer;
+}
+function parseErrorLog(log) {
+	const out = {
+		mdf: null,
+		errorType: "",
+		errorMessage: "",
+		frames: []
+	};
+	const code = log.match(/\b(E\d{5})\b/);
+	const kind = log.match(/\[([^\]]{2,20}错误)\]/);
+	const diwork = log.match(/diworkCode:\s*([^\]]+)\]/);
+	const method = log.match(/\[([a-zA-Z_$][\w$]*(?:\.[\w$$.]+)+)\]\s*:/);
+	const event = log.match(/execute\[([^\]]+)\]/);
+	const bill = log.match(/\[([^\]]+)\]\s*\[[^\]]{2,20}错误\]/);
+	if (code && log.includes("【MDF】")) out.mdf = {
+		code: code[1],
+		billName: bill?.[1] ?? "",
+		errorKind: kind?.[1] ?? "",
+		diworkCode: diwork?.[1]?.trim() ?? "",
+		method: method?.[1] ?? "",
+		event: event?.[1] ?? ""
+	};
+	const errMatches = [...log.matchAll(/(TypeError|ReferenceError|SyntaxError|RangeError)\s*:\s*([^\n\r]+)/g)];
+	if (errMatches.length > 0) {
+		const last = errMatches[errMatches.length - 1];
+		out.errorType = last[1];
+		out.errorMessage = `${last[1]}: ${last[2].trim()}`;
+	}
+	for (const m of log.matchAll(/(https?:\/\/[^\s()"']+?\.min\.js):(\d+):(\d+)/g)) out.frames.push({
+		index: out.frames.length,
+		url: m[1],
+		line: Number(m[2]),
+		col: Number(m[3])
+	});
+	return out;
+}
+function pickFrame(frames) {
+	const ext = frames.findIndex((f) => /\/extend\.\d+\.[a-f0-9]+/.test(f.url));
+	return ext !== -1 ? ext : 0;
+}
+function resolveSourceMappingUrl(jsUrl, comment) {
+	if (/^https?:\/\//.test(comment)) return comment;
+	return `${jsUrl.replace(/\/[^/]*$/, "")}/${comment.replace(/^\.?\//, "")}`;
+}
+function webpackSourceInfo(source) {
+	const m = source.match(/^webpack:\/\/([^/]+)\/(.+)$/);
+	if (!m) return {
+		repo: "",
+		filePath: source.replace(/^webpack:\/\//, "")
+	};
+	return {
+		repo: m[1],
+		filePath: m[2].replace(/^\.\//, "")
+	};
+}
+function extractContext(content, line, ctx) {
+	const lines = content.split("\n");
+	const start = Math.max(1, line - ctx);
+	const end = Math.min(lines.length, line + ctx);
+	const width = String(end).length;
+	const out = [];
+	for (let i = start; i <= end; i++) {
+		const mark = i === line ? " --> " : "     ";
+		out.push(`${mark}${String(i).padStart(width)} | ${lines[i - 1]}`);
+	}
+	return out.join("\n");
+}
+const UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36";
+function httpGet(url, redirects = 0) {
+	return new Promise((resolve, reject) => {
+		if (redirects > 5) {
+			reject(/* @__PURE__ */ new Error(`重定向超过 5 次: ${url}`));
+			return;
+		}
+		const req = (url.startsWith("https://") ? https : http).get(url, {
+			headers: {
+				"user-agent": UA,
+				accept: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+				cookie: "debug=true"
+			},
+			timeout: 6e4
+		}, (res) => {
+			const status = res.statusCode ?? 0;
+			const loc = res.headers.location;
+			if (status >= 300 && status < 400 && loc) {
+				res.resume();
+				httpGet(new URL(loc, url).toString(), redirects + 1).then(resolve, reject);
+				return;
+			}
+			const chunks = [];
+			res.on("data", (c) => chunks.push(c));
+			res.on("end", () => resolve({
+				status,
+				body: Buffer.concat(chunks)
+			}));
+		});
+		req.on("timeout", () => req.destroy(/* @__PURE__ */ new Error(`下载超时（60s）: ${url}`)));
+		req.on("error", reject);
+	});
+}
+async function downloadTo(url, file, what) {
+	const { status, body } = await httpGet(url);
+	if (status !== 200 || body.length === 0) throw new Error(`${what}下载失败（HTTP ${status}）: ${url}\n若 sourcemap 被剥离，降级：按 JS 文件名走 bfi-code-search 内容搜索定位`);
+	fs.writeFileSync(file, body);
+	return body.length;
+}
+function cacheDirFor(jsUrl, root) {
+	const u = new URL(jsUrl);
+	return path$1.join(root || path$1.join(os$1.homedir(), ".bfi", "fe-locate", "cache"), u.host, path$1.dirname(u.pathname).replace(/^\/|\/$/g, ""));
+}
+function readStdin() {
+	return new Promise((resolve, reject) => {
+		let data = "";
+		process.stdin.setEncoding("utf-8");
+		process.stdin.on("data", (c) => {
+			data += c;
+		});
+		process.stdin.on("end", () => resolve(data));
+		process.stdin.on("error", reject);
+	});
+}
+function parseSourceMappingComment(jsContent) {
+	const m = jsContent.slice(-3e3).match(/\/\/# sourceMappingURL=(\S+)/);
+	if (!m) throw new Error("JS 文件末尾未找到 //# sourceMappingURL= 注释（构建未产出 sourcemap）");
+	return m[1];
+}
+async function locateInMap(mapFile, line, col) {
+	const consumer = await new (loadSourceMapConsumer())(JSON.parse(fs.readFileSync(mapFile, "utf-8")));
+	try {
+		let pos = consumer.originalPositionFor({
+			line,
+			column: Math.max(0, col - 1)
+		});
+		if (!pos?.source) pos = consumer.originalPositionFor({
+			line,
+			column: col
+		});
+		if (!pos?.source) throw new Error(`sourcemap 中无该位置映射（line=${line}, col=${col}）——JS 与 map 版本可能不一致`);
+		const content = pos.source ? consumer.sourceContentFor(pos.source, true) : null;
+		return {
+			source: pos.source,
+			line: pos.line ?? 0,
+			column: pos.column ?? 0,
+			name: pos.name ?? "",
+			content
+		};
+	} finally {
+		consumer.destroy?.();
+	}
+}
+function printHelp() {
+	console.log(`bfi fe-locate — 前端错误定位（sourcemap 还原）
+
+用法:
+  bfi fe-locate "<错误日志>"              # 单参数（控制台报错栈粘贴）
+  cat error.log | bfi fe-locate --stdin   # 长日志走 stdin（推荐，免转义）
+
+选项:
+  --json          结构化 JSON 输出（定位结果+全部帧+上下文）
+  --stdin         从标准输入读取错误日志
+  --context <N>   源码上下文行数（默认 5）
+  --frame <N>     指定第 N 帧定位（1-based；默认智能选帧：extend 业务帧优先）
+  --no-cache      强制重新下载 JS/sourcemap
+
+示例:
+  bfi fe-locate "TypeError: e.get(...).setValue is not a function at y (https://static-dc-core1.yonyoucloud.com/static/mdf/udinghuo/latest/javascripts/extend.23.xxx.min.js:1:100358)"`);
+}
+function printResult(r, ctxLines) {
+	const err = r.error;
+	const mdf = r.mdf;
+	console.log("═══ bfi fe-locate — 前端错误定位 ═══\n");
+	if (mdf) console.log(`【MDF 头】${mdf.code} | 单据:${mdf.billName} | 类型:${mdf.errorKind} | diworkCode:${mdf.diworkCode} | 方法:${mdf.method} | 事件:${mdf.event}`);
+	console.log(`【错误】${err.type}: ${err.message}`);
+	const frames = r.frames;
+	const sel = r.selected;
+	console.log(`【选帧】第 ${sel.index} 帧（${sel.reason}）: ${path$1.basename(String(sel.url))}:${sel.line}:${sel.col}（共 ${frames.length} 帧）`);
+	console.log(`【压缩 JS】${r.jsUrl}`);
+	const resolved = r.resolved;
+	if (resolved) {
+		console.log("\n── sourcemap 还原 ──");
+		console.log(`原始文件: ${resolved.source}`);
+		const info = resolved.webpack;
+		if (info.repo) console.log(`包内仓库: ${info.repo}（注：包内仓库名≠GitLab 仓库名，远程定位按文件名搜索）`);
+		console.log(`文件路径: ${info.filePath}`);
+		console.log(`位置: 行 ${resolved.line}, 列 ${resolved.column}`);
+		if (resolved.name) console.log(`函数名: ${resolved.name}`);
+		if (ctxLines) {
+			console.log(`\n── 源码上下文（sourcemap sourcesContent，±${r.context} 行）──`);
+			console.log(ctxLines);
+		}
+		console.log("\n── 下一步 ──");
+		console.log(`· 远程仓库: SourceGraph 精确文件名搜索 "${path$1.basename(info.filePath)}"（bfi-code-search）`);
+		console.log("· 归因分析: 对照 bfi-diagnose-engine references/fe-error-attribution.md");
+		console.log("· 数据格式类根因（接口返回变化）→ deep 档联动 bfi ymc ingress/trace 取证");
+	}
+	console.log(`\n缓存: ${r.cacheDir}`);
+}
+async function runFeLocate(args, globalOpts) {
+	if (!args.length || flag(args, "--help") || flag(args, "-h")) {
+		printHelp();
+		return;
+	}
+	const jsonMode = flag(args, "--json");
+	const noCache = flag(args, "--no-cache");
+	const ctxN = Number(opt(args, "--context") ?? 5) || 5;
+	const frameN = opt(args, "--frame");
+	let log = positionals(args)[0] ?? "";
+	if (!log && flag(args, "--stdin")) log = await readStdin();
+	if (!log && !process.stdin.isTTY) log = await readStdin();
+	if (!log.trim()) {
+		console.error("缺少错误日志参数。粘贴控制台报错栈，或 cat error.log | bfi fe-locate --stdin");
+		process.exit(1);
+	}
+	const parsed = parseErrorLog(log);
+	if (parsed.frames.length === 0) {
+		console.error("未在日志中找到压缩 JS 帧（https://...xxx.min.js:行:列）。请确认粘贴的是浏览器控制台报错栈。");
+		process.exit(1);
+	}
+	const selIdx = frameN ? Math.max(0, Number(frameN) - 1) : pickFrame(parsed.frames);
+	const selReason = frameN ? "--frame 指定" : parsed.frames[selIdx] && /\/extend\.\d+\./.test(parsed.frames[selIdx].url) ? "extend 业务帧优先" : "默认第一帧";
+	if (selIdx >= parsed.frames.length) {
+		console.error(`--frame ${frameN} 超出范围（共 ${parsed.frames.length} 帧）`);
+		process.exit(1);
+	}
+	const frame = parsed.frames[selIdx];
+	const cDir = cacheDirFor(frame.url, globalOpts["fe-cache-dir"]);
+	fs.mkdirSync(cDir, { recursive: true });
+	const jsFile = path$1.join(cDir, "error.min.js");
+	const mapFile = path$1.join(cDir, "error.min.js.map");
+	const metaFile = path$1.join(cDir, "meta.json");
+	let sourceMappingURL = "";
+	if (!noCache && fs.existsSync(metaFile)) try {
+		sourceMappingURL = JSON.parse(fs.readFileSync(metaFile, "utf-8")).sourceMappingUrl ?? "";
+	} catch {}
+	if (sourceMappingURL && fs.existsSync(mapFile)) console.error(`[缓存命中] ${cDir}`);
+	else {
+		const jsSize = await downloadTo(frame.url, jsFile, "压缩 JS");
+		console.error(`[下载] 压缩 JS（${(jsSize / 1024).toFixed(0)} KB）`);
+		const comment = parseSourceMappingComment(fs.readFileSync(jsFile, "utf-8"));
+		sourceMappingURL = resolveSourceMappingUrl(frame.url, comment);
+		console.error(`[解析] sourceMappingURL → ${sourceMappingURL}`);
+		const mapSize = await downloadTo(sourceMappingURL, mapFile, "sourcemap");
+		console.error(`[下载] sourcemap（${(mapSize / 1024).toFixed(0)} KB）`);
+		fs.writeFileSync(metaFile, JSON.stringify({
+			jsUrl: frame.url,
+			sourceMappingUrl: sourceMappingURL,
+			downloadedAt: (/* @__PURE__ */ new Date()).toISOString()
+		}, null, 2));
+	}
+	const located = await locateInMap(mapFile, frame.line, frame.col);
+	const webpack = webpackSourceInfo(located.source);
+	const ctxLines = located.content ? extractContext(located.content, located.line, ctxN) : null;
+	const result = {
+		error: {
+			type: parsed.errorType,
+			message: parsed.errorMessage
+		},
+		mdf: parsed.mdf,
+		frames: parsed.frames,
+		selected: {
+			...frame,
+			index: selIdx + 1,
+			reason: selReason
+		},
+		jsUrl: frame.url,
+		sourceMappingURL,
+		resolved: {
+			source: located.source,
+			webpack,
+			line: located.line,
+			column: located.column,
+			name: located.name
+		},
+		context: ctxN,
+		contextText: ctxLines,
+		cacheDir: cDir,
+		locatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\D/g, "").slice(0, 14);
+	const runDir = path$1.join(cDir, stamp);
+	fs.mkdirSync(runDir, { recursive: true });
+	fs.writeFileSync(path$1.join(runDir, "error.log"), log);
+	fs.writeFileSync(path$1.join(runDir, "result.json"), JSON.stringify(result, null, 2));
+	if (jsonMode) {
+		console.log(JSON.stringify(result, null, 2));
+		return;
+	}
+	printResult(result, ctxLines);
+	console.log(`\n结果已存: ${path$1.join(runDir, "result.json")}`);
+}
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function getVersion() {
 	try {
@@ -9374,6 +9667,9 @@ async function main() {
 		case "ymc":
 			await runYmc(restArgs, globalOpts);
 			break;
+		case "fe-locate":
+			await runFeLocate(restArgs, globalOpts);
+			break;
 		case "auth":
 			if (restArgs[0] === "logout") await runLogout();
 			else if (restArgs[0] === "whoami") await runWhoami(globalOpts);

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "bfi-cli",
-  "version": "0.1.74",
+  "version": "0.1.75",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {
-    "bfi": "./bin/bfi.js",
-    "bfi-db-mcp": "./bin/bfi-db-mcp.js"
+    "bfi": "bin/bfi.js",
+    "bfi-db-mcp": "bin/bfi-db-mcp.js"
   },
   "files": [
     "dist",
@@ -50,6 +50,7 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@vercel/detect-agent": "^1.2.3",
     "mysql2": "^3.14.0",
+    "source-map": "^0.7.4",
     "yaml": "^2.8.3",
     "zod": "^3.25.0"
   }