AI编程实践第8节:使用Understand Anything理解项目关系图谱

为什么我们需要它？

当我们阅读新系统代码的时候，阅读代码已经很难了，理解整个系统更难。文档往往过时，上手周期长达数周，新功能开发像考古。Understand Anything 通过结合 大语言模型（LLM）与静态代码分析去生成一个动态、可探索的代码知识地图 — 并提供自然语言解释。

想象一下，你可以轻松点击每个函数、类和文件节点，立即看到它的作用、依赖关系以及简明的自然语言解释。对于入门开发者，它像一位耐心的导师，引导你循序渐进地理解整个系统；对于产品经理和设计师，它像一本透明的手册，让你无需阅读代码，也能洞察系统的逻辑；而对于 AI 协同开发者，它提供了深入的分析接口，让你的智能工具真正理解你的项目。

目前适用哪些人群？

👩‍💻 入门级开发者：不再被陌生代码淹没。通过结构化引导逐步理解系统架构，每个函数和类都有简明易懂的解释。

📋 产品经理 & 设计师：无需阅读代码，也能理解系统逻辑。比如直接提问：“认证流程是怎么实现的？” 便可获得基于实际代码库的清晰答案。

🤖 AI协同开发者：让你的 AI 工具深入了解你的项目。在代码审查之前使用/understand-diff，在深入任何模块时使用/understand-explain，或在架构分析中使用 /understand-chat。

核心功能如下：

接下来我使用ClaudeCode、MiniMax2.7、开源商城项目：CRMEB商城JAVA版来分享下这个东西。

首先，我们更新为最新版本的Claude Code：

npm install -g @anthropic-ai/claude-code

然后通过cc switch软件，设置ClaudeCode的模型为MiniMax2.7模型，这里我购买了TokenPlan计划，目前是比较合适的：

然后我们访问下CRMEB Java这个开源项目的代码仓库，下载代码到本地：https://gitee.com/ZhongBangKeJi/crmeb_java，CRMEB开源商城系统Java版，是一款基于Apache-2.0协议发布的开源电商解决方案。代码全开源无加密，可免费商用，适合各类企业及开发者快速构建多端一体化商城。系统采用Java + Vue +

uni-app技术栈，基于SpringBoot框架构建，前后端分离架构设计清晰。借助uni-app的跨端能力，轻松实现小程序、公众号、H5、APP、PC端全覆盖，数据统一、业务同步，极大提升开发与维护效率。

这里我导入的项目到IDEA中，如下所示：

接下来我们在这个项目下打开ClaudeCode的终端窗口，安装下这个Understand Anything插件：

/plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything

截图如下所示：

安装完成后，我们这里重启下插件，执行reload-plugins命令，然后看到：

如果没有看到可以直接ctrl+C然后claude -c重进。

接下来可以看到Claude Code开始执行这个/understand的命令。

执行这个命令第一阶段是扫描当前项目，识别项目的复杂度和文件的数量：

接下来它开启了5个并行的agent，阶段2的分析，它创建了43个批次进行分批处理：

这个步骤比较耗时，当前我下载的这个CRMEB项目中的java文件大概有1000多个，Claude Code帮我搞了40个多个批次去执行。

每个批次执行的时候，本次磁盘会处理生成一些临时性的文件：

多智能体（multi-agent）架构会：扫描你的项目，提取函数 / 类 / 依赖，构建知识图谱保存至.understand-anything/knowledge-graph.json

/understand 命令调用 5 个 agent：

接下来经过漫长的等待，几个小时后，1000多个文件终于分析完成了，同时它会提示如下结果：

生成完成后，实际上再本地会产生一个知识图谱的JSON文件，如果我们后续需要自己二次创作也是OK的：

接下来我们继续，我们输入如下命令查看数据看板：

/understand-dashboard

打开交互式网页数据看板，您的代码库将以图表形式呈现 — 按架构层级进行颜色编码，支持搜索和点击。选择任意节点即可查看其代码、关系以及简明易懂的解释。

执行命令后，会在浏览器中打开如下界面：

目前看了一些，目前这个软件应该是正在处于发展期，从一些效果层面，还没有到Neo4j这种，但是基本上把一个系统的关系进行了展示。

可以询问下相关内容：

# 询问任意代码库的问题

/understand-chat  购物车模块的相关逻辑

如下：

还有其他可以使用：

# 分析当前修改的影响 /understand-diff  # 深入理解某个文件 /understand-explain src/auth/login.ts  # 为新团队成员生成指南 /understand-onboard

例如让它可以让他给我解释某个模块文件：

我们可以执行/understand-onboard这个技能，然后让它根据我们的需要给我们写一写指南，例如：

这个运行完成后，可以看下文档，文档中也包含一些学习的路径：

我们也可以根据自己的需求进行提问。

根据作者仓库的介绍，它的功能不仅仅停留在可视化。语义搜索可以帮你迅速找到项目中处理身份验证的部分；变更影响分析让你在提交修改前知道可能波及的模块；引导式学习路径为你梳理系统架构；甚至根据不同角色自动调整界面，让每一位使用者都能高效上手。

目前我感觉当前有一些大的代码仓库，可能不太适合用这个。

同时这种情况也需要一个厉害的模型，例如OPUS4.6，当前MiniMax还是有些欠缺，这个开源项目还需要发展一下，不过目前提供的一些能力也是能够满足了一些简单的场景。