前言我先说结论这个插件是我最近用过很离谱的东西。事情是这样的。我有个博客项目199 个文件自己写的自己当然清楚。但我最近发现了一个叫Understand Anything的 Claude Code 插件据说能自动分析代码库生成知识图谱。听起来挺唬人的我心想不就是扫个目录嘛能有多厉害然后我跑了一下。它把我 199 个文件的项目拆成了 298 个节点、184 条依赖边、9 个架构层还给我生成了一条 13 步的学习路线。我盯着仪表盘看了十分钟有种我写的代码被 AI 从头到尾读了一遍然后画了张地图的感觉。它知道哪个文件是 API 客户端的核心哪个组件被哪些页面依赖。关键是——我什么都没配置就跑了一个命令。这篇文章就来聊聊这个插件到底是什么、怎么装、怎么用以及它分析我的项目后到底给出了什么。它到底能做什么先说核心能力你给它一个代码库它给你一张知识图谱。不是文件列表不是目录树而是一张真正的图——每个文件、函数、类都是节点它们之间的导入、调用、依赖关系都是边。然后它还会自动识别你的项目架构分层生成一条引导式学习路线。整个过程全自动不需要你写任何配置。分析结果一览拿我的博客项目 Kirameku 举例。它跑完之后我得到了这些节点统计298 个类型数量说明file186源代码文件function98函数/方法config9配置文件document4文档文件class1类/接口边统计184 条类型数量说明contains104文件包含函数/类depends_on38运行时依赖imports28导入关系exports9导出关系documents3文档关联configures2配置关联自动识别的架构层9 层层级文件数说明工具与游戏层5835 工具箱应用 18 款小游戏UI 页面层43博客核心页面 花园实验区 小说阅读资源层25WebP 图片 Live2D 模型配置组件层32可复用 UI 组件布局/音乐/照片/特效API 层17统一 HTTP 客户端 各业务域 API配置层9Next.js/TS/ESLint 配置数据层6静态数据 类型声明内容层4博客文章状态管理层55 个 React Context Provider学习路线13 步从根布局开始到首页、API 层、状态管理、工具箱、花园、小说阅读、社交功能、最后到部署配置。像一份自动写的项目导览。这些全都是 AI 自己分析出来的我没做任何标注。安装前置条件Node.js ≥ 22推荐 24pnpm ≥ 10Claude CodeCLI 或桌面版都行Claude Code 安装在 Claude Code 中依次运行/plugin marketplaceaddLum1104/Understand-Anything /plugininstallunderstand-anything装完就完事了插件会自动注册所有命令。其他平台这个插件不只支持 Claude Code还支持一堆 AI 编码工具平台安装方式Claude Code插件市场Cursor克隆仓库自动发现VS Code GitHub Copilot克隆仓库自动发现Copilot CLIcopilot plugin installCodex / Gemini CLI / OpenCode 等一行脚本安装Codex、Gemini CLI 等平台用一行命令装# macOS / Linuxcurl-fsSLhttps://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh|bash# Windows (PowerShell)iwr-usebhttps://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1|iex基本用法1. 分析项目进入你的项目目录运行/understand没了。就这一个命令。插件会自动走完 7 个阶段扫描文件 → 识别语言框架 → 分批分析 → 建立依赖 → 识别架构 → 生成路线 → 保存图谱。输出保存在.understand-anything/knowledge-graph.json。2. 中文输出默认输出是英文。加--language参数切换语言/understand--languagezh支持的语言en默认、zh、zh-TW、ja、ko、ru。这个参数会影响节点摘要和描述、仪表盘 UI 的标签和按钮、学习路线的解释说明。3. 打开仪表盘分析完之后启动可视化/understand-dashboard浏览器会自动打开一个交互式页面。你可以浏览节点点击查看每个文件的摘要、标签、复杂度探索依赖看文件之间的导入、调用关系切换层级按架构层过滤只看 API 层或只看 UI 层走学习路线跟着 Tour 一步步理解项目语义搜索搜索哪些部分处理身份验证就能找到相关节点4. 增量更新改了代码之后再跑/understand它会自动检测哪些文件变了只重新分析那些文件。不用全量重建速度很快。还可以开启自动更新/understand --auto-update这会安装一个 post-commit 钩子每次 git 提交后自动增量更新图谱。进阶用法基于知识图谱问答分析完之后你可以直接问项目相关的问题/understand-chat这个项目的 API 层是怎么组织的/understand-chat首页用了哪些组件/understand-chat音乐播放器的状态管理方案是什么AI 会基于知识图谱里的节点和边来回答不是泛泛而谈而是基于实际代码结构。分析变更影响提交代码前看看这次改动影响了哪些模块/understand-diff深入理解某个文件对某个文件有疑问直接问/understand-explain app/api/client.ts生成新人指南要给新同事介绍项目/understand-onboard它会生成一份结构化的项目导览从入口文件开始一步步带你了解整个项目。提取业务领域想看代码如何映射到业务流程/understand-domain它会识别出业务领域、流程和处理步骤以水平图的形式展示。分析知识库指向一个 Markdown wiki/understand-knowledge ~/path/to/wiki它会把你的 wiki 转化为可导航的知识图谱带社区聚类和隐式关系发现。指定子目录只想分析某个子目录/understand src/frontend大型 monorepo 可以用这个来缩小分析范围。强制全量重建/understand--full跳过某些文件项目根目录下有个.understand-anything/.understandignore文件语法跟.gitignore一样。把不想分析的文件加进去就行。比如我的项目有很多 Live2D 模型资源二进制文件、动画文件我就把它们排除了# .understandignore public/live2d/model/ public/live2d/jsdelivr/团队共享图谱就是一份 JSON 文件提交到 git 之后团队成员可以跳过分析直接用。# .gitignore 中排除临时文件 .understand-anything/intermediate/ .understand-anything/diff-overlay.json大型图谱10 MB 以上建议用 git-lfs 跟踪。它是怎么工作的Tree-sitter LLM 混合分析插件用了一种很聪明的分工Tree-sitter确定性—— 把源码解析成语法树提取结构性事实导入、导出、函数定义、类定义、调用点、继承关系。这些是确定性的同样的代码永远得到同样的结果。LLM语义—— 读取解析后的结构和源码生成 Tree-sitter 做不了的事通俗易懂的摘要、标签、架构层归属、学习路线。正因为这个分工图谱在结构层面是可复现的同样的代码总是产生同样的边同时在语义层面又能捕捉意图一个文件是「为了什么」存在而不仅仅是它 import 了什么。多智能体架构/understand命令背后有 5 个 AI 代理协作代理职责project-scanner扫描项目文件检测语言和框架file-analyzer提取代码结构生成图节点和边architecture-analyzer识别架构层tour-builder生成引导式学习路径graph-reviewer验证图的完整性和引用完整性文件分析器并行运行最多 3 个并发所以分析速度还不错。适用场景接手新项目最直接的用法。跑一遍/understand5 分钟内对项目架构有个整体认知比翻 README 快多了。代码审查PR 改了一堆文件用/understand-diff看看这次改动影响了哪些模块依赖关系有没有变化。写文档知识图谱里的节点摘要、架构分层、学习路线稍微整理一下就是一份不错的项目文档。技术分享要给别人介绍项目把仪表盘打开边点边讲比 PPT 直观多了。新人 onboarding/understand-onboard生成的项目导览比你自己写的新人文档靠谱多了——因为它是基于实际代码结构生成的不会遗漏。局限性说几个目前的不足大项目会慢文件越多分析越久100 个文件大概 20 分钟500 个文件可能要 40 分钟甚至更久AI 分析有上限特别复杂的业务逻辑AI 可能理解得不够深静态分析为主运行时的调用关系比如动态 import、反射分析不到图谱体积大型项目的图谱 JSON 可能超过 10 MB需要用 git-lfs总结Understand Anything 的核心价值是把看代码这件事从人工翻阅变成了 AI 自动分析 可视化探索。你不需要手动画架构图不需要写文档解释项目结构不需要花一周时间通读代码库。跑一个命令等几分钟打开仪表盘一切都在那里。对于个人项目、小团队项目来说它能帮你快速建立对代码库的整体认知。对于大型项目它至少能给你一个起点——知道该从哪里开始看。安装简单用法简单输出直观。如果你经常需要接手新项目或者给别人介绍项目强烈建议试试。项目地址https://github.com/Lum1104/Understand-Anything在线演示https://understand-anything.com/demo/我的博客项目完整代码在 GitHub欢迎 star本文基于 Understand Anything v2.7.5 编写功能和接口可能随版本更新有所变化。
