GraphMind 代码知识图谱
把本地代码库转成可供 AI 查询、导航和长期记忆的知识图谱。
- Star 数
- ★ 218
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Rust
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude Code · Claude.aiOpenAI API(部分支持)
- 费用
- 有免费版,另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 维护大型仓库的开发者,在修改函数前用
graphmind fn-impact或graphmind diff-impact检查潜在影响范围。 - 不适合
- 需要 Windows 桌面应用而不接受 CLI 的用户
- 只想使用托管式网页服务的团队
- 代码语言不在已列出的 30 种语言中的项目
- 官网
- getgraphmind.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-10-15最新版本 v0.3.7(2026-10-15)
- 源码审查
- 55/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
GraphMind 是一套以 Rust 编写的本地优先代码智能工具,通过 tree-sitter 将仓库解析为函数和文件级知识图谱,并保存在 SQLite 与 JSONL 文件中。它提供 CLI、macOS 桌面应用和基于 stdio 的 MCP 服务器,可接入 Claude Code、Claude Desktop、Cursor、Windsurf、Cline、Zed、Continue、VS Code 与其他 MCP 客户端。检索层结合 FTS5、语义向量和一跳图扩展,并用 RRF 对符号结果排序;源码内容默认不返回,以控制上下文用量。除代码结构外,它还保存决策、模式、约定和问题记录,并能连接多个已注册项目。默认运行不开放端口、不启用遥测,也不需要云服务;嵌入功能可选择本地 ONNX、OpenAI 或 Voyage AI。基础能力采用 MIT 许可证,团队图谱和共享记忆同步则标注为 Pro/Team 层级。
用户先通过 graphmind init 注册并构建项目。Rust 核心使用 tree-sitter 解析受支持的源文件,提取符号、调用点和依赖边,把结构图及 FTS5 索引写入 ~/.graphmind/graphs/<slug>/graph.db,并用增量缓存维护后续构建。配置嵌入提供方后,graphmind build 还会生成向量并写入 embeddings.db;graphmind search 将全文匹配、余弦相似度和调用图扩展结果通过 RRF 合并。CLI 与 MCP 工具可查询符号和完整函数、读取文件、生成文件依赖图、追踪传递调用者、评估 Git 变更影响、检测循环和死代码,并导出 Mermaid、DOT、JSON 或 Obsidian 笔记。记忆功能把决策、模式、约定、缺陷和上下文写入项目级或全局 JSONL,通过 Claude Code 钩子或 MCP 指令自动召回。跨项目命令还能搜索所有注册仓库、推断共享符号关系并查看项目间依赖。
- 维护大型仓库的开发者,在修改函数前用
graphmind fn-impact或graphmind diff-impact检查潜在影响范围。 - 使用 Claude Code 或 Cursor 的团队,希望让助手直接查询符号、调用关系和架构,而不是反复读取完整仓库。
- 同时维护 API、前端和共享库的工程团队,需要跨已注册项目搜索符号并追踪项目间依赖。
- 接手陌生代码库的开发者,希望快速查看关键文件、层次化符号大纲、循环依赖和无入边符号。
- 希望跨 AI 会话保留架构决策、编码约定、已知缺陷和业务上下文的个人或团队。
- 需要把局部或跨项目代码图导出为 Mermaid、Graphviz DOT、JSON 或 Obsidian 知识库的架构人员。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://raw.githubusercontent.com/aouicher/graphmind/main/scripts/install.sh | bashbrew install aouicher/graphmind/graphmindbrew install --cask aouicher/graphmind/graphmind
- 配置文件
~/.local/bin/graphmind~/.graphmind/config.json- 安装说明涉及
- macOS · Linux
如何安装或部署这个 Agent?
macOS 用户可从 GitHub Releases 下载对应的 GraphMind-macos-arm64.dmg 或 GraphMind-macos-x64.dmg;桌面应用会安装 CLI,并通过引导配置 MCP、钩子、技能和嵌入。
macOS 或 Linux 也可使用安装脚本:
curl -fsSL https://raw.githubusercontent.com/aouicher/graphmind/main/scripts/install.sh | bash或通过 Homebrew 安装 CLI:
brew install aouicher/graphmind/graphmindmacOS 桌面应用也可通过 Homebrew 安装:
brew install --cask aouicher/graphmind/graphmindLinux x64 可直接下载 CLI:
curl -fsSL https://github.com/aouicher/graphmind/releases/latest/download/graphmind-cli-linux-x64 -o ~/.local/bin/graphmind
chmod +x ~/.local/bin/graphmind从源码构建需要 Rust/Cargo:
git clone https://github.com/aouicher/graphmind
cd graphmind
cargo build --release -p graphmind-cli
cp target/release/graphmind ~/.local/bin/默认关闭嵌入,因此首次使用不需要 API 密钥。若选择 OpenAI 或 Voyage AI 嵌入,需要在 ~/.graphmind/config.json 中配置相应密钥。
如何使用这个 Agent?
先执行一次全局设置,再在每个代码仓库中初始化:
graphmind setup
cd ~/projects/myapp
graphmind initsetup 配置 PATH、Claude Code 钩子与技能,以及 Claude Desktop、Claude Code、OpenCode 和 Cursor 的 MCP 设置;init 注册当前目录、安装 Git 钩子、构建图谱,并写入支持的项目级 MCP 配置。两条命令均可安全重复执行。
完成构建后,可直接从终端查询:
graphmind search "authentication flow"
graphmind fn validate_token --include-content
graphmind deps src/services/auth.ts
graphmind diff-impact
graphmind dead-code --kind function
graphmind cycles
graphmind export -f mermaid如需持久化项目知识,可使用:
graphmind memory add "Authentication tokens are validated by AuthService"
graphmind memory search "authentication"
graphmind memory list本地嵌入模式无需 API 密钥;若要启用它,可在配置文件中选择本地模型:
{
"embedding": {
"mode": "local",
"model": "nomic-embed-text-v1.5"
}
}然后生成嵌入:
graphmind embed --runMCP 客户端通过 stdio 启动服务:
graphmind mcp这个 Agent 有哪些优点和局限?
- 结构图、FTS5、语义向量和调用图扩展集中在同一检索流程中,结果还标明来自 FTS、语义或图扩展。
- 默认完全本地运行,不开放端口、不启用遥测;图谱、嵌入和记忆均保存在可检查的 SQLite 或 JSONL 文件中。
- 除符号搜索外,还覆盖调用链、变更影响、循环依赖、死代码、事件监听器和跨项目关系等具体工程任务。
- 既能独立用作 CLI,也能通过 stdio MCP 接入多种编辑器和 AI 助手,并提供 Claude Code 钩子进行自动上下文注入。
- 支持 30 种语言,并提供增量构建、Git 提交后重建和推送前影响检查。
- 桌面应用的安装资产只列出 macOS;Linux 和 Windows 用户需要使用 CLI。
- 语义搜索在新安装中默认关闭;启用后需要本地 ONNX 模型,或配置 OpenAI/Voyage AI 密钥并承担相应网络与服务依赖。
- 自动改写 grep、find 和 rg 的 Claude Code 钩子会介入既有搜索工作流,团队需要评估其行为和五分钟缓存机制。
- 团队图谱同步和共享记忆工具属于 Pro/Team 层级,免费层无法获得完整团队同步能力。
- README 给出了令牌节省基准,但没有提供独立验证、准确率评测或与其他代码图谱工具的质量对比。
这个 Agent 与同类方案有什么区别?
与直接运行 grep -r 并把原始匹配交给模型相比,GraphMind 先建立符号与依赖图,再返回经过 FTS、语义检索和图扩展排序的紧凑结果。项目给出的基准是在约 10 万行代码上,GraphMind 输出少于 300 个 token,而原始 grep 输出超过 150 万个 token;这是仓库自身报告的测试结果。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| GraphMind 代码知识图谱 当前 | 55 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 218 | 1 个月前 | Rust | Claude Code · Claude.ai |
| Gortex 代码智能引擎 | 73 · 存在缺口 | 命令行工具免费 | ★ 2.1k | 今天 | Go | Codex · Claude Code · OpenAI API · Claude API |
| Ori Mnemos | 56 · 缺口较多 | 命令行工具免费 | ★ 337 | 1 个月前 | TypeScript | Claude Code · OpenAI API · Claude API |
| mex 项目记忆 | 84 · 表现良好 | 命令行工具免费 | ★ 1.8k | 2 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
代码与文档显示工具主要通过本地 stdio MCP、SQLite 和 JSONL 工作,网络请求用于可选的 OpenAI/Voyage 嵌入,且默认禁用嵌入;因此最小权限和数据流有一定说明(各 2)。setup/init 会改写配置、PATH、hooks、MCP 条目并建立索引,文档说明备份、保留用户编辑内容及部分解析失败时的处理,但没有普遍逐项确认流程(用户确认 1),也未见对记忆和 API 密钥的具体保护措施(敏感数据 1)。依赖安全仅有 Cargo 工作区和 CI 信息,样本未展示审计或漏洞缓解机制(1)。外部副作用及其适用范围说明较细(2),备份、幂等和卸载命令提供部分回退路径(2)。仓库含安全联系地址和版权信息,但发布者身份未核实,维护归属仍不充分(来源归属 2)。
README 声称 25 个 MCP 工具,架构和 CLAUDE.md 写 27 个,且所列工具数量与数字未能从样本统一核对,自洽性因此偏低(1)。CI 配置显示有多平台构建和多组测试,但外部模型服务、安装分发和解析器依赖的可用性保障未充分展示(依赖可用性 1)。代码将解析错误转成带文件信息的错误,README 也说明若干配置解析失败时会保留原文件并提示,错误处理达到普通使用水平(2)。
README 覆盖 CLI、桌面端、多种编辑器/MCP 客户端、工作树及不同嵌入模式,常见受众和场景说明充分(2)。文档说明适用边界,例如未注册目录、husky/core.hooksPath、外部会话以及本地与远程嵌入选项(2)。技能说明要求优先使用 GraphMind,但触发范围较宽,并把自动保存记忆设为默认行为,触发精度与控制说明有限(1)。安装覆盖 macOS、Linux、Windows 的不同路径,但桌面端仅列 macOS 资产,平台支持并不完全一致(2)。
README 按安装、配置、搜索、记忆和命令组织,配有大量命令示例,但材料样本未包含全文,架构评分为 2。安装说明细致,列出配置位置、平台差异及手动设置方式(3)。命令与 MCP 名称整体可辨认,但工具计数和部分命名在 README/CLAUDE.md 之间有差异(1)。示例充足,README 以手动设置和场景说明部分回答常见问题,但未见完整 FAQ(2)。已披露若干平台与 hook 限制(2)。MIT 许可证文本和 Cargo 元数据一致(3)。Cargo.toml 有版本号,CI 描述发布流程;样本未含完整变更日志,故给 2。安全政策给出报告邮箱和响应目标,但未核实发布者,也没有明确维护团队或持续维护安排(1)。
CLI、MCP 和记忆查询提供结构化符号、依赖、影响分析及搜索结果,输出具备实用性,但样本未充分显示输出格式本身(2)。图谱、语义搜索、跨项目链接和持久记忆相较原始文本搜索有明显增量用途;令牌节省与准确性等关键收益仍主要是项目自述(2)。需要安装 CLI、注册和构建图谱,部分嵌入还需外部 API;成本与收益没有独立证据量化(1)。
架构、安装、配置、副作用和基准主张有 README 与部分源代码/CI 文件可追溯,但令牌基准及若干产品能力没有样本内的具体测量证据(2)。少数主张可由 README、CLI 源码、Cargo 元数据或 CI 互相印证,但主要能力描述集中在 README,且样本有限(1)。README 对事实、默认值和部分行为作了区分,但基准和效率主张与实现证据之间没有明确标出推断边界(1)。
- README 对 MCP 工具数量的表述与架构和 CLAUDE.md 不一致;评估材料也不是完整仓库。
- 安装与 setup 会修改用户级配置、hooks 和项目索引;运行前应检查涉及路径,并确认这些改动符合预期。
- 嵌入可使用外部服务并配置 API 密钥;样本没有说明密钥存储保护细节。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Fixed - Update checks call curl directly, not through rtk. rtk 1.0 renamed rtk proxy, which graphmind used for its update checks; once rtk drops the old name, those checks would have failed. They never needed rtk. The CLI and the MCP server now share one daily check, so a failed check isn't retried by every MCP server start, and graphmind update reads the release tag from GitHub's JSON. by @aouicher . Thanks @KennethWKZ for spotting the rename. Upgrading Nothing to do.在 GitHub 查看 ↗ -
发布说明摘录
Fixed - A removed worktree no longer lingers. After git worktree remove, the next graphmind list or graphmind build --all (and the desktop app's project list and "build all") forgets the worktree and deletes its graph, so build --all no longer fails on its missing folder. Before, it stayed until another worktree of the repo was registered or graphmind clean --stale ran. Projects registered by hand are not affected. Upgrading Nothing to do. Worktrees removed before this version are forgotten by the first graphmind list or graphmind build --all.在 GitHub 查看 ↗ -
发布说明摘录
Fixed - graphmind update downloads to a file of its own. The new binary is written next to the installed one, under a unique name created for this update, instead of a fixed name in the temp folder: two updates at once no longer corrupt each other, and on a shared machine no other user can put a file in its place. A downloaded binary that crashes now says why. - graphmind build --all says when a project fails. It still builds every project, then exits non-zero and names the projects whose build failed, so a script or hook can tell. …在 GitHub 查看 ↗
常见问题
离线环境可以使用吗?
它会把源码上传到云端吗?
~/.graphmind/,MCP 使用 stdio。只有显式配置 OpenAI/Voyage AI 嵌入或启用 Pro/Team 同步时才涉及网络功能。必须使用 Claude Code 吗?
/gm 技能则针对 Claude Code。写入记忆是否受控?
gm_memory_add 要求明确确认;记忆会持续保存,直到被显式删除。免费版本是否足够个人使用?
GraphMind 代码知识图谱 官网是什么?
GraphMind 代码知识图谱 安全吗?
GraphMind 代码知识图谱 还在维护吗?
GraphMind 代码知识图谱 是谁开发的?
谢谢反馈,我们会据此改进页面。