bfi-cli 0.1.105 → 0.1.106

package/bin/bfi-pm-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-pm/main.mjs');

package/dist/mcp-pm/main.d.mts

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

package/dist/mcp-pm/main.mjs

@@ -0,0 +1,282 @@
+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 { readFile, realpath, stat } from "node:fs/promises";
+import path from "node:path";
+const PM_ORIGIN = "https://bfi.yyuap.com";
+var PmError = class extends Error {
+	errorKind;
+	constructor(errorKind, message) {
+		super(message);
+		this.errorKind = errorKind;
+	}
+};
+function resolveCredentials() {
+	const ak = (process.env.BFI_PM_AK || "").trim();
+	const sk = (process.env.BFI_PM_SK || "").trim();
+	if (!ak || !sk || ak.includes("${") || sk.includes("${")) return null;
+	return {
+		ak,
+		sk,
+		env: (process.env.BFI_PM_ENV || "prod").trim(),
+		productLine: (process.env.BFI_PM_PRODUCT_LINE || "YonBIP").trim()
+	};
+}
+function credentialHint() {
+	return "未找到 PM 凭证：请在插件配置中填写 PM Access Key / Secret Key（`/plugin configure bfi-perf-stability-kit@bfi-skills`），或设置环境变量 BFI_PM_AK / BFI_PM_SK";
+}
+var PmRemote = class {
+	url;
+	credentials;
+	fetchImpl;
+	client = null;
+	constructor(url = process.env.BFI_PM_URL || "https://bfi.yyuap.com/bfi-api/bficli/api/v1/mcp/mcp", credentials = resolveCredentials(), fetchImpl) {
+		this.url = url;
+		this.credentials = credentials;
+		this.fetchImpl = fetchImpl;
+	}
+	hasCredentials() {
+		return this.credentials !== null;
+	}
+	async listTools() {
+		try {
+			return (await (await this.ensure()).request({ method: "tools/list" }, ListToolsResultSchema)).tools;
+		} catch (e) {
+			console.error(`[bfi-pm-mcp] 远端工具列表获取失败: ${messageOf(e)}`);
+			this.client = null;
+			return [];
+		}
+	}
+	async callTool(name, args) {
+		const client = await this.ensure();
+		try {
+			return await client.request({
+				method: "tools/call",
+				params: {
+					name,
+					arguments: args ?? {}
+				}
+			}, CallToolResultSchema);
+		} catch (e) {
+			return this.handleRemoteFailure(e);
+		}
+	}
+	async ensure() {
+		if (this.client) return this.client;
+		if (!this.credentials) throw new PmError("unauthorized", credentialHint());
+		const client = new Client({
+			name: "bfi-pm-mcp",
+			version: "0.1.0"
+		});
+		const transport = new StreamableHTTPClientTransport(new URL(this.url), {
+			requestInit: { headers: {
+				"X-PM-AK": this.credentials.ak,
+				"X-PM-SK": this.credentials.sk,
+				"X-PM-ENV": this.credentials.env,
+				"X-PM-PRODUCT-LINE": this.credentials.productLine
+			} },
+			...this.fetchImpl ? { fetch: this.fetchImpl } : {}
+		});
+		try {
+			await client.connect(transport);
+		} catch (e) {
+			throw new PmError("pm_unreachable", `bfi-pm 服务不可达（${this.url}）: ${messageOf(e)}。请检查网络或 BFI_PM_URL`);
+		}
+		this.client = client;
+		return client;
+	}
+	handleRemoteFailure(e) {
+		this.client = null;
+		const message = messageOf(e);
+		if (/401|unauthorized|Unauthorized/i.test(message)) throw new PmError("unauthorized", `PM 凭证无效或过期。${credentialHint()}`);
+		throw new PmError("pm_error", `bfi-pm 远端调用失败: ${message}`);
+	}
+};
+function messageOf(e) {
+	return e instanceof Error ? e.message : String(e);
+}
+const DEFAULT_MAX_MB = 100;
+function resolveUploadRoots() {
+	return [...(process.env.BFI_UPLOAD_ROOTS || "").split(path.delimiter).map((s) => s.trim()).filter(Boolean), process.cwd()].map((p) => path.resolve(p));
+}
+function resolveMaxBytes() {
+	const mb = Number(process.env.BFI_UPLOAD_MAX_MB || DEFAULT_MAX_MB);
+	return (Number.isFinite(mb) && mb > 0 ? mb : DEFAULT_MAX_MB) * 1024 * 1024;
+}
+async function resolveLocalFile(filePath, roots = resolveUploadRoots(), maxBytes = resolveMaxBytes()) {
+	if (!filePath || !filePath.trim()) throw new Error("file_path 不能为空");
+	const requested = path.resolve(filePath);
+	let real;
+	try {
+		real = await realpath(requested);
+	} catch {
+		throw new Error(`文件不存在或不可读: ${filePath}`);
+	}
+	if (!roots.some((root) => real === root || real.startsWith(root + path.sep))) throw new Error(`路径不在允许目录内: ${real}（允许：${roots.join(", ")}；可用 BFI_UPLOAD_ROOTS 扩展）`);
+	const info = await stat(real);
+	if (!info.isFile()) throw new Error(`不是普通文件: ${real}`);
+	if (info.size > maxBytes) throw new Error(`文件过大: ${(info.size / 1024 / 1024).toFixed(1)}MB（上限 ${Math.round(maxBytes / 1024 / 1024)}MB）`);
+	return {
+		realPath: real,
+		name: path.basename(real),
+		size: info.size
+	};
+}
+function absoluteUploadUrl(uploadUrl, origin = PM_ORIGIN) {
+	return new URL(uploadUrl, origin).toString();
+}
+async function uploadToTicket(url, file, fetchImpl = fetch) {
+	const data = await readFile(file.realPath);
+	const form = new FormData();
+	form.append("file", new Blob([new Uint8Array(data)]), file.name);
+	const resp = await fetchImpl(url, {
+		method: "POST",
+		body: form
+	});
+	const text = await resp.text();
+	if (!resp.ok) throw new Error(`附件上传失败 HTTP ${resp.status}: ${text.slice(0, 200)}`);
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new Error(`附件上传响应非 JSON: ${text.slice(0, 200)}`);
+	}
+}
+const LOCAL_TOOLS = [{
+	name: "attachment_upload",
+	description: "把本地文件上传到 PM 附件库（零失真：文件内容不经模型）。file_path 为本地路径（须在允许目录内），file_name 可覆盖显示名。返回 {aid, fileName, size}；aid 可直接用于 add_comment 的 attache_ids 或 create_defect 的 attachments。仅上传用户明确指定的文件，禁止自行猜测或遍历路径。",
+	inputSchema: {
+		type: "object",
+		properties: {
+			file_path: {
+				type: "string",
+				description: "本地文件路径（绝对或相对 cwd）"
+			},
+			file_name: {
+				type: "string",
+				description: "上传显示文件名（默认取文件名）"
+			}
+		},
+		required: ["file_path"]
+	}
+}, {
+	name: "add_comment_with_attachment",
+	description: "一次完成“逐个上传本地文件 → 添加评论”：content 为评论正文，file_paths 为本地文件列表。返回远端 add_comment 结果（含 attache_ids）。适合报告/日志等大文件，无需 Bash 与 base64。",
+	inputSchema: {
+		type: "object",
+		properties: {
+			object_id: {
+				type: "string",
+				description: "缺陷编号（如 BIP-BUG-xxx）或 aid"
+			},
+			content: {
+				type: "string",
+				description: "评论正文"
+			},
+			file_paths: {
+				type: "array",
+				items: { type: "string" },
+				description: "本地文件路径列表（按顺序上传）"
+			}
+		},
+		required: ["object_id", "file_paths"]
+	}
+}];
+function textResult(payload, isError = false) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify(payload, null, 2)
+		}],
+		isError
+	};
+}
+function extractJson(result) {
+	if (result.structuredContent && typeof result.structuredContent === "object") return result.structuredContent;
+	const blocks = Array.isArray(result.content) ? result.content : [];
+	for (const block of blocks) if (block && typeof block === "object" && block.type === "text") {
+		const text = String(block.text ?? "");
+		try {
+			return JSON.parse(text);
+		} catch {
+			return { text };
+		}
+	}
+	return {};
+}
+function buildServer(remote, fetchImpl) {
+	const pm = remote ?? new PmRemote();
+	const server = new Server({
+		name: "bfi-pm",
+		version: "0.1.0"
+	}, {
+		capabilities: { tools: {} },
+		instructions: [
+			"BFI 研发管理平台（PM）通道：缺陷/特性/子任务/评论/附件/元数据。",
+			"查询与建单优先用远端工具（search_defects / query_defect / create_defect / add_comment 等）。",
+			"附件上传用本地工具 attachment_upload(file_path)：文件不经模型，支持大文件，无需 Bash。",
+			"需要“上传并评论”一步完成时用 add_comment_with_attachment。",
+			pm.hasCredentials() ? "" : `当前未配置 PM 凭证：${credentialHint()}`
+		].filter(Boolean).join("\n")
+	});
+	server.setRequestHandler(ListToolsRequestSchema, async () => {
+		const remoteTools = await pm.listTools();
+		const localNames = new Set(LOCAL_TOOLS.map((t) => t.name));
+		return { tools: [...LOCAL_TOOLS, ...remoteTools.filter((t) => !localNames.has(t.name))] };
+	});
+	async function uploadOne(filePath, fileName) {
+		if (!pm.hasCredentials()) throw new PmError("unauthorized", credentialHint());
+		const file = await resolveLocalFile(filePath);
+		const ticket = extractJson(await pm.callTool("get_upload_ticket", { file_name: (fileName || file.name).trim() }));
+		const uploadUrl = String(ticket.upload_url || "");
+		if (!uploadUrl) throw new PmError("ticket_failed", `签发 ticket 失败: ${JSON.stringify(ticket).slice(0, 200)}`);
+		const uploaded = await uploadToTicket(absoluteUploadUrl(uploadUrl), file, fetchImpl);
+		if (!uploaded.aid) throw new PmError("upload_failed", `上传响应缺少 aid: ${JSON.stringify(uploaded).slice(0, 200)}`);
+		return {
+			...uploaded,
+			fileName: uploaded.fileName || file.name,
+			size: file.size
+		};
+	}
+	server.setRequestHandler(CallToolRequestSchema, async (request) => {
+		const { name, arguments: args } = request.params;
+		const input = args ?? {};
+		try {
+			if (name === "attachment_upload") return textResult(await uploadOne(String(input.file_path ?? ""), input.file_name ? String(input.file_name) : void 0));
+			if (name === "add_comment_with_attachment") {
+				const paths = Array.isArray(input.file_paths) ? input.file_paths.map(String) : [];
+				if (!input.object_id) throw new PmError("invalid_params", "object_id 不能为空");
+				if (!paths.length) throw new PmError("invalid_params", "file_paths 不能为空");
+				const uploads = [];
+				for (const p of paths) uploads.push(await uploadOne(p));
+				const aids = uploads.map((u) => String(u.aid));
+				return textResult({
+					ok: true,
+					uploads,
+					comment: extractJson(await pm.callTool("add_comment", {
+						object_id: String(input.object_id),
+						content: input.content ? String(input.content) : "",
+						attache_ids: aids
+					}))
+				});
+			}
+			return await pm.callTool(name, input);
+		} catch (e) {
+			return textResult({
+				ok: false,
+				error_kind: e instanceof PmError ? 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-pm-mcp] 启动失败:", e);
+	process.exit(1);
+});
+export {};

package/package.json

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