GraphMind 代码知识图谱

这个 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 知识库的架构人员。

如何安装或部署这个 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 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题