GraphMind 代码知识图谱

把本地代码库转成可供 AI 查询、导航和长期记忆的知识图谱。

Star 数
★ 218
最近更新
1 个月前
License
MIT
主语言
Rust

30 秒速览

运行形态
桌面应用命令行工具MCP 服务器
可在哪里用
通用 · 跨平台Claude Code · Claude.aiOpenAI API(部分支持)
费用
有免费版,另有付费云服务
上手难度
低 · 几分钟可跑通
开始前需要
Shell / 命令行本地文件系统MCP Server
典型场景
维护大型仓库的开发者,在修改函数前用 graphmind fn-impact 或 graphmind diff-impact 检查潜在影响范围。
不适合
  • 需要 Windows 桌面应用而不接受 CLI 的用户
  • 只想使用托管式网页服务的团队
  • 代码语言不在已列出的 30 种语言中的项目
官网
getgraphmind.com ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-10-15最新版本 v0.3.7(2026-10-15)

这个 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 指令自动召回。跨项目命令还能搜索所有注册仓库、推断共享符号关系并查看项目间依赖。

  1. 维护大型仓库的开发者,在修改函数前用 graphmind fn-impact 或 graphmind diff-impact 检查潜在影响范围。
  2. 使用 Claude Code 或 Cursor 的团队,希望让助手直接查询符号、调用关系和架构,而不是反复读取完整仓库。
  3. 同时维护 API、前端和共享库的工程团队,需要跨已注册项目搜索符号并追踪项目间依赖。
  4. 接手陌生代码库的开发者,希望快速查看关键文件、层次化符号大纲、循环依赖和无入边符号。
  5. 希望跨 AI 会话保留架构决策、编码约定、已知缺陷和业务上下文的个人或团队。
  6. 需要把局部或跨项目代码图导出为 Mermaid、Graphviz DOT、JSON 或 Obsidian 知识库的架构人员。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • curl -fsSL https://raw.githubusercontent.com/aouicher/graphmind/main/scripts/install.sh | bash
  • brew install aouicher/graphmind/graphmind
  • brew 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/graphmind

macOS 桌面应用也可通过 Homebrew 安装:

brew install --cask aouicher/graphmind/graphmind

Linux 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 init

setup 配置 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 --run

MCP 客户端通过 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
55/ 100 五分制 2.8 / 5
信任安全 16/29
可靠稳定 6/14
适用触发 10/18
规范维护 12/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全16 / 29 · 2.8/5

代码与文档显示工具主要通过本地 stdio MCP、SQLite 和 JSONL 工作,网络请求用于可选的 OpenAI/Voyage 嵌入,且默认禁用嵌入;因此最小权限和数据流有一定说明(各 2)。setup/init 会改写配置、PATH、hooks、MCP 条目并建立索引,文档说明备份、保留用户编辑内容及部分解析失败时的处理,但没有普遍逐项确认流程(用户确认 1),也未见对记忆和 API 密钥的具体保护措施(敏感数据 1)。依赖安全仅有 Cargo 工作区和 CI 信息,样本未展示审计或漏洞缓解机制(1)。外部副作用及其适用范围说明较细(2),备份、幂等和卸载命令提供部分回退路径(2)。仓库含安全联系地址和版权信息,但发布者身份未核实,维护归属仍不充分(来源归属 2)。

可靠稳定6 / 14 · 2.1/5

README 声称 25 个 MCP 工具,架构和 CLAUDE.md 写 27 个,且所列工具数量与数字未能从样本统一核对,自洽性因此偏低(1)。CI 配置显示有多平台构建和多组测试,但外部模型服务、安装分发和解析器依赖的可用性保障未充分展示(依赖可用性 1)。代码将解析错误转成带文件信息的错误,README 也说明若干配置解析失败时会保留原文件并提示,错误处理达到普通使用水平(2)。

适用触发10 / 18 · 2.8/5

README 覆盖 CLI、桌面端、多种编辑器/MCP 客户端、工作树及不同嵌入模式,常见受众和场景说明充分(2)。文档说明适用边界,例如未注册目录、husky/core.hooksPath、外部会话以及本地与远程嵌入选项(2)。技能说明要求优先使用 GraphMind,但触发范围较宽,并把自动保存记忆设为默认行为,触发精度与控制说明有限(1)。安装覆盖 macOS、Linux、Windows 的不同路径,但桌面端仅列 macOS 资产,平台支持并不完全一致(2)。

规范维护12 / 18 · 3.3/5

