Git-AI：追踪 AI 生成代码的 Git 扩展工具

Git Note 机制

Git-AI 选择使用 Git 原生的 Note 机制存储归属信息。这是一个精妙的设计，优点包括：

• 不污染 commit 历史
• 可以独立同步/备份
• 向后兼容，不影响现有工作流

标准规范

Git-AI 制定了开放标准 Git AI Standard v3.0.0，定义了归属信息的格式，便于第三方工具集成和跨平台数据交换。

快速上手

安装

Mac / Linux / Windows (WSL)：

curl -sSL https://usegitai.com/install.sh | bash

Windows (非 WSL)：

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm http://usegitai.com/install.ps1 | iex"

安装完成后会看到类似输出，提示 Hooks 已更新。重要提示：安装完成后，需要重启终端或执行 source ~/.zshrc 使 PATH 生效。

如果看到提示无法自动安装扩展，需要手动安装：在扩展商店搜索 git-ai-vscode 或在 VSCode 市场访问对应插件页面。

使用前提

Git-AI 需要在有提交历史的仓库中才能正常工作。新仓库直接使用可能会报错，建议先初始化并提交一次：

git init
git add .
git commit -m "initial commit"
git-ai stats # 正常工作

零配置使用

安装完成后，无需任何配置，Git-AI 会自动与支持的 AI 工具集成。正常使用你的 AI 编程工具，正常提交，然后查看 AI 归属即可。

常用命令

命令格式说明：git ai 和 git-ai 两种写法都可以执行命令，但推荐统一使用 git-ai（带连字符）。

# 查看文件的 AI 归属
git-ai blame <file>
# 查看仓库 AI 代码统计（需要有提交历史）
git-ai stats
# 查看特定 commit 的统计
git-ai stats <commit-hash>
# 查看 diff 的 AI 归属注解
git-ai diff <commit-hash>
# 查看某个 prompt 的详情
git-ai show-prompt <prompt-id>
# 查看归属日志（Git Note 内容）
git-ai show <commit-hash>
# 查看未提交的 AI 编辑状态
git-ai status
# 安装/更新 Agent hooks
git-ai install-hooks
# 查看帮助
git-ai --help

企业级应用场景

代码审计与合规

对于企业来说，Git-AI 可以回答关键问题：代码库中有多少比例是 AI 生成的？哪些模块 AI 参与度最高？AI 代码的质量如何？

团队协作洞察

通过 Stats Bot，可以获得 PR 级别的 AI 代码占比、不同 Agent+Model 组合的代码接受率以及 AI 代码的'半衰期'。

最佳实践沉淀

高质量的 prompt 会被保留，团队可以建立 prompt 知识库，新人快速学习有效的 AI 协作方式，持续优化 AI 使用策略。

与传统 git blame 的对比

实战踩坑指南

在实际使用 Git-AI 的过程中，可能会遇到一些问题，这里整理出来供大家参考。

安装后命令不生效

现象：安装完成后执行 git-ai 提示 command not found。

原因：安装脚本修改了配置文件，但当前终端会话没有加载新配置。

解决：重新加载配置 source ~/.zshrc 或重启终端。

Cursor/VSCode 扩展需要手动安装

现象：安装日志显示警告，无法自动安装扩展。

原因：git-ai 无法自动在 GUI 编辑器中安装扩展。

解决：打开编辑器，按快捷键打开扩展面板，搜索 git-ai 或 git-ai-vscode，点击安装并重启编辑器。

安装扩展后 AI 代码仍然不被追踪

现象：用 Cursor AI 改了代码，提交后 git-ai stats 显示 100% 人工。

原因：扩展安装后没有重启编辑器，或者之前的提交不会被追溯标记。

解决：完全退出编辑器重新打开，用 AI 做一些修改，提交前检查 git-ai status 是否捕捉到 AI 编辑，确认有捕捉到后再提交。

SourceTree 等 GUI 工具提交后丢失 AI 追踪

现象：用 SourceTree 提交后，git-ai stats 显示 0% AI。

原因：Git-AI 依赖 Git Hooks 机制，某些 GUI 工具可能跳过 hooks 或使用不同的 git 环境。

