Graphify
从智能体向 Graphify 卡片画一条箭头。它会向项目地图询问各部分如何相连:谁调用了这个函数,结账流程如何到达数据库,改动这里会影响什么。你可以实时看到每个问题在地图上的走向。
基于 Graphify Labs 的开源代码知识图谱 graphify:github.com/Graphify-Labs/graphify
9
一根箭头让智能体获得的图谱工具:提问、邻居、路径、影响等
≈12
在我们的测试中首次为本网站代码(472 个文件)绘制地图所需的秒数;编辑后只重新读取改动的文件
0
字节的代码被发送到外部。graphify 用 tree-sitter 在本地解析,不用 LLM,没有遥测
每个问题都会点亮地图
三个智能体向同一张 Graphify 卡片提问。问题出现后,搜索起点的文件泛起波纹,遍历沿着调用和导入一跳一跳地展开。点击一个问题可重放,点击一个文件可查看它的关联。
结果
访问了 6 个文件 · 深度 1
- 0blogHref()lib/blog.ts:186
- 1PostPage()app/blog/[slug]/page.tsx:109
- 1Footer()components/Footer.tsx:138
- 1resourceGroups()components/Nav.tsx:162
- 1blogFeed()lib/blogFeed.ts:41
演示用的虚构项目。工具、遍历过程和回答的形式与应用中一致。
两个图谱,两种用途
NeuroSquad 有两个代码图谱插件。它们回答不同的问题,可以在同一工作区中并用。
Graphify:地图
- 用自然语言提问,一次调用得到图谱中相关的部分
- 通过聚类找出的子系统,一眼看出哪些内容属于一起
- 文档、Markdown 章节和 NOTE / WHY 注释与代码在同一个图谱中
- 影响范围:改动一个符号会波及的所有内容
- 卡片上的实时可视化地图,绘出每一次智能体查询
代码图谱:精确工具
- 精确的符号搜索,多跳的调用者和被调用者
- 无需打开文件即可获取单个函数的源码
- 只读 Cypher,用于多步问题
- 语义代码搜索,以及把未提交改动映射到符号
- 引擎在代码所在处运行,包括 WSL 和 SSH 主机
用 Graphify 理解代码库、规划改动,用代码图谱定位到具体的行。让智能体同时连到两者:每个工具的描述都写明了它适合哪类问题。
了解代码图谱graphify 自己的查询,限定在你的工作区
graphify MCP 服务器的工具,由 graphify 自己的代码在本工作区的图谱上作答。每个工具的描述都写明了何时图谱比文本搜索更合适。
提问
graphify_query 把一个问题或几个符号名转换为相关子图:带行号的文件、调用、导入、继承,每条边都标有 EXTRACTED 或 INFERRED。
邻居
graphify_neighbors 列出调用、导入或引用某个符号的所有位置,附带每处使用的文件和行号。graphify_node 说明它在哪里、属于哪个子系统。
路径与影响
graphify_path 找出两者之间最短的链路。graphify_affected 从一个符号向回追溯,列出改动它会波及的一切。
全局视图
graphify_community 列出一个子系统,graphify_god_nodes 列出连接最多的抽象,graphify_stats 给出图谱规模。
让智能体知道何时图谱比 grep 好用
智能体从不调用的工具毫无用处。卡片会用简明的事实告诉已连接的智能体图谱的用途,但从不强制。
第一回合的说明
带箭头的第一回合会附上一段简短说明:图谱里有什么、哪个工具回答哪类问题、什么时候文本搜索仍然更合适。
在需要时提醒
之后的回合在提问涉及代码结构时附上一行提醒,否则每隔几个回合提醒一次。移除箭头会发送一条说明,告知工具已不可用。
搜索前的提示
在 Claude Code 中,对看起来像符号的内容执行 Grep、Glob 或 shell grep 时,会收到一行指向 graphify_neighbors 的提示。刚用过图谱时不提示,其余情况也有频率限制。
从不阻止
提示只是上下文,不是权限决定。你的 allow 和 deny 规则保持不变,搜索照常执行。卡片上的开关可以全部关闭。
附带说明的 CLI
添加卡片后立即绘制地图
卡片会立即构建工作区文件夹的完整图谱,并随你的编辑保持同步。
进度一目了然
首次构建时,卡片上显示已读文件数与总数、当前步骤和剩余时间。
如实告知智能体
首个图谱构建期间,工具会回答当前进度,智能体会先用常规搜索,而不是收到错误。
增量更新
卡片监视文件夹,几秒后重新读取改动的文件;graphify 的缓存让更新只需几秒。
文件由你决定
遵循 .gitignore 和 .graphifyignore。在卡片上可以排除语言、添加忽略模式,或包含被 git 忽略的生成代码。
一张卡片,一根箭头
一切都在你已经打开的画布上完成。
添加卡片
添加卡片菜单 → “插件…” → Graphify → “添加到画布”。
安装一次
点击“安装”。应用把 graphify 安装到自己的文件夹(约 250 MB),并立即为整个项目绘制地图。
画一根箭头
从智能体指向卡片。它会在下一次列出工具时获得图谱工具,大多数 CLI 无需重启。
观看提问
每次查询及其结果都会在地图上播放。点击任意文件即可在编辑器中打开。
NeuroSquad 运行的所有 CLI
工具通过 NeuroSquad 自己的 MCP 服务器提供,因此任何带箭头的智能体都能使用。
图谱工具:NeuroSquad 连接到其 MCP 服务器的所有智能体
支持本机和 WSL 中的工作区(graphify 从 Windows 读取发行版中的文件)。不支持 SSH 工作区,请改用代码图谱。
你的代码留在你的电脑上
graphify 是你电脑上的程序,而不是服务。
仅本地解析
代码在本机用 tree-sitter 解析。卡片以“仅代码”模式运行 graphify,不使用 LLM,其环境中也没有任何 API 密钥。
不向外发送
graphify 没有遥测,其可选的查询日志由应用关闭。
固定版本的安装
通过 uv 把独立的 Python 安装到应用的文件夹中。uv 的下载和每个 Python 包都按固定的校验和核对。不会使用或改动你自己的 Python 和设置。
保存在应用文件夹中
图谱保存在 NeuroSquad 的数据文件夹中,不会写入你的项目,删除卡片会同时删除其图谱。
内置开源
由 graphify 驱动
提取、图谱和查询都来自 graphify:用 tree-sitter 解析约 40 种语言,跨文件解析调用和导入,识别子系统并执行图谱查询。作者 Graphify Labs,Apache-2.0 许可。NeuroSquad 为你安装它并绘制它的图谱。
关于 Graphify 的问题
看看你的智能体如何阅读你的代码
下载 NeuroSquad,添加 Graphify 卡片,画一根箭头。