git-lrc 实战：在 Git Commit 时用 AI 做代码审查，告别无声 Bug

AI 编码工具写代码的速度越来越快，但一个微妙的问题也随之放大：AI 会偷偷引入 Bug——删除边界检查、放宽约束、插入昂贵的云服务调用、甚至泄露凭据，而开发者经常直到生产环境出问题才发现。

git-lrc 是一个用 Go 编写的轻量级 CLI 工具，在 git commit 之前自动运行 AI 代码审查，覆盖 10 大风险类别和 100+ 种失效模式。1342 颗 GitHub Stars、跨平台支持、免费层每月 30K LOC，让它在众多 AI 代码审查工具中走出了一条「轻量 + 及时」的路线。

为什么选择在 Commit 阶段做审查？

PR 审查的问题在于时机太晚——有问题的代码已经被提交、推送甚至部署。IDE 扩展的问题是依赖个人习惯——团队成员的编辑器各不相同，无法统一执行。

Commit 是「最佳甜蜜点」：足够早，能在代码进入 Git 历史之前发现问题；又足够通用，Git 是所有开发者共享的唯一工作流步骤。

安装 git-lrc 后，每次 git commit 都会自动触发一次 AI 审查，结果以 Web UI 呈现——包含行内评论、严重级别标记、以及可过滤的问题导航器。

安装与设置

一键安装

Linux / macOS：

curl -L https://hexmos.com/ipm-install | bash && ipm i HexmosTech/git-lrc

Windows（PowerShell）：

iwr https://hexmos.com/ipm-install-ps | iex; ipm i HexmosTech/git-lrc

安装完成后运行一次设置：

git lrc setup

系统会引导你在浏览器中完成两步配置：

1. LiveReview API Key——用 Hexmos 账号登录获取
2. Gemini API Key——从 Google AI Studio 免费获取

整个过程大约 1 分钟，一次设置后所有 Git 仓库自动生效，无需逐个项目配置。

两种审查模式

模式 A：自动审查（Commit 时触发）

git add .
git commit -m "add payment validation"

模式 B：手动审查（Commit 前主动运行）

git add .
git lrc review          # 主动运行 AI 审查
git lrc review --vouch   # 个人担保，跳过 AI 审查
git lrc review --skip    # 跳过本次审查
git commit -m "add payment validation"

审查结果会以 Web UI 形式在浏览器中打开，包含：

• GitHub 风格 Diff——彩色增减代码
• 行内 AI 评论——在问题行上显示严重级别标记
• 审查摘要——AI 发现了什么类型的问题
• 暂存文件列表——一眼看到所有待审查文件
• 问题导航器——按严重程度筛选（Critical / Warning / Info）

三种提交决策

审查完成后，Web UI 底部会显示三个按钮：

审查迭代循环

典型的 AI 生成代码工作流：

1. 用 AI 编码工具生成代码
2. git add . → git lrc review — AI 标记问题
3. 复制问题清单，反馈给 AI 工具修复
4. git add . → git lrc review — AI 再次审查
5. 重复直到满意
6. git lrc review --vouch → git commit — 担保并提交

每次 git lrc review 计为一次迭代。工具会追踪迭代次数和 AI 审查覆盖率。

Vouch（个人担保）

当迭代足够、你对代码满意后：

git lrc review --vouch

这句话的意思是：「我已经审查过这段代码，我承担责任。」 不会运行 AI 审查，但之前的覆盖率统计会被记录。

Skip（跳过）

想直接提交不做任何审查？

git lrc review --skip

没有 AI 审查，没有个人担保。Git 日志会记录本次为 skipped。

Git 日志追踪

每次提交的审查状态会被追加到 git log 信息中：

LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)
LiveReview Pre-Commit Check: vouched (iter:2, coverage:50%)
LiveReview Pre-Commit Check: skipped

• iter ——审查迭代次数。iter:3 = 经过 3 轮审查 → 修复 → 重新审查
• coverage ——最终 diff 中被 AI 审查过的百分比。coverage:85% = 仅 15% 的代码未经 AI 审查

团队可以直接在 git log 中看到哪些提交被审查、担保或跳过，无需额外工具。

Issue Navigator 与 Summary Deck

除了行内评论，git-lrc 还提供两个辅助视图：

Issue Navigator（问题导航器）——将审查结果转换为结构化的可过滤视图。按严重程度（Critical / Warning / Info）、风险类别（Security / Reliability / Performance 等）和代码区域（前端 / 后端 / 配置）筛选。「Send to Claude」一键将当前问题列表传入 AI 编码工具。

Summary Deck（摘要幻灯片）——每次审查自动生成一份幻灯片摘要，用自然语言描述「变更了什么、为什么、存在什么风险」。新成员入职时，不用读几十行 diff，60 秒就能了解变更内容和风险点。

仓库规则：让 AI 审查理解你的风格

一个好的审查者不仅懂语言和框架——它需要懂你的仓库。git-lrc 支持在每个仓库根目录下创建 .lrc/ 目录，把团队约定写成版本控制的规则文件：

lrc config init

.lrc/
├── README.md
├── ignore                # 审查者跳过的文件/路径
└── rules/
    ├── INSTRUCTIONS.md   # 最重要的指引
    ├── design.md
    ├── security.md
    └── style.md

规则示例：

• “可靠性比延迟更重要。”
• “优先使用直接 SQL 而非 ORM 抽象。”
• “避免新增基础设施依赖。”

规则包上限 3000 字符——这个限制是刻意的：几行能改变审查结果的句子，胜过一本无人翻阅的二十页风格指南。

lrc config check    # 离线验证规则、忽略模式和包大小
lrc config preview  # 预览将发送给审查者的确切指令

支持多种 AI 模型

git-lrc 支持 BYOK（Bring Your Own Keys），你可以在 Web UI 中配置：

• Google Gemini（默认，免费 Key 即可使用）
• OpenAI
• Claude（Anthropic）
• DeepSeek
• OpenRouter
• Atlas Cloud
• Anthropic Compatible API

lrc ui

在 UI 中可以添加、更新或重新排序 AI 连接器。默认使用列表中的第一个连接器进行审查。

定价

无需信用卡即可使用免费层。

claude-lrc：Claude Code 内嵌审查

安装 git-lrc 的同时会附带 claude-lrc——相同的审查、担保和跳过功能，以斜杠命令直接嵌入 Claude Code：

git-lrc 适合需要编辑器无关、Commit 时强制执行的团队级审查。claude-lrc 适合直接在 Claude Code 对话中通过自然语言或斜杠命令控制审查流程。

适用场景

• AI 生成代码的质量把控——每次 AI 生成的变更在落地前都经过审查
• 团队代码质量统一——不论用什么编辑器，Commit 是共同工作流
• 持续审查习惯养成——审查嵌入 Commit 流程，无需额外仪式
• 新成员快速融入——Summary Deck 让新成员快速理解变更背景
• 安全/合规审核——审查日志证明哪些代码经过了审查

注意事项

• git-lrc 使用 Hexmos 的 LiveReview API 做审查，代码 diff 会发送到云端处理
• 免费层 30K LOC/月，适合个人开发者和小型项目
• 企业版提供自托管方案，满足数据隐私要求
• 依赖于外部 AI API（默认 Gemini），首次审查需要等待 AI 响应

相关链接

• GitHub 仓库
• 定价页
• claude-lrc