SuperAPI AI 工具集

gitnexus-cli

编程与开发

查看项目

更新于 10-16 06:43

技能介绍

用途:面向需要运行 GitNexus CLI 命令的场景,如分析/索引仓库、查看状态、清理索引、生成 wiki、列出已索引仓库。命令以 node .gitnexus/run.cjs <command> 形式调用项目内运行器,该运行器由 gitnexus analyze 生成,调用时自动选择可用运行器(全局 gitnexus、否则 pnpm dlx、否则 npx),无需假设包管理器,也无需全局安装。

主要能力: analyze 构建或刷新索引:node .gitnexus/run.cjs analyze。在项目根目录运行,解析源文件、构建知识图谱、写入 .gitnexus/ 并生成 CLAUDE.md / AGENTS.md。支持 --force(强制全量重建)、--embeddings(启用语义搜索嵌入,默认关闭)、--drop-embeddings(重建时丢弃已有嵌入)。首次使用、重大代码变更后或索引过期时运行。 status 检查索引新鲜度:node .gitnexus/run.cjs status,显示是否有索引、最后更新时间及符号/关系数量。 clean 删除索引:node .gitnexus/run.cjs clean,删除 .gitnexus/ 并从全局注册表注销;支持 --force 跳过确认、--all 清理所有已索引仓库。 wiki 生成文档:node .gitnexus/run.cjs wiki,基于知识图谱用 LLM 生成仓库文档,需 API key(首次保存到 ~/.gitnexus/config.json);支持 --force、--model <model>、--base-url <url>、--api-key <key>、--concurrency <n>、--gist。 list 列出所有已索引仓库:node .gitnexus/run.cjs list,读取 ~/.gitnexus/registry.json。

必要用法:若未分析或运行器缺失(如新克隆或 git clean 后),在项目根目录用 npx gitnexus analyze 重新生成。npm 11.x 下若 npx 安装崩溃(node.target is null),可 npm i -g gitnexus 后 gitnexus analyze,或使用 pnpm --allow-build=@ladybugdb/core --allow-build=gitnexus --allow-build=tree-sitter dlx gitnexus@latest analyze。

索引后:读取 gitnexus://repo/{name}/context 验证索引已加载,并使用其他 GitNexus 技能(exploring、debugging、impact-analysis、refactoring)。

限制与故障排查:须在 git 仓库内运行,否则报 "Not inside a git repository";重新分析后索引若仍显示过期,重启 Claude Code 以重载 MCP 服务器;嵌入较慢时可省略 --embeddings 或设置 OPENAI_API_KEY。以上为资料提供内容,其余细节暂未提供。