mcp-probe-kit 1.0.0

package/build/tools/refactor.js

@@ -0,0 +1,318 @@
+// refactor 工具实现
+export async function refactor(args) {
+    try {
+        const code = args?.code || "";
+        const goal = args?.goal || ""; // improve_readability, reduce_complexity, extract_function, etc.
+        const message = `请为以下代码提供重构建议：
+
+📝 **代码内容**：
+${code || "请提供需要重构的代码"}
+
+🎯 **重构目标**：${goal || "全面优化"}
+
+---
+
+## 重构分析流程
+
+### 第一步：识别代码坏味道
+
+**常见问题**：
+1. **重复代码（Duplicated Code）**
+   - 相同或相似的代码出现多次
+   - 建议：提取公共函数/方法
+
+2. **过长函数（Long Function）**
+   - 函数超过 30 行
+   - 建议：拆分为多个小函数
+
+3. **过大类（Large Class）**
+   - 类职责过多
+   - 建议：按职责拆分类
+
+4. **过长参数列表（Long Parameter List）**
+   - 参数超过 3-4 个
+   - 建议：使用对象封装参数
+
+5. **复杂条件判断（Complex Conditional）**
+   - 嵌套超过 3 层
+   - 建议：提前返回、使用策略模式
+
+6. **魔法数字（Magic Numbers）**
+   - 硬编码的数字
+   - 建议：使用常量
+
+7. **紧耦合（Tight Coupling）**
+   - 模块间依赖过强
+   - 建议：依赖注入、接口抽象
+
+### 第二步：重构建议
+
+**优先级分类**：
+- 🔴 **Critical**：严重影响可维护性
+- 🟡 **Important**：建议尽快处理
+- 🟢 **Nice-to-have**：可选优化
+
+---
+
+## 重构技术清单
+
+### 1️⃣ 提取函数（Extract Function）
+
+**场景**：一段代码可以被独立理解
+
+**示例**：
+\`\`\`typescript
+// Before
+function processOrder(order) {
+  // 验证订单
+  if (!order.id || !order.items || order.items.length === 0) {
+    throw new Error('Invalid order');
+  }
+  
+  // 计算总价
+  let total = 0;
+  for (const item of order.items) {
+    total += item.price * item.quantity;
+  }
+  
+  // 应用折扣
+  if (order.coupon) {
+    total = total * (1 - order.coupon.discount);
+  }
+  
+  return total;
+}
+
+// After
+function processOrder(order) {
+  validateOrder(order);
+  const subtotal = calculateSubtotal(order.items);
+  const total = applyDiscount(subtotal, order.coupon);
+  return total;
+}
+
+function validateOrder(order) {
+  if (!order.id || !order.items || order.items.length === 0) {
+    throw new Error('Invalid order');
+  }
+}
+
+function calculateSubtotal(items) {
+  return items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+}
+
+function applyDiscount(amount, coupon) {
+  return coupon ? amount * (1 - coupon.discount) : amount;
+}
+\`\`\`
+
+### 2️⃣ 简化条件表达式
+
+**技巧**：
+- 使用提前返回（Early Return）
+- 合并条件
+- 使用三元运算符
+- 策略模式替代 switch
+
+**示例**：
+\`\`\`typescript
+// Before
+function getDiscount(user) {
+  if (user) {
+    if (user.isPremium) {
+      if (user.orderCount > 10) {
+        return 0.3;
+      } else {
+        return 0.2;
+      }
+    } else {
+      return 0.1;
+    }
+  } else {
+    return 0;
+  }
+}
+
+// After
+function getDiscount(user) {
+  if (!user) return 0;
+  if (!user.isPremium) return 0.1;
+  return user.orderCount > 10 ? 0.3 : 0.2;
+}
+\`\`\`
+
+### 3️⃣ 引入参数对象
+
+**场景**：参数过多
+
+**示例**：
+\`\`\`typescript
+// Before
+function createUser(name, email, age, address, phone, country) {
+  // ...
+}
+
+// After
+interface UserData {
+  name: string;
+  email: string;
+  age: number;
+  address: string;
+  phone: string;
+  country: string;
+}
+
+function createUser(userData: UserData) {
+  // ...
+}
+\`\`\`
+
+### 4️⃣ 替换魔法数字
+
+**示例**：
+\`\`\`typescript
+// Before
+if (status === 1) {
+  // ...
+} else if (status === 2) {
+  // ...
+}
+
+// After
+enum OrderStatus {
+  PENDING = 1,
+  PROCESSING = 2,
+  COMPLETED = 3
+}
+
+if (status === OrderStatus.PENDING) {
+  // ...
+} else if (status === OrderStatus.PROCESSING) {
+  // ...
+}
+\`\`\`
+
+### 5️⃣ 组合函数调用
+
+**示例**：
+\`\`\`typescript
+// Before
+const data = getData();
+const filtered = filterData(data);
+const sorted = sortData(filtered);
+const formatted = formatData(sorted);
+
+// After
+const result = getData()
+  .then(filterData)
+  .then(sortData)
+  .then(formatData);
+
+// Or using pipe
+const result = pipe(
+  getData,
+  filterData,
+  sortData,
+  formatData
+)();
+\`\`\`
+
+---
+
+## 重构计划模板
+
+### 🎯 重构目标
+简要说明重构的目的和预期效果
+
+### 📋 问题清单
+1. **问题 1**：重复代码
+   - 位置：第 10-20 行、第 50-60 行
+   - 影响：可维护性差
+   - 优先级：🔴 Critical
+
+2. **问题 2**：函数过长
+   - 位置：processData() 函数
+   - 影响：难以理解和测试
+   - 优先级：🟡 Important
+
+### 🔧 重构步骤
+
+**步骤 1：准备**
+- [x] 确保测试覆盖率 > 80%
+- [x] 备份当前代码
+- [x] 创建重构分支
+
+**步骤 2：小步重构**
+1. 提取 calculateTotal 函数
+   - 风险：低
+   - 预计时间：10 分钟
+   - 测试：运行单元测试
+
+2. 简化条件判断
+   - 风险：低
+   - 预计时间：15 分钟
+   - 测试：运行集成测试
+
+3. 引入参数对象
+   - 风险：中
+   - 预计时间：30 分钟
+   - 测试：全量测试
+
+**步骤 3：验证**
+- [ ] 所有测试通过
+- [ ] 代码审查
+- [ ] 性能对比
+- [ ] 部署到测试环境
+
+### ⚠️ 风险评估
+
+**高风险操作**：
+- 修改公共 API
+- 改变数据结构
+- 调整核心算法
+
+**降低风险的措施**：
+- 渐进式重构（小步快跑）
+- 每步都运行测试
+- 保持功能不变
+- Code Review
+
+### 📊 预期收益
+
+**可维护性**：⬆️ 30%
+- 代码行数减少 20%
+- 圈复杂度降低 40%
+
+**可测试性**：⬆️ 50%
+- 函数职责单一
+- 依赖可注入
+
+**性能**：⬆️ 10%
+- 减少重复计算
+- 优化算法复杂度
+
+---
+
+现在请分析代码，提供详细的重构建议和实施计划。`;
+        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/resolve_conflict.d.ts

@@ -0,0 +1,13 @@
+export declare function resolveConflict(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/resolve_conflict.js

@@ -0,0 +1,338 @@
+// resolve_conflict 工具实现
+export async function resolveConflict(args) {
+    try {
+        const conflicts = args?.conflicts || "";
+        const message = `请分析并解决以下 Git 冲突：
+
+⚔️ **冲突内容**：
+${conflicts || "请提供 git diff 或冲突文件内容"}
+
+---
+
+## Git 冲突解决流程
+
+### 第一步：识别冲突
+
+执行以下命令查看冲突：
+\`\`\`bash
+# 查看冲突文件列表
+git status
+
+# 查看具体冲突
+git diff
+
+# 或查看单个文件冲突
+git diff --ours --theirs filename
+\`\`\`
+
+### 第二步：理解冲突标记
+
+**冲突格式：**
+\`\`\`
+<<<<<<< HEAD (当前分支)
+你的修改
+=======
+他人的修改
+>>>>>>> branch-name (合并的分支)
+\`\`\`
+
+**示例冲突：**
+\`\`\`javascript
+function calculateTotal(items) {
+<<<<<<< HEAD
+  // 你的修改：添加了折扣
+  const subtotal = items.reduce((sum, item) => sum + item.price, 0);
+  return subtotal * 0.9; // 10% 折扣
+=======
+  // 他人的修改：添加了税费
+  const subtotal = items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+  return subtotal * 1.1; // 10% 税费
+>>>>>>> feature/add-tax
+}
+\`\`\`
+
+---
+
+## 冲突分析
+
+### 🔍 冲突类型识别
+
+**1️⃣ 简单冲突（二选一）**
+- 两个分支修改了同一行
+- 通常选择其中一个版本
+
+**2️⃣ 复杂冲突（需要合并）**
+- 两个分支都添加了有用的功能
+- 需要整合双方的修改
+
+**3️⃣ 语义冲突**
+- 语法上没冲突，但逻辑上不兼容
+- 需要重新设计
+
+**4️⃣ 结构冲突**
+- 文件被移动或删除
+- 需要决定文件的最终状态
+
+---
+
+## 解决策略
+
+### 策略 1：保留当前分支（ours）
+\`\`\`bash
+git checkout --ours filename
+git add filename
+\`\`\`
+
+### 策略 2：保留对方分支（theirs）
+\`\`\`bash
+git checkout --theirs filename
+git add filename
+\`\`\`
+
+### 策略 3：手动合并（推荐）
+
+**步骤：**
+1. 分析双方的修改意图
+2. 整合有价值的修改
+3. 删除冲突标记
+4. 测试合并后的代码
+
+**合并示例：**
+\`\`\`javascript
+// 原始冲突
+function calculateTotal(items) {
+<<<<<<< HEAD
+  const subtotal = items.reduce((sum, item) => sum + item.price, 0);
+  return subtotal * 0.9; // 10% 折扣
+=======
+  const subtotal = items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+  return subtotal * 1.1; // 10% 税费
+>>>>>>> feature/add-tax
+}
+
+// ✅ 合并后（整合双方修改）
+function calculateTotal(items, { discount = 0, taxRate = 0.1 } = {}) {
+  // 整合了数量计算（theirs）和参数化设计（改进）
+  const subtotal = items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+  const afterDiscount = subtotal * (1 - discount);
+  return afterDiscount * (1 + taxRate);
+}
+\`\`\`
+
+---
+
+## 常见冲突场景
+
+### 场景 1：Import 语句冲突
+\`\`\`typescript
+<<<<<<< HEAD
+import { Button, Input } from './components';
+import { api } from './services';
+=======
+import { Button, Select } from './components';
+import { fetchData } from './utils';
+>>>>>>> feature/add-select
+
+// ✅ 合并后
+import { Button, Input, Select } from './components';
+import { api } from './services';
+import { fetchData } from './utils';
+\`\`\`
+
+### 场景 2：配置文件冲突
+\`\`\`json
+<<<<<<< HEAD
+{
+  "name": "my-app",
+  "version": "1.2.0",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  }
+}
+=======
+{
+  "name": "my-app",
+  "version": "1.1.0",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "test": "jest"
+  }
+}
+>>>>>>> feature/add-tests
+
+// ✅ 合并后（保留最新版本号和所有脚本）
+{
+  "name": "my-app",
+  "version": "1.2.0",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "test": "jest"
+  }
+}
+\`\`\`
+
+### 场景 3：函数重构冲突
+\`\`\`typescript
+<<<<<<< HEAD
+// 你将同步改为异步
+async function getUserData(id) {
+  const response = await fetch(\`/api/users/\${id}\`);
+  return response.json();
+}
+=======
+// 他人添加了缓存
+function getUserData(id) {
+  if (cache.has(id)) {
+    return cache.get(id);
+  }
+  const data = fetchUser(id);
+  cache.set(id, data);
+  return data;
+}
+>>>>>>> feature/add-cache
+
+// ✅ 合并后（异步 + 缓存）
+async function getUserData(id) {
+  if (cache.has(id)) {
+    return cache.get(id);
+  }
+  const response = await fetch(\`/api/users/\${id}\`);
+  const data = await response.json();
+  cache.set(id, data);
+  return data;
+}
+\`\`\`
+
+---
+
+## 解决步骤
+
+### Step 1: 备份
+\`\`\`bash
+# 创建备份分支
+git branch backup-before-merge
+\`\`\`
+
+### Step 2: 分析冲突
+\`\`\`bash
+# 查看冲突统计
+git diff --stat
+
+# 使用可视化工具
+git mergetool
+\`\`\`
+
+### Step 3: 解决冲突
+1. 打开冲突文件
+2. 分析双方修改
+3. 手动合并代码
+4. 删除冲突标记（<<<, ===, >>>）
+
+### Step 4: 测试
+\`\`\`bash
+# 运行测试
+npm test
+
+# 运行 linter
+npm run lint
+
+# 构建检查
+npm run build
+\`\`\`
+
+### Step 5: 提交
+\`\`\`bash
+# 标记冲突已解决
+git add .
+
+# 完成合并
+git commit
+
+# Git 会自动生成合并消息，或自定义：
+git commit -m "chore: 解决 feature/xxx 合并冲突
+
+- 整合了折扣和税费计算
+- 保留了所有新增功能
+- 所有测试通过"
+\`\`\`
+
+---
+
+## 预防冲突
+
+### 1️⃣ 频繁同步
+\`\`\`bash
+# 每天同步主分支
+git fetch origin
+git rebase origin/main
+\`\`\`
+
+### 2️⃣ 小步提交
+- 提交粒度要小
+- 功能尽量独立
+- 避免大范围重构
+
+### 3️⃣ 代码审查
+- PR 及时 Review
+- 避免长期未合并的分支
+
+### 4️⃣ 使用工具
+- VSCode Git Lens
+- GitKraken
+- Sourcetree
+
+---
+
+## 复杂冲突处理
+
+### 使用 Git Rerere（重用已记录的解决方案）
+\`\`\`bash
+# 启用 rerere
+git config --global rerere.enabled true
+
+# Git 会记住你的冲突解决方式
+# 下次遇到相同冲突时自动应用
+\`\`\`
+
+### 使用三路合并工具
+\`\`\`bash
+# 配置 VSCode 作为合并工具
+git config --global merge.tool vscode
+git config --global mergetool.vscode.cmd 'code --wait $MERGED'
+
+# 使用
+git mergetool
+\`\`\`
+
+---
+
+现在请分析冲突内容，提供：
+1. 冲突原因分析
+2. 双方修改意图
+3. 推荐的合并方案
+4. 完整的解决后代码`;
+        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/split.d.ts

@@ -0,0 +1,13 @@
+export declare function split(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;