Understand-Anything 使用教程

70K Star 开源工具,把任意代码库变成可交互知识图谱

⭐ 开源免费

📖 项目简介

Understand-Anything 是一款拿下 70K Star 的开源工具,能把任意代码库、知识库或文档, 变成一张可交互的知识图谱——每个文件、函数、类、依赖都是图上一个可点击、可搜索的节点。

它通过多智能体协作的流水线扫描整个项目,自动提取结构与关系,生成一份 knowledge-graph.json, 再配上可视化仪表盘:点开任意节点就能看到大白话的功能说明、关联依赖和引导讲解。 接手陌生项目、读别人的"屎山代码"时,不用再一行行硬啃,一张图直接看穿整个架构。

它是一个编辑器插件,原生支持 Claude Code,并为 Codex、Cursor、VS Code + Copilot、Gemini CLI、 OpenCode 等十多个平台提供一键安装。Cursor / VS Code 克隆仓库后可自动发现,开箱即用。

核心亮点

🕸️
代码变知识图谱
文件 / 函数 / 类 / 依赖,全部变成可点、可搜、可探索的节点
🗣️
大白话讲解
点开任意节点,LLM 给出通俗说明、关联关系和引导式导览
🔎
语义搜索
直接问「哪部分处理登录逻辑」,秒定位对应模块
🧩
多平台通用
Claude Code / Codex / Cursor / Copilot 等十多个平台一键接入

🚀 如何使用

1

安装插件

Cursor / VS Code + Copilot:把仓库克隆到你的项目里即可,编辑器会自动发现插件,无需手动安装。 Codex / Gemini CLI / OpenCode 等:跑一键安装脚本(在仓库 README 的 Installation 章节复制对应平台命令,后面接平台名如 codex)。

2

生成知识图谱

在项目里执行 /understand 命令,多个智能体会依次扫描项目、提取文件 / 函数 / 类 / 依赖, 并把结果保存到 .understand-anything/knowledge-graph.json

3

打开仪表盘探索

运行 /understand-dashboard 打开可视化图谱,点击任意节点看讲解与关系; 用 /understand-explain [文件路径] 对某个组件做深度分析。整个陌生项目,一张图看穿。

常见问题

Q: 支持哪些编程语言?

用 Tree-sitter 做结构解析,主流语言都能覆盖(TypeScript、JavaScript、Python、Go、Java 等), 对多语言混合的仓库也能统一建图。

Q: 会不会把我的代码传到云端?

结构解析在本地完成,生成的知识图谱是本地的 knowledge-graph.json。只有节点的大白话摘要 会调用你已配置的大模型来生成,用的是你自己的编辑器 / API,可控。

Q: Cursor 里装了没反应怎么办?

确认仓库已完整克隆到项目目录、并在 Cursor 中打开该项目;若自动发现失败,可在 Cursor 设置里手动填入仓库地址安装。 仍不行时,按 README 提示执行依赖安装后重新运行 /understand