用途:在用户调试 bug、追踪错误或询问“为什么失败”时使用,例如“为什么 X 失败”“这个错误来自哪里”“谁调用了这个方法”“该接口返回 500”。
主要能力:借助 GitNexus 的代码图谱定位与错误相关的执行流程和符号;查看可疑函数的调用者、被调用者与所属流程;追踪执行流程;必要时用 Cypher 自定义调用链查询;用 detect_changes 查看改动影响。
使用方式(工作流):
- query({query: "<error or symptom>"}) 查找相关执行流程;
- context({name: "<suspect>"}) 查看调用者/被调用者/流程;
- READ gitnexus://repo/{name}/process/{name} 追踪执行流程;
- cypher({query: "MATCH path..."}) 需要时做自定义追踪。 若提示“Index is stale”,在终端运行 node .gitnexus/run.cjs analyze。
调试模式:错误信息用 query 检索错误文本再对抛出点做 context;返回值错误对函数做 context 并追踪被调用者数据流;间歇性失败用 context 查找外部调用与异步依赖;性能问题用 context 找调用者众多的符号(热点路径);近期回归用 detect_changes 查看改动影响。
适用场景:排查 bug、错误与异常行为,追踪调用链与执行流程。
限制:资料未提供安装方式、收费、平台支持等细节;需已有 GitNexus 索引,索引过期需重新分析。