resolve_conflict
Analyze and resolve Git conflicts by processing git diff output or conflict file content to restore code functionality.
Instructions
【Git 冲突解决】分析并解决 Git 冲突
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| conflicts | No | 冲突内容（git diff 或冲突文件内容） |
Implementation Reference
- src/tools/resolve_conflict.ts:2-340 (handler)The core handler function for the 'resolve_conflict' tool. It constructs a detailed Markdown message guiding the user through Git conflict resolution steps, analysis, strategies, examples, and prevention tips based on the provided conflicts input.export async function resolveConflict(args: any) { 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, }; } }
- src/index.ts:319-332 (schema)Defines the input schema for the resolve_conflict tool in the ListToolsRequestHandler response, specifying an optional 'conflicts' string parameter.{ name: "resolve_conflict", description: "【Git 冲突解决】分析并解决 Git 冲突", inputSchema: { type: "object", properties: { conflicts: { type: "string", description: "冲突内容（git diff 或冲突文件内容）", }, }, required: [], }, },
- src/index.ts:507-508 (registration)Registers and dispatches the resolve_conflict tool in the CallToolRequestHandler switch statement by invoking the resolveConflict function.case "resolve_conflict": return await resolveConflict(args);
- src/tools/index.ts:17-17 (registration)Re-exports the resolveConflict handler from its implementation file for use in the main index.ts.export { resolveConflict } from "./resolve_conflict.js";