mcp-probe-kit 1.8.1 → 1.9.0

package/build/tools/add_feature.d.ts

@@ -1,14 +1,3 @@
-/**
- * add_feature 工具
- *
- * 功能：为已有项目添加新功能的规格文档
- * 模式：指令生成器模式 - 返回详细的生成指南，由 AI 执行实际操作
- *
- * 输出文件：
- * - docs/specs/{feature_name}/requirements.md - 需求文档
- * - docs/specs/{feature_name}/design.md - 设计文档
- * - docs/specs/{feature_name}/tasks.md - 任务清单
- */
 /**
  * add_feature 工具实现
  *

package/build/tools/add_feature.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString, validateRequired } from "../utils/parseArgs.js";
 /**
  * add_feature 工具
  *
@@ -423,17 +424,25 @@ interface [ModelName] {
  */
 export async function addFeature(args) {
     try {
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                feature_name: "",
+                description: "",
+                docs_dir: DEFAULT_DOCS_DIR,
+            },
+            primaryField: "description", // 纯文本输入默认映射到 description 字段
+            fieldAliases: {
+                feature_name: ["name", "feature", "功能名", "功能名称"],
+                description: ["desc", "requirement", "描述", "需求"],
+                docs_dir: ["dir", "output", "目录", "文档目录"],
+            },
+        });
+        const featureName = getString(parsedArgs.feature_name);
+        const description = getString(parsedArgs.description);
+        const docsDir = getString(parsedArgs.docs_dir) || DEFAULT_DOCS_DIR;
         // 验证必填参数
-        const featureName = args?.feature_name;
-        const description = args?.description;
-        if (!featureName) {
-            throw new Error("缺少必填参数: feature_name（功能名称）");
-        }
-        if (!description) {
-            throw new Error("缺少必填参数: description（功能描述）");
-        }
-        // 解析可选参数
-        const docsDir = args?.docs_dir || DEFAULT_DOCS_DIR;
+        validateRequired(parsedArgs, ["feature_name", "description"]);
         // 构建指南文本（替换占位符）
         const guide = PROMPT_TEMPLATE
             .replace(/{feature_name}/g, featureName)

package/build/tools/analyze_project.js

