用途:面向调试场景,当用户询问“为什么 X 失败”“这个错误从哪来”“谁调用了这个方法”或接口返回 500 时,借助 GitNexus 定位缺陷与执行流。
主要能力:gitnexus_query 按错误或症状查找相关代码与执行流;gitnexus_context 查看某符号的调用方、被调用方与所属流程;通过 gitnexus://repo/{name}/process/{name} 读取流程资源以追踪执行链路;gitnexus_cypher 编写自定义调用链查询;detect_changes 查看改动影响,用于排查近期回归。
使用方式:按工作流依次执行 gitnexus_query({query: "<error or symptom>"})、gitnexus_context({name: "<suspect>"}),需要时读取流程资源或用 gitnexus_cypher({query: "MATCH path..."}) 自定义追踪,最后阅读源码确认根因。若提示索引过期,在终端运行 npx gitnexus analyze。
适用场景:报错文本定位、返回值异常的数据流追踪、间歇性失败中的外部调用与异步依赖排查、性能热点(被大量调用的符号)分析、以及近期改动影响评估。
限制:资料未提供支持的平台、语言范围、索引构建成本与性能数据;使用前需已有可用的 GitNexus 索引,否则需先执行分析命令。