zero-workspace 0.0.2

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+// src/utils/index.ts
+export * from "./id.js";
+export * from "./time.js";
+export * from "./validation.js";
+export * from "./devLog.js";
+export * from "./git.js";
+export * from "./errorLogger.js";
+export * from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AAErB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,42 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogEntry {
+    ts: string;
+    level: LogLevel;
+    source: string;
+    [key: string]: unknown;
+}
+/**
+ * Logger 类 - 统一日志记录器
+ */
+declare class Logger {
+    /**
+     * 调试日志
+     */
+    debug(source: string, data: object): void;
+    /**
+     * 信息日志
+     */
+    info(source: string, data: object): void;
+    /**
+     * 警告日志
+     */
+    warn(source: string, data: object): void;
+    /**
+     * 错误日志
+     */
+    error(source: string, data: object): void;
+}
+/**
+ * 导出单例实例
+ */
+export declare const logger: Logger;
+/**
+ * 获取系统日志路径（用于调试/测试）
+ */
+export declare function getSystemLogPath(): string;
+/**
+ * 获取日志目录路径（用于调试/测试）
+ */
+export declare function getLogsDir(): string;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAiD3D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA4HD;;GAEG;AACH,cAAM,MAAM;IACV;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxC;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxC;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAK1C;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils/logger.js

