code-context-tools 面向需要为代码智能体提供仓库上下文的开发者,核心用途是帮助在几类上下文工具之间做选择,并对它们进行可比的测量。资料列出四类候选:repo-map、代码图谱、语义搜索和检索器;适用触发场景包括用户询问该用哪种工具给智能体提供仓库上下文、需要在 repo-map、图谱、语义搜索或检索器之间取舍,以及要测量或比较这类工具。
主要能力体现在一张按需求分派的工具对照表:开始工作时做定向可用 graft map;判断改动会破坏什么可用 GitNexus impact;查看符号 360 视图可用 GitNexus context;查询谁调用了某个符号可用 graft callers;为 PR 评估影响范围可用 graft blast;按行为搜索可用 jevgrep 或 semble;字面搜索可用 tgrep。资料强调这些工具并不互相竞争,而是分担不同工作。同时资料也列出不宜当作检索器使用的选项,并给出这些选项在非字面 R@5 指标上的实测数值,以及“会话内近因”作为基线、完美天花板 0.877 等参照。
使用方式包括:在测量前先运行工具自带的 doctor 并确认配置完整;不要比较样本量不同的部分运行结果;报告指标时始终附带样本量 n。资料给出了在 Mac 上的安装命令示例,并提示 bun 会因安全原因阻止 postinstall、tree-sitter-kotlin 没有预编译产物等实际问题;GitNexus 可通过环境变量跳过可选 grammar,其 analyze --embeddings 接收数字而非路径,缺少该值会令 VECTOR 扩展未安装,而 VECTOR 扩展决定是否具备语义能力。资料还说明 Graft 在没有图谱时 ask 会以退出码 0 返回空结果,init 默认会写多个全局配置,建议使用限定参数;从 shell 读取 GitNexus 输出时不要把 CLI 原始输出直接送入 JSON 解析器。
适用场景包括:为代码智能体选择上下文工具、评测上下文工具、在真实仓库上比较检索效果,以及把此类工具安全接入用户仓库。安全接入规则包括先 dry-run、只做被要求的事、备份被修改的文件、用 git status 确认未改动代码文件、未经同意不提交。
限制与提醒:资料中的数值来自特定日期与特定样本的测量,不能当作通用效果或价格依据;修复脚本失败三次后应撤下并手工验证;验证 GitNexus 时要用仓库中真实存在的符号,避免使用易歧义的泛化名称。