Git Agent

Overview

GitHubGitHub

Git Agent 是一款使用 Rust 和 egui 构建的原生桌面 Git 客户端，支持 Windows、macOS 和 Linux 平台。它将仓库管理、变更审查、历史探索和冲突解决集中在一个应用中，并提供可选的 AI 辅助功能。 ### 核心能力 - **日常 Git 工作流**：打开、克隆和初始化仓库，组织工作区和标签页；检查暂存与未暂存的变更，执行提交；管理分支、标签、stash，配置远程仓库；获取、拉取和推送；编辑 `.gitignore` 规则并附带逐行语法解释。 - **历史与变更审查**：浏览提交图，按文件或关键字搜索提交；查看提交详情、文件变更和 blame 信息；提供带语法高亮的并排 diff 窗口；创建和应用补丁。 - **分支与冲突解决**：支持 merge、cherry-pick、revert 和 reset；规划交互式 rebase（pick、reword、edit、squash、fixup、drop）；内置三路合并编辑器，可对比两侧、编辑结果、撤销或重做。 - **仓库工具与自定义**：配置 Git Flow 工作流；添加 submodule 和 subtree；配置 Git LFS；支持自定义 Git 操作和性能诊断；提供中英文界面、明暗主题、强调色及字体设置；可通过纯数据语言插件扩展语法高亮。 ### AI 辅助功能 Git Agent 提供两项可选的 AI 功能，均需要用户自行配置兼容 OpenAI Chat Completions 或 Claude Messages 格式的模型提供商： - **AI 生成提交信息**（v1.4.1+）：根据已暂存的 diff 和相关上下文生成 conventional commit 格式的提交信息，支持英文或中文输出。生成过程不会自动提交或推送，需人工审查。 - **AI 辅助合并**：在三路合并编辑器中请求 AI 分析冲突，获取解释和建议的解决方案。用户可选择性应用建议（v1.4.0 起支持一键应用所有可行建议），最终保存前仍需人工检查代码并运行测试。 ### 运行要求 系统必须安装 Git 并在 `PATH` 中可用，Git Agent 会调用系统 Git，安装包不包含 Git。远程认证操作需配置 SSH 或 HTTPS 凭据助手。Linux 版本目前提供 Debian 包，其他发行版可从源码构建。macOS 版本为通用构建，采用 ad-hoc 签名。

Q&A

Git Agent 需要安装 Rust 才能使用吗？AI-generated

不需要。使用打包好的安装程序即可运行，无需安装 Rust 或 PowerShell。但系统必须安装 Git 并在 PATH 中可用，因为 Git Agent 会调用系统的 Git。

支持哪些操作系统？AI-generated

支持 Windows x64、macOS（Apple Silicon 和 Intel 通用构建）以及 Linux（目前提供 Debian/Ubuntu amd64 的 deb 包，其他发行版可从源码构建）。

AI 功能会自动提交或推送代码吗？AI-generated

不会。AI 生成的提交信息会直接替换编辑器中的文本，但不会自动提交或推送，需要用户在提交前进行审查。AI 辅助合并的建议也需要用户手动应用和保存。

如何配置 AI 功能？AI-generated

在应用的 Settings → AI 中添加模型配置，选择 API 格式（支持 OpenAI 兼容的 Chat Completions 和 Claude 兼容的 Messages 格式），输入提供商的 base URL、API key 和 model ID，并测试连接。

使用 AI 功能会发送我的代码吗？AI-generated

会。AI 分析会将暂存的 diff、请求的上下文、相关文件内容甚至 Git 历史发送到配置的模型提供商。应用会屏蔽常见的敏感文件名，但这不是秘密扫描器，发送前需自行审查暂存内容。

macOS 上为什么提示无法验证开发者？AI-generated

当前的 macOS 打包脚本使用的是 ad-hoc 签名，而非 Developer ID 公证。如果 macOS 阻止运行，请核实来源并参考 Apple 关于打开下载应用的指南，不要为了启动它而禁用系统级安全检查。

支持哪些 Git 高级操作？AI-generated

支持 merge、cherry-pick、revert、reset、交互式 rebase（含 continue/skip/abort）、创建和应用补丁、配置 Git Flow、管理 submodule 和 subtree、Git LFS 操作等。