Claude Code扩展工具——Understand-Anything

cuixiaogang

Understand-Anything 是一个把代码库、知识库、文档转成“可视化知识图谱 + 可搜索 + 可对话”的工具,帮助你快速理解系统全貌。Understand-Anything 的目标不是帮你逐行看代码,而是帮你从全局理解“这个系统是怎么组织起来的、每一部分为什么存在、它们之间如何协作”。

它主要是做什么的

帮你理解大型代码库

当你接手一个陌生项目、一个新团队、或者一个很大的 monorepo 时,它会:

  • 扫描项目结构
  • 提取文件、函数、类、依赖关系
  • 构建知识图谱
  • 生成交互式可视化界面

这样你不用从头“盲读代码”,而是可以先看到:

  • 系统有哪些模块
  • 模块之间怎么连接
  • 某个功能涉及哪些文件
  • 某个改动会影响哪些地方

把代码变成“可探索”的图谱

它会把代码库中的元素变成图节点,例如:

  • 文件
  • 函数
  • 依赖关系

你可以在 Dashboard 里:

  • 点击节点查看说明
  • 搜索相关功能
  • 看依赖上下游
  • 按架构层级浏览(API、Service、Data、UI 等)
  • 这相当于给代码库加了一层“地图”。

用 AI 帮你解释代码和业务逻辑

它不仅做静态分析,还结合 LLM 做语义理解,所以除了“结构”,还会生成:

  • 通俗摘要
  • 架构层归类
  • 业务流程映射
  • 学习路径
  • 语言特性解释

比如你可以直接问:

  • payment flow 是怎么走的?
  • 哪些部分处理身份验证?
  • 修改这个文件会影响哪里?

支持知识库/Wiki 图谱化

除了代码库,它也能分析知识库,尤其是类似 wiki 的文档体系。它可以:

  • 解析文档之间的链接关系
  • 提取实体、关系、论断
  • 生成知识图谱
  • 帮你浏览一个知识体系的结构

也就是说,它不只是“读代码”,也能“读文档”。

claude 如何安装及使用

注意

  1. 需要安装 node 20+ 版本
  2. 以下的所有命令都是在 ClaudeCode CLI 会话中完成的。

安装

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

分析代码库

1
2
// 前置,必须跑一次
/understand --language zh

--language 参数会影响:

  • 知识图谱中的节点摘要和描述
  • Dashboard UI 的标签、按钮和提示
  • 导览路线的解释说明

其他使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 打开数据看板
/understand-dashboard

# 询问任意代码库的问题
/understand-chat How does the payment flow work?

# 分析当前修改的影响
/understand-diff

# 深入理解某个文件
/understand-explain src/auth/login.ts

# 为新团队成员生成指南
/understand-onboard

# 提取业务领域知识(领域、流程、步骤)
/understand-domain

# 分析 Karpathy 模式的 LLM Wiki 知识库
/understand-knowledge ~/path/to/wiki

# 直接重跑即可 —— 默认增量更新,只分析变更的文件
/understand

# 安装 post-commit 钩子,每次提交自动增量更新
/understand --auto-update

# 大型 monorepo?把分析范围限定到某个子目录
/understand src/frontend

其他平台支持度

其他平台支持度
其他平台支持度

数据看板

注意:如果期望常驻运行这个数据看板服务,那就不适合在 Claude 会话中启动了,可以使用下面的命令运行服务(前提是运行了 /understand 命令,这个命令会在项目目录下生成一个文件.understand-anything/knowledge-graph.json):

1
2
3
cd ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard \
&& GRAPH_DIR=/data/cuixiaogang/service/data/{项目目录}\
npx vite --host 0.0.0.0 --port 15490

Understand-Anything数据看板
Understand-Anything数据看板