Gito 是一个开源的 AI 代码审查器，使用大语言模型检测 GitHub 拉取请求或本地代码变更中的高置信度、高影响问题，例如安全漏洞、bug 和可维护性问题。它不锁定供应商，可与任何语言模型提供商配合使用。
用途
Gito 用于自动完成代码审查：可在 GitHub 拉取请求上自动运行并将结果以评论形式发布，也可在本地对当前分支与主分支的差异进行分析。适合想要无需等待人工即可获得专家级代码审查的独立开发者、希望在人工审查前发现问题的团队、需要大规模维持高代码质量的开源项目，以及需要自动化质量门禁的 CI/CD 流水线。
主要能力
- 快速：借助并行化 LLM 处理，可在数秒内获得详细代码审查。
- 供应商无关：支持 OpenAI、Anthropic、Google、本地模型等任意语言模型提供商。
- 隐私与安全：代码直接从你的环境（CI/CD 运行器或本地机器）发送到你明确配置的 LLM 提供商；使用本地模型时代码不离开你的网络。Gito 设计为无状态、客户端侧工具，严格零保留策略，不存储、记录或保留代码，且完全开源可审计。
- 通用：支持所有主流编程语言和框架。
- 全面分析：跨安全、性能、可维护性、最佳实践等方面检测问题。
- 质量一致：不疲劳、不带偏见，每次审查质量一致。
- 易于集成：通过 CI/CD 工作流自动审查拉取请求、发布 PR 评论并响应维护者评论。
- 高度灵活：可配置审查规则、严重级别和关注领域，构建自定义工作流。
使用方式
通过 GitHub Actions 审查拉取请求
创建 .github/workflows/gito-code-review.yml 文件，并确保将 LLM_API_KEY 添加到仓库的 GitHub secrets。完成后 PR 将自动收到 AI 代码审查。也可在本地安装 Gito 后在仓库根目录运行 gito deploy，部署向导会引导设置并自动生成或更新所需工作流文件，支持 GitHub Actions 和 GitLab CI。GitLab 可参考 GitLab 设置指南或工作流模板手动配置。
本地安装与运行代码分析
使用 uvx 可跳过安装步骤（如 uvx gito.bot setup、uvx gito.bot review 会按需安装所需内容）。也可用 pip 安装 gito.bot（要求 Python 3.11 / 3.12 / 3.13），或下载 Windows 独立安装程序（包含无需 Python 的可执行文件、自动 PATH 配置、开始菜单快捷方式、易于卸载）。安装后运行一次性交互式设置向导，输入 LLM 配置（API 类型、API 密钥等），配置保存到 ~/.gito/.env；若有 uvx 也可通过 uvx 运行设置命令。本地分析步骤：进入仓库根目录，切换到要审查的分支，运行命令；默认将当前分支与仓库主分支比较，未暂存提交的文件的将被忽略，详见 gito --help。也支持审查远程仓库。
配置
Gito 使用两层配置模型：环境配置定义外部资源和凭据，机器相关且不提交到版本控制；项目配置定义审查行为，可在团队内共享。
- 环境配置：控制 LLM 推理、API 密钥，系统级生效，通过操作系统环境变量或 .env 文件配置，默认位置 ~/.gito/.env。Gito 使用 ai-microcore 实现供应商无关的 LLM 访问。CI 工作流中通过工作流环境变量配置 LLM 设置，API 密钥使用平台密钥管理（GitHub Secrets、GitLab CI Variables）。
- 项目配置：支持在项目根目录放置 .gito/config.toml 进行每仓库定制，采用分层覆盖模型（内置默认 config.toml → 项目配置），只需指定要更改的设置。可运行命令生成内置默认值的完整可编辑副本（创建 .gito/config.toml，拒绝替换已有配置，可用 --force 覆盖）。可配置审查提示词、输出模板、后处理 Python 片段、机器人行为（提及触发、重试、评论处理）、流水线集成（Jira、Linear 等）。
集成
提供 Git 平台（如 GitHub、GitLab）的即用 CI/CD 工作流，支持通过 PR 评论触发、自动发布审查和 PR 生命周期集成；不在列表中的平台可通过自定义 CI/CD 流水线或 CLI 直接使用。支持多种 LLM 提供商/运行时，并集成 Linear 和 Atlassian Jira 等议题跟踪器。还支持使用 Gito 生成文档。
已知限制
在响应 GitHub PR 评论时，Gito 无法修改 .github/workflows 内的文件（例如“Gito fix issue 2”），这是 GitHub 安全限制，阻止工作流使用默认 GITHUB_TOKEN 修改其他工作流文件。使用具有 workflow 作用域的 Personal Access Token (PAT) 可绕过该限制，但不推荐作为变通方法，因为 PAT 权限更广、寿命更长、绑定个人账户，安全性不如默认 GITHUB_TOKEN。
其他信息
许可证为 MIT License。
