GitNexus

加入官方 *** 讨论想法、问题等！

企业版（SaaS 和自托管）- akonlabs.com

为智能体上下文构建神经系统。

将任何代码库索引到知识图谱中——包括所有依赖项、调用链、集群和执行流程——然后通过智能工具公开，确保 AI 智能体不会遗漏代码。

类似于 DeepWiki，但更深入。 DeepWiki 帮助你理解代码。GitNexus 让你分析代码——因为知识图谱追踪所有关系，而不仅仅是描述。

TL;DR： Web UI 是与任何仓库快速交互的方式。CLI + MCP 则让你的 AI 智能体真正可靠——它为 Cursor、Claude Code、Codex 等工具提供代码库的深度架构视图，防止它们遗漏依赖项、破坏调用链和进行盲目编辑。即使是较小的模型也能获得完整的架构清晰度，使其能够与大型模型竞争。

AI 代理可获取的功能

通过 MCP 暴露的16 种工具（11 种仓库级工具 + 5 种组级工具）：

工具	功能描述	`repo`参数
`list_repos`	发现所有已索引的仓库	—
`query`	进程分组混合搜索（BM25 + 语义搜索 + RRF）	可选
`context`	360 度符号视图 — 分类引用、进程参与情况	可选
`impact`	带深度分组和置信度的影响范围分析	可选
`detect_changes`	Git 差异影响 — 将变更行映射到受影响的进程	可选
`rename`	结合图谱和文本搜索的多文件协同重命名	可选
`cypher`	原始 Cypher 图谱查询	可选
`group_list`	列出已配置的仓库组	—
`group_sync`	提取契约并跨仓库/服务匹配	—
`group_contracts`	检查提取的契约和交叉链接	—
`group_query`	搜索组内所有仓库的执行流程	—
`group_status`	检查组内仓库的索引时效性	—

当仅索引了一个仓库时，repo参数为可选。若有多个仓库，需指定具体仓库：query({query: "auth", repo: "my-app"})。

用于即时上下文的资源：

资源	用途
`gitnexus://repos`	列出所有已索引的仓库（首先阅读此内容）
`gitnexus://repo/{name}/context`	代码库统计信息、时效性检查和可用工具
`gitnexus://repo/{name}/clusters`	所有功能集群及内聚分数
`gitnexus://repo/{name}/cluster/{name}`	集群成员及详细信息
`gitnexus://repo/{name}/processes`	所有执行流程
`gitnexus://repo/{name}/process/{name}`	带步骤的完整流程跟踪
`gitnexus://repo/{name}/schema`	Cypher 查询的图谱模式

用于引导式工作流的2 个 MCP 提示词：

提示词	功能描述
`detect_impact`	提交前变更分析 — 范围、受影响流程、风险等级
`generate_map`	基于知识图谱生成架构文档（含 mermaid 图表）

自动安装到 .claude/skills/ 的4 种代理技能：

探索 — 使用知识图谱导航不熟悉的代码
调试 — 通过调用链追踪 bug
影响分析 — 变更前分析影响范围
重构 — 利用依赖映射规划安全重构

通过 --skills 生成的仓库特定技能：

运行 gitnexus analyze --skills 时，GitNexus 会检测代码库的功能区域（通过 Leiden 社区检测算法），并在 .claude/skills/generated/ 下为每个区域生成 SKILL.md 文件。每个技能文件描述模块的关键文件、入口点、执行流程和跨区域连接 — 使 AI 代理能够获取你正在处理的特定代码区域的精准上下文。技能会在每次 --skills 运行时重新生成，以保持与代码库的同步。

一键部署

docker compose up -d

这会在 http://localhost:4747 启动服务器，并在 http://localhost:4173 启动 Web UI。UI 会自动检测服务器，因为浏览器运行在主机上，可通过映射端口访问容器。

命名卷（gitnexus-data）会持久化全局注册表、索引和克隆的仓库，存储在服务器容器内的 /data/gitnexus 路径。要使主机上的仓库可被索引，请在启动服务栈前设置 WORKSPACE_DIR：

WORKSPACE_DIR=$HOME/code docker compose up -d
# 在服务器容器内，该目录以只读方式挂载到 /workspace。
docker compose exec gitnexus-server gitnexus index /workspace/my-repo

文档生成

从知识图谱生成由 LLM 驱动的文档：

# 需要 LLM API 密钥（如 OPENAI_API_KEY 等）
gitnexus wiki

# 使用自定义模型或服务提供商
gitnexus wiki --model gpt-4o
gitnexus wiki --base-url https://api.anthropic.com/v1

# 强制完全重新生成
gitnexus wiki --force

文档生成器读取已索引的图谱结构，通过 LLM 将文件分组为模块，生成每个模块的文档页面，并创建概览页面——所有内容均包含指向知识图谱的交叉引用。