mcp-probe-kit 3.0.23 → 3.1.0

package/build/tools/fix.js

@@ -0,0 +1,303 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
+// fix 工具实现
+export async function fix(args) {
+    try {
+        // 智能参数解析，支持自然语言输入
+        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 = `请自动修复以下代码问题：
+
+📝 **代码内容**：
+${code || "请提供需要修复的代码"}
+
+🎯 **修复类型**：${type}
+
+---
+
+## 自动修复步骤
+
+### 第一步：识别问题
+
+执行以下检查：
+\`\`\`bash
+# Lint 检查
+npm run lint
+
+# TypeScript 类型检查
+tsc --noEmit
+
+# 格式化检查
+npm run format:check
+\`\`\`
+
+### 第二步：问题分类
+
+**1️⃣ Lint 错误**
+- ESLint 规则违反
+- 代码质量问题
+- 潜在 Bug
+
+**2️⃣ TypeScript 类型错误**
+- 类型不匹配
+- 缺少类型定义
+- 隐式 any
+
+**3️⃣ 格式化问题**
+- 缩进不一致
+- 引号风格
+- 分号使用
+- 换行规则
+
+**4️⃣ Import 问题**
+- 未使用的 import
+- 重复 import
+- Import 顺序混乱
+- 相对路径 vs 绝对路径
+
+**5️⃣ 未使用代码**
+- 未使用的变量
+- 未使用的函数
+- 死代码（Dead Code）
+
+---
+
+## 修复策略
+
+### 🔧 Lint 错误修复
+
+**常见问题和修复：**
+
+1. **no-unused-vars**
+\`\`\`typescript
+// ❌ Before
+const unusedVar = 123;
+function test() {
+  const result = compute();
+  return 42;
+}
+
+// ✅ After
+function test() {
+  return 42;
+}
+\`\`\`
+
+2. **no-console**
+\`\`\`typescript
+// ❌ Before
+console.log('debug info');
+
+// ✅ After (开发环境)
+if (process.env.NODE_ENV === 'development') {
+  console.log('debug info');
+}
+
+// ✅ After (使用 logger)
+logger.debug('debug info');
+\`\`\`
+
+3. **prefer-const**
+\`\`\`typescript
+// ❌ Before
+let value = 10;
+const result = value * 2;
+
+// ✅ After
+const value = 10;
+const result = value * 2;
+\`\`\`
+
+### 🔧 TypeScript 类型错误修复
+
+**常见问题和修复：**
+
+1. **隐式 any**
+\`\`\`typescript
+// ❌ Before
+function process(data) {
+  return data.value;
+}
+
+// ✅ After
+function process(data: { value: string }): string {
+  return data.value;
+}
+\`\`\`
+
+2. **类型不匹配**
+\`\`\`typescript
+// ❌ Before
+const num: number = "123";
+
+// ✅ After
+const num: number = 123;
+// 或
+const num: number = parseInt("123");
+\`\`\`
+
+3. **可能为 null/undefined**
+\`\`\`typescript
+// ❌ Before
+function getName(user) {
+  return user.name.toUpperCase();
+}
+
+// ✅ After
+function getName(user: User | null): string {
+  return user?.name?.toUpperCase() ?? 'Unknown';
+}
+\`\`\`
+
+### 🔧 Import 优化
+
+**修复策略：**
+
+\`\`\`typescript
+// ❌ Before
+import { useState, useEffect, useMemo } from 'react';
+import { Button } from './components/Button';
+import React from 'react';
+import { formatDate } from '../utils/date';
+import { api } from '../../services/api';
+
+// ✅ After
+// 外部依赖
+import React, { useEffect, useMemo, useState } from 'react';
+
+// 内部模块（按层级从远到近）
+import { api } from '../../services/api';
+import { formatDate } from '../utils/date';
+import { Button } from './components/Button';
+\`\`\`
+
+### 🔧 格式化修复
+
+**自动格式化：**
+\`\`\`bash
+# Prettier
+npm run format
+
+# ESLint 自动修复
+npm run lint:fix
+\`\`\`
+
+---
+
+## 批量修复命令
+
+**一键修复所有可自动修复的问题：**
+\`\`\`bash
+# 1. 格式化代码
+npm run format
+
+# 2. ESLint 自动修复
+npm run lint:fix
+
+# 3. 整理 import
+npx organize-imports-cli 'src/**/*.ts'
+
+# 4. 移除未使用的 import
+npx ts-unused-exports tsconfig.json --deleteUnusedFile
+
+# 5. TypeScript 类型检查
+tsc --noEmit
+\`\`\`
+
+---
+
+## 修复报告
+
+### 📊 问题统计
+- Lint 错误: X 个
+- 类型错误: Y 个
+- 格式问题: Z 个
+- Import 问题: W 个
+
+### ✅ 已自动修复
+1. [文件:行号] 问题描述 → 已修复
+2. [文件:行号] 问题描述 → 已修复
+
+### ⚠️ 需要手动处理
+1. [文件:行号] 问题描述 → 修复建议
+2. [文件:行号] 问题描述 → 修复建议
+
+### 📝 修复后的代码
+\`\`\`typescript
+// 完整的修复后代码
+\`\`\`
+
+---
+
+## 预防措施
+
+**配置自动修复：**
+
+\`\`\`.vscode/settings.json
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": true,
+    "source.organizeImports": true
+  },
+  "eslint.validate": [
+    "javascript",
+    "typescript",
+    "javascriptreact",
+    "typescriptreact"
+  ]
+}
+\`\`\`
+
+**Git Hooks（Husky）：**
+\`\`\`json
+{
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}
+\`\`\`
+
+---
+
+现在请开始分析代码问题并自动修复。`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 自动修复失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/fix_bug.js

@@ -10,167 +10,167 @@ import { parseArgs, getString } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
 import { renderGuidanceHeader } from "../lib/guidance.js";
 import { handleToolError } from "../utils/error-handler.js";
-const PROMPT_TEMPLATE = `# TBP 8 步 Bug 真因分析与修复指南
-
-## 🐛 Bug 信息
-
-**错误信息**:
-\`\`\`
-{error_message}
-\`\`\`
-
-{stack_trace_section}
-
-{reproduce_section}
-
-{behavior_section}
-
-{code_context_section}
-
----
-
-## TBP-1 现象
-
-先把用户可见的问题定义准确，避免“坏了/卡了/有问题”这类泛化描述。
-
-要求：
-1. 用 1-2 句定义现象
-2. 明确是“慢”“停滞”“失败”“回归”还是“未生效”
-3. 如果提供了期望/实际行为，必须纳入现象定义
-
-## TBP-2 时间线
-
-基于现有信息复盘事件顺序，至少回答：
-1. 什么时候开始
-2. 中间发生了什么
-3. 最后停在什么状态
-
-优先记录：
-- 用户输入 / 复现步骤
-- first progress / first error
-- tool call / stack / stop / timeout
-- 关键文件或模块
-
-## TBP-3 不是这个
-
-列出当前应优先排除的错误方向，并说明需要什么证据排除。
-
-常见排除项：
-- 不是单纯网络慢
-- 不是前端展示截断
-- 不是消息没转发
-- 不是纯粹的超时表象
-- 不是用户输入丢失
-
-## TBP-4 共同模式
-
-对比成功/失败样本，找出从哪一步开始分叉。
-
-重点检查：
-- 传输层
-- 会话状态机
-- 完成态判定
-- 工具执行
-- 文件写入
-- 重试策略
-
-## TBP-5 边界
-
-明确指出问题失控落在哪一层：
-- 上游模型 / SDK
-- 网关状态机
-- session 复用
-- tool 执行层
-- 文件系统
-- 环境配置
-- UI 展示层
-
-## TBP-6 真因
-
-真因必须写成因果句：
-\`A + B 在条件 D 下导致了 C\`
-
-不允许只写：
-- 超时了
-- SDK 有 bug
-- 返回慢
-
-## TBP-7 证据链
-
-说明：
-1. 哪些证据支持真因
-2. 哪些现象若出现会推翻它，但现场没有出现
-3. 为什么其他解释更弱
-
-## TBP-8 修复
-
-只有在证据链闭合后，才开始设计修复。
-
-每个修复方案都要说明：
-- 改哪一层
-- 为什么这是修真因，不是补症状
-- 风险是什么
-- 怎么验证
-
----
-
-## 📤 输出格式要求
-
-请严格按以下 JSON 格式输出修复指南：
-
-\`\`\`json
-{
-  "bug_summary": "Bug 简述（一句话）",
-  "analysis_mode": "tbp8",
-  "analysis": {
-    "error_type": "错误类型",
-    "direct_cause": "直接原因",
-    "root_cause": "根本原因",
-    "affected_scope": "影响范围"
-  },
-  "tbp": {
-    "phenomenon": "TBP-1 现象",
-    "timeline": [],
-    "ruled_out": [],
-    "common_pattern": "TBP-4 共同模式",
-    "boundary": "TBP-5 边界",
-    "root_cause_statement": "A + B 在条件 D 下导致 C",
-    "evidence": [],
-    "repair": []
-  },
-  "location": {
-    "file": "问题文件路径",
-    "line": 42,
-    "function": "问题函数名",
-    "code_snippet": "问题代码片段"
-  },
-  "fix_plan": {
-    "chosen_solution": "选择的修复方案",
-    "reason": "选择理由",
-    "steps": [
-      { "step": 1, "action": "修复步骤", "file": "文件", "change": "变更内容" }
-    ],
-    "code_before": "修改前代码",
-    "code_after": "修改后代码"
-  },
-  "verification": {
-    "test_cases": ["测试用例1", "测试用例2"],
-    "manual_checks": ["手动验证项1", "手动验证项2"]
-  }
-}
-\`\`\`
-
-## ⚠️ 护栏
-
-- 不要一看到新现象就补一个新分支，先判断是不是同一类根因在换表现
-- 不要把“超时”直接当真因，要先分清是没进展、慢进展，还是结果已出现但判定过严
-- 不要只看单一样本就下结论，有对比样本时必须做对比
-- 如果证据不足，要明确说明还缺什么证据
-
----
-
-*指南版本: 2.0.0*
-*工具: MCP Probe Kit - fix_bug*
+const PROMPT_TEMPLATE = `# TBP 8 步 Bug 真因分析与修复指南
+
+## 🐛 Bug 信息
+
+**错误信息**:
+\`\`\`
+{error_message}
+\`\`\`
+
+{stack_trace_section}
+
+{reproduce_section}
+
+{behavior_section}
+
+{code_context_section}
+
+---
+
+## TBP-1 现象
+
+先把用户可见的问题定义准确，避免“坏了/卡了/有问题”这类泛化描述。
+
+要求：
+1. 用 1-2 句定义现象
+2. 明确是“慢”“停滞”“失败”“回归”还是“未生效”
+3. 如果提供了期望/实际行为，必须纳入现象定义
+
+## TBP-2 时间线
+
+基于现有信息复盘事件顺序，至少回答：
+1. 什么时候开始
+2. 中间发生了什么
+3. 最后停在什么状态
+
+优先记录：
+- 用户输入 / 复现步骤
+- first progress / first error
+- tool call / stack / stop / timeout
+- 关键文件或模块
+
+## TBP-3 不是这个
+
+列出当前应优先排除的错误方向，并说明需要什么证据排除。
+
+常见排除项：
+- 不是单纯网络慢
+- 不是前端展示截断
+- 不是消息没转发
+- 不是纯粹的超时表象
+- 不是用户输入丢失
+
+## TBP-4 共同模式
+
+对比成功/失败样本，找出从哪一步开始分叉。
+
+重点检查：
+- 传输层
+- 会话状态机
+- 完成态判定
+- 工具执行
+- 文件写入
+- 重试策略
+
+## TBP-5 边界
+
+明确指出问题失控落在哪一层：
+- 上游模型 / SDK
+- 网关状态机
+- session 复用
+- tool 执行层
+- 文件系统
+- 环境配置
+- UI 展示层
+
+## TBP-6 真因
+
+真因必须写成因果句：
+\`A + B 在条件 D 下导致了 C\`
+
+不允许只写：
+- 超时了
+- SDK 有 bug
+- 返回慢
+
+## TBP-7 证据链
+
+说明：
+1. 哪些证据支持真因
+2. 哪些现象若出现会推翻它，但现场没有出现
+3. 为什么其他解释更弱
+
+## TBP-8 修复
+
+只有在证据链闭合后，才开始设计修复。
+
+每个修复方案都要说明：
+- 改哪一层
+- 为什么这是修真因，不是补症状
+- 风险是什么
+- 怎么验证
+
+---
+
+## 📤 输出格式要求
+
+请严格按以下 JSON 格式输出修复指南：
+
+\`\`\`json
+{
+  "bug_summary": "Bug 简述（一句话）",
+  "analysis_mode": "tbp8",
+  "analysis": {
+    "error_type": "错误类型",
+    "direct_cause": "直接原因",
+    "root_cause": "根本原因",
+    "affected_scope": "影响范围"
+  },
+  "tbp": {
+    "phenomenon": "TBP-1 现象",
+    "timeline": [],
+    "ruled_out": [],
+    "common_pattern": "TBP-4 共同模式",
+    "boundary": "TBP-5 边界",
+    "root_cause_statement": "A + B 在条件 D 下导致 C",
+    "evidence": [],
+    "repair": []
+  },
+  "location": {
+    "file": "问题文件路径",
+    "line": 42,
+    "function": "问题函数名",
+    "code_snippet": "问题代码片段"
+  },
+  "fix_plan": {
+    "chosen_solution": "选择的修复方案",
+    "reason": "选择理由",
+    "steps": [
+      { "step": 1, "action": "修复步骤", "file": "文件", "change": "变更内容" }
+    ],
+    "code_before": "修改前代码",
+    "code_after": "修改后代码"
+  },
+  "verification": {
+    "test_cases": ["测试用例1", "测试用例2"],
+    "manual_checks": ["手动验证项1", "手动验证项2"]
+  }
+}
+\`\`\`
+
+## ⚠️ 护栏
+
+- 不要一看到新现象就补一个新分支，先判断是不是同一类根因在换表现
+- 不要把“超时”直接当真因，要先分清是没进展、慢进展，还是结果已出现但判定过严
+- 不要只看单一样本就下结论，有对比样本时必须做对比
+- 如果证据不足，要明确说明还缺什么证据
+
+---
+
+*指南版本: 2.0.0*
+*工具: MCP Probe Kit - fix_bug*
 `;
 function inferBugType(text) {
     if (/timeout|latency|slow|卡|慢|超时/i.test(text))

package/build/tools/gen_mock.d.ts

@@ -0,0 +1,22 @@
+/**
+ * gen_mock 工具
+ *
+ * 功能：根据数据结构生成 Mock 数据
+ * 模式：指令生成器模式 - 返回生成指南，由 AI 执行实际生成
+ */
+/**
+ * gen_mock 工具实现
+ */
+export declare function genMock(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;