用途:重新索引当前仓库的 GitNexus 知识图谱,并验证更新后的统计数据。适合在大型重构(改动 5 个以上文件)、合并大型 PR、陈旧度钩子报告索引落后,或需要“刷新知识图谱”时使用。
重要限制:仅支持 CLI,不存在 MCP 服务器,绝不要用 readMcpResource 访问 gitnexus:// URI。
使用方式:命令均在仓库根目录执行。若工作区索引了多个仓库,可用 --repo <repo-name> 指定目标。
步骤 0 预检:gitnexus 由 npm/mise 安装,mise shim 在项目未激活 node 时可能失败,先运行: gitnexus --version 2>/dev/null || mise use node@25.8.0
步骤 1 查看状态:gitnexus status。若已是最新(lastCommit 与 HEAD 一致),报告“索引已是最新”并停止。
步骤 2 运行索引:gitnexus analyze。若索引疑似损坏或常规分析未发现改动,用 gitnexus analyze --force。命令可能耗时 30–120 秒,取决于代码库规模。
步骤 3 验证:再次运行 gitnexus status。
步骤 4 报告统计:展示 Nodes、Edges、Communities、Flows、Last Commit 的前后对比。
注意事项:analyze 在本地运行,无网络调用;KuzuDB 数据库存放于仓库根目录的 .gitnexus/;大型代码库(1 万以上文件)可能需 2 分钟以上;--force 从头重建,不加则使用增量分析。该技能为自演化技能,执行后可反思并修正说明,但仅针对真实可复现的问题更新。