如何为git-ai接入新的AI Agent支持Claude、Cursor、Copilot等10编码助手【免费下载链接】git-aiA Git extension for tracking the AI-generated code in your repos项目地址: https://gitcode.com/gh_mirrors/git/git-aigit-ai是一款 Git 扩展工具用于追踪仓库中每一行 AI 生成的代码。它会自动为每次提交附加作者归属Authorship Log元数据让团队精确统计 Claude Code、Cursor、GitHub Copilot 等 10 款 AI 编码助手的代码贡献占比。本文是一份面向新手的完整指南带你理解 git-ai 如何识别 AI Agent以及如何为你的新助手接入 git-ai。已支持的 AI Agent 一览git-ai 目前覆盖主流编码助手Claude Code、Cursor、GitHub CopilotVS Code 插件 / CLI / OTEL、Gemini CLI、Codex、Windsurf、Continue、Cline、OpenCode、Pi、Amp、Droid、Firebender以及 JetBrains 与 Visual Studio 生态。各助手的识别逻辑分别位于会话记录解析器src/streams/agents/如 claude.rs、cursor.rs、copilot.rs提交前 Hook 事件预设src/commands/checkpoint_agent/presets/Hook 自动安装器src/mdm/agents/工作原理git-ai 如何区分人写的与AI 写的git-ai 不修改提交历史也不依赖耗时的 Git Hook。当 AI Agent 修改文件时git-ai 通过git-ai checkpoint命令在关键节点做快照把工作区改动精确切分为 Human Edits 与 Agent Edits最终归属信息通过 Git AI 开放标准 v3.0.0 定义的格式存入refs/notes/ai命名空间下的 Git Notes并自动把每一行 AI 代码关联到生成它的提示词prompt——这些会话数据会经过脱敏处理后保存在仓库之外防止密钥与隐私信息泄漏。接入新 Agent 的 4 个关键步骤git-ai 的 Agent 接入遵循三层结构这也是你为新助手开发支持时应该覆盖的模块第 1 步解析 Hook 事件Preset 层Agent 执行改文件、跑 Bash 命令等操作时会向 git-ai 发送 Hook 事件。每个 Agent 对应一个预设Preset负责把原始 JSON 解析为统一的 ParsedHookEventPreFileEdit、PostBashCall 等。以 Cursor 为例cursor.rs 会校验conversation_id、workspace_roots等必填字段并识别 Agent 运行环境你可以参考 2026-04-20-agent-presets-rewrite.md 了解预设体系的重构设计。第 2 步实现会话扫描器Streams 层除了实时 Hookgit-ai 的守护进程daemon还会定期扫库sweep各 Agent 本地保存的会话文件通常是 JSONL/SQLite。以 Cursor 为例streams/agents/cursor.rs 每 30 分钟递归扫描~/.cursor/projects下的对话文件并用 字节偏移水印 记录读取进度避免重复解析。 提示如果你的 Agent 会把对话日志存在本地如~/.claude、~/.codex只需仿照现有 Agent 的Agenttrait 实现即可。第 3 步编写 Hook 安装器MDM 层HookInstaller 接口 定义了check_hooks/install_hooks/uninstall_hooks方法。你的安装器负责检测目标工具是否已安装并把 git-ai 的 Hook 配置写入 Agent 的配置文件支持 dry-run 预览。所有安装器在 get_all_installers() 中统一注册。第 4 步补充测试与夹具每个 Agent 都有对应的集成测试与测试数据例如 tests/integration/cursor.rs 及其夹具 tests/fixtures/cursor-session-simple.jsonl。接入新 Agent 时建议同步添加一份最小化会话夹具保证解析逻辑可回归验证。官方建议对接实现而不是重写标准如果你想让自研 Agent 兼容 git-ai 格式官方标准明确建议直接对接已发布的实现Hook 协议 checkpoint 命令而不是自行实现整套 Git Notes 规范见 specs/git_ai_standard_v3.0.0.md。这样做可以自动获得归属日志序列化、脱敏redaction、统计与 Blame 等全部能力。此外git-ai 还会把内置技能Skills安装到 Claude Code、Cursor 等 Agent 的技能目录中安装逻辑见 src/mdm/skills_installer.rs技能源文件位于 skills/ 目录。验证接入效果stats 与 blame接入完成后两条命令即可验证归属链路是否打通git ai stats # 统计 AI 代码占比、接受率并按工具/模型细分 git ai blame file # 逐行显示每行代码来自人类还是 AI Agent小结层级目录职责Preset 层src/commands/checkpoint_agent/presets/解析 Agent 的实时 Hook 事件Streams 层src/streams/agents/扫描 Agent 本地会话文件MDM 层src/mdm/agents/自动安装/卸载 Hook 配置按照预设解析 → 会话扫描 → Hook 安装 → 集成测试四步走你就能把自己的 AI Agent 顺利接入 git-ai让团队清晰掌握 AI 代码的真实贡献。【免费下载链接】git-aiA Git extension for tracking the AI-generated code in your repos项目地址: https://gitcode.com/gh_mirrors/git/git-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考