用途:当需要理解代码如何工作、查看项目架构、追踪执行流程或探索不熟悉的代码库时使用。典型问题包括"认证是如何工作的""项目结构是什么""展示主要组件""数据库逻辑在哪里"。
主要能力:通过读取 gitnexus 资源并结合 query、context 工具,获取代码库概览、功能区域、执行流程与符号上下文。资源包括:context(统计与过期警告,约150 tokens)、clusters(各功能区域及内聚分数,约300 tokens)、cluster/{name}(区域成员及文件路径,约500 tokens)、process/{name}(逐步执行轨迹,约200 tokens)。query 用于按概念查找相关执行流程并列出符号与文件位置;context 提供符号的360度视图,包括入站调用、出站调用及其所属流程步骤。
使用方式:推荐的探索流程为:1. READ gitnexus://repos 发现已索引仓库;2. READ gitnexus://repo/{name}/context 获取代码库概览并检查索引是否过期;3. 调用 query({query: "<想理解的内容>"}) 查找相关执行流程;4. 对特定符号调用 context({name: "<symbol>"}) 深入查看;5. READ gitnexus://repo/{name}/process/{name} 追踪完整执行流程。若第2步提示"Index is stale",需在终端运行 node .gitnexus/run.cjs analyze。最后可阅读源文件了解实现细节。
适用场景:理解陌生代码、梳理架构、追踪跨符号的调用链、定位与某概念相关的处理流程。
限制:依赖已建立的 GitNexus 索引,索引过期需重新分析;具体平台、收费、价格等信息官方资料暂未提供。