@pubinfo-pr/devtools 0.171.4 → 0.171.5

package/dist/index.mjs

@@ -3,8 +3,8 @@ import sirv from "sirv";
 import { basename, dirname, extname, join, relative } from "node:path";
 import { pathToFileURL } from "node:url";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { readdir } from "node:fs/promises";
-import { js, ts, tsx } from "@ast-grep/napi";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { Lang, parse } from "@ast-grep/napi";
 
 //#region src/server/controller/api.ts
 const REQUEST_MODULE_EXTENSIONS = [
@@ -1483,8 +1483,27 @@ const components = [...vueComponent, ...pubinfoComponent];
 
 //#endregion
 //#region src/server/utils/ast-analyzer.ts
+/** 跳过的目录 */
+const IGNORED_DIRS = new Set([
+	"node_modules",
+	"dist",
+	"build",
+	".git",
+	"coverage",
+	".pubinfo"
+]);
+/** 默认源码扩展名 */
+const SOURCE_EXTENSIONS$2 = new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".vue"
+]);
+/** 单次并发读取文件数（防止文件描述符爆满） */
+const FILE_READ_CONCURRENCY = 64;
 /**
-* 递归扫描目录获取所有源文件
+* 递归扫描目录获取所有源文件（同步版本，保留给 module-counter 使用）
 */
 function getAllSourceFiles(dir, extensions = [
 	".ts",
@@ -1493,6 +1512,7 @@ function getAllSourceFiles(dir, extensions = [
 	".jsx",
 	".vue"
 ]) {
+	const extSet = new Set(extensions);
 	const files = [];
 	function scan(currentDir) {
 		try {
@@ -1500,128 +1520,214 @@ function getAllSourceFiles(dir, extensions = [
 			for (const entry of entries) {
 				const fullPath = join(currentDir, entry);
 				try {
-					const stat = statSync(fullPath);
-					if (stat.isDirectory()) {
-						if (![
-							"node_modules",
-							"dist",
-							"build",
-							".git",
-							"coverage",
-							".pubinfo"
-						].includes(entry)) scan(fullPath);
-					} else if (stat.isFile()) {
-						const ext = extname(fullPath);
-						if (extensions.includes(ext)) files.push(fullPath);
-					}
-				} catch (error) {
-					console.warn(`无法访问: ${fullPath}`, error);
-				}
+					const s = statSync(fullPath);
+					if (s.isDirectory()) {
+						if (!IGNORED_DIRS.has(entry)) scan(fullPath);
+					} else if (s.isFile() && extSet.has(extname(fullPath))) files.push(fullPath);
+				} catch {}
 			}
-		} catch (error) {
-			console.warn(`无法读取目录: ${currentDir}`, error);
-		}
+		} catch {}
 	}
 	scan(dir);
 	return files;
 }
 /**
-* 根据文件扩展名选择解析器
+* 异步递归扫描目录获取所有源文件
 */
-function getParser(filePath) {
+async function getAllSourceFilesAsync(dir) {
+	const files = [];
+	async function scan(currentDir) {
+		let entries;
+		try {
+			entries = await readdir(currentDir);
+		} catch {
+			return;
+		}
+		const statJobs = entries.map(async (entry) => {
+			const fullPath = join(currentDir, entry);
+			try {
+				const s = await stat(fullPath);
+				if (s.isDirectory()) {
+					if (!IGNORED_DIRS.has(entry)) await scan(fullPath);
+				} else if (s.isFile() && SOURCE_EXTENSIONS$2.has(extname(fullPath))) files.push(fullPath);
+			} catch {}
+		});
+		await Promise.all(statJobs);
+	}
+	await scan(dir);
+	return files;
+}
+/**
+* 根据文件扩展名选择语言类型
+*/
+function getLang(filePath) {
 	switch (extname(filePath)) {
 		case ".tsx":
-		case ".jsx": return tsx;
-		case ".js": return js;
+		case ".jsx": return Lang.Tsx;
+		case ".js": return Lang.JavaScript;
 		case ".ts":
 		case ".vue":
-		default: return ts;
+		default: return Lang.TypeScript;
 	}
 }
 /**
-* 分析 Vue 组件使用情况
+* 在文件内容上做一次快速字符串检查，返回内容中可能出现的追踪项名称集合。
+* 通过这一步可以跳过绝大部分不相关的文件，避免无效 AST 解析。
+*/
+function quickFilterNames(content, names) {
+	const hits = /* @__PURE__ */ new Set();
+	for (const name of names) if (content.includes(name)) hits.add(name);
+	return hits;
+}
+/**
+* 对单个文件做一次性全量分析，返回该文件中出现的所有追踪名的使用位置。
+*
+* 优化点：
+* 1. 先用字符串 includes 快速预过滤，跳过不相关名称。
+* 2. AST 只解析一次，遍历一次 rootNode，收集所有 call_expression / import_specifier / jsx。
+* 3. Vue template 部分改为一次性合并正则匹配（而非 N 次独立正则）。
 */
-function analyzeComponentUsage(content, componentName, filePath) {
-	const locations = [];
+function analyzeFile(content, filePath, functionNames, componentNames) {
+	const result = {
+		functions: /* @__PURE__ */ new Map(),
+		components: /* @__PURE__ */ new Map()
+	};
+	const hitFunctions = quickFilterNames(content, functionNames);
+	const hitComponents = quickFilterNames(content, componentNames);
+	if (hitFunctions.size === 0 && hitComponents.size === 0) return result;
 	try {
-		const matches = getParser(filePath).parse(content).root().findAll({ rule: {
-			kind: "jsx_opening_element",
-			pattern: `<${componentName}`
-		} });
-		for (const match of matches) {
-			const range = match.range();
-			locations.push({
-				file: filePath,
-				line: range.start.line + 1,
-				column: range.start.column + 1,
-				code: match.text().slice(0, 100)
-			});
+		const rootNode = parse(getLang(filePath), content).root();
+		if (hitFunctions.size > 0) {
+			const callMatches = rootNode.findAll({ rule: { kind: "call_expression" } });
+			for (const match of callMatches) {
+				const calleeName = match.field("function")?.text();
+				if (calleeName && hitFunctions.has(calleeName)) {
+					const range = match.range();
+					const loc = {
+						file: filePath,
+						line: range.start.line + 1,
+						column: range.start.column + 1,
+						code: match.text().slice(0, 100)
+					};
+					if (!result.functions.has(calleeName)) result.functions.set(calleeName, []);
+					result.functions.get(calleeName).push(loc);
+				}
+			}
+			const importMatches = rootNode.findAll({ rule: { kind: "import_specifier" } });
+			for (const match of importMatches) {
+				const text = match.text();
+				const specName = text.split(/\s/)[0];
+				if (specName && hitFunctions.has(specName)) {
+					const range = match.range();
+					const loc = {
+						file: filePath,
+						line: range.start.line + 1,
+						column: range.start.column + 1,
+						code: text
+					};
+					if (!result.functions.has(specName)) result.functions.set(specName, []);
+					result.functions.get(specName).push(loc);
+				}
+			}
 		}
-	} catch (error) {}
-	if (filePath.endsWith(".vue")) {
-		const templateRegex = new RegExp(`<${componentName}[\\s>]`, "g");
+		if (hitComponents.size > 0) {
+			const jsxMatches = rootNode.findAll({ rule: { kind: "jsx_opening_element" } });
+			for (const match of jsxMatches) {
+				const text = match.text();
+				const nameMatch = text.match(/^<(\w+)/);
+				if (nameMatch && hitComponents.has(nameMatch[1])) {
+					const compName = nameMatch[1];
+					const range = match.range();
+					const loc = {
+						file: filePath,
+						line: range.start.line + 1,
+						column: range.start.column + 1,
+						code: text.slice(0, 100)
+					};
+					if (!result.components.has(compName)) result.components.set(compName, []);
+					result.components.get(compName).push(loc);
+				}
+			}
+		}
+	} catch {}
+	if (filePath.endsWith(".vue") && hitComponents.size > 0) {
+		const names = Array.from(hitComponents);
+		const unionRegex = new RegExp(`<(${names.map(escapeRegex).join("|")})[\\s>/]`, "g");
 		const lines = content.split("\n");
-		let match = templateRegex.exec(content);
+		const lineOffsets = buildLineOffsets(lines);
+		let match = unionRegex.exec(content);
 		while (match !== null) {
+			const compName = match[1];
 			const pos = match.index;
-			let lineNum = 0;
-			let charCount = 0;
-			for (let i = 0; i < lines.length; i++) {
-				charCount += lines[i].length + 1;
-				if (charCount > pos) {
-					lineNum = i + 1;
-					break;
-				}
-			}
-			locations.push({
+			const lineNum = findLineNumber(lineOffsets, pos);
+			const loc = {
 				file: filePath,
 				line: lineNum,
-				column: pos - (charCount - lines[lineNum - 1].length - 1) + 1,
+				column: pos - lineOffsets[lineNum - 1] + 1,
 				code: lines[lineNum - 1].trim().slice(0, 100)
-			});
-			match = templateRegex.exec(content);
+			};
+			if (!result.components.has(compName)) result.components.set(compName, []);
+			result.components.get(compName).push(loc);
+			match = unionRegex.exec(content);
 		}
 	}
-	return locations;
+	return result;
+}
+/** 转义正则特殊字符 */
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** 构建每行起始偏移量数组，索引 0 = 第 1 行起始偏移 */
+function buildLineOffsets(lines) {
+	const offsets = Array.from({ length: lines.length });
+	offsets[0] = 0;
+	for (let i = 1; i < lines.length; i++) offsets[i] = offsets[i - 1] + lines[i - 1].length + 1;
+	return offsets;
+}
+/** 通过二分查找快速定位字符偏移所在的行号（1-based） */
+function findLineNumber(lineOffsets, pos) {
+	let lo = 0;
+	let hi = lineOffsets.length - 1;
+	while (lo < hi) {
+		const mid = lo + hi + 1 >> 1;
+		if (lineOffsets[mid] <= pos) lo = mid;
+		else hi = mid - 1;
+	}
+	return lo + 1;
+}
+/**
+* 以指定并发度分批执行异步任务
+*/
+async function processBatched(items, concurrency, fn) {
+	const results = [];
+	for (let i = 0; i < items.length; i += concurrency) {
+		const batch = items.slice(i, i + concurrency);
+		const batchResults = await Promise.all(batch.map(fn));
+		results.push(...batchResults);
+	}
+	return results;
 }
 /**
-* 分析函数/方法使用情况
+* 扫描单个文件的使用情况。用于增量更新场景。
 */
-function analyzeFunctionUsage(content, functionName, filePath) {
-	const locations = [];
+async function scanSingleFile(filePath, functionsToTrack, componentsToTrack) {
+	const ext = extname(filePath);
+	if (!SOURCE_EXTENSIONS$2.has(ext)) return null;
 	try {
-		const root = getParser(filePath).parse(content);
-		const callMatches = root.root().findAll({ rule: {
-			kind: "call_expression",
-			pattern: `${functionName}($$$)`
-		} });
-		for (const match of callMatches) {
-			const range = match.range();
-			locations.push({
-				file: filePath,
-				line: range.start.line + 1,
-				column: range.start.column + 1,
-				code: match.text().slice(0, 100)
-			});
-		}
-		const importMatches = root.root().findAll({ rule: {
-			kind: "import_specifier",
-			pattern: functionName
-		} });
-		for (const match of importMatches) {
-			const range = match.range();
-			locations.push({
-				file: filePath,
-				line: range.start.line + 1,
-				column: range.start.column + 1,
-				code: match.text()
-			});
-		}
-	} catch (error) {}
-	return locations;
+		return analyzeFile(await readFile(filePath, "utf-8"), filePath, new Set(functionsToTrack.map((f) => f.name)), new Set(componentsToTrack.map((c) => c.name)));
+	} catch {
+		return null;
+	}
 }
 /**
-* 扫描项目中的使用情况
+* 扫描项目中的使用情况（优化版）
+*
+* 相比旧版的优化：
+* 1. 异步 I/O + 并发读取文件，不阻塞 Vite dev server。
+* 2. 每文件只做一次 AST 解析，遍历一次收集所有命中。
+* 3. 快速预过滤（string.includes）跳过不相关文件。
+* 4. Vue template 使用联合正则一次匹配，二分法定位行号。
+*
 * @param projectRoot 项目根目录
 * @param functionsToTrack 要追踪的函数列表
 * @param componentsToTrack 要追踪的组件列表
@@ -1633,8 +1739,10 @@ async function scanUsageStats(projectRoot, functionsToTrack, componentsToTrack)
 		totalFiles: 0,
 		scannedFiles: 0
 	};
-	const files = getAllSourceFiles(projectRoot);
+	const files = await getAllSourceFilesAsync(projectRoot);
 	result.totalFiles = files.length;
+	const functionNames = new Set(functionsToTrack.map((f) => f.name));
+	const componentNames = new Set(componentsToTrack.map((c) => c.name));
 	const functionStatsMap = /* @__PURE__ */ new Map();
 	const componentStatsMap = /* @__PURE__ */ new Map();
 	for (const func of functionsToTrack) functionStatsMap.set(func.name, {
@@ -1653,28 +1761,27 @@ async function scanUsageStats(projectRoot, functionsToTrack, componentsToTrack)
 		locations: [],
 		meta: comp.meta
 	});
-	for (const file of files) try {
-		const content = readFileSync(file, "utf-8");
-		result.scannedFiles++;
-		for (const func of functionsToTrack) {
-			const locations = analyzeFunctionUsage(content, func.name, file);
-			if (locations.length > 0) {
-				const stats = functionStatsMap.get(func.name);
-				stats.locations.push(...locations);
-				stats.count += locations.length;
+	await processBatched(files, FILE_READ_CONCURRENCY, async (file) => {
+		try {
+			const content = await readFile(file, "utf-8");
+			result.scannedFiles++;
+			const analysis = analyzeFile(content, file, functionNames, componentNames);
+			for (const [name, locations] of analysis.functions) {
+				const stats = functionStatsMap.get(name);
+				if (stats) {
+					stats.locations.push(...locations);
+					stats.count += locations.length;
+				}
 			}
-		}
-		for (const comp of componentsToTrack) {
-			const locations = analyzeComponentUsage(content, comp.name, file);
-			if (locations.length > 0) {
-				const stats = componentStatsMap.get(comp.name);
-				stats.locations.push(...locations);
-				stats.count += locations.length;
+			for (const [name, locations] of analysis.components) {
+				const stats = componentStatsMap.get(name);
+				if (stats) {
+					stats.locations.push(...locations);
+					stats.count += locations.length;
+				}
 			}
-		}
-	} catch (error) {
-		console.warn(`无法读取文件: ${file}`, error);
-	}
+		} catch {}
+	});
 	result.functions = Array.from(functionStatsMap.values());
 	result.components = Array.from(componentStatsMap.values());
 	return result;
@@ -1700,7 +1807,7 @@ function countRegisteredModules(projectRoot) {
 		}
 		if (!content.includes("createPubinfo")) continue;
 		try {
-			const rootNode = getParser(filePath).parse(content).root();
+			const rootNode = parse(getLang(filePath), content).root();
 			const context = {
 				rootNode,
 				initializerCache: /* @__PURE__ */ new Map()
@@ -1816,6 +1923,139 @@ function getFirstNamedChild(node) {
 
 //#endregion
 //#region src/server/controller/usage.ts
+/** 源码扩展名集合，用于判断文件变更是否需要触发增量更新 */
+const SOURCE_EXTENSIONS$1 = new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".vue"
+]);
+let _cache = null;
+let _scanPromise = null;
+/**
+* 获取或初始化缓存。
+* 多个并发请求只会触发一次扫描（Promise 去重）。
+*/
+async function getOrCreateCache(projectRoot) {
+	if (_cache) return _cache;
+	if (_scanPromise) return _scanPromise;
+	_scanPromise = (async () => {
+		const stats = await scanUsageStats(projectRoot, functions, components);
+		_cache = {
+			stats,
+			fileHits: buildFileHitsIndex(stats),
+			timestamp: Date.now()
+		};
+		_scanPromise = null;
+		return _cache;
+	})();
+	return _scanPromise;
+}
+/**
+* 从扫描结果构建 "文件 → 命中" 索引，用于增量更新时快速清除旧数据。
+*/
+function buildFileHitsIndex(stats) {
+	const map = /* @__PURE__ */ new Map();
+	for (const item of stats.functions) for (const loc of item.locations) {
+		if (!map.has(loc.file)) map.set(loc.file, {
+			functions: /* @__PURE__ */ new Map(),
+			components: /* @__PURE__ */ new Map()
+		});
+		const entry = map.get(loc.file);
+		entry.functions.set(item.name, (entry.functions.get(item.name) ?? 0) + 1);
+	}
+	for (const item of stats.components) for (const loc of item.locations) {
+		if (!map.has(loc.file)) map.set(loc.file, {
+			functions: /* @__PURE__ */ new Map(),
+			components: /* @__PURE__ */ new Map()
+		});
+		const entry = map.get(loc.file);
+		entry.components.set(item.name, (entry.components.get(item.name) ?? 0) + 1);
+	}
+	return map;
+}
+/**
+* 增量更新：当单个文件发生变更时，只重新扫描该文件。
+*
+* 流程：
+* 1. 从缓存中清除该文件的旧贡献值。
+* 2. 重新扫描该文件。
+* 3. 把新结果合并回缓存。
+*/
+async function incrementalUpdate(filePath) {
+	if (!_cache) return;
+	const ext = extname(filePath);
+	if (!SOURCE_EXTENSIONS$1.has(ext)) return;
+	const { stats, fileHits } = _cache;
+	const oldEntry = fileHits.get(filePath);
+	if (oldEntry) {
+		for (const [name, count] of oldEntry.functions) {
+			const item = stats.functions.find((f) => f.name === name);
+			if (item) {
+				item.count -= count;
+				item.locations = item.locations.filter((loc) => loc.file !== filePath);
+			}
+		}
+		for (const [name, count] of oldEntry.components) {
+			const item = stats.components.find((c) => c.name === name);
+			if (item) {
+				item.count -= count;
+				item.locations = item.locations.filter((loc) => loc.file !== filePath);
+			}
+		}
+		fileHits.delete(filePath);
+	}
+	const result = await scanSingleFile(filePath, functions, components);
+	if (!result) return;
+	const newEntry = {
+		functions: /* @__PURE__ */ new Map(),
+		components: /* @__PURE__ */ new Map()
+	};
+	for (const [name, locations] of result.functions) {
+		const item = stats.functions.find((f) => f.name === name);
+		if (item) {
+			item.locations.push(...locations);
+			item.count += locations.length;
+		}
+		newEntry.functions.set(name, locations.length);
+	}
+	for (const [name, locations] of result.components) {
+		const item = stats.components.find((c) => c.name === name);
+		if (item) {
+			item.locations.push(...locations);
+			item.count += locations.length;
+		}
+		newEntry.components.set(name, locations.length);
+	}
+	if (newEntry.functions.size > 0 || newEntry.components.size > 0) fileHits.set(filePath, newEntry);
+	_cache.timestamp = Date.now();
+}
+/**
+* 增量删除：当文件被删除时，清除其贡献。
+*/
+async function incrementalRemove(filePath) {
+	if (!_cache) return;
+	const { stats, fileHits } = _cache;
+	const oldEntry = fileHits.get(filePath);
+	if (!oldEntry) return;
+	for (const [name, count] of oldEntry.functions) {
+		const item = stats.functions.find((f) => f.name === name);
+		if (item) {
+			item.count -= count;
+			item.locations = item.locations.filter((loc) => loc.file !== filePath);
+		}
+	}
+	for (const [name, count] of oldEntry.components) {
+		const item = stats.components.find((c) => c.name === name);
+		if (item) {
+			item.count -= count;
+			item.locations = item.locations.filter((loc) => loc.file !== filePath);
+		}
+	}
+	fileHits.delete(filePath);
+	_cache.timestamp = Date.now();
+}
 /**
 * 将 PascalCase/CamelCase 名称转换为 kebab-case（用于搜索匹配）
 */
@@ -1827,10 +2067,8 @@ function toKebabCase(name) {
 * 返回项目中实际使用的 functions 和 components（仅 count > 0）
 */
 async function getOverview(projectRoot) {
-	const statsPromise = scanUsageStats(projectRoot, functions, components);
-	const apiListPromise = getRequestList(projectRoot);
-	const [stats, apiList] = await Promise.all([statsPromise, apiListPromise]);
-	const apiMethodCount = apiList.modules.reduce((total, module) => {
+	const stats = (await getOrCreateCache(projectRoot)).stats;
+	const apiMethodCount = (await getRequestList(projectRoot)).modules.reduce((total, module) => {
 		return total + module.functions.length;
 	}, 0);
 	const moduleCount = countRegisteredModules(projectRoot);
@@ -1848,13 +2086,13 @@ async function getOverview(projectRoot) {
 * 返回所有追踪项的使用情况（包括未使用的 count = 0）
 */
 async function getUsageStats(projectRoot) {
-	return await scanUsageStats(projectRoot, functions, components);
+	return (await getOrCreateCache(projectRoot)).stats;
 }
 /**
 * 获取组件使用详情，附带统计摘要
 */
 async function getComponentUsage(projectRoot) {
-	const componentsWithMeta = (await getUsageStats(projectRoot)).components.map((component) => {
+	const componentsWithMeta = (await getOrCreateCache(projectRoot)).stats.components.map((component) => {
 		const dependents = Array.from(new Set(component.locations.map((location) => location.file))).sort();
 		const componentFilePath = component.locations[0]?.file;
 		return {
@@ -1880,7 +2118,7 @@ async function getComponentUsage(projectRoot) {
 * 获取 Import/Hook 使用详情，附带统计摘要
 */
 async function getImportUsage(projectRoot) {
-	const importsWithMeta = (await getUsageStats(projectRoot)).functions.map((importItem) => {
+	const importsWithMeta = (await getOrCreateCache(projectRoot)).stats.functions.map((importItem) => {
 		const dependents = Array.from(new Set(importItem.locations.map((location) => location.file))).sort();
 		const importFilePath = importItem.locations[0]?.file;
 		return {
@@ -1997,20 +2235,51 @@ async function getPackageVersion(root, packageName) {
 * 能力概览：
 * - 提供一个轻量 UI（iframe）静态资源服务：`/__pubinfo_devtools`。
 * - 提供 devtools 专用的 API：`/__pubinfo_devtools_api`。
-*   - `/` → 返回项目文件数量（用于示例与健康检查）。
+*   - `/overview` → 返回项目中实际使用的方法和组件。
+*   - `/usage-stats` → 返回完整使用统计。
+*   - `/component-usage` → 返回组件使用详情。
+*   - `/import-usage` → 返回 Import/Hook 使用详情。
 *   - `/api-list` → 返回解析的 OpenAPI 配置与扫描到的 API 函数/类型清单。
+*   - `/package-version` → 返回包版本信息。
+*
+* 性能优化：
+* - 首次请求时执行全量扫描并缓存结果。
+* - 借助 Vite watcher 监听文件变化，仅对变更文件做增量更新。
+* - 所有 API 共享同一份缓存，避免重复扫描。
+* - JSON 响应不做美化格式化（减少 ~30% 体积）。
 *
 * 注意：本插件默认以 `enforce: 'pre'` 注入，避免被其他中间件拦截。
 * 路由均在开发服务器中间件阶段生效，不影响生产构建输出。
 *
 * 安全说明：这些接口仅用于本地开发环境调试，不应暴露到公网。
 */
+/** 源码文件扩展名，与 ast-analyzer 保持一致 */
+const SOURCE_EXTENSIONS = new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".vue"
+]);
+function isSourceFile(path) {
+	const dot = path.lastIndexOf(".");
+	return dot !== -1 && SOURCE_EXTENSIONS.has(path.slice(dot));
+}
 function pubinfoDevtools() {
 	return {
 		name: "vite-plugin-pubinfo-devtools",
 		enforce: "pre",
 		configureServer(server) {
 			const baseURL = "__pubinfo_devtools";
+			server.watcher.on("change", (filePath) => {
+				if (isSourceFile(filePath)) incrementalUpdate(filePath).catch(() => {});
+			});
+			server.watcher.on("add", (filePath) => {
+				if (isSourceFile(filePath)) incrementalUpdate(filePath).catch(() => {});
+			});
+			server.watcher.on("unlink", (filePath) => {
+				if (isSourceFile(filePath)) incrementalRemove(filePath).catch(() => {});
+			});
 			server.middlewares.use(`/${baseURL}`, sirv(DIR_CLIENT, {
 				single: true,
 				dev: true
@@ -2019,82 +2288,42 @@ function pubinfoDevtools() {
 				if (!req.url) return next();
 				if (req.url === "/overview") {
 					try {
-						const overview = await getOverview(server.config.root);
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify(overview, null, 2));
+						sendJSON(res, await getOverview(server.config.root));
 					} catch (error) {
-						res.statusCode = 500;
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify({
-							error: "Failed to get overview data",
-							message: error instanceof Error ? error.message : String(error)
-						}));
+						sendError(res, "Failed to get overview data", error);
 					}
-					res.end();
 					return;
 				}
 				if (req.url === "/usage-stats") {
 					try {
-						const usageStats = await getUsageStats(server.config.root);
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify(usageStats, null, 2));
+						sendJSON(res, await getUsageStats(server.config.root));
 					} catch (error) {
-						res.statusCode = 500;
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify({
-							error: "Failed to get usage statistics",
-							message: error instanceof Error ? error.message : String(error)
-						}));
+						sendError(res, "Failed to get usage statistics", error);
 					}
-					res.end();
 					return;
 				}
 				if (req.url === "/component-usage") {
 					try {
-						const componentUsage = await getComponentUsage(server.config.root);
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify(componentUsage, null, 2));
+						sendJSON(res, await getComponentUsage(server.config.root));
 					} catch (error) {
-						res.statusCode = 500;
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify({
-							error: "Failed to get component usage",
-							message: error instanceof Error ? error.message : String(error)
-						}));
+						sendError(res, "Failed to get component usage", error);
 					}
-					res.end();
 					return;
 				}
 				if (req.url === "/import-usage") {
 					try {
-						const importUsage = await getImportUsage(server.config.root);
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify(importUsage, null, 2));
+						sendJSON(res, await getImportUsage(server.config.root));
 					} catch (error) {
-						res.statusCode = 500;
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify({
-							error: "Failed to get import usage",
-							message: error instanceof Error ? error.message : String(error)
-						}));
+						sendError(res, "Failed to get import usage", error);
 					}
-					res.end();
 					return;
 				}
 				if (req.url.startsWith("/api-list")) {
 					try {
-						const apiList = await getRequestList(server.config.root);
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify(apiList, null, 2));
+						sendJSON(res, await getRequestList(server.config.root));
 					} catch (error) {
-						res.statusCode = 500;
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify({
-							error: "Failed to get API list",
-							message: error instanceof Error ? error.message : String(error)
-						}));
+						sendError(res, "Failed to get API list", error);
 					}
-					res.end();
 					return;
 				}
 				if (req.url.startsWith("/package-version")) {
@@ -2102,26 +2331,16 @@ function pubinfoDevtools() {
 						const packageName = new URLSearchParams(req.url.slice(16)).get("package") || "";
 						if (!packageName) {
 							res.statusCode = 400;
-							res.setHeader("Content-Type", "application/json");
-							res.write(JSON.stringify({
+							sendJSON(res, {
 								error: "Missing package parameter",
 								message: "Please provide a package name using ?package=<package-name>"
-							}));
-							res.end();
+							});
 							return;
 						}
-						const versionInfo = await getPackageVersion(server.config.root, packageName);
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify(versionInfo, null, 2));
+						sendJSON(res, await getPackageVersion(server.config.root, packageName));
 					} catch (error) {
-						res.statusCode = 500;
-						res.setHeader("Content-Type", "application/json");
-						res.write(JSON.stringify({
-							error: "Failed to get package version",
-							message: error instanceof Error ? error.message : String(error)
-						}));
+						sendError(res, "Failed to get package version", error);
 					}
-					res.end();
 					return;
 				}
 				next();
@@ -2129,6 +2348,24 @@ function pubinfoDevtools() {
 		}
 	};
 }
+/**
+* 发送 JSON 响应（不做美化，减小体积）
+*/
+function sendJSON(res, data) {
+	res.setHeader("Content-Type", "application/json");
+	res.end(JSON.stringify(data));
+}
+/**
+* 发送 500 错误响应
+*/
+function sendError(res, defaultMessage, error) {
+	res.statusCode = 500;
+	res.setHeader("Content-Type", "application/json");
+	res.end(JSON.stringify({
+		error: defaultMessage,
+		message: error instanceof Error ? error.message : String(error)
+	}));
+}
 
 //#endregion
 export { pubinfoDevtools };