解决：推荐使用命令行或 IDE 内置 Git 面板提交。如果必须用 SourceTree，请确保设置中使用系统 Git 且未禁用 hooks。

git ai --help 不工作

现象：git ai --help 输出 No manual entry。

原因：git ai --help 会被 git 解释为查看 man page。

解决：使用连字符写法 git-ai --help。

Git Hook 原理详解

什么是 Git Hooks？

Git Hooks 是 Git 内置的一套事件触发机制。当你执行某个 Git 操作时，Git 会检查 .git/hooks/ 目录下有没有对应名字的脚本，如果有，就自动执行它。

Git-AI 使用了哪些 Hooks？

Git-AI 主要依赖两个 Hook：

• pre-commit：在 commit 前准备和验证 AI 归属数据。
• post-commit：在 commit 后将 AI 归属信息写入 Git Note。

常见问题排查

问题 1：提交后没有 AI 归属信息 检查 hook 是否存在，如果不存在，重新初始化 git-ai。

问题 2：hook 存在但不执行 检查执行权限，添加执行权限 chmod +x .git/hooks/post-commit。

问题 3：使用了 --no-verify 跳过 hooks 这个命令会跳过所有 hooks，导致 AI 归属不会被记录。正确做法是不使用 --no-verify。

Prompt 存储详解

两个存储位置

Git-AI 的数据存储在两个地方：

Git Commit 与 Git Note 的关系

Git Note 是'贴'在 Commit 上的便签纸——不改变 commit 本身，但可以附加额外信息。Commit 会影响 hash，Note 不会。默认情况下，Commit 会 push，但 Notes 不会自动推送，需单独配置。

查看 Git Note 中的归属信息

方法 1：使用 git-ai 命令

git-ai show <commit-hash>

方法 2：使用原生 git 命令

# 列出所有带 AI 归属的 commits
git notes --ref=refs/notes/ai list
# 查看某个 commit 的 note 内容
git notes --ref=refs/notes/ai show <commit-hash>

方法 3：在 git log 中直接显示（推荐）

配置一次，永久生效：

git config notes.displayRef refs/notes/ai

然后 git log 就能直接看到 AI 归属信息。

多人协同：Git Notes 的推送与同步

这是最容易混淆的地方。Commit 时 Note 自动附加，但 push 时 Note 不会自动推送。

配置自动推送/拉取（推荐）

# push 时自动包含 notes
git config --add remote.origin.push refs/notes/ai
# fetch 时自动拉取 notes
git config --add remote.origin.fetch +refs/notes/ai:refs/notes/ai

配置后的效果：git push 代码和 notes 一起推送，git fetch 代码和 notes 一起拉取。

查看使用了哪些 AI 工具

git-ai stats 只显示整体的 AI 代码比例，如果想知道具体使用了哪些 AI 工具，有以下方法：

方法 1：查看某个文件的 AI 归属详情

git-ai blame <文件名>

方法 2：查看某个 commit 的 AI 信息

git-ai show <commit-hash>

方法 3：通过 prompts 数据库查询

# 列出所有 prompts
git-ai prompts list
# 用 SQL 统计使用了哪些 AI 工具和模型
git-ai prompts exec "SELECT DISTINCT json_extract(agent_id, '$.tool') as tool FROM prompts"

常见 AI 工具标识

查看完整的 Prompt 对话

Git Note 里只有精简的元数据，完整的 prompt 对话存储在全局数据库：

# 生成/更新 prompts 数据库
git-ai prompts
# 列出所有 prompts
git-ai prompts list
# 用 SQL 查看完整对话
git-ai prompts exec "SELECT messages FROM prompts WHERE ..."

项目目录下的 prompts.db

运行 git-ai prompts 会在项目目录生成 prompts.db，这是临时分析文件，建议加入 .gitignore：

echo "prompts.db" >> .gitignore

总结

Git-AI 填补了 AI 编程时代的一个重要空白：追踪和管理 AI 生成的代码。它的核心价值在于透明性、可追溯性、工程化和标准化。对于正在大规模采用 AI 编程工具的团队来说，Git-AI 不是'nice to have'，而是即将成为'must have'的基础设施。