README 按安装、配置、搜索、记忆和命令组织,配有大量命令示例,但材料样本未包含全文,架构评分为 2。安装说明细致,列出配置位置、平台差异及手动设置方式(3)。命令与 MCP 名称整体可辨认,但工具计数和部分命名在 README/CLAUDE.md 之间有差异(1)。示例充足,README 以手动设置和场景说明部分回答常见问题,但未见完整 FAQ(2)。已披露若干平台与 hook 限制(2)。MIT 许可证文本和 Cargo 元数据一致(3)。Cargo.toml 有版本号,CI 描述发布流程;样本未含完整变更日志,故给 2。安全政策给出报告邮箱和响应目标,但未核实发布者,也没有明确维护团队或持续维护安排(1)。

有效结果7 / 13 · 2.7/5

CLI、MCP 和记忆查询提供结构化符号、依赖、影响分析及搜索结果,输出具备实用性,但样本未充分显示输出格式本身(2)。图谱、语义搜索、跨项目链接和持久记忆相较原始文本搜索有明显增量用途;令牌节省与准确性等关键收益仍主要是项目自述(2)。需要安装 CLI、注册和构建图谱,部分嵌入还需外部 API;成本与收益没有独立证据量化(1)。

证据核验4 / 8 · 2.5/5

架构、安装、配置、副作用和基准主张有 README 与部分源代码/CI 文件可追溯,但令牌基准及若干产品能力没有样本内的具体测量证据(2)。少数主张可由 README、CLI 源码、Cargo 元数据或 CI 互相印证,但主要能力描述集中在 README,且样本有限(1)。README 对事实、默认值和部分行为作了区分,但基准和效率主张与实现证据之间没有明确标出推断边界(1)。

风险与缓解建议
  • README 对 MCP 工具数量的表述与架构和 CLAUDE.md 不一致;评估材料也不是完整仓库。
  • 安装与 setup 会修改用户级配置、hooks 和项目索引;运行前应检查涉及路径,并确认这些改动符合预期。
  • 嵌入可使用外部服务并配置 API 密钥;样本没有说明密钥存储保护细节。
证据充分度:低 评估于 2026年11月8日 审查版本 ccbf1b820a30
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/graphmind.svg?lang=zh)](https://followagents.com/zh/agents/graphmind)
<a href="https://followagents.com/zh/agents/graphmind"><img src="https://followagents.com/badge/graphmind.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.3.7
    发布说明摘录
    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 查看 ↗
  2. v0.3.6
    发布说明摘录
    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 查看 ↗
  3. v0.3.5
    发布说明摘录
    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 查看 ↗

常见问题

离线环境可以使用吗?
可以使用结构图、FTS 搜索和持久记忆。默认不启用嵌入,也不进行网络调用;如需语义检索,可选择本地 ONNX 模型。安装文件本身仍需预先取得。
它会把源码上传到云端吗?
默认不会。数据保存在 ~/.graphmind/,MCP 使用 stdio。只有显式配置 OpenAI/Voyage AI 嵌入或启用 Pro/Team 同步时才涉及网络功能。
必须使用 Claude Code 吗?
不必。GraphMind 有独立 CLI,并声明支持 Claude Desktop、Cursor、Windsurf、Cline、Zed、Continue、VS Code 以及其他 MCP 客户端;自动搜索钩子和 /gm 技能则针对 Claude Code。
写入记忆是否受控?
CLI 提供添加、搜索、列出和删除命令。通过 MCP 写入时,gm_memory_add 要求明确确认;记忆会持续保存,直到被显式删除。
免费版本是否足够个人使用?
MIT 许可的本地 CLI、图谱、搜索和记忆功能可用于个人工作流。团队图谱同步、共享记忆和相关 MCP 工具被标记为 Pro/Team 功能。
GraphMind 代码知识图谱 官网是什么?
GraphMind 代码知识图谱 的 GitHub 仓库填写的官网是 https://getgraphmind.com。这个链接由仓库作者设置;源码在 GitHub(aouicher/graphmind)。
GraphMind 代码知识图谱 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 GraphMind 代码知识图谱 的“信任与安全”打了 16/29 分。评审检查的 8 项安全措施没有完全缺失的。
GraphMind 代码知识图谱 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-15,在最近半年内,但不在最近 30 天内。最新版本是 v0.3.7(2026-10-15)。
GraphMind 代码知识图谱 是谁开发的?
GraphMind 代码知识图谱 由 GitHub 账号 aouicher 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念