@@ -0,0 +1,228 @@
+// src/utils/logger.ts
+// 统一日志记录工具 - JSON Lines 格式，异步写入
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+const IS_DEV = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+const DIR_SUFFIX = IS_DEV ? "-dev" : "";
+const ZERO_HOME = path.join(os.homedir(), `.zero-workspace${DIR_SUFFIX}`);
+const LOGS_DIR = path.join(ZERO_HOME, "logs");
+const SYSTEM_LOG_PATH = path.join(LOGS_DIR, "system.log");
+const CONFIG_PATH = path.join(ZERO_HOME, "config.json");
+// 日志轮转配置
+const MAX_LOG_SIZE = 10 * 1024 * 1024; // 10MB
+const MAX_LOG_FILES = 10; // 最多保留 10 个文件
+// 日志级别优先级映射
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// 默认日志级别
+const DEFAULT_LOG_LEVEL = "info";
+// 配置缓存
+let cachedLogLevel = DEFAULT_LOG_LEVEL;
+let configLoaded = false;
+/**
+ * 异步加载日志级别配置
+ * 在模块加载时调用，配置就绪前使用默认级别
+ */
+async function loadLogLevelConfig() {
+    try {
+        const content = await fs.promises.readFile(CONFIG_PATH, "utf-8");
+        const config = JSON.parse(content);
+        // 验证 logLevel 是否有效
+        if (config.logLevel && LOG_LEVEL_PRIORITY[config.logLevel] !== undefined) {
+            cachedLogLevel = config.logLevel;
+        }
+    }
+    catch {
+        // 配置文件不存在或读取失败，使用默认级别
+        cachedLogLevel = DEFAULT_LOG_LEVEL;
+    }
+    configLoaded = true;
+}
+/**
+ * 检查日志级别是否应该被记录
+ * @param level 当前日志级别
+ * @returns 是否应该记录
+ */
+function shouldLog(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[cachedLogLevel];
+}
+// 模块加载时异步初始化配置（不阻塞）
+loadLogLevelConfig();
+/**
+ * 写入队列，用于处理并发写入
+ */
+let writeQueue = Promise.resolve();
+let dirEnsured = false;
+/**
+ * 确保日志目录存在
+ */
+function ensureLogDir() {
+    if (dirEnsured)
+        return true;
+    try {
+        if (!fs.existsSync(LOGS_DIR)) {
+            fs.mkdirSync(LOGS_DIR, { recursive: true });
+        }
+        dirEnsured = true;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取轮转日志文件路径
+ * @param index 轮转索引，0 表示 system.log，1-9 表示 system.1.log - system.9.log
+ */
+function getRotatedLogPath(index) {
+    if (index === 0) {
+        return SYSTEM_LOG_PATH;
+    }
+    return path.join(LOGS_DIR, `system.${index}.log`);
+}
+/**
+ * 检查是否需要轮转日志文件
+ */
+function shouldRotate() {
+    try {
+        if (!fs.existsSync(SYSTEM_LOG_PATH)) {
+            return false;
+        }
+        const stats = fs.statSync(SYSTEM_LOG_PATH);
+        return stats.size >= MAX_LOG_SIZE;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 执行日志轮转（同步方式）
+ * 轮转流程:
+ * 1. 删除 system.9.log (如果存在)
+ * 2. system.8.log → system.9.log
+ * 3. system.7.log → system.8.log
+ * ...
+ * 4. system.1.log → system.2.log
+ * 5. system.log → system.1.log
+ * 6. 创建新的空 system.log
+ */
+function rotateLogsSync() {
+    try {
+        // 删除最旧的日志文件 (system.9.log)
+        const oldestLogPath = getRotatedLogPath(MAX_LOG_FILES - 1);
+        if (fs.existsSync(oldestLogPath)) {
+            fs.unlinkSync(oldestLogPath);
+        }
+        // 从最旧的开始，依次重命名文件
+        // system.8.log → system.9.log, system.7.log → system.8.log, ...
+        for (let i = MAX_LOG_FILES - 2; i >= 1; i--) {
+            const currentPath = getRotatedLogPath(i);
+            const nextPath = getRotatedLogPath(i + 1);
+            if (fs.existsSync(currentPath)) {
+                fs.renameSync(currentPath, nextPath);
+            }
+        }
+        // system.log → system.1.log
+        if (fs.existsSync(SYSTEM_LOG_PATH)) {
+            fs.renameSync(SYSTEM_LOG_PATH, getRotatedLogPath(1));
+        }
+        // 创建新的空 system.log（不需要显式创建，appendFile 会自动创建）
+    }
+    catch {
+        // 静默处理轮转失败
+    }
+}
+/**
+ * 异步写入日志行（使用队列保证顺序）
+ */
+function writeLogLine(entry) {
+    writeQueue = writeQueue.then(async () => {
+        try {
+            if (!ensureLogDir())
+                return;
+            // 检查是否需要轮转（同步方式，避免并发问题）
+            if (shouldRotate()) {
+                rotateLogsSync();
+            }
+            const line = JSON.stringify(entry) + "\n";
+            await fs.promises.appendFile(SYSTEM_LOG_PATH, line, "utf-8");
+        }
+        catch {
+            // 静默处理写入失败
+        }
+    });
+}
+/**
+ * 创建日志条目
+ */
+function createEntry(level, source, data) {
+    return {
+        ts: new Date().toISOString(),
+        level,
+        source,
+        ...data,
+    };
+}
+/**
+ * Logger 类 - 统一日志记录器
+ */
+class Logger {
+    /**
+     * 调试日志
+     */
+    debug(source, data) {
+        if (!shouldLog("debug"))
+            return;
+        const entry = createEntry("debug", source, data);
+        writeLogLine(entry);
+    }
+    /**
+     * 信息日志
+     */
+    info(source, data) {
+        if (!shouldLog("info"))
+            return;
+        const entry = createEntry("info", source, data);
+        writeLogLine(entry);
+    }
+    /**
+     * 警告日志
+     */
+    warn(source, data) {
+        if (!shouldLog("warn"))
+            return;
+        const entry = createEntry("warn", source, data);
+        writeLogLine(entry);
+    }
+    /**
+     * 错误日志
+     */
+    error(source, data) {
+        if (!shouldLog("error"))
+            return;
+        const entry = createEntry("error", source, data);
+        writeLogLine(entry);
+    }
+}
+/**
+ * 导出单例实例
+ */
+export const logger = new Logger();
+/**
+ * 获取系统日志路径（用于调试/测试）
+ */
+export function getSystemLogPath() {
+    return SYSTEM_LOG_PATH;
+}
+/**
+ * 获取日志目录路径（用于调试/测试）
+ */
+export function getLogsDir() {
+    return LOGS_DIR;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/manualChangeFormatter.d.ts

@@ -0,0 +1,8 @@
+import type { ManualChange } from "../types/workspace.js";
+/**
+ * 格式化手动变更记录为提醒文本
+ * @param changes 变更记录列表
+ * @returns 格式化后的提醒文本
+ */
+export declare function formatManualChangeReminder(changes: ManualChange[]): string;
+//# sourceMappingURL=manualChangeFormatter.d.ts.map

package/dist/utils/manualChangeFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manualChangeFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/manualChangeFormatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAiB1E"}

package/dist/utils/manualChangeFormatter.js

@@ -0,0 +1,21 @@
+// src/utils/manualChangeFormatter.ts
+/**
+ * 格式化手动变更记录为提醒文本
+ * @param changes 变更记录列表
+ * @returns 格式化后的提醒文本
+ */
+export function formatManualChangeReminder(changes) {
+    if (changes.length === 0) {
+        return "";
+    }
+    const lines = [];
+    lines.push("---");
+    lines.push(`⚠️ 用户在 WebUI 进行了 ${changes.length} 次手动操作：`);
+    for (const change of changes) {
+        lines.push(`- ${change.description}`);
+    }
+    lines.push("");
+    lines.push("请调用 context_get 了解详情，并向用户核实意图。");
+    return lines.join("\n");
+}
+//# sourceMappingURL=manualChangeFormatter.js.map

package/dist/utils/manualChangeFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manualChangeFormatter.js","sourceRoot":"","sources":["../../src/utils/manualChangeFormatter.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAIrC;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAuB;IAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;IAExD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAE7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/paramValidator.d.ts

@@ -0,0 +1,35 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * 参数验证结果
+ */
+export interface ParamValidationResult {
+    /** 纠正后的参数（可直接使用） */
+    correctedArgs: Record<string, unknown>;
+    /** 警告信息（自动纠正的参数） */
+    warnings: string[];
+    /** 错误信息（无法纠正的参数） */
+    errors: string[];
+}
+/**
+ * 计算两个字符串的 Levenshtein 编辑距离
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * 计算两个字符串的相似度 (0-1)
+ * 1 表示完全相同，0 表示完全不同
+ */
+export declare function similarity(a: string, b: string): number;
+/**
+ * 从 Tool schema 中提取有效参数名列表
+ */
+export declare function getSchemaProperties(tool: Tool): string[];
+/**
+ * 验证并纠正 MCP 工具参数
+ *
+ * @param toolName 工具名称（用于错误提示）
+ * @param args 用户传入的参数
+ * @param tool 工具定义（包含 inputSchema）
+ * @returns 验证结果，包含纠正后的参数、警告和错误
+ */
+export declare function validateAndCorrectParams(toolName: string, args: Record<string, unknown> | undefined, tool: Tool): ParamValidationResult;
+//# sourceMappingURL=paramValidator.d.ts.map

package/dist/utils/paramValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paramValidator.d.ts","sourceRoot":"","sources":["../../src/utils/paramValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,oBAAoB;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAeD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkChE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAQxD;AAkED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,IAAI,EAAE,IAAI,GACT,qBAAqB,CA+FvB"}

package/dist/utils/paramValidator.js

@@ -0,0 +1,214 @@
+// src/utils/paramValidator.ts
+// MCP 工具参数验证与自动纠错
+/**
+ * 自动纠正的相似度阈值
+ * >= 此值时自动纠正并警告，< 此值时报错
+ */
+const AUTO_CORRECT_THRESHOLD = 0.8;
+/**
+ * 给出建议的最低相似度阈值
+ * >= 此值时在错误信息中给出"是否想使用 xxx？"的建议
+ * < 此值时只列出支持的参数，不给出具体建议
+ */
+const SUGGEST_THRESHOLD = 0.5;
+/**
+ * 计算两个字符串的 Levenshtein 编辑距离
+ */
+export function levenshteinDistance(a, b) {
+    const aLower = a.toLowerCase();
+    const bLower = b.toLowerCase();
+    if (aLower === bLower)
+        return 0;
+    if (aLower.length === 0)
+        return bLower.length;
+    if (bLower.length === 0)
+        return aLower.length;
+    // 创建距离矩阵
+    const matrix = [];
+    // 初始化第一列
+    for (let i = 0; i <= bLower.length; i++) {
+        matrix[i] = [i];
+    }
+    // 初始化第一行
+    for (let j = 0; j <= aLower.length; j++) {
+        matrix[0][j] = j;
+    }
+    // 填充矩阵
+    for (let i = 1; i <= bLower.length; i++) {
+        for (let j = 1; j <= aLower.length; j++) {
+            const cost = bLower[i - 1] === aLower[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // 删除
+            matrix[i][j - 1] + 1, // 插入
+            matrix[i - 1][j - 1] + cost // 替换
+            );
+        }
+    }
+    return matrix[bLower.length][aLower.length];
+}
+/**
+ * 计算两个字符串的相似度 (0-1)
+ * 1 表示完全相同，0 表示完全不同
+ */
+export function similarity(a, b) {
+    if (a === b)
+        return 1;
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1;
+    const distance = levenshteinDistance(a, b);
+    return 1 - distance / maxLen;
+}
+/**
+ * 从 Tool schema 中提取有效参数名列表
+ */
+export function getSchemaProperties(tool) {
+    const schema = tool.inputSchema;
+    if (!schema || typeof schema !== "object")
+        return [];
+    const properties = schema.properties;
+    if (!properties || typeof properties !== "object")
+        return [];
+    return Object.keys(properties);
+}
+/**
+ * 找到最相似的参数名
+ * @returns [最相似的参数名, 相似度] 或 null（如果没有找到）
+ */
+function findMostSimilar(unknownParam, validParams) {
+    if (validParams.length === 0)
+        return null;
+    let bestMatch = null;
+    let bestSimilarity = 0;
+    for (const validParam of validParams) {
+        const sim = similarity(unknownParam, validParam);
+        if (sim > bestSimilarity) {
+            bestSimilarity = sim;
+            bestMatch = validParam;
+        }
+    }
+    return bestMatch ? [bestMatch, bestSimilarity] : null;
+}
+/**
+ * 允许空字符串的字段白名单
+ * 格式：{ toolName: [fieldName, ...] }
+ */
+const ALLOW_EMPTY_STRING = {
+// 暂时没有需要允许空字符串的必填字段
+};
+/**
+ * 允许空数组的字段白名单
+ * 格式：{ toolName: [fieldName, ...] }
+ */
+const ALLOW_EMPTY_ARRAY = {
+// 暂时没有需要允许空数组的必填字段
+};
+/**
+ * 判断字段是否允许空字符串
+ */
+function isEmptyStringAllowed(toolName, field) {
+    return ALLOW_EMPTY_STRING[toolName]?.includes(field) ?? false;
+}
+/**
+ * 判断字段是否允许空数组
+ */
+function isEmptyArrayAllowed(toolName, field) {
+    return ALLOW_EMPTY_ARRAY[toolName]?.includes(field) ?? false;
+}
+/**
+ * 检查值是否为"空"（undefined、null、空字符串、纯空白字符串、空数组）
+ */
+function isEmptyValue(value) {
+    if (value === undefined || value === null)
+        return true;
+    if (typeof value === "string" && value.trim() === "")
+        return true;
+    if (Array.isArray(value) && value.length === 0)
+        return true;
+    return false;
+}
+/**
+ * 验证并纠正 MCP 工具参数
+ *
+ * @param toolName 工具名称（用于错误提示）
+ * @param args 用户传入的参数
+ * @param tool 工具定义（包含 inputSchema）
+ * @returns 验证结果，包含纠正后的参数、警告和错误
+ */
+export function validateAndCorrectParams(toolName, args, tool) {
+    const result = {
+        correctedArgs: { ...(args || {}) },
+        warnings: [],
+        errors: [],
+    };
+    const schema = tool.inputSchema;
+    const validParams = getSchemaProperties(tool);
+    // ========== 必填字段检查 ==========
+    const requiredFields = schema.required || [];
+    for (const field of requiredFields) {
+        const value = result.correctedArgs[field];
+        if (value === undefined || value === null) {
+            // 完全缺失
+            result.errors.push(`缺少必填参数 '${field}'`);
+        }
+        else if (typeof value === "string" && value.trim() === "") {
+            // 空字符串或纯空白
+            if (!isEmptyStringAllowed(toolName, field)) {
+                result.errors.push(`参数 '${field}' 不能为空`);
+            }
+        }
+        else if (Array.isArray(value) && value.length === 0) {
+            // 空数组
+            if (!isEmptyArrayAllowed(toolName, field)) {
+                result.errors.push(`参数 '${field}' 不能为空数组`);
+            }
+        }
+    }
+    // ==================================
+    // 如果没有参数，跳过未知参数检查
+    if (!args || Object.keys(args).length === 0) {
+        return result;
+    }
+    if (validParams.length === 0) {
+        // 没有定义参数的工具，跳过验证
+        return result;
+    }
+    const inputParams = Object.keys(args);
+    for (const inputParam of inputParams) {
+        // 跳过有效参数
+        if (validParams.includes(inputParam)) {
+            continue;
+        }
+        // 检测未知参数
+        const match = findMostSimilar(inputParam, validParams);
+        if (match) {
+            const [suggestedParam, sim] = match;
+            if (sim >= AUTO_CORRECT_THRESHOLD) {
+                // 高相似度：自动纠正 + 警告
+                // 只有当目标参数未被设置时才纠正
+                if (result.correctedArgs[suggestedParam] === undefined) {
+                    result.correctedArgs[suggestedParam] = args[inputParam];
+                    delete result.correctedArgs[inputParam];
+                    result.warnings.push(`参数自动纠正: "${inputParam}" → "${suggestedParam}"`);
+                }
+                else {
+                    // 目标参数已存在，报错
+                    result.errors.push(`未知参数 "${inputParam}"（与已存在的 "${suggestedParam}" 冲突）`);
+                }
+            }
+            else if (sim >= SUGGEST_THRESHOLD) {
+                // 中等相似度：报错 + 建议
+                result.errors.push(`未知参数 "${inputParam}"，是否想使用 "${suggestedParam}"？`);
+            }
+            else {
+                // 低相似度：报错 + 列出支持参数（不给具体建议）
+                result.errors.push(`未知参数 "${inputParam}"。${toolName} 支持的参数: ${validParams.join(", ")}`);
+            }
+        }
+        else {
+            // 没有找到相似参数
+            result.errors.push(`未知参数 "${inputParam}"。${toolName} 支持的参数: ${validParams.join(", ")}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=paramValidator.js.map

package/dist/utils/paramValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paramValidator.js","sourceRoot":"","sources":["../../src/utils/paramValidator.ts"],"names":[],"mappings":"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"}

package/dist/utils/port.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 检测端口是否被占用
+ * @param port 端口号
+ * @param host 主机地址，默认 127.0.0.1
+ */
+export declare function isPortInUse(port: number, host?: string): Promise<boolean>;
+//# sourceMappingURL=port.d.ts.map

package/dist/utils/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/utils/port.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBtF"}

package/dist/utils/port.js

@@ -0,0 +1,28 @@
+// src/utils/port.ts
+// 端口检测工具
+import * as net from "node:net";
+/**
+ * 检测端口是否被占用
+ * @param port 端口号
+ * @param host 主机地址，默认 127.0.0.1
+ */
+export function isPortInUse(port, host = "127.0.0.1") {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+        server.once("listening", () => {
+            server.close();
+            resolve(false);
+        });
+        // 使用指定的 host 检测端口占用
+        server.listen(port, host);
+    });
+}
+//# sourceMappingURL=port.js.map

package/dist/utils/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/utils/port.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,SAAS;AAET,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe,WAAW;IAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAClD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}