mcp-probe-kit 1.8.1 → 1.10.0

package/build/tools/gen_mock.js

@@ -202,19 +202,38 @@ interface Config {
 *指南版本: 1.0.0*
 *工具: MCP Probe Kit - gen_mock*
 `;
+import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 /**
  * gen_mock 工具实现
  */
 export async function genMock(args) {
     try {
-        const schema = args?.schema;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                schema: "",
+                count: 1,
+                format: "json",
+                locale: "zh-CN",
+                seed: 0,
+            },
+            primaryField: "schema", // 纯文本输入默认映射到 schema 字段
+            fieldAliases: {
+                schema: ["type", "interface", "structure", "类型", "数据结构"],
+                count: ["num", "amount", "number", "数量"],
+                format: ["output", "type", "格式", "输出格式"],
+                locale: ["lang", "language", "语言", "区域"],
+                seed: ["random_seed", "种子"],
+            },
+        });
+        const schema = getString(parsedArgs.schema);
+        const count = getNumber(parsedArgs.count, 1);
+        const format = getString(parsedArgs.format) || "json";
+        const locale = getString(parsedArgs.locale) || "zh-CN";
+        const seed = getNumber(parsedArgs.seed, 0);
         if (!schema) {
             throw new Error("缺少必填参数: schema（数据结构定义）");
         }
-        const count = args?.count || 1;
-        const format = args?.format || "json";
-        const locale = args?.locale || "zh-CN";
-        const seed = args?.seed;
         if (count < 1 || count > 1000) {
             throw new Error("count 参数必须在 1-1000 之间");
         }

package/build/tools/gen_skill.d.ts

@@ -1,6 +1,3 @@
-/**
- * gen_skill - 生成 Agent Skills 文档
- */
 export declare function genSkill(args: any): Promise<{
     content: {
         type: string;

package/build/tools/gen_skill.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * gen_skill - 生成 Agent Skills 文档
  */
@@ -446,10 +447,26 @@ function generateReadme(tools, lang) {
 }
 export async function genSkill(args) {
     try {
-        const scope = args?.scope || "all";
-        const toolName = args?.tool_name;
-        const outputDir = args?.output_dir || "skills";
-        const lang = args?.lang || "zh";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                scope: "all",
+                tool_name: "",
+                output_dir: "skills",
+                lang: "zh",
+            },
+            primaryField: "scope", // 纯文本输入默认映射到 scope 字段
+            fieldAliases: {
+                scope: ["range", "category", "范围", "类别"],
+                tool_name: ["tool", "name", "工具", "工具名"],
+                output_dir: ["dir", "output", "目录", "输出目录"],
+                lang: ["language", "语言"],
+            },
+        });
+        const scope = getString(parsedArgs.scope) || "all";
+        const toolName = getString(parsedArgs.tool_name);
+        const outputDir = getString(parsedArgs.output_dir) || "skills";
+        const lang = getString(parsedArgs.lang) || "zh";
         const isZh = lang === "zh";
         let toolsToGenerate = [];
         if (toolName) {

package/build/tools/genapi.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // genapi 工具实现
 export async function genapi(args) {
     try {
-        const code = args?.code || "";
-        const format = args?.format || "markdown"; // markdown, openapi, jsdoc
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                format: "markdown",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "api", "代码", "endpoint"],
+                format: ["output_format", "type", "格式", "输出格式"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const format = getString(parsedArgs.format) || "markdown"; // markdown, openapi, jsdoc
         const message = `请为以下代码生成 API 文档：
 
 📝 **代码**：

package/build/tools/genchangelog.js

@@ -1,9 +1,24 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // genchangelog 工具实现
 export async function genchangelog(args) {
     try {
-        const version = args?.version || "";
-        const from = args?.from || "";
-        const to = args?.to || "HEAD";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                version: "",
+                from: "",
+                to: "HEAD",
+            },
+            primaryField: "version", // 纯文本输入默认映射到 version 字段
+            fieldAliases: {
+                version: ["ver", "v", "版本", "版本号"],
+                from: ["from_tag", "start", "起始", "起始版本"],
+                to: ["to_tag", "end", "结束", "结束版本"],
+            },
+        });
+        const version = getString(parsedArgs.version);
+        const from = getString(parsedArgs.from);
+        const to = getString(parsedArgs.to) || "HEAD";
         const message = `请生成项目的 CHANGELOG（变更日志）：
 
 📝 **版本信息**：

package/build/tools/gencommit.js

@@ -1,8 +1,30 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // gencommit 工具实现
 export async function gencommit(args) {
     try {
-        const changes = args?.changes || "";
-        const type = args?.type || ""; // fixed, fix, feat, docs, style, chore, refactor, test
+        // 使用智能参数解析，支持自然语言输入
+        // 用户可以直接说 "帮我生成 commit 消息" 或传递 JSON 对象
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                input: "",
+                changes: "",
+                type: "",
+            },
+            primaryField: "input", // 纯文本输入默认映射到 input 字段
+            fieldAliases: {
+                input: ["输入"],
+                changes: ["change", "diff", "code", "修改", "变更"],
+                type: ["commit_type", "类型"],
+            },
+        });
+        // 优先使用 input 参数（自然语言输入）
+        const input = getString(parsedArgs.input);
+        let changes = getString(parsedArgs.changes);
+        const type = getString(parsedArgs.type); // fixed, fix, feat, docs, style, chore, refactor, test
+        // 如果提供了 input，将其作为 changes
+        if (input) {
+            changes = input;
+        }
         const message = `请按以下步骤生成规范的 Git commit 消息：
 
 **第一步：获取变更信息**

