修仙家族模拟器5.4
66.55M · 2026-04-08
GitNexus 是一个零服务器的代码智能引擎,可以将任何代码库转换为 AI 可理解的知识图谱。它通过索引代码库中的每个依赖、调用链、集群和执行流程,帮助 AI 智能体深度理解代码结构。
全局安装:
npm install -g gitnexus
或使用 npx(无需安装):
npx gitnexus --version
在任何目录下运行:
npx gitnexus setup
此命令会:
支持的编辑器:
进入你的项目目录:
cd /path/to/your/project
npx gitnexus analyze
这一条命令会完成:
AGENTS.md 和 CLAUDE.md 上下文文件基础用法:
gitnexus analyze [path]
常用选项:
| 选项 | 说明 |
|---|---|
--force | 强制完整重建索引 |
--skip-embeddings | 跳过 embedding 生成(更快) |
--embeddings | 启用 embedding 生成(更慢,搜索更准确) |
--skills | 从检测到的社区生成仓库特定的技能文件 |
--skip-agents-md | 保留自定义的 AGENTS.md/CLAUDE.md 内容 |
--verbose | 显示详细日志,包括跳过的文件 |
示例:
# 快速索引(跳过 embeddings)
npx gitnexus analyze --skip-embeddings
# 强制完全重建索引
npx gitnexus analyze --force
# 生成技能文件
npx gitnexus analyze --skills
# 索引指定路径
npx gitnexus analyze /path/to/repo
gitnexus setup
一次性配置命令,自动为所有支持的 AI 编辑器写入正确的全局 MCP 配置。
gitnexus mcp
为所有已索引的仓库启动 MCP 服务器(stdio 模式)。
gitnexus list
显示所有已建立索引的代码库。
gitnexus status
显示当前仓库的索引状态和统计信息。
gitnexus clean
删除当前仓库的索引数据。
对于大型仓库(如 Linux 内核),GitNexus 会自动分配最多 8GB 堆内存。如需自定义:
NODE_OPTIONS="--max-old-space-size=16384" npx gitnexus analyze
GitNexus 支持智能增量更新。再次运行 analyze 命令只会更新发生变化的部分:
npx gitnexus analyze
如果不需要语义搜索功能,可以跳过 embeddings 生成:
npx gitnexus analyze --skip-embeddings
如果你手动编辑了 AGENTS.md 或 CLAUDE.md,使用 --skip-agents-md 保留修改:
npx gitnexus analyze --skip-agents-md
GitNexus 为 Claude Code 提供最深度的集成:
使用流程:
# 1. 配置(仅首次)
npx gitnexus setup
# 2. 索引项目
cd /path/to/your/project
npx gitnexus analyze
# 3. 在 Claude Code 中打开项目
# AI 将自动获得代码库的深度理解能力
通过 MCP 协议集成:
# 配置
npx gitnexus setup
# 索引
npx gitnexus analyze
索引完成后,会在项目根目录生成:
包含面向 AI 智能体的代码库概览,包括:
Claude Code 专用的上下文文件,包含:
索引数据目录(自动管理,无需手动修改)
在克隆新项目后立即索引:
git clone
cd repo
npx gitnexus analyze
在重大代码变更后重新索引:
git pull
npx gitnexus analyze
对于超大型项目:
# 跳过 embeddings,仅索引结构
npx gitnexus analyze --skip-embeddings --verbose
让 AI 更好地理解项目特定的模式:
npx gitnexus analyze --skills
A: 取决于项目大小:
A: GitNexus 支持主流编程语言,包括:
A: 索引数据存储在项目的 .gitnexus/ 目录中,可以安全地添加到 .gitignore。
A: 使用 clean 命令:
gitnexus clean
A: 重新运行 setup 命令:
npx gitnexus setup --force
GitNexus 通过将代码库转换为 AI 可理解的知识图谱,显著提升了 AI 编程助手的代码理解能力。
核心工作流:
# 1. 一次性配置
npx gitnexus setup
# 2. 每个项目索引一次
cd /path/to/project
npx gitnexus analyze
# 3. 在 AI 编辑器中享受增强的代码理解能力
开始使用 GitNexus,让 AI 真正理解你的代码!