@@ -1,10 +1,25 @@
+import { parseArgs, getString, getNumber, getBoolean } from "../utils/parseArgs.js";
 import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, extname } from 'path';
 import { VERSION } from '../version.js';
 export async function analyzeProject(args) {
-    const projectPath = args.project_path || process.cwd();
-    const maxDepth = args.max_depth || 5;
-    const includeContent = args.include_content !== false;
+    // 智能参数解析，支持自然语言输入
+    const parsedArgs = parseArgs(args, {
+        defaultValues: {
+            project_path: process.cwd(),
+            max_depth: 5,
+            include_content: true,
+        },
+        primaryField: "project_path", // 纯文本输入默认映射到 project_path 字段
+        fieldAliases: {
+            project_path: ["path", "dir", "directory", "路径", "项目路径"],
+            max_depth: ["depth", "level", "深度", "层级"],
+            include_content: ["content", "with_content", "包含内容"],
+        },
+    });
+    const projectPath = getString(parsedArgs.project_path) || process.cwd();
+    const maxDepth = getNumber(parsedArgs.max_depth, 5);
+    const includeContent = getBoolean(parsedArgs.include_content, true);
     try {
         console.error(`开始分析项目: ${projectPath}`);
         const analysis = await performProjectAnalysis(projectPath, maxDepth, includeContent);
@@ -12,68 +27,68 @@ export async function analyzeProject(args) {
             content: [
                 {
                     type: "text",
-                    text: `# 📊 项目分析报告
-
-## 🏗️ 项目概览
-- **项目名称**: ${analysis.projectStructure.name}
-- **项目类型**: ${analysis.projectStructure.type}
-- **技术栈**: ${analysis.projectStructure.framework}
-- **主要语言**: ${analysis.projectStructure.language}
-- **包管理器**: ${analysis.projectStructure.packageManager}
-
-## 📁 目录结构
-\`\`\`
-${analysis.directoryTree}
-\`\`\`
-
-## 🔑 关键文件
-${analysis.keyFiles.map(file => `### ${file.path}
-**用途**: ${file.purpose}
-${includeContent ? `\`\`\`${getFileExtension(file.path)}
-${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
-\`\`\`` : ''}`).join('\n\n')}
-
-## 📦 依赖分析
-- **生产依赖**: ${analysis.dependencies.production.length} 个
-- **开发依赖**: ${analysis.dependencies.development.length} 个
-- **总依赖数**: ${analysis.dependencies.total} 个
-
-### 主要依赖
-${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
-
-## 📈 代码指标
-- **总文件数**: ${analysis.codeMetrics.totalFiles}
-- **总行数**: ${analysis.codeMetrics.totalLines}
-${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
-- **文件类型分布**:
+                    text: `# 📊 项目分析报告
+
+## 🏗️ 项目概览
+- **项目名称**: ${analysis.projectStructure.name}
+- **项目类型**: ${analysis.projectStructure.type}
+- **技术栈**: ${analysis.projectStructure.framework}
+- **主要语言**: ${analysis.projectStructure.language}
+- **包管理器**: ${analysis.projectStructure.packageManager}
+
+## 📁 目录结构
+\`\`\`
+${analysis.directoryTree}
+\`\`\`
+
+## 🔑 关键文件
+${analysis.keyFiles.map(file => `### ${file.path}
+**用途**: ${file.purpose}
+${includeContent ? `\`\`\`${getFileExtension(file.path)}
+${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
+\`\`\`` : ''}`).join('\n\n')}
+
+## 📦 依赖分析
+- **生产依赖**: ${analysis.dependencies.production.length} 个
+- **开发依赖**: ${analysis.dependencies.development.length} 个
+- **总依赖数**: ${analysis.dependencies.total} 个
+
+### 主要依赖
+${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
+
+## 📈 代码指标
+- **总文件数**: ${analysis.codeMetrics.totalFiles}
+- **总行数**: ${analysis.codeMetrics.totalLines}
+${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
+- **文件类型分布**:
 ${Object.entries(analysis.codeMetrics.fileTypes)
                         .sort(([, a], [, b]) => b - a)
                         .slice(0, 10)
                         .map(([type, count]) => `  - ${type}: ${count} 个文件`)
-                        .join('\n')}
-${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
-
-### 最大文件
-${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => `- ${file.path} (${file.lines} 行)`).join('\n')}
-
-## 🏛️ 架构分析
-- **设计模式**: ${analysis.architecture.patterns.join(', ')}
-- **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
-- **核心模块**: ${analysis.architecture.mainModules.join(', ')}
-
-## 📋 项目总结
-**项目目的**: ${analysis.summary.purpose}
-**复杂度**: ${analysis.summary.complexity}
-**建议**: 
-${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
-
----
-*分析完成时间: ${new Date().toLocaleString('zh-CN')}*
-*分析工具: MCP Probe Kit v${VERSION}*
-
-**分析说明**:
-- 大型项目会自动采样分析，限制最多扫描 5000 个文件
-- 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
+                        .join('\n')}
+${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
+
+### 最大文件
+${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => `- ${file.path} (${file.lines} 行)`).join('\n')}
+
+## 🏛️ 架构分析
+- **设计模式**: ${analysis.architecture.patterns.join(', ')}
+- **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
+- **核心模块**: ${analysis.architecture.mainModules.join(', ')}
+
+## 📋 项目总结
+**项目目的**: ${analysis.summary.purpose}
+**复杂度**: ${analysis.summary.complexity}
+**建议**: 
+${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
+
+---
+*分析完成时间: ${new Date().toLocaleString('zh-CN')}*
+*分析工具: MCP Probe Kit v${VERSION}*
+
+**分析说明**:
+- 大型项目会自动采样分析，限制最多扫描 5000 个文件
+- 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
 - 单个文件大小限制: 1MB，超过则跳过`,
                 },
             ],

package/build/tools/check_deps.d.ts

@@ -1,4 +1,4 @@
-export declare function checkDeps(args: any): Promise<{
+export declare function checkDeps(_args: any): Promise<{
     content: {
         type: string;
         text: string;

package/build/tools/check_deps.js

@@ -1,5 +1,5 @@
-// check_deps 工具实现
-export async function checkDeps(args) {
+// check_deps 工具实现（无参数）
+export async function checkDeps(_args) {
     try {
         const message = `请分析项目依赖的健康状况：
 

package/build/tools/code_review.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // code_review 工具实现
 export async function codeReview(args) {
     try {
-        const code = args?.code || "";
-        const focus = args?.focus || "all"; // quality, security, performance, all
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                focus: "all",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "content"],
+                focus: ["type", "category", "类型", "重点"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const focus = getString(parsedArgs.focus) || "all"; // quality, security, performance, all
         const message = `请对以下代码进行全面审查：
 
 📝 **代码内容**：

package/build/tools/convert.js

@@ -1,9 +1,24 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // convert 工具实现
 export async function convert(args) {
     try {
-        const code = args?.code || "";
-        const from = args?.from || "";
-        const to = args?.to || "";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                from: "",
+                to: "",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "content"],
+                from: ["source_format", "source_type", "源格式", "源类型"],
+                to: ["target_format", "target_type", "目标格式", "目标类型"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const from = getString(parsedArgs.from);
+        const to = getString(parsedArgs.to);
         const message = `请转换以下代码：
 
 📝 **源代码**：

package/build/tools/css_order.js

@@ -1,61 +1,61 @@
 // css_order 工具实现
 export async function cssOrder(_args) {
     try {
-        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
-
-如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
-
----
-
-## 排序逻辑（由外向内，由大到小）
-
-将属性分为五类，按顺序排列：
-
-### 1. 定位属性 (Positioning)
-决定元素“在哪里”。
-- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
-
-### 2. 盒子模型 (Box Model)
-决定元素“占多大空间”。
-- \`display\` / \`flex\` / \`grid\` 相关属性
-- \`width\` / \`height\` / \`max-width\` / \`min-width\`
-- \`margin\` / \`padding\` / \`border\`
-- \`box-sizing\` / \`overflow\`
-
-### 3. 文本排版 (Typography)
-决定元素内“文字内容”的样式。
-- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
-- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
-
-### 4. 视觉表现 (Visual/Decoration)
-决定元素“皮肤”的外观。
-- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
-
-### 5. 其他与交互 (Misc/Transitions)
-动效和交互相关。
-- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
-
----
-
-## 处理要求
-
-1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
-2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
-3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
-4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
-5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
-
----
-
-## 快速对比表
-
-| 顺序 | 类别 | 常用属性举例 | 核心目的 |
-| --- | --- | --- | --- |
-| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
-| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
-| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
-| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
-| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
+        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
+
+如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
+
+---
+
+## 排序逻辑（由外向内，由大到小）
+
+将属性分为五类，按顺序排列：
+
+### 1. 定位属性 (Positioning)
+决定元素“在哪里”。
+- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
+
+### 2. 盒子模型 (Box Model)
+决定元素“占多大空间”。
+- \`display\` / \`flex\` / \`grid\` 相关属性
+- \`width\` / \`height\` / \`max-width\` / \`min-width\`
+- \`margin\` / \`padding\` / \`border\`
+- \`box-sizing\` / \`overflow\`
+
+### 3. 文本排版 (Typography)
+决定元素内“文字内容”的样式。
+- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
+- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
+
+### 4. 视觉表现 (Visual/Decoration)
+决定元素“皮肤”的外观。
+- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
+
+### 5. 其他与交互 (Misc/Transitions)
+动效和交互相关。
+- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
+
+---
+
+## 处理要求
+
+1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
+2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
+3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
+4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
+5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
+
+---
+
+## 快速对比表
+
+| 顺序 | 类别 | 常用属性举例 | 核心目的 |
+| --- | --- | --- | --- |
+| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
+| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
+| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
+| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
+| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
 `;
         return {
             content: [

package/build/tools/debug.js

@@ -1,8 +1,20 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // debug 工具实现
 export async function debug(args) {
     try {
-        const error = args?.error || "";
-        const context = args?.context || "";
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                error: "",
+                context: "",
+            },
+            primaryField: "error", // 纯文本输入默认映射到 error 字段
+            fieldAliases: {
+                error: ["err", "exception", "错误", "异常"],
+                context: ["ctx", "code", "上下文", "代码"],
+            },
+        });
+        const error = getString(parsedArgs.error);
+        const context = getString(parsedArgs.context);
         const message = `请分析以下错误并提供调试策略：
 
 ❌ **错误信息**：

package/build/tools/design2code.d.ts

@@ -1,12 +1,3 @@
-/**
- * design2code - 设计稿转代码工具
- *
- * 功能：
- * 1. 根据设计稿图片生成页面代码（支持图片 URL 或 base64）
- * 2. 根据设计稿描述生成页面代码
- * 3. 将 HTML 转换为 Vue/React 组件
- * 4. 1:1 还原设计稿布局和样式
- */
 export declare function design2code(args: any): Promise<{
     content: ({
         type: string;
@@ -15,8 +6,8 @@ export declare function design2code(args: any): Promise<{
         mimeType?: undefined;
     } | {
         type: string;
-        data: any;
-        mimeType: any;
+        data: string;
+        mimeType: string;
         text?: undefined;
     })[];
     isError?: undefined;

package/build/tools/design2code.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * design2code - 设计稿转代码工具
  *
@@ -244,10 +245,26 @@ src/components/
 `;
 export async function design2code(args) {
     try {
-        const input = args?.input;
-        const framework = args?.framework || "vue";
-        const styleSolution = args?.style_solution || "tailwind";
-        const componentType = args?.component_type || "page";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                input: "",
+                framework: "vue",
+                style_solution: "tailwind",
+                component_type: "page",
+            },
+            primaryField: "input", // 纯文本输入默认映射到 input 字段
+            fieldAliases: {
+                input: ["design", "image", "url", "设计稿", "图片"],
+                framework: ["lib", "library", "框架", "前端框架"],
+                style_solution: ["style", "css", "样式", "样式方案"],
+                component_type: ["type", "kind", "类型", "组件类型"],
+            },
+        });
+        const input = getString(parsedArgs.input);
+        const framework = getString(parsedArgs.framework) || "vue";
+        const styleSolution = getString(parsedArgs.style_solution) || "tailwind";
+        const componentType = getString(parsedArgs.component_type) || "page";
         if (!input) {
             throw new Error("缺少必填参数: input（设计稿图片 URL/base64、设计稿描述或 HTML 代码）");
         }

package/build/tools/detect_shell.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString, getBoolean } from "../utils/parseArgs.js";
 import crypto from "crypto";
 import https from "https";
 import http from "http";
@@ -51,8 +52,20 @@ async function probeUrl(url, timeoutMs) {
 }
 // detect_shell 工具实现
 export async function detectShell(args) {
-    const nonce = args?.nonce || "gpt|gemini|claude|2025-10-25|guyu|boot";
-    const skipNetwork = args?.skip_network;
+    // 智能参数解析，支持自然语言输入
+    const parsedArgs = parseArgs(args, {
+        defaultValues: {
+            nonce: "gpt|gemini|claude|2025-10-25|guyu|boot",
+            skip_network: false,
+        },
+        primaryField: "nonce", // 纯文本输入默认映射到 nonce 字段
+        fieldAliases: {
+            nonce: ["随机字符串", "校验字符串"],
+            skip_network: ["skip", "跳过网络", "跳过"],
+        },
+    });
+    const nonce = getString(parsedArgs.nonce) || "gpt|gemini|claude|2025-10-25|guyu|boot";
+    const skipNetwork = getBoolean(parsedArgs.skip_network, false);
     // 计算 nonce 的哈希
     const hash = crypto.createHash("sha256");
     hash.update(nonce, "utf8");

package/build/tools/estimate.js

@@ -218,18 +218,35 @@ const PROMPT_TEMPLATE = `# 工作量估算指南
 *指南版本: 1.0.0*
 *工具: MCP Probe Kit - estimate*
 `;
+import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 /**
  * estimate 工具实现
  */
 export async function estimate(args) {
     try {
-        const taskDescription = args?.task_description;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                task_description: "",
+                code_context: "",
+                team_size: 1,
+                experience_level: "mid",
+            },
+            primaryField: "task_description", // 纯文本输入默认映射到 task_description 字段
+            fieldAliases: {
+                task_description: ["task", "description", "requirement", "任务", "任务描述"],
+                code_context: ["context", "code", "上下文", "相关代码"],
+                team_size: ["team", "size", "团队", "团队规模"],
+                experience_level: ["level", "experience", "经验", "经验水平"],
+            },
+        });
+        const taskDescription = getString(parsedArgs.task_description);
+        const codeContext = getString(parsedArgs.code_context);
+        const teamSize = getNumber(parsedArgs.team_size, 1);
+        const experienceLevel = getString(parsedArgs.experience_level) || "mid";
         if (!taskDescription) {
             throw new Error("缺少必填参数: task_description（任务描述）");
         }
-        const codeContext = args?.code_context || "";
-        const teamSize = args?.team_size || 1;
-        const experienceLevel = args?.experience_level || "mid";
         const expLevelMap = {
             junior: "初级（1-2年经验）",
             mid: "中级（3-5年经验）",

package/build/tools/explain.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // explain 工具实现
 export async function explain(args) {
     try {
-        const code = args?.code || "";
-        const context = args?.context || "";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                context: "",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "snippet"],
+                context: ["background", "info", "上下文", "背景"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const context = getString(parsedArgs.context);
         const message = `请详细解释以下代码：
 
 📝 **代码内容**：

package/build/tools/fix.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // fix 工具实现
 export async function fix(args) {
     try {
-        const code = args?.code || "";
-        const type = args?.type || "all"; // lint, type, format, import, unused
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                type: "all",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "content"],
+                type: ["fix_type", "category", "类型", "修复类型"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const type = getString(parsedArgs.type) || "all"; // lint, type, format, import, unused
         const message = `请自动修复以下代码问题：
 
 📝 **代码内容**：

package/build/tools/fix_bug.js

@@ -294,19 +294,38 @@ describe('[功能描述]', () => {
 *指南版本: 1.0.0*
 *工具: MCP Probe Kit - fix_bug*
 `;
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * fix_bug 工具实现
  */
 export async function fixBug(args) {
     try {
-        const errorMessage = args?.error_message;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                error_message: "",
+                stack_trace: "",
+                steps_to_reproduce: "",
+                expected_behavior: "",
+                actual_behavior: "",
+            },
+            primaryField: "error_message", // 纯文本输入默认映射到 error_message 字段
+            fieldAliases: {
+                error_message: ["error", "err", "message", "错误", "错误信息"],
+                stack_trace: ["stack", "trace", "堆栈", "调用栈"],
+                steps_to_reproduce: ["steps", "reproduce", "步骤", "复现步骤"],
+                expected_behavior: ["expected", "期望", "期望行为"],
+                actual_behavior: ["actual", "实际", "实际行为"],
+            },
+        });
+        const errorMessage = getString(parsedArgs.error_message);
+        const stackTrace = getString(parsedArgs.stack_trace);
+        const stepsToReproduce = getString(parsedArgs.steps_to_reproduce);
+        const expectedBehavior = getString(parsedArgs.expected_behavior);
+        const actualBehavior = getString(parsedArgs.actual_behavior);
         if (!errorMessage) {
             throw new Error("缺少必填参数: error_message（错误信息）");
         }
-        const stackTrace = args?.stack_trace || "";
-        const stepsToReproduce = args?.steps_to_reproduce || "";
-        const expectedBehavior = args?.expected_behavior || "";
-        const actualBehavior = args?.actual_behavior || "";
         // 构建可选部分
         const stackTraceSection = stackTrace
             ? `**堆栈跟踪**:\n\`\`\`\n${stackTrace}\n\`\`\``