package/build/tools/gendoc.js

@@ -1,9 +1,24 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // gendoc 工具实现
 export async function gendoc(args) {
     try {
-        const code = args?.code || "";
-        const style = args?.style || "jsdoc"; // jsdoc, tsdoc, javadoc
-        const lang = args?.lang || "zh"; // zh, en
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                style: "jsdoc",
+                lang: "zh",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "function"],
+                style: ["format", "type", "风格", "注释风格"],
+                lang: ["language", "语言"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const style = getString(parsedArgs.style) || "jsdoc"; // jsdoc, tsdoc, javadoc
+        const lang = getString(parsedArgs.lang) || "zh"; // zh, en
         const message = `请为以下代码生成详细的注释文档：
 
 📝 **代码内容**：

package/build/tools/genpr.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // genpr 工具实现
 export async function genpr(args) {
     try {
-        const branch = args?.branch || "";
-        const commits = args?.commits || "";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                branch: "",
+                commits: "",
+            },
+            primaryField: "commits", // 纯文本输入默认映射到 commits 字段
+            fieldAliases: {
+                branch: ["分支", "branch_name"],
+                commits: ["commit_history", "log", "提交", "提交历史"],
+            },
+        });
+        const branch = getString(parsedArgs.branch);
+        const commits = getString(parsedArgs.commits);
         const message = `请生成规范的 Pull Request 描述：
 
 📝 **分支信息**：

package/build/tools/genreadme.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // genreadme 工具实现
 export async function genreadme(args) {
     try {
-        const projectInfo = args?.project_info || "";
-        const style = args?.style || "standard"; // standard, minimal, detailed
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                project_info: "",
+                style: "standard",
+            },
+            primaryField: "project_info", // 纯文本输入默认映射到 project_info 字段
+            fieldAliases: {
+                project_info: ["info", "description", "project", "项目信息", "项目描述"],
+                style: ["format", "type", "风格", "模板"],
+            },
+        });
+        const projectInfo = getString(parsedArgs.project_info);
+        const style = getString(parsedArgs.style) || "standard"; // standard, minimal, detailed
         const message = `请生成项目的 README.md 文档：
 
 📝 **项目信息**：

package/build/tools/gensql.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // gensql 工具实现
 export async function gensql(args) {
     try {
-        const description = args?.description || "";
-        const dialect = args?.dialect || "postgres"; // postgres, mysql, sqlite
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                description: "",
+                dialect: "postgres",
+            },
+            primaryField: "description", // 纯文本输入默认映射到 description 字段
+            fieldAliases: {
+                description: ["query", "requirement", "需求", "查询需求"],
+                dialect: ["database", "db", "type", "数据库", "数据库类型"],
+            },
+        });
+        const description = getString(parsedArgs.description);
+        const dialect = getString(parsedArgs.dialect) || "postgres"; // postgres, mysql, sqlite
         const message = `请根据以下需求生成 SQL：
 
 📝 **需求描述**：

package/build/tools/gentest.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // gentest 工具实现
 export async function gentest(args) {
     try {
-        const code = args?.code || "";
-        const framework = args?.framework || "jest"; // jest, vitest, mocha
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                framework: "jest",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "function"],
+                framework: ["test_framework", "lib", "框架", "测试框架"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const framework = getString(parsedArgs.framework) || "jest"; // jest, vitest, mocha
         const message = `请为以下代码生成完整的测试用例：
 
 📝 **代码内容**：

package/build/tools/genui.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // genui 工具实现
 export async function genui(args) {
     try {
-        const description = args?.description || "";
-        const framework = args?.framework || "react"; // react, vue, html
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                description: "",
+                framework: "react",
+            },
+            primaryField: "description", // 纯文本输入默认映射到 description 字段
+            fieldAliases: {
+                description: ["requirement", "spec", "需求", "组件描述"],
+                framework: ["lib", "library", "框架", "前端框架"],
+            },
+        });
+        const description = getString(parsedArgs.description);
+        const framework = getString(parsedArgs.framework) || "react"; // react, vue, html
         const message = `请生成以下 UI 组件：
 
 📝 **组件描述**：

package/build/tools/init_project.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // init_project 工具实现
 export async function initProject(args) {
     try {
-        const input = args?.input || "";
-        const projectName = args?.project_name || "新项目";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                input: "",
+                project_name: "新项目",
+            },
+            primaryField: "input", // 纯文本输入默认映射到 input 字段
+            fieldAliases: {
+                input: ["requirement", "description", "需求", "项目需求"],
+                project_name: ["name", "project", "项目名", "项目名称"],
+            },
+        });
+        const input = getString(parsedArgs.input);
+        const projectName = getString(parsedArgs.project_name) || "新项目";
         const featureSlug = projectName.toLowerCase().replace(/\s+/g, '-');
         const message = `你需要按照 Spec-Driven Development（规范驱动开发）的方式初始化项目，参考 https://github.com/github/spec-kit 的工作流程。
 

package/build/tools/init_project_context.d.ts

@@ -1,9 +1,3 @@
-/**
- * init_project_context 工具
- *
- * 功能：生成项目上下文文档，帮助 AI 理解项目的技术栈、架构和规范
- * 模式：指令生成器模式 - 返回详细的分析指南，由 AI 执行实际操作
- */
 /**
  * init_project_context 工具实现
  *

package/build/tools/init_project_context.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * init_project_context 工具
  *
@@ -302,8 +303,17 @@ project/
  */
 export async function initProjectContext(args) {
     try {
-        // 解析参数
-        const docsDir = args?.docs_dir || DEFAULT_DOCS_DIR;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                docs_dir: DEFAULT_DOCS_DIR,
+            },
+            primaryField: "docs_dir", // 纯文本输入默认映射到 docs_dir 字段
+            fieldAliases: {
+                docs_dir: ["dir", "output", "directory", "目录", "文档目录"],
+            },
+        });
+        const docsDir = getString(parsedArgs.docs_dir) || DEFAULT_DOCS_DIR;
         // 构建指南文本（替换占位符）
         const guide = PROMPT_TEMPLATE.replace(/{docs_dir}/g, docsDir);
         // 返回结果

package/build/tools/perf.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // perf 工具实现
 export async function perf(args) {
     try {
-        const code = args?.code || "";
-        const type = args?.type || "all"; // algorithm, memory, react, database
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                type: "all",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "function"],
+                type: ["analysis_type", "category", "类型", "分析类型"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const type = getString(parsedArgs.type) || "all"; // algorithm, memory, react, database
         const message = `请分析以下代码的性能问题并提供优化建议：
 
 📝 **代码内容**：

package/build/tools/refactor.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // refactor 工具实现
 export async function refactor(args) {
     try {
-        const code = args?.code || "";
-        const goal = args?.goal || ""; // improve_readability, reduce_complexity, extract_function, etc.
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                goal: "",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "content"],
+                goal: ["target", "objective", "目标", "重构目标"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const goal = getString(parsedArgs.goal); // improve_readability, reduce_complexity, extract_function, etc.
         const message = `请为以下代码提供重构建议：
 
 📝 **代码内容**：

package/build/tools/resolve_conflict.js

@@ -1,7 +1,18 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // resolve_conflict 工具实现
 export async function resolveConflict(args) {
     try {
-        const conflicts = args?.conflicts || "";
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                conflicts: "",
+            },
+            primaryField: "conflicts", // 纯文本输入默认映射到 conflicts 字段
+            fieldAliases: {
+                conflicts: ["conflict", "diff", "merge", "冲突", "合并冲突"],
+            },
+        });
+        const conflicts = getString(parsedArgs.conflicts);
         const message = `请分析并解决以下 Git 冲突：
 
 ⚔️ **冲突内容**：

package/build/tools/security_scan.js

@@ -272,17 +272,32 @@ logger.info("API call with token:", maskToken(apiToken))
 *指南版本: 1.0.0*
 *工具: MCP Probe Kit - security_scan*
 `;
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * security_scan 工具实现
  */
 export async function securityScan(args) {
     try {
-        const code = args?.code;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                language: "auto",
+                scan_type: "all",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "src", "代码", "content"],
+                language: ["lang", "语言", "编程语言"],
+                scan_type: ["type", "category", "类型", "扫描类型"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const language = getString(parsedArgs.language) || "auto";
+        const scanType = getString(parsedArgs.scan_type) || "all";
         if (!code) {
             throw new Error("缺少必填参数: code（需要扫描的代码）");
         }
-        const language = args?.language || "auto";
-        const scanType = args?.scan_type || "all";
         const scanTypeDesc = {
             all: "全面扫描（注入、认证、加密、敏感数据）",
             injection: "注入类漏洞（SQL注入、XSS、命令注入）",

package/build/tools/split.js

@@ -1,8 +1,21 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 // split 工具实现
 export async function split(args) {
     try {
-        const file = args?.file || "";
-        const strategy = args?.strategy || "auto"; // auto, type, function, component, feature
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                file: "",
+                strategy: "auto",
+            },
+            primaryField: "file", // 纯文本输入默认映射到 file 字段
+            fieldAliases: {
+                file: ["code", "source", "content", "文件", "代码"],
+                strategy: ["method", "type", "策略", "拆分策略"],
+            },
+        });
+        const file = getString(parsedArgs.file);
+        const strategy = getString(parsedArgs.strategy) || "auto"; // auto, type, function, component, feature
         const message = `请拆分以下文件：
 
 📝 **文件内容**：

package/build/tools/start_api.d.ts

@@ -1,9 +1,3 @@
-/**
- * start_api 智能编排工具
- *
- * 场景：API 开发
- * 编排：[检查上下文] → genapi → gen_mock → gentest
- */
 export declare function startApi(args: any): Promise<{
     content: {
         type: string;

package/build/tools/start_api.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * start_api 智能编排工具
  *
@@ -154,12 +155,26 @@ const PROMPT_TEMPLATE = `# 🔌 API 开发编排指南
 `;
 export async function startApi(args) {
     try {
-        const code = args?.code;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                code: "",
+                language: "typescript",
+                format: "markdown",
+            },
+            primaryField: "code", // 纯文本输入默认映射到 code 字段
+            fieldAliases: {
+                code: ["source", "api", "代码", "endpoint"],
+                language: ["lang", "语言", "编程语言"],
+                format: ["output", "type", "格式", "输出格式"],
+            },
+        });
+        const code = getString(parsedArgs.code);
+        const language = getString(parsedArgs.language) || "typescript";
+        const format = getString(parsedArgs.format) || "markdown";
         if (!code) {
             throw new Error("缺少必填参数: code（API 代码）");
         }
-        const language = args?.language || "typescript";
-        const format = args?.format || "markdown";
         const guide = PROMPT_TEMPLATE
             .replace(/{code}/g, code)
             .replace(/{language}/g, language)

package/build/tools/start_bugfix.d.ts

@@ -1,9 +1,3 @@
-/**
- * start_bugfix 智能编排工具
- *
- * 场景：修复 Bug
- * 编排：[检查上下文] → fix_bug → gentest
- */
 export declare function startBugfix(args: any): Promise<{
     content: {
         type: string;

package/build/tools/start_bugfix.js

@@ -1,3 +1,4 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * start_bugfix 智能编排工具
  *
@@ -101,11 +102,23 @@ const PROMPT_TEMPLATE = `# 🐛 Bug 修复编排指南
 `;
 export async function startBugfix(args) {
     try {
-        const errorMessage = args?.error_message;
+        // 智能参数解析，支持自然语言输入
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                error_message: "",
+                stack_trace: "",
+            },
+            primaryField: "error_message", // 纯文本输入默认映射到 error_message 字段
+            fieldAliases: {
+                error_message: ["error", "err", "message", "错误", "错误信息"],
+                stack_trace: ["stack", "trace", "堆栈", "调用栈"],
+            },
+        });
+        const errorMessage = getString(parsedArgs.error_message);
+        const stackTrace = getString(parsedArgs.stack_trace);
         if (!errorMessage) {
             throw new Error("缺少必填参数: error_message（错误信息）");
         }
-        const stackTrace = args?.stack_trace || "";
         const stackTraceSection = stackTrace
             ? `**堆栈跟踪**:\n\`\`\`\n${stackTrace}\n\`\`\``
             : "";

package/build/tools/start_doc.d.ts

@@ -1,9 +1,3 @@
-/**
- * start_doc 智能编排工具
- *
- * 场景：文档生成
- * 编排：[检查上下文] → gendoc → genreadme → genapi
- */
 export declare function startDoc(args: any): Promise<{
     content: {
         type: string;