git-lrc

git-lrc：为 AI 生成代码打造的自动 Git Hooks 审查系统

在生成式 AI 高速发展的今天，代码产出的速度已达到前所未有的高度。然而，AI 代理在快速生成代码的同时，往往会悄无声息地引入错误：删除核心逻辑、放宽安全约束、引入昂贵的云服务调用，甚至泄露敏感凭据。git-lrc 正是为您准备的“制动系统”，它通过 git-lrc 强大的 AI 审查能力，在每一段代码提交前进行严格把关。

什么是 git-lrc？

git-lrc 是一款基于 Git Hook 的 AI 代码审查工具。它直接嵌入到您的开发流程中，每当您执行 git commit 时，git-lrc 都会自动对暂存区的差异（Diff）进行 AI 分析。它旨在通过 git-lrc 提供的自动化 Review，确保每一行进入仓库的代码都经过了严谨的检查。

git-lrc 是一套源可用的（Source-Available）系统，通过调用 Google Gemini API，为开发者提供完全免费且无限次数的代码审查服务。您只需提供自己的 API 密钥，即可享受企业级的代码质量保障。

git-lrc 的核心功能 (Features)

1. 自动触发的 AI 审查

git-lrc 会在您提交代码时自动运行，利用大语言模型捕捉 AI 代理可能遗漏的问题。通过 git-lrc，您可以轻松发现：

• 逻辑变更与意外的功能删除
• 泄露的凭据与敏感数据
• 昂贵的云操作调用
• 日志中的敏感信息泄露

2. 直观的审查界面 (Review UI)

git-lrc 提供了类似 GitHub 的交互式审查体验：

• GitHub 风格 Diff：清晰的颜色标记增加与删除的内容。
• 内联 AI 评论：在相关代码行直接显示 AI 建议，并附带严重程度标签。
• 审查摘要：提供高层次的代码变更评估。
• 事件日志：追踪审查迭代次数及覆盖范围。

3. 透明的 Git 日志追踪

git-lrc 会在 commit message 后自动附加审查状态。您的团队可以通过 git log 直接看到每个提交的审核情况，包括迭代次数（iter）和覆盖率（coverage）。

4. 灵活的命令操作

git-lrc 支持多种模式，无论是自动提交前审查，还是手动执行 git lrc review，都能完美契合您的工作流。

为什么选择 git-lrc？

• 防止 AI 破坏代码：AI 可能会在不告知的情况下修改边缘案例。git-lrc 能在这些变更上线前将其捕获。
• 全机器覆盖：一次安装，全局生效。无需为每个仓库单独配置，git-lrc 自动接管您机器上的所有 Git 仓库。
• 完全免费：通过直接连接 Gemini API，git-lrc 避免了中间商费用，提供无限次的 Review 额度。

如何使用 git-lrc (How to Use)

第一步：安装

对于 macOS 和 Linux 用户，可以使用以下命令快速安装 git-lrc：

curl -fsSL https://hexmos.com/lrc-install.sh | sudo bash

第二步：一分钟设置

安装完成后，运行设置命令：

git lrc setup

在此过程中，您需要完成两个简单的步骤：

1. 登录 Hexmos 获取 LiveReview API 密钥。
2. 从 Google AI Studio 获取免费的 Gemini API 密钥。

第三步：开始审查工作流

您可以选择两种方式使用 git-lrc：

选项 A：自动审查（推荐）

1. git add .
2. git commit -m "your message"
3. git-lrc 审查界面将自动弹出。

选项 B：手动预览审查

1. git add .
2. git lrc review —— 进行 AI 审查并修复问题。
3. git commit -m "your message" —— 确认无误后提交。

git-lrc 常用命令参考 (Reference)

| 命令 | 说明 | | :--- | :--- | | lrc 或 lrc review | 审查当前暂存的更改 | | lrc review --vouch | 担保——跳过 AI，由个人承担代码责任 | | lrc review --skip | 跳过本次提交的审查 | | lrc review --commit HEAD | 审查已经提交的最近更改 | | lrc hooks disable | 禁用当前仓库的 git-lrc 钩子 | | lrc hooks enable | 重新启用当前仓库的钩子 | | lrc self-update | 更新 git-lrc 到最新版本 |

常见问题解答 (FAQ)

Q: git-lrc 会发送我的哪些代码数据？

A: git-lrc 仅分析暂存区（Staged）的差异（Diff）。它不会上传整个代码库的上下文，且差异数据在审查完成后不会被存储，确保了您的隐私安全。

Q: 我可以针对特定仓库禁用 git-lrc 吗？

A: 可以。只需在对应仓库目录下运行 git lrc hooks disable 即可。若需恢复，请运行 git lrc hooks enable。

Q: git-lrc 的 Review、Vouch 和 Skip 有什么区别？

A:

• Review：AI 介入审查，记录迭代次数并更新 Git 日志。
• Vouch：不进行 AI 审查，但您显式声明对该代码负责。
• Skip：完全跳过审查，不建议在正式提交中使用。

Q: 如果我需要审查以前的提交怎么办？

A: 您可以使用 git lrc review --commit HEAD~1 等命令来回顾之前的代码变更。

立即安装 git-lrc，在下一次提交前，让 AI 为您的代码质量保驾护航！