GitWand：带智能冲突解决的 Git 客户端

项目简介

GitWand 是一个轻量、原生的 Git 客户端，使用 Tauri 2 与 Vue 3 构建。它覆盖日常 Git 工作流的完整环节——改动、历史、分支、推送与拉取，并在此基础上提供了简单合并冲突的自动解决、内嵌的 PR 代码评审和以 Git Tree 为主的历史视图。

项目采用 MIT 协议，免费使用，代码以 TypeScript 为主。

主要功能

冲突解决引擎

核心引擎（@gitwand/core）会自动解决简单的 Git 合并冲突，从不触碰复杂或有歧义的 hunk。引擎内置 12 种模式，其中 8 种会自动应用，典型包括：

• same_change：两个分支做了完全相同的修改
• delete_no_change：一侧删除了该块，另一侧未改动
• one_side_change：只有一侧修改了该块
• non_overlapping：两侧在同一块的不同位置新增内容
• whitespace_only：逻辑相同，仅缩进或空格不同
• reorder_only：同样的行、不同顺序的纯排列
• insertion_at_boundary：两侧均为纯插入，base 完好
• value_only_change：两侧修改了同一个标量（版本号、哈希、时间戳等）

其余模式如 token_level_merge、refactoring_aware_merge、llm_proposed 需要确认或手动开启；complex 则始终带上完整追踪信息呈现给用户。

历史与仓库视图

• Git Tree：以全分辨率 DAG 渲染分支拓扑，支持主干固定、ref 徽章、WIP 节点；点击提交查看 diff，右键可 checkout、reset、建分支、打 tag、cherry-pick。v3.2 提供过滤模式，可按分支、作者筛选，支持日期分组与 #<PR 号> 查找。
• 仓库视图：侧栏列出已暂存、未暂存、未跟踪与冲突文件，支持行级或 hunk 级部分暂存。
• Diff 查看器：并排或内联切换，30 多种语言语法高亮、词级 diff、折叠未变更区域、canvas 缩略图、hunk 跳转。
• 文件历史与 blame：基于 git log --follow 的完整文件历史，按提交分组的 blame 视图，以及任意两个版本间的时间旅行 diff。

分支、合并与同步

• 分支搜索、切换、新建、删除，单独的合并按钮。
• 合并预览：不触碰工作区即可预测合并结果，逐个文件标注为自动可解、部分可解、需人工处理或增删。
• 一键 push / pull，徽章显示 ahead/behind 数量，每 30 秒后台自动 fetch。

多仓库与工作区

• 仓库切换器展示最近打开的仓库，可固定收藏。
• Workspaces 把多个仓库汇总到一个面板，提供跨仓库状态、协同 push/pull 与快速创建工作树（⌘⇧N）。

Today 与 Pull Requests

• Today（⌘L）是跨仓库的待办收件箱，把进行中的 WIP、PR、Issue 按紧急程度分层，每行带一个状态相关的操作按钮，可固定或稍后处理。
• 支持 GitHub、GitLab、Bitbucket、Azure DevOps 的 PR 浏览、创建、checkout 与合并，从 remote 自动识别平台。
• 支持 GitHub 与 Azure DevOps 的 OAuth device flow 登录，令牌存入系统钥匙串，无需 gh CLI；也支持从 fork 向上游发起 PR。
• 行内评审评论、代码建议块、CI 检查标注直接叠加在 diff 上、Approve / Request changes / Comment 三种评审结论与草稿队列。

终端、编辑器与 AI

• v3.2 的集成终端通过 WebGL 渲染，支持搜索、可点击链接与 shell / claude / codex 分类标签页；「New AI task」会新建一个临时 worktree 并在其中打开 Claude Code 标签，完成后可合并或删除该 worktree。
• Files 面板可停靠、缩放、全屏，基于 git ls-files 列出仓库树，用 CodeMirror 6 打开文件编辑。
• Agents 面板显示活跃的 MCP 会话，可从 GitWand 直接启动 Claude Code；Settings > MCP 中可一键安装 MCP 服务器。
• AI 能力还覆盖分支命名、PR 撰写、hunk 级评审、语义 squash、自然语言提交搜索等。

设置

支持英文、法文、西班牙文、巴西葡萄牙文、简体中文界面；主题（深色/浅色/跟随系统）、提交签名、diff 模式、外部编辑器、Git 二进制路径、切换行为等。AI 提供商支持 API 后端（Claude / OpenAI 兼容 / Ollama）与本地 CLI agent（Claude Code、Codex、opencode、GitHub Copilot CLI）。

安装与使用

从 GitHub Releases 下载对应平台的安装包：

• macOS — .dmg（Universal，Apple Silicon + Intel，已签名并公证）
• Linux — .AppImage 或 .deb
• Windows — .msi 或 .exe

Windows 也可以使用 winget 安装：

winget install Devlint.GitWand

从源码运行（需要 Node 与 pnpm，桌面模式还需要 Rust 工具链）：

git clone https://github.com/devlint/GitWand.git
cd GitWand
pnpm install
cd apps/desktop && pnpm dev:web

如需 Tauri 桌面模式，在 apps/desktop/ 目录下执行 pnpm --filter desktop tauri dev。

注意事项

• 冲突解决引擎只会自动处理简单模式，复杂或有歧义的 hunk 会原样交回人工处理，并附带完整追踪信息。
• 部分模式（如 refactoring_aware_merge、llm_proposed）默认不启用，需要在设置中开启。
• 在 Linux 上运行开发模式时，可能需要设置 WEBKIT_DISABLE_COMPOSITING_MODE=1。
• 项目暂无公开的截图，README 中仅提供了 logo。

---

本作品整理自 GitHub 开源项目 devlint/GitWand，原作者 @devlint，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。