GitNexus Guide 是关于 GitNexus 本身的快速参考,用于回答用户提出的与 GitNexus 相关的问题,例如可用工具有哪些、如何查询知识图谱、MCP 资源、图谱 schema 或工作流参考。
用途 它汇总了所有 GitNexus MCP 工具、资源和知识图谱 schema,并给出处理代码理解、调试、影响分析或重构任务时的统一起点与技能索引。
推荐起点 对于任何涉及代码理解、调试、影响分析或重构的任务,文档建议:
- 读取 gitnexus://repo/{name}/context —— 获取代码库概览并检查索引新鲜度;
- 将任务匹配到下表中的某个技能并读取该技能文件;
- 按照该技能的工作流与检查清单执行。 如果第 1 步提示索引已过期(stale),需要先在终端运行:node .gitnexus/run.cjs analyze。
技能索引 文档按任务列出应读取的技能文件:
- 理解架构 / “X 是如何工作的?” → gitnexus-exploring
- 影响半径 / “如果我改 X 会破坏什么?” → gitnexus-impact-analysis
- 追踪缺陷 / “为什么 X 失败?” → gitnexus-debugging
- 重命名 / 提取 / 拆分 / 重构 → gitnexus-refactoring
- 工具、资源、schema 参考 → gitnexus-guide(本文档)
- 索引、状态、清理、wiki CLI 命令 → gitnexus-cli
工具参考 文档列出各工具及其提供的能力:
- query:按流程分组的代码智能——与某个概念相关的执行流。
- context:360 度符号视图——分类引用、该符号参与的过程。
- impact:符号影响半径——在深度 1/2/3 上会破坏什么,带置信度。
- detect_changes:Git diff 影响——当前改动会影响什么。
- rename:多文件协同重命名,编辑带置信度标记。
- cypher:原始图谱查询(需先读取 gitnexus://repo/{name}/schema)。
- list_repos:发现已索引仓库(分页——limit/offset)。
list_repos 的分页 list_repos 采用分页,以避免大型注册表被 MCP/LLM 的 token 限制截断。它接受可选的 limit(默认 50,最大 200)和 offset,返回结构如下: { "repositories": [ { "name": "...", "path": "...", "indexedAt": "...", "lastCommit": "...", "stats": { } } ], "pagination": { "total": 437, "limit": 50, "offset": 0, "returned": 50, "hasMore": true, "nextOffset": 50 } } 要枚举全部仓库,持续调用并把 offset 设为 pagination.nextOffset,直到 hasMore 为 false: list_repos {} → repos 1–50, nextOffset 50, hasMore true list_repos { offset: 50 } → repos 51–100, nextOffset 100, hasMore true … list_repos { offset: 400 } → repos 401–437, hasMore false (done) 说明:offset ≥ total 返回空页(仍会报告 total)。超出范围或格式错误的 limit/offset(非整数、limit 不在 [1, 200]、offset < 0)会被明确报错拒绝——limit 超过最大值会被拒绝,而不是静默截断上限。排序是确定性的(先按小写名称,再按路径),因此在注册表不变时分页不会跳过或重复条目。
资源参考 以下为用于导航的轻量读取(约 100–500 tokens):
- gitnexus://repo/{name}/context:统计信息、过期检查
- gitnexus://repo/{name}/clusters:所有功能区域及其内聚分数
- gitnexus://repo/{name}/cluster/{clusterName}:区域成员
- gitnexus://repo/{name}/processes:所有执行流
- gitnexus://repo/{name}/process/{processName}:逐步追踪
- gitnexus://repo/{name}/schema:用于 Cypher 的图谱 schema
图谱 schema 节点:File、Function、Class、Interface、Method、Community、Process。 边(通过 CodeRelation.type):CALLS、IMPORTS、EXTENDS、IMPLEMENTS、DEFINES、MEMBER_OF、STEP_IN_PROCESS。 示例查询: MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"}) RETURN caller.name, caller.filePath
适用场景 适用于询问 GitNexus 本身的能力与用法,包括可用工具、知识图谱查询方式、MCP 资源、图谱 schema、工作流参考与技能选择。
限制 资料未提供 GitNexus 的安装方式、收费与价格信息、支持平台、具体运行效果或使用步骤细节,这些内容暂未提供。