GitNexus 接入 Antigravity(Gemini CLI)指南:AfterTool 钩子怎么用

GitNexus 接入 Antigravity(Gemini CLI)指南:AfterTool 钩子怎么用 GitNexus 接入 AntigravityGemini CLI指南AfterTool 钩子怎么用【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexusGitNexus是一款零服务端代码智能引擎它把 Git 仓库变成可交互的知识图谱并内置 Graph RAG Agent。本文带你快速完成GitNexus 接入 Antigravity的完整配置只需一条gitnexus setup命令即可把 GitNexus 的 MCP 工具、Agent 技能和AfterTool 钩子自动写入 AntigravityGemini CLI配置让 AI 在每次搜索代码后自动附加图谱上下文。为什么需要 AfterTool 钩子GitNexus 在 Antigravity 中获得完全支持FullMCP 技能 钩子三件套。钩子是它最独特的部分图谱增强Augment当你用search_file_content、glob或在 shell 里跑rg/grep搜索代码后钩子会在工具结果后自动追加知识图谱上下文调用链、依赖关系、影响范围AI 拿到的不再是一堆文件路径而是带着结构信息的搜索结果。索引过期提醒Stale-index当git commit / merge / rebase / cherry-pick / pull成功后钩子会检测到索引落后于 HEAD并提示运行gitnexus analyze --index-only刷新图谱。一个关键区别Gemini CLI 钩子规范只有BeforeTool/AfterTool两个事件而非 Claude Code 的 PreToolUse/PostToolUse。由于BeforeTool没有向 Agent 注入文本的通道GitNexus 把增强逻辑放在AfterTool中——通过hookSpecificOutput.additionalContext字段把图谱上下文拼接到工具结果里Agent 能直接看见。适配器源码见 gitnexus-antigravity-hook.cjs。三步完成 GitNexus Antigravity 接入第 1 步索引你的仓库在项目根目录执行npx gitnexus analyze这会在项目下生成.gitnexus/索引目录钩子正是靠它判断当前目录是否已被 GitNexus 管理适配器会向上逐级查找最多 5 层逻辑见 gitnexus-antigravity-hook.cjs。第 2 步一键写入 Antigravity 配置npx gitnexus setup -c antigravitysetup会自动探测已安装的编辑器一次性写入三处配置无需手动编辑安装时会重写钩子脚本路径配置项写入位置作用MCP 服务器~/.gemini/antigravity/mcp_config.json提供query、explain、impact等图谱工具Agent 技能~/.gemini/antigravity/skills/探索、调试、影响分析、重构等技能AfterTool 钩子~/.gemini/settings.json合并写入保留你已有的钩子搜索增强 索引过期提醒各路径的映射关系定义在 editor-targets.ts编辑器自动检测逻辑在 setup.ts。第 3 步重启 Antigravity 会话重新打开 Antigravity / Gemini CLI 会话钩子和 MCP 工具即生效。AfterTool 钩子的工作流程钩子在每次工具调用结束后被触发核心判断逻辑在 buildAfterToolContext 中流程如下定位索引从当前工作目录向上查找.gitnexus/找不到则静默跳过搜索增强如果本次工具是search_file_content、glob或含rg/grep的run_shell_command且执行成功提取搜索词并调用gitnexus augment快速通道冷启动 500ms见 augment.ts把图谱上下文写入additionalContext过期提醒如果成功执行了git commit等写操作且 HEAD 已变生成索引过期提示同样经additionalContext送达 Agent调试模式下同步输出到 stderr并发保护每仓库最多 3 个并发钩子槽位若图谱数据库正被 GitNexus 服务端占用会改为提示使用 MCPquery工具默认 10 分钟节流避免锁竞争——完整防护策略见 runAugment。整个钩子设计为优雅失败任何异常都不打断 Agent 正常工作只有设置GITNEXUS_DEBUG1时才会输出诊断信息。常见问题排查现象原因与解决搜索后没有图谱上下文检查项目内是否存在.gitnexus/目录确认搜索词 ≥3 个字符提示本地 augment 不可用请用 MCP query图谱库正被 GitNexus 服务端持有写锁属正常降级按提示调用 MCPquery即可提交代码后收到过期提醒属预期行为运行gitnexus analyze --index-only刷新即可怀疑钩子未触发设GITNEXUS_DEBUG1后重新搜索查看 stderr 中的跳过原因完整的端到端行为安装 → 真实 git 仓库 → 触发钩子由集成测试覆盖可参考 antigravity-hook-e2e.test.ts 了解钩子契约细节编辑器能力矩阵见 README.md。总结一条npx gitnexus analyze建立索引一条npx gitnexus setup -c antigravity完成全部接入AfterTool 钩子利用 Gemini CLI 的additionalContext通道把图谱搜索增强和索引过期提醒无缝注入 AI 的每次工具调用无需手动编辑 JSONsetup会合并写入并保留你已有的钩子与 MCP 配置升级后重跑一次setup即可。装好后你的 Antigravity / Gemini CLI 会话里的 AI 就不再是盲搜代码而是每次搜索都自带一张代码知识图谱。【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexus创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考