大家好,我是何三,独立开发者
2.5 个月冲了近 4 万 Star。一条 /understand 命令,20 万行代码直接变成交互式知识图谱——不用一行一行读,不用问同事"这个文件是干嘛的",点一下节点,中文解释自己蹦出来。
这就是 Understand Anything。
你刚加入一个新团队。代码库 20 万行。打开项目,文件夹套文件夹,文件名一个比一个抽象。Team Lead 丢来一句"你先看看代码熟悉一下"就走人了。
熟悉一下?从哪熟悉?
它的开发者显然也被这个问题折磨过——README 开篇第一句就是灵魂拷问:"当你刚加入一个新团队,面对 20 万行代码,你从哪里开始?"

这玩意儿到底怎么做到的?
原理说复杂也复杂,说简单也简单。
它体内跑了 5 个 AI 智能体,各干各的:
- 一个负责扫目录、识别语言和框架
- 一个负责提取函数、类、import 关系,生成图节点和边
- 一个负责判断架构层级——API 层、服务层、数据层,自动分好
- 一个负责生成引导式学习路径,按依赖顺序排好
- 一个负责校验图谱的完整性,确保不会漏东西
文件分析器还开了并行,一批跑 20-30 个文件。改了什么只重跑什么——增量更新,不用每次都全量扫描。
说白了,让 AI 替你把代码读了一遍,还画了张地图送你。

它的技术选型也挺有意思——Tree-sitter + LLM 的混合架构。Tree-sitter 干确定的事:解析语法树、提取 import、函数定义,给啥代码出啥结果,不玩花的。LLM 干语义的事:写摘要、判断文件属于哪个层、解释这段代码到底在干嘛。
一个管结构,一个管意思。分工跟大公司项目似的。
说到 Tree-sitter,我突然想起一个事——这玩意儿最早是 GitHub 给 Atom 编辑器做的语法高亮引擎。后来 Atom 凉了,Tree-sitter 被 NeoVim 捡走当核心解析器。现在又被 AI 工具拿来当代码分析的骨架。一个项目的一生啊,真是跟连续剧一样——主角死了,配角的番外篇火了。
扯远了,回正题。
怎么上手?简单到离谱
如果你用 Claude Code,装插件就行了:
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
然后跑分析:
/understand --language zh
再打开看板:
/understand-dashboard
浏览器直接弹出交互面板。代码库以图谱形式呈现——按架构层级上色,能搜索能点击。点开任何一个节点:代码原文、中文摘要、和谁有关系,一目了然。
还有一堆骚操作:
# 直接问
/understand-chat 支付流程是怎么走的?
# 改代码之前看看影响范围
/understand-diff
# 给新同学生成入职指南
/understand-onboard
# 提取业务领域知识
/understand-domain
生成的知识图谱就是一份 JSON 文件,提交到 Git 里,团队其他人直接复用。新人入职第一天,不用找任何人,打开图谱就知道代码长啥样。
不止 Claude Code,它支持 14 个平台。Cursor 和 VS Code 能自动发现,其他的一条 curl 搞定:
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
同类赛道里,Sourcegraph 做代码搜索很强,但不给你画图谱。CodeSee 有可视化,但处理 20 万行的项目有点吃力。Understand Anything 是目前唯一把 AI 多智能体 + 知识图谱 + 交互面板打包成一个插件的方案。
道理我都懂,但有一个问题——为什么用多智能体而不是一个大模型直接分析?
我猜是因为大模型有上下文窗口限制,一次塞 20 万行代码进去直接报错。拆成 5 个智能体各管一摊,绕过了限制,出错也只需要修一个模块。
当然,以上纯属我的推测——有懂的大佬欢迎指正。
项目地址
GitHub:Lum1104/Understand-Anything
不想装 CLI?官网有 在线演示:https://understand-anything.com/demo/
浏览器打开就能体验图谱效果。建议你现在就去试试,因为——
说实话,我第一次打开那个交互图谱的时候,真的愣住了。那个感觉就像你一直在黑灯瞎火里摸墙走路,突然有人把整个房间的灯全打开了。
本文使用 MGO 编辑并发布
关注"何三笔记",回复"mgo" 免费下载使用