你刚加入一个新项目,代码库有 20 万行。
老员工给你一个 GitHub 地址,说「先熟悉熟悉」。你打开文件目录,1000 多个文件夹,不知道从哪开始。问 AI,AI 给你的回答和代码根本对不上。问人,人比你更忙。
Understand Anything 想解决的是这个场景:把任意代码库变成一张可以点击、搜索、漫游的交互式知识图谱。
Understand Anything 是一个开源的 Claude Code Plugin(GitHub:Lum1104/Understand-Anything),通过多 Agent 管道分析代码库,构建包含每个文件、函数、类和依赖关系的知识图谱,然后给你一个交互式 Dashboard 让你可视化地探索整个项目。
支持 Claude Code、Codex、Cursor、Copilot、Gemini CLI、OpenCode、Trae 等主流 Agent——不绑定任何一家。
核心思路:
不是给你一段代码让你自己读,而是先让 AI 把整个代码库的结构「理解」一遍,生成一张图。你在这张图上漫游,比读源码快 10 倍。
Understand Anything 的处理流程:
代码库 → 多 Agent 管道分析
↓
构建知识图谱(文件 / 函数 / 类 / 依赖关系)↓
组装成交互式 Dashboard
↓
你在 Dashboard 上漫游、搜索、点击节点
多 Agent 协作,每个 Agent 负责一个专项:
- project-scanner:扫描项目结构
- file-analyzer:分析单个文件
- architecture-analyzer:分析架构层级
- tour-builder:生成导览路线
- graph-reviewer:审查图谱质量
Understand Anything 包含 8 个 Skills,覆盖不同使用场景:
理解代码库
| Skill | 功能 |
|---|---|
/understand |
主入口,分析整个代码库并生成图谱 |
/understand-dashboard |
启动交互式 Dashboard |
/understand-onboard |
新人入职引导,生成架构导览 |
查询与解释
| Skill | 功能 |
|---|---|
/understand-chat |
对着代码库聊天,问任意问题 |
/understand-explain |
解释具体代码段的作用 |
/understand-knowledge |
分析知识库(LLM Wiki 等) |
分析与变更
| Skill | 功能 |
|---|---|
/understand-diff |
变更影响分析——改一行代码会影响到哪里 |
/understand-domain |
业务逻辑视图,看代码如何映射到业务流程 |
Dashboard 用深黑底色(#0a0a0a)+ 金色点缀(#d4a574),采用 React Flow 构建图谱,左侧 75% 是图形区域,右侧是信息面板。
点击任意节点(文件、函数、类),右侧显示:
- 英文摘要
- 和其他节点的关系
- 所在模块的上下文
Dashboard 还根据访问者身份调整信息密度——Junior Dev 看到更多解释,Power User 看到更多细节。
场景一:新人入职
以前:新人在 Slack 上问「这个模块是干啥的」,等半天没人回,就开始在代码里乱翻。
现在:/understand-onboard,生成架构导览,走一遍关键路径,知道哪些文件是核心、哪些是工具类、从哪开始看。
场景二:代码审查
以前:Reviewer 拉 PR,看半天代码,看不出来改了啥影响。
现在:/understand-diff,输入变更内容,直接看到影响范围——改了哪几个文件,分别影响哪些模块。
场景三:接手遗留代码
以前:10 万行遗留代码,注释全英文,逻辑全靠猜。
现在:/understand-chat 问「这个核心流程经过哪些文件」,图谱直接展示调用链,比读代码快了不知道多少倍。
claude plugin marketplace add Lum1104/Understand-Anything
claude plugin install understand-anything
git clone https://github.com/Lum1104/Understand-Anything.git
cd Understand-Anything
./install.sh
-
Dashboard 需要本地运行:不是纯在线工具,需要在本地起服务
-
大型代码库耗时:20 万行代码首次分析需要几分钟
-
依赖 Agent 能力:图谱质量受底层 LLM 影响,能力强的模型效果更好
-
学习曲线:Dashboard 功能多,刚上手需要摸索
-
接新项目的开发者:快速理解不熟悉的代码库
-
技术负责人:在代码写之前先搞清楚影响范围
-
新人入职:系统化了解项目架构,不用到处问人
-
代码审查者:改一行代码之前看清楚影响
代码库的规模越来越大,人肉读代码的效率越来越低。
Understand Anything 的本质是 让 AI 先替你读一遍代码,把结构抽出来,然后你在这张结构图上快速导航。不是让 AI 给你一段代码的解释,而是让 AI 给你一张地图。
这个方向和 OpenSpace 有些相似——都是解决 Agent 的「记忆与理解」问题。OpenSpace 解决的是 Agent 经验积累,Understand Anything 解决的是代码库理解。两者结合,Agent 能做的事情疆域会大很多。
相关链接:
- GitHub:https://github.com/Lum1104/Understand-Anything
- 官网:https://understand-anything.com
- 在线 Demo:https://understand-anything.com/demo/
END
如果你曾经面对一个 20 万行的代码库不知道从哪下手,Understand Anything 可能是你需要的那个入口。