CLI Git-lrc 提交前自动运行的免费AI代码审查

团队里最容易被忽略的环节是“提交前的最后一道检查”。等代码进了 PR、被同事或 CI 拦下来才发现少了对齐、漏了空值判断，既浪费评审时间也打击节奏。现有的 AI 审查工具要么按调用量收费、要么要接一堆云服务，对小团队和个人开发者不够轻量。
更理想的做法是：把审查直接嵌进 git commit 这个动作本身——你一提交，AI 就先帮你过一遍，能改当场改，过不了就提示你 vouch 或跳过。git-lrc 做的就是这件事，而且强调“免费、微审查、可本地跑”。

项目基本信息

一、项目介绍

HexmosTech/git-lrc（LiveReview Commit）是一个免费、微型的 AI 代码审查工具，它挂载在 git commit 上，在你提交时自动触发轻量级 AI 审查。它支持多语言文档，提供 Commit / Commit & Push / Skip 等提交前交互，并可切换到 agent 模式做更深入的检查。审查引擎可本地安装与更新（git lrc graph install），整个流程对单人开发者和小型团队都很轻。协议方面仓库采用基于 fair-code 的源码可见许可（非标准 SPDX），按需留意商用条款。

二、核心优势

1. 提交即审查：把 AI review 嵌进 git commit 动作，不用额外开工具或切平台。
2. 免费且轻量：官方定位“免费、微型”，单仓库审查开销小，适合个人与小团队。
3. 本地引擎：git lrc graph install 在本地装好审查引擎，可减少对外部服务的依赖。
4. 灵活放行：review 支持 --vouch（本人担保跳过）、--skip（直接跳过）、--agent-mode（深度模式）。
5. 多平台：Linux/macOS 一行脚本安装，Windows 用 PowerShell 一行安装，跨平台一致。

三、适用场景

• 个人开发者在每次提交前做低成本自检，提前抓出明显问题。
• 小团队把审查前置到 commit，减少 PR 阶段的无谓往返。
• 作为 CI 之外的“第一道本地关卡”，快速覆盖基础规范。
• 想在本地完成审查、不希望代码频繁外传的场景。

四、安装教程

Linux / macOS 一行安装：

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

Windows（PowerShell）：

iwr -useb https://hexmos.com/lrc-install.ps1 | iex

安装后初始化：

git lrc setup

常见报错：若 curl 管道安装报权限问题，可先下载脚本再 chmod +x 后运行；Windows 执行策略拦截用 Set-ExecutionPolicy -Scope Process RemoteSigned。

五、使用示例

正常提交时审查会自动触发：

git add .
git lrc review          # 先跑 AI 审查
git commit -m "add payment validation"

也可以跳过或本人担保：

git lrc review --vouch   # 自己担保，跳过 AI
git lrc review --skip    # 完全跳过审查

真实输出示意：

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

六、常见问题

Q：git-lrc 和 PR 上的 AI 审查重复吗？
A：不冲突。git-lrc 是提交前的本地/轻量第一道关，PR 审查是协作层把关，两者层级不同。
Q：代码会被上传到云端吗？
A：可通过 git lrc graph install 在本地运行审查引擎；是否外传取决于你选用的模型/服务配置。
Q：协议能商用吗？
A：仓库使用基于 fair-code 的源码可见许可（非标准 SPDX），商使用前请阅读 LICENSE 原文与商用条款。

七、总结

git-lrc 把 AI 代码审查前置到 git commit，用最低摩擦给每次提交加一道“免费自检”。对个人和小团队，它是降低低级错误、减少 PR 往返的轻量利器；源码可见许可下可自用与定制，介入提交链前建议读清